@pingux/astro 2.9.1 → 2.13.0-alpha.10

package/lib/cjs/components/HelpHint/HelpHint.mdx

@@ -0,0 +1,32 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Components/HelpHint/HelpHint" />
+
+# HelpHint
+
+HelpHints display information intended to help users enter, select or provide the appropriate information in a field. This component can be customized, and consists of the [TooltipTrigger](./?path=/docs/components-tooltiptrigger--default) and [IconButton](./?path=/docs/components-iconbutton--default).
+
+When implementing this component, use short, clear language and a text size relative to the trigger button. They should not block important information when the popover displays, nor should it be used to communicate important information.
+
+### Required Components
+
+This component can be used independently and does not require additional components.
+
+### Accessibility
+This component adheres to [WAI-ARIA Button](https://www.w3.org/TR/wai-aria-practices-1.1/examples/button/button.html) accessibility guidelines.
+
+#### Keyboard Navigation
+
+These keys provide additional functionality to the component. 
+
+| Aria Attribute | Role |
+| ---- | ---- |
+| Space or Enter | Selects the help hint. |
+| Tab | Focuses the help hint and follows the page tab sequence. |
+
+#### Screen Readers
+
+This component uses the following attributes to assist screen readers:
+- The trigger button uses **`aria-expanded`** to indicate the expansion and collapse of the popover.
+- The **`aria-live`** attribute announces the dynamic changes in live region content.
+

package/lib/cjs/components/HelpHint/HelpHint.stories.js

@@ -5,11 +5,13 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = exports.WithTooltipAndIconButtonProps = exports.Default = void 0;
+exports["default"] = exports.WithPopoverAndIconButtonProps = exports.WithDelay = exports.Default = exports.ContentWithLink = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _react = _interopRequireDefault(require("react"));
 var _storybookAddonDesigns = require("storybook-addon-designs");
 var _storybookDocsLayout = _interopRequireDefault(require("../../../.storybook/storybookDocsLayout"));
 var _index = require("../../index");
+var _safariAgent = require("../../styles/safariAgent");
 var _figmaLinks = require("../../utils/designUtils/figmaLinks.js");
 var _HelpHint = _interopRequireDefault(require("./HelpHint.mdx"));
 var _react2 = require("@emotion/react");
@@ -26,14 +28,14 @@ var _default = {
   },
   argTypes: {
     children: {
-      description: 'Tooltip content',
+      description: 'Popover content',
       control: {
         type: 'text'
       }
     }
   },
   args: {
-    children: 'Text of the tooltip right here...'
+    children: 'Text of the popover right here...'
   }
 };
 exports["default"] = _default;
@@ -49,16 +51,47 @@ Default.parameters = {
     url: _figmaLinks.FIGMA_LINKS.helpHint["default"]
   }
 };
-var WithTooltipAndIconButtonProps = function WithTooltipAndIconButtonProps() {
+var WithPopoverAndIconButtonProps = function WithPopoverAndIconButtonProps() {
   return (0, _react2.jsx)(_index.Box, {
     p: 50
   }, (0, _react2.jsx)(_index.HelpHint, {
-    tooltipProps: {
+    popoverProps: {
       direction: 'bottom'
     },
     iconButtonProps: {
       'aria-label': 'Help hint'
     }
-  }, "Text of the tooltip right here..."));
+  }, "Text of the popover right here..."));
 };
