@enact/limestone 1.3.0

package/ContextualMenuDecorator/ContextualMenuDecorator.js

@@ -0,0 +1,264 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.ContextualMenuDecorator = void 0;
+var _handle = require("@enact/core/handle");
+var _hoc = _interopRequireDefault(require("@enact/core/hoc"));
+var _kind = _interopRequireDefault(require("@enact/core/kind"));
+var _Repeater = _interopRequireDefault(require("@enact/ui/Repeater"));
+var _Toggleable = _interopRequireDefault(require("@enact/ui/Toggleable"));
+var _compose = _interopRequireDefault(require("ramda/src/compose"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _ContextualPopupDecorator = _interopRequireDefault(require("../ContextualPopupDecorator"));
+var _Item = _interopRequireDefault(require("../Item"));
+var _Scroller = _interopRequireDefault(require("../Scroller"));
+var _Skinnable = _interopRequireDefault(require("../Skinnable"));
+var _ContextualMenuDecoratorModule = _interopRequireDefault(require("./ContextualMenuDecorator.module.css"));
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["className"],
+  _excluded2 = ["onOpen", "popupProps"];
+/**
+ * A decorator for adding contextual menus to components.
+ *
+ * @module limestone/ContextualMenuDecorator
+ * @exports ContextualMenuDecorator
+ */
+// The maximum number of visible items. More than this number invokes a scroller.
+// When updating this value, you must also set the max-items LESS variable.
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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; }
+var MAX_VISIBLE_MENU_ITEMS = 5;
+
+/**
+ * Default config for {@link limestone/ContextualMenuDecorator.ContextualMenuDecorator}
+ *
+ * @type {Object}
+ * @hocconfig
+ * @memberof limestone/ContextualMenuDecorator.ContextualMenuDecorator
+ */
+var defaultConfig = {
+  /**
+   * Disables passing the `skin` prop to the wrapped component.
+   *
+   * @see {@link limestone/Skinnable.Skinnable.skin}
+   * @type {Boolean}
+   * @default false
+   * @memberof limestone/ContextualMenuDecorator.ContextualMenuDecorator.defaultConfig
+   * @public
+   */
+  noSkin: false,
+  /**
+   * The prop in which to pass the value of `open` state of ContextualMenuDecorator to the
+   * wrapped component.
+   *
+   * @type {String}
+   * @default 'selected'
+   * @memberof limestone/ContextualMenuDecorator.ContextualMenuDecorator.defaultConfig
+   * @public
+   */
+  openProp: 'selected'
+};
+var ScrollingRepeater = function ScrollingRepeater(_ref) {
+  var className = _ref.className,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Scroller["default"], {
+    className: className,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Repeater["default"], _objectSpread({}, rest))
+  });
+};
+var ContextualMenuDecoratorBase = (0, _hoc["default"])(defaultConfig, function (config, Wrapped) {
+  // we might not need Skinnable at all here. If we want to skin the popup, and it's defined as a
+  // private component in this module, we can wrap it with skinnable and style it as needed there.
+  var Component = (0, _Skinnable["default"])((0, _ContextualPopupDecorator["default"])(_objectSpread(_objectSpread({}, config), {}, {
+    noArrow: true
+  }), Wrapped));
+  return (0, _kind["default"])({
+    name: 'ContextualMenuDecorator',
+    propTypes: /** @lends limestone/ContextualMenuDecorator.ContextualMenuDecorator.prototype */{
+      /**
+       * Direction of popup with respect to the wrapped component.
+       *
+       * @type {('above'|'above center'|'above left'|'above right'|'below'|'below center'|'below left'|'below right'|'left middle'|'left top'|'left bottom'|'right middle'|'right top'|'right bottom')}
+       * @default 'below right'
+       * @public
+       */
+      direction: _propTypes["default"].oneOf(['above', 'above center', 'above left', 'above right', 'below', 'below center', 'below left', 'below right', 'left middle', 'left top', 'left bottom', 'right middle', 'right top', 'right bottom']),
+      /**
+       * The items to be displayed in the `ContextualMenuDecorator` when `open`.
+       *
+       * Takes either an array of strings or an array of objects. When strings, the values will be
+       * used in the generated components as the readable text. When objects, the properties will
+       * be passed onto an `Item` component and `children` as well as a unique `key` property are
+       * required.
+       *
+       * @type {String[]|Array.<{key: (Number|String), children: (String|Component)}>}
+       * @public
+       */
+      menuItems: _propTypes["default"].oneOfType([_propTypes["default"].arrayOf(_propTypes["default"].string), _propTypes["default"].arrayOf(_propTypes["default"].shape({
+        children: _propTypes["default"].string.isRequired,
+        key: _propTypes["default"].oneOfType([_propTypes["default"].string, _propTypes["default"].number]).isRequired
+      }))]),
+      /**
+       * Offset from the activator to apply to the position of the popup.
+       *
+       * @type {('none'|'overlap'|'small'|'large')}
+       * @default 'overlap'
+       * @public
+       */
+      offset: _propTypes["default"].oneOf(['none', 'overlap', 'small', 'large']),
+      /**
+       * Called when the user has attempted to close the popup.
+       *
+       * This may occur either when the close button is clicked or when spotlight focus
+       * moves outside the boundary of the popup. Setting `spotlightRestrict` to `'self-only'`
+       * will prevent Spotlight focus from leaving the popup.
+       *
+       * @type {Function}
+       * @public
+       */
+      onClose: _propTypes["default"].func,
+      /**
+       * Called when the popup is opened.
+       *
+       * @type {Function}
+       * @public
+       */
+      onOpen: _propTypes["default"].func,
+      /**
+       * CSS class name to pass to the
+       * {@link limestone/ContextualPopupDecorator.ContextualPopup|ContextualPopup}.
+       *
+       * This is commonly used to set width and height of the popup.
+       *
+       * @type {String}
+       * @public
+       */
+      popupClassName: _propTypes["default"].string,
+      /**
+       * An object containing properties to be passed to popup component.
+       *
+       * @type {Object}
+       * @public
+       */
+      popupProps: _propTypes["default"].object,
+      /**
+       * Width of the Popup component.
+       *
+       * When `'auto'` the popup will match the activator's width when `direction` is
+       * `'below'` or `'above'` or a width specified in `popupClassName`.
+       *
+       * @type {('auto'|'large'|'small')}
+       * @default 'auto'
+       * @private
+       */
+      popupWidth: _propTypes["default"].oneOf(['auto', 'large', 'small']),
+      /**
+       * Set the type of scrim to use
+       *
+       * @type {('holepunch'|'translucent'|'transparent'|'none')}
+       * @default 'holepunch'
+       * @private
+       */
+      scrimType: _propTypes["default"].oneOf(['holepunch', 'translucent', 'transparent', 'none']),
+      /**
+       * Restricts or prioritizes spotlight navigation.
+       *
+       * Allowed values are:
+       * * `'none'` - Spotlight can move freely within and beyond the popup
+       * * `'self-first'` - Spotlight should prefer components within the popup over
+       *   components beyond the popup, or
+       * * `'self-only'` - Spotlight can only be set within the popup
+       *
+       * @type {('none'|'self-first'|'self-only')}
+       * @default 'self-only'
+       * @public
+       */
+      spotlightRestrict: _propTypes["default"].oneOf(['none', 'self-first', 'self-only'])
+    },
+    defaultProps: {
+      direction: 'below right',
+      offset: 'overlap',
+      popupWidth: 'auto',
+      scrimType: 'holepunch',
+      spotlightRestrict: 'self-only'
+    },
+    handlers: {
+      onOpen: (0, _handle.handle)((0, _handle.forward)('onClick'), (0, _handle.forProp)('open', false), (0, _handle.forward)('onOpen'))
+    },
+    styles: {
+      css: _ContextualMenuDecoratorModule["default"]
+    },
+    computed: {
+      // expect we'll be able to drop this when we add the private popupComponent
+      // implementation with the Repeater for the items since the popup class could be set
+      // on the component by itself
+      popupClassName: function popupClassName(_ref2) {
+        var menuItems = _ref2.menuItems,
+          popupWidth = _ref2.popupWidth,
+          _popupClassName = _ref2.popupClassName,
+          styler = _ref2.styler;
+        var sizeClass = popupWidth !== 'auto' && popupWidth;
+        var verticalScrollbar = menuItems.length > MAX_VISIBLE_MENU_ITEMS;
+        return styler.join('popup', 'container', _popupClassName, sizeClass, verticalScrollbar ? 'verticalScrollbar' : null);
+      },
+      popupComponent: function popupComponent(_ref3) {
+        var menuItems = _ref3.menuItems;
+        return menuItems && menuItems.length > MAX_VISIBLE_MENU_ITEMS ? ScrollingRepeater : _Repeater["default"];
+      },
+      popupProps: function popupProps(_ref4) {
+        var menuItems = _ref4.menuItems,
+          _popupProps = _ref4.popupProps;
+        return _objectSpread({
+          'aria-live': null,
+          children: menuItems,
+          childComponent: _Item["default"],
+          className: _ContextualMenuDecoratorModule["default"].innerContainer,
+          itemProps: {
+            className: _ContextualMenuDecoratorModule["default"].item,
+            size: 'small'
+          },
+          component: 'div',
+          role: null
+        }, _popupProps);
+      }
+    },
+    render: function render(_ref5) {
+      var onOpen = _ref5.onOpen,
+        popupProps = _ref5.popupProps,
+        rest = _objectWithoutProperties(_ref5, _excluded2);
+      delete rest.menuItems;
+      delete rest.onOpen;
+      delete rest.popupWidth;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(Component, _objectSpread(_objectSpread({}, rest), {}, {
+        onClick: onOpen,
+        popupProps: popupProps
+      }));
+    }
+  });
+});
+
+/**
+ * Wraps a component to display a contextual popup menu.
+ *
+ * @hoc
+ * @memberof limestone/ContextualMenuDecorator
+ * @mixes ui/Toggleable.Toggleable
+ * @mixes limestone/Skinnable.Skinnable
+ * @mixes limestone/ContextualPopupDecorator.ContextualPopupDecorator
+ * @public
+ */
+var ContextualMenuDecorator = exports.ContextualMenuDecorator = (0, _compose["default"])((0, _Toggleable["default"])({
+  activate: 'onOpen',
+  deactivate: 'onClose',
+  prop: 'open',
+  toggle: null
+}), ContextualMenuDecoratorBase);
+var _default = exports["default"] = ContextualMenuDecorator;