-exports.WithTooltipAndIconButtonProps = WithTooltipAndIconButtonProps;
+exports.WithPopoverAndIconButtonProps = WithPopoverAndIconButtonProps;
+var ContentWithLink = function ContentWithLink() {
+  return (0, _react2.jsx)(_index.Box, {
+    p: 70
+  }, (0, _react2.jsx)(_index.HelpHint, null, (0, _react2.jsx)(_index.Text, {
+    variant: "popover"
+  }, "Text of the popover right here... "), _safariAgent.isSafari ? (0, _react2.jsx)(_index.Box, {
+    href: "https://uilibrary.ping-eng.com/",
+    as: "a",
+    pl: "xs"
+  }, (0, _react2.jsx)(_index.Link, {
+    variant: "popover"
+  }, "Learn More")) : (0, _react2.jsx)(_index.Link, {
+    variant: "popover",
+    href: "https://uilibrary.ping-eng.com/"
+  }, "Learn More")));
+};
+exports.ContentWithLink = ContentWithLink;
+ContentWithLink.parameters = {
+  design: {
+    type: 'figma',
+    url: _figmaLinks.FIGMA_LINKS.helpHint.withLink
+  }
+};
+var WithDelay = function WithDelay(args) {
+  return (0, _react2.jsx)(_index.Box, {
+    p: 50
+  }, (0, _react2.jsx)(_index.HelpHint, (0, _extends2["default"])({}, args, {
+    closeDelay: 5000
+  })));
+};
+exports.WithDelay = WithDelay;

package/lib/cjs/components/HelpHint/HelpHint.styles.js