package/ContextualMenuDecorator/ContextualMenuDecorator.module.css

@@ -0,0 +1,42 @@
+/*
+// our convention is to use camelCase class name on the root node of the component. however, we do
+// not have a way to set that class on ContextualPopupDecorator's root so we can't use it right now
+// but keeping it around as a future note.
+.contextualMenu {
+	.applySkins({
+		&.popup {
+			// add theme styles
+		}
+	});
+}
+*/
+.popup {
+  max-height: 14.625rem;
+  overflow: hidden;
+  /*
+	// in order to override the default ContextualPopupDecorator's container padding style, we
+	// need to use an arbitrary additional CSS rule for precedence
+	*/
+}
+.popup.container {
+  min-width: 12.75rem;
+  padding: var(--primitive-spacing-36) 0;
+}
+.popup.container .innerContainer {
+  max-height: 13.125rem;
+}
+.popup.container.small {
+  width: 12.75rem;
+}
+.popup.container.large {
+  width: 20rem;
+}
+.popup.container .item {
+  margin-bottom: 0;
+}
+.popup.verticalScrollbar {
+  min-width: 13.25rem;
+}
+.popup.verticalScrollbar.large {
+  width: 20.5rem;
+}

package/ContextualMenuDecorator/package.json

@@ -0,0 +1,3 @@
+{
+	"main": "ContextualMenuDecorator.js"
+}