@@ -15,6 +15,7 @@ _Object$defineProperty(exports, "__esModule", {
 exports.hintButton = exports["default"] = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
 var _Buttons = require("../Button/Buttons.styles");
+var _TooltipStyles = require("../TooltipTrigger/Tooltip.styles.js");
 function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context, _context2; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(source), !0)).call(_context, function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context2 = ownKeys(Object(source))).call(_context2, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
 var hintButton = {
@@ -53,7 +54,14 @@ var hintButton = {
   }
 };
 exports.hintButton = hintButton;
+var popoverContainer = _objectSpread(_objectSpread({}, _TooltipStyles.container), {}, {
+  p: '10px',
+  fontSize: 'sm',
+  fontWeight: 1,
+  width: '117px'
+});
 var _default = {
-  hintButton: hintButton
+  hintButton: hintButton,
+  popoverContainer: popoverContainer
 };
 exports["default"] = _default;

package/lib/cjs/components/HelpHint/HelpHint.test.js

@@ -1,21 +1,39 @@
 "use strict";
 
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Symbol = require("@babel/runtime-corejs3/core-js-stable/symbol");
+var _Object$create = require("@babel/runtime-corejs3/core-js-stable/object/create");
+var _Object$getPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/get-prototype-of");
+var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
+var _Object$setPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/set-prototype-of");
+var _Promise = require("@babel/runtime-corejs3/core-js-stable/promise");
+var _reverseInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/reverse");
+var _sliceInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/slice");
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/asyncToGenerator"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _react = _interopRequireDefault(require("react"));
 var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
+var _index = require("../../index");
 var _testAxe = _interopRequireDefault(require("../../utils/testUtils/testAxe"));
 var _testWrapper = require("../../utils/testUtils/testWrapper");
-var _HelpHint = _interopRequireDefault(require("./HelpHint"));
 var _react2 = require("@emotion/react");
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = _Object$defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof _Symbol ? _Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return _Object$defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = _Object$create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = _Object$getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = _Object$create(IteratorPrototype); function defineIteratorMethods(prototype) { var _context8; _forEachInstanceProperty(_context8 = ["next", "throw", "return"]).call(_context8, function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], _forEachInstanceProperty(tryLocsList).call(tryLocsList, pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return _Object$setPrototypeOf ? _Object$setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = _Object$create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = _Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) { keys.push(key); } return _reverseInstanceProperty(keys).call(keys), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { var _context9; if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, _forEachInstanceProperty(_context9 = this.tryEntries).call(_context9, resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+_sliceInstanceProperty(name).call(name, 1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, "catch": function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
 var testId = 'help-hint__button';
-var tooltipValue = 'Some text';
+var popoverValue = 'Some text';
 var defaultProps = {
-  children: tooltipValue
+  children: popoverValue
 };
 var getComponent = function getComponent() {
   var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  return (0, _testWrapper.render)((0, _react2.jsx)(_HelpHint["default"], (0, _extends2["default"])({}, defaultProps, props)));
+  return (0, _testWrapper.render)((0, _react2.jsx)(_index.HelpHint, (0, _extends2["default"])({}, defaultProps, props)));
+};
+var getComponentWithLink = function getComponentWithLink() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return (0, _testWrapper.render)((0, _react2.jsx)(_index.HelpHint, (0, _extends2["default"])({}, defaultProps, props), (0, _react2.jsx)(_index.Link, {
+    href: "https://uilibrary.ping-eng.com/"
+  }, "Learn More")));
 };
 
 // Need to be added to each test file to test accessibility using axe.
@@ -25,35 +43,124 @@ test('renders HelpHint component', function () {
   var helpHintButton = _testWrapper.screen.getByTestId(testId);
   expect(helpHintButton).toBeInTheDocument();
 });
-test('shows tooltip on hover', function () {
-  getComponent();
-  var helpHintButton = _testWrapper.screen.getByTestId(testId);
-  expect(_testWrapper.screen.queryByText(tooltipValue)).not.toBeInTheDocument();
-  _testWrapper.fireEvent.mouseMove(helpHintButton);
-  _testWrapper.fireEvent.mouseEnter(helpHintButton);
-  var tooltip = _testWrapper.screen.getByRole('tooltip');
-  var tooltipId = tooltip.getAttribute('id');
-  expect(tooltip).toBeInTheDocument();
-  expect(helpHintButton).toHaveAttribute('aria-describedby', tooltipId);
-});
-test('shows tooltip on focus', function () {
-  getComponent();
-  var helpHintButton = _testWrapper.screen.getByTestId(testId);
-  expect(_testWrapper.screen.queryByText(tooltipValue)).not.toBeInTheDocument();
-  _userEvent["default"].tab();
-  expect(helpHintButton).toHaveFocus();
-  var tooltip = _testWrapper.screen.getByRole('tooltip');
-  var tooltipId = tooltip.getAttribute('id');
-  expect(tooltip).toBeInTheDocument();
-  expect(helpHintButton).toHaveAttribute('aria-describedby', tooltipId);
-});
-test('applies tooltipProps', function () {
+test('shows popover when trigger is hovered', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+  var helpHintButton, popover;
+  return _regeneratorRuntime().wrap(function _callee$(_context) {
+    while (1) {
+      switch (_context.prev = _context.next) {
+        case 0:
+          getComponent();
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          expect(_testWrapper.screen.queryByText(popoverValue)).not.toBeInTheDocument();
+          _testWrapper.fireEvent.mouseMove(helpHintButton);
+          _testWrapper.fireEvent.mouseEnter(helpHintButton);
+          popover = _testWrapper.screen.getByRole('presentation');
+          expect(popover).toBeInTheDocument();
+        case 7:
+        case "end":
+          return _context.stop();
+      }
+    }
+  }, _callee);
+})));
+test('keeps the popover open if the popover is hovered', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+  var helpHintButton, popover;
+  return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+    while (1) {
+      switch (_context2.prev = _context2.next) {
+        case 0:
+          getComponent();
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          expect(_testWrapper.screen.queryByText(popoverValue)).not.toBeInTheDocument();
+          _testWrapper.fireEvent.mouseMove(helpHintButton);
+          _testWrapper.fireEvent.mouseEnter(helpHintButton);
+          popover = _testWrapper.screen.getByRole('presentation');
+          _testWrapper.fireEvent.mouseMove(popover);
+          _testWrapper.fireEvent.mouseEnter(popover);
+          expect(popover).toBeInTheDocument();
+          _context2.next = 11;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).toBeInTheDocument();
+          }, {
+            timeout: 2000
+          });
+        case 11:
+        case "end":
+          return _context2.stop();
+      }
+    }
+  }, _callee2);
+})));
+test('popover without focusable children should open onPress and disappear in 1000ms', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+  var helpHintButton;
+  return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+    while (1) {
+      switch (_context3.prev = _context3.next) {
+        case 0:
+          getComponent();
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          _userEvent["default"].tab();
+          expect(helpHintButton).toHaveFocus();
+          _userEvent["default"].type(helpHintButton, '{enter}', {
+            skipClick: true
+          });
+          _context3.next = 7;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).toBeInTheDocument();
+          }, {
+            timeout: 500
+          });
+        case 7:
+          _context3.next = 9;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).not.toBeInTheDocument();
+          }, {
+            timeout: 1100
+          });
+        case 9:
+        case "end":
+          return _context3.stop();
+      }
+    }
+  }, _callee3);
+})));
+test('popover with focusable children should open onPress and focus the first focusable child', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+  var helpHintButton, link;
+  return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+    while (1) {
+      switch (_context4.prev = _context4.next) {
+        case 0:
+          getComponentWithLink();
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          _userEvent["default"].tab();
+          expect(helpHintButton).toHaveFocus();
+          _userEvent["default"].type(helpHintButton, '{enter}', {
+            skipClick: true
+          });
+          _context4.next = 7;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).toBeInTheDocument();
+          }, {
+            timeout: 3000
+          });
+        case 7:
+          link = _testWrapper.screen.queryByRole('link');
+          expect(link).toBeInTheDocument();
+          expect(link).toHaveFocus();
+        case 10:
+        case "end":
+          return _context4.stop();
+      }
+    }
+  }, _callee4);
+})));
+test('applies popoverProps', function () {
   getComponent({
-    tooltipProps: {
+    popoverProps: {
       isOpen: true
     }
   });
-  expect(_testWrapper.screen.getByText(tooltipValue)).toBeInTheDocument();
+  expect(_testWrapper.screen.getByText(popoverValue)).toBeInTheDocument();
 });
 test('applies iconButtonProps', function () {
   var newLabel = 'New label';
@@ -63,4 +170,80 @@ test('applies iconButtonProps', function () {
     }
   });
   expect(_testWrapper.screen.getByLabelText(newLabel)).toBeInTheDocument();
-});
+});
+test('popover stays open until closeDelay after mouse leaves trigger', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
+  var closeDelay, helpHintButton;
+  return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+    while (1) {
+      switch (_context5.prev = _context5.next) {
+        case 0:
+          closeDelay = 10;
+          getComponent({
+            closeDelay: closeDelay
+          });
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          _testWrapper.fireEvent.mouseEnter(helpHintButton);
+          _testWrapper.fireEvent.mouseLeave(helpHintButton);
+          _context5.next = 7;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).toBeInTheDocument();
+          }, {
+            timeout: closeDelay - 1
+          });
+        case 7:
+        case "end":
+          return _context5.stop();
+      }
+    }
+  }, _callee5);
+})));
+test('popover closes after closeDelay when mouse leaves trigger', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
+  var closeDelay, helpHintButton;
+  return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+    while (1) {
+      switch (_context6.prev = _context6.next) {
+        case 0:
+          closeDelay = 10;
+          getComponent({
+            closeDelay: closeDelay
+          });
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          _testWrapper.fireEvent.mouseEnter(helpHintButton);
+          _testWrapper.fireEvent.mouseLeave(helpHintButton);
+          _context6.next = 7;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).not.toBeInTheDocument();
+          }, {
+            timeout: closeDelay + 1
+          });
+        case 7:
+        case "end":
+          return _context6.stop();
+      }
+    }
+  }, _callee6);
+})));
+test('popover automatically closes in 1000ms after mouse leaves trigger', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+  var oneSecond, helpHintButton;
+  return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+    while (1) {
+      switch (_context7.prev = _context7.next) {
+        case 0:
+          oneSecond = 1000;
+          getComponent();
+          helpHintButton = _testWrapper.screen.getByTestId(testId);
+          _testWrapper.fireEvent.mouseEnter(helpHintButton);
+          _testWrapper.fireEvent.mouseLeave(helpHintButton);
+          _context7.next = 7;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('presentation')).not.toBeInTheDocument();
+          }, {
+            timeout: oneSecond + 1
+          });
+        case 7:
+        case "end":
+          return _context7.stop();
+      }
+    }
+  }, _callee7);
+})));

package/lib/cjs/components/Icon/Icon.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { IconProps } from '../../types';
+declare const Icon: React.ForwardRefExoticComponent<IconProps & React.RefAttributes<HTMLElement>>;
+export default Icon;

package/lib/cjs/components/Icon/Icon.js

@@ -1,6 +1,6 @@
 "use strict";
 
-var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _typeof3 = require("@babel/runtime-corejs3/helpers/typeof");
 var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
 var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols");
 var _filterInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/filter");
@@ -17,13 +17,13 @@ _Object$defineProperty(exports, "__esModule", {
 exports["default"] = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/typeof"));
 var _react = _interopRequireWildcard(require("react"));
-var _propTypes = _interopRequireDefault(require("prop-types"));
 var _hooks = require("../../hooks");
 var _Box = _interopRequireDefault(require("../Box"));
 var _react2 = require("@emotion/react");
 function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof3(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context, _context2; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(source), !0)).call(_context, function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context2 = ownKeys(Object(source))).call(_context2, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
 var Icon = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
@@ -32,7 +32,7 @@ var Icon = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
     sx = props.sx;
   var _useTShirtSize = (0, _hooks.useTShirtSize)(props),
     sizeProps = _useTShirtSize.sizeProps;
-  var title = props.title || (IconComponent.type ? {
+  var title = props.title || ((0, _typeof2["default"])(IconComponent) === 'object' && 'type' in IconComponent ? {
     name: IconComponent.type.name
   } : null);
   return (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
@@ -48,29 +48,6 @@ var Icon = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
     }, sx)
   }));
 });