package/ContextualMenuDecorator/tests/ContextualMenuDecorator-specs.js

@@ -0,0 +1,136 @@
+"use strict";
+
+var _FloatingLayer = require("@enact/ui/FloatingLayer");
+require("@testing-library/jest-dom");
+var _react = require("@testing-library/react");
+var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
+var _ContextualMenuDecorator = require("../ContextualMenuDecorator");
+var _Button = _interopRequireDefault(require("../../Button"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+var ContextualButton = (0, _ContextualMenuDecorator.ContextualMenuDecorator)(_Button["default"]);
+var Root = (0, _FloatingLayer.FloatingLayerDecorator)('div');
+var items = new Array(3).fill().map(function (i, index) {
+  return "Option ".concat(index + 1);
+});
+describe('ContextualMenuDecorator Specs', function () {
+  test('should render component into FloatingLayer if open', function () {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var contextualMenu = _react.screen.getByRole('list');
+    var expected = 'Option 1';
+    var actual = contextualMenu.children.item(0);
+    expect(actual).toHaveTextContent(expected);
+  });
+  test('should not render into FloatingLayer if not open', function () {
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        children: "Hello"
+      })
+    }));
+    var menu = _react.screen.queryByText('Option 1');
+    expect(menu).toBeNull();
+  });
+  test('should emit onClose event when clicking outside the contextual menu', /*#__PURE__*/_asyncToGenerator(function* () {
+    var handleClose = jest.fn();
+    var user = _userEvent["default"].setup();
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      "data-testid": "contextualMenu",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        onClose: handleClose,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var floatingLayerScrim = _react.screen.getByTestId('contextualMenu').nextElementSibling.querySelector('.scrim');
+    yield user.click(floatingLayerScrim);
+    expect(handleClose).toHaveBeenCalled();
+  }));
+  test('should not close menu when clicking outside if noAutoDismiss is true', /*#__PURE__*/_asyncToGenerator(function* () {
+    var handleClose = jest.fn();
+    var user = _userEvent["default"].setup();
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      "data-testid": "contextualMenu",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        noAutoDismiss: true,
+        onClose: handleClose,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var floatingLayerScrim = _react.screen.getByTestId('contextualMenu').nextElementSibling.querySelector('.scrim');
+    yield user.click(floatingLayerScrim);
+    expect(handleClose).not.toHaveBeenCalled();
+  }));
+  test('should have \'below right\' className when direction is set to \'below right\'', function () {
+    var handleClose = jest.fn();
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        direction: "below right",
+        menuItems: items,
+        onClose: handleClose,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var contextualMenu = _react.screen.getByRole('list');
+    var expected = 'below right';
+    var actual = contextualMenu.parentElement;
+    expect(actual).toHaveClass(expected);
+  });
+  test('should have offset \'none\' when offset is set to \'none\'', function () {
+    var handleClose = jest.fn();
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        offset: "none",
+        onClose: handleClose,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var contextualMenu = _react.screen.getByRole('list').parentElement.parentElement;
+    var expected = 'none';
+    expect(contextualMenu).toHaveAttribute('offset', expected);
+  });
+  test('should have \'large\' className when popupWidth is set to \'large\'', function () {
+    var handleClose = jest.fn();
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: items,
+        onClose: handleClose,
+        open: true,
+        popupWidth: "large",
+        children: "Hello"
+      })
+    }));
+    var contextualMenu = _react.screen.getByRole('list').parentElement;
+    var expected = 'large';
+    expect(contextualMenu).toHaveClass(expected);
+  });
+  test('should wrap content in Scroller component if menuItem length exceeds MAX_VISIBLE_MENU_ITEMS', function () {
+    var moreItems = new Array(8).fill().map(function (i, index) {
+      return "Option ".concat(index + 1);
+    });
+    (0, _react.render)(/*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualButton, {
+        menuItems: moreItems,
+        open: true,
+        children: "Hello"
+      })
+    }));
+    var scroller = _react.screen.getByRole('list').parentElement;
+    var expected = 'scroller';
+    expect(scroller).toHaveClass(expected);
+  });
+});

package/ContextualPopupDecorator/ContextualPopup.js

@@ -0,0 +1,200 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.ContextualPopupBase = exports.ContextualPopup = void 0;
+var _propTypes = _interopRequireDefault(require("@enact/core/internal/prop-types"));
+var _kind = _interopRequireDefault(require("@enact/core/kind"));
+var _propTypes2 = _interopRequireDefault(require("prop-types"));
+var _Skinnable = _interopRequireDefault(require("../Skinnable"));
+var _ContextualPopupModule = _interopRequireDefault(require("./ContextualPopup.module.css"));
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["arrowDirection", "arrowPosition", "className", "containerPosition", "containerRef", "children", "showArrow"];
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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 _readOnlyError(r) { throw new TypeError('"' + r + '" is read-only'); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+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 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); } /**
+ * An SVG arrow for {@link limestone/ContextualPopupDecorator/ContextualPopup.ContextualPopup}.
+ *
+ * @class ContextualPopupArrow
+ * @memberof limestone/ContextualPopupDecorator
+ * @ui
+ * @private
+ */
+var ContextualPopupArrow = (0, _kind["default"])({
+  name: 'ContextualPopupArrow',
+  propTypes: /** @lends limestone/ContextualPopupDecorator.ContextualPopupArrow.prototype */{
+    direction: _propTypes2["default"].oneOf(['above', 'below', 'left', 'right'])
+  },
+  defaultProps: {
+    direction: 'below'
+  },
+  styles: {
+    css: _ContextualPopupModule["default"],
+    className: 'arrow'
+  },
+  computed: {
+    className: function className(_ref) {
+      var direction = _ref.direction,
+        styler = _ref.styler;
+      return styler.append(direction, _ContextualPopupModule["default"].arrow);
+    }
+  },
+  render: function render(props) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)("svg", _objectSpread(_objectSpread({}, props), {}, {
+      viewBox: "0 0 30 30",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
+        d: "M0 20 L15 2 L30 20",
+        className: _ContextualPopupModule["default"].arrowFill
+      })
+    }));
+  }
+});
+var ContextualPopupRoot = (0, _Skinnable["default"])('div');
+
+/**
+ * A popup component used by
+ * {@link limestone/ContextualPopupDecorator.ContextualPopupDecorator|ContextualPopupDecorator} to
+ * wrap its {@link limestone/ContextualPopupDecorator.ContextualPopupDecorator.popupComponent|popupComponent}.
+ *
+ * `ContextualPopup` is usually not used directly but is made available for unique application use
+ * cases.
+ *
+ * @class ContextualPopup
+ * @memberof limestone/ContextualPopupDecorator
+ * @ui
+ * @public
+ */
+var ContextualPopupBase = exports.ContextualPopupBase = exports.ContextualPopup = (0, _kind["default"])({
+  name: 'ContextualPopup',
+  propTypes: /** @lends limestone/ContextualPopupDecorator.ContextualPopup.prototype */{
+    /**
+     * The contents of the popup.
+     *
+     * @type {Node}
+     * @required
+     * @public
+     */
+    children: _propTypes2["default"].node.isRequired,
+    /**
+     * Style object for arrow position.
+     *
+     * @type {Object}
+     * @public
+     */
+    arrowPosition: _propTypes2["default"].shape({
+      bottom: _propTypes2["default"].number,
+      left: _propTypes2["default"].number,
+      right: _propTypes2["default"].number,
+      top: _propTypes2["default"].number
+    }),
+    /**
+     * Style object for container position.
+     *
+     * @type {Object}
+     * @public
+     */
+    containerPosition: _propTypes2["default"].shape({
+      bottom: _propTypes2["default"].number,
+      left: _propTypes2["default"].number,
+      right: _propTypes2["default"].number,
+      top: _propTypes2["default"].number,
+      width: _propTypes2["default"].number
+    }),
+    /**
+     * Called with the reference to the container node.
+     *
+     * @type {Object|Function}
+     * @public
+     */
+    containerRef: _propTypes["default"].ref,
+    /**
+     * Direction of ContextualPopup.
+     *
+     * @type {('above'|'above center'|'above left'|'above right'|'below'|'below center'|'below left'|'below right'|'left middle'|'left top'|'left bottom'|'right middle'|'right top'|'right bottom')}
+     * @default 'below'
+     * @public
+     */
+    direction: _propTypes2["default"].oneOf(['above', 'above center', 'above left', 'above right', 'below', 'below center', 'below left', 'below right', 'left middle', 'left top', 'left bottom', 'right middle', 'right top', 'right bottom']),
+    /**
+     * Offset from the activator to apply to the position of the popup.
+     *
+     * @type {('none'|'overlap'|'small'|'large')}
+     * @default 'small'
+     * @public
+     */
+    offset: _propTypes2["default"].oneOf(['none', 'overlap', 'small', 'large']),
+    /**
+     * Shows the arrow.
+     *
+     * @type {Boolean}
+     * @default false
+     * @public
+     */
+    showArrow: _propTypes2["default"].bool
+  },
+  defaultProps: {
+    direction: 'below center',
+    offset: 'small'
+  },
+  styles: {
+    css: _ContextualPopupModule["default"],
+    className: 'container'
+  },
+  computed: {
+    arrowDirection: function arrowDirection(_ref2) {
+      var direction = _ref2.direction;
+      var _direction$split = direction.split(' '),
+        _direction$split2 = _slicedToArray(_direction$split, 1),
+        arrowDirection = _direction$split2[0];
+      return arrowDirection;
+    },
+    className: function className(_ref3) {
+      var direction = _ref3.direction,
+        offset = _ref3.offset,
+        styler = _ref3.styler;
+      return styler.append({
+        fixedSize: direction === 'above' || direction === 'below'
+      }, direction.split(' '), offset, _ContextualPopupModule["default"].outline);
+    }
+  },
+  render: function render(_ref4) {
+    var arrowDirection = _ref4.arrowDirection,
+      arrowPosition = _ref4.arrowPosition,
+      className = _ref4.className,
+      containerPosition = _ref4.containerPosition,
+      containerRef = _ref4.containerRef,
+      children = _ref4.children,
+      showArrow = _ref4.showArrow,
+      rest = _objectWithoutProperties(_ref4, _excluded);
+    delete rest.direction;
+    return /*#__PURE__*/(0, _jsxRuntime.jsxs)(ContextualPopupRoot, _objectSpread(_objectSpread({
+      "aria-live": "off",
+      role: "alert"
+    }, rest), {}, {
+      className: _ContextualPopupModule["default"].contextualPopup,
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+        className: className,
+        style: containerPosition,
+        ref: containerRef,
+        children: children
+      }), showArrow ? /*#__PURE__*/(0, _jsxRuntime.jsx)(ContextualPopupArrow, {
+        direction: arrowDirection,
+        style: arrowPosition
+      }) : null]
+    }));
+  }
+});
+var _default = exports["default"] = ContextualPopupBase;