-Icon.propTypes = {
-  /** The icon to render. */
-  icon: _propTypes["default"].elementType.isRequired,
-  /**
-   * The size of the icon container. If given a number value, it will be converted to pixels.
-   * Tshirt sizing is recommended and can be passed to the size prop as 'xs', 'sm' , 'md'
-   * rendering 15, 20, and 25 pixel svg containers.  */
-  size: _propTypes["default"].oneOfType([_propTypes["default"].number, _propTypes["default"].string]),
-  /** A theme-aware prop to set the icon's color. */
-  color: _propTypes["default"].string,
-  /**
-   * The title associated with the icon. It is recommended that icons always have an associated
-   * title in order to allow a better user experience for those using screen readers.
-   * The **`id`** in the title object will be the id of the title and
-   * is also what will be supplied to the **`aria-labelledby`** attribute in the SVG.
-   * The **`name`** in the title object will be the content of the title.
-   * This prop can only be used when importing the icon from [@pingux/mdi-react](https://www.npmjs.com/package/@pingux/mdi-react).
-   * */
-  title: _propTypes["default"].shape({
-    id: _propTypes["default"].string,
-    name: _propTypes["default"].string
-  })
-};
 Icon.defaultProps = {
   size: 20
 };

package/lib/cjs/components/Icon/Icon.mdx

@@ -0,0 +1,49 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Components/Icon/Icon" />
+
+# Icon
+
+Icons are small images that represent concepts or capabilities that often provide information or lead users to other pages within the application. 
+
+Icon should be:
+- Centrally aligned when used in a group with an appropriate amount of space between them.
+- Paired with text or a tooltip when its intention is not immediately evident. 
+- Relatively sized when used with text.
+
+Icon shouldn’t:
+- Include letters in the icon design.
+- Be randomly scaled to fit the layout.
+
+Regarding sizing, this component uses the **1em x 1em** container by default and maintains the aspect ratios. You can:
+
+- Use SVGR to import SVG files as React components and then pass them into icon components. 
+- Use the theme to color the icon.
+  
+  **Note**: Ensure that the dimensions in Webpack configuration file are set to false, or the icon cannot be resized using the size property. 
+  See [SVGR docs](https://react-svgr.com/docs/options/#dimensions) for more information. 
+- Import icons from the [Material UI Icon Library](https://materialdesignicons.com/)
+
+It is built on top of the [Box from Theme-UI](https://theme-ui.com/components/box/) and uses the available [props from Theme-UI](https://theme-ui.com/sx-prop).
+
+### Required Components
+
+This component can be used independently and does not require additional components.
+
+### Accessibility
+
+#### Labelling
+
+The Icon component accepts the title prop:
+`title={{ id: 'unique id', name: 'short description of the icon'}}`.
+The `name` will be passed inside `<title>` element of the SVG.
+The `id` is optional. If not specified, it will be generated automatically.
+This is needed to make SVG icon accessible.
+
+#### Screen Readers
+
+If the icon has a title associated with it, the **`aria-labelledby`** attribute is used to provide the label ID.
+
+
+
+

package/lib/cjs/components/Icon/Icon.stories.d.ts

@@ -0,0 +1,8 @@
+import { Story } from '@storybook/react';
+import { IconProps } from '../../types';
+declare const _default: import("@storybook/types").ComponentAnnotations<import("@storybook/react/dist/types-0a347bb9").R, import("@storybook/types").Args>;
+export default _default;
+export declare const Default: Story<IconProps>;
+export declare const SVGIcons: Story;
+export declare const Sizes: Story;
+export declare const CommonlyUsed: Story;

package/lib/cjs/components/Icon/Icon.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/cjs/components/Icon/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Icon';

package/lib/cjs/components/IconBadge/IconBadge.mdx

@@ -0,0 +1,14 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Components/IconBadge/IconBadge" />
+
+# IconBadge
+
+IconBadge is a pair of overlapping icons. It should be paired with text or a [tooltip](./?path=/story/components-tooltiptrigger--icon-with-tooltip) when its meaning is unclear.
+It should only have Icon as a child component.
+
+The component follows the same pattern as icons. Check [Icon](./?path=/docs/components-icon--default) component for best practices.
+
+### Required Components
+
+This component requires the [Icon](./?path=/story/components-icon--default) component. 

package/lib/cjs/components/IconButton/IconButton.mdx

@@ -0,0 +1,33 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Components/IconButton/IconButton" />
+
+# IconButton
+
+The component combines the functionality of a [Button](./?path=/docs/components-button--default) and an [Icon](./?path=/story/components-icon--default). 
+This component applies specific styles necessary for icons and changes the behavior pattern for buttons and ensures compatibility across browsers and devices. 
+
+IconButtons should:
+- Use meaningful symbols that represent a basic idea or concept.
+- Include a title rendered as a tooltip when more descriptive information is needed.
+- Use an **aria-label** or **aria-labelledby** attribute to provide a label or label ID.
+
+IconButtons should not include anything other than an [Icon](.?path=/docs/components-icon--default) as a child component. If you need to pair an icon with text inside a button, review the [Button](./?path=/docs/components-button--default) component.
+
+### Required Components
+
+This component requires the [Icon](./?path=/story/components-icon--default) component. 
+
+### Accessibility
+This component adheres to [WAI-ARIA Button](https://www.w3.org/TR/wai-aria-practices-1.1/examples/button/button.html) accessibility guidelines.
+
+#### Keyboard Navigation
+
+| Key | Functions |
+| ---- | ---- |
+| Space or Enter | Selects the icon button. |
+| Tab | Focuses the icon button and follows the page tab sequence. |
+
+#### Screen Readers
+
+This component uses the **`aria-label`** to provide an accessible name.