@pingux/astro 2.13.0-alpha.3 → 2.13.0-alpha.5

package/lib/cjs/components/TooltipTrigger/Tooltip.styles.js

@@ -12,7 +12,7 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = exports.button = void 0;
+exports["default"] = exports.container = exports.button = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
 var _Badge = require("../Badge/Badge.styles");
 var _Buttons = require("../Button/Buttons.styles");
@@ -33,6 +33,7 @@ var container = {
     WebkitLineClamp: '4'
   }
 };
+exports.container = container;
 var badge = _objectSpread(_objectSpread({}, _Badge.baseBadge), {}, {
   cursor: 'default',
   '&.is-hovered, &.is-pressed': {

package/lib/cjs/components/TooltipTrigger/TooltipTrigger.js

@@ -100,6 +100,8 @@ TooltipTrigger.propTypes = {
   /** The additional offset applied along the cross axis
    * between the element and its anchor element. */
   crossOffset: _propTypes["default"].number,
+  /** Amount of time before the tooltip disappears */
+  closeDelay: _propTypes["default"].number,
   /** Amount of time before the tooltip shows */
   delay: _propTypes["default"].number,
   /** Where the popover menu opens relative to its trigger. */

package/lib/cjs/components/TooltipTrigger/TooltipTrigger.mdx

@@ -10,6 +10,8 @@ This component is typically used as a design fallback for contextual information
 This component should provide useful, supplementary information or clarification regarding the element it points to. 
 It shouldn’t contain essential content, error or feedback messages, or action items.
 
+Tooltips cannot contain interactive content (links, buttons) according to the [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/).
+
 ### Required Components
 
 This component requires the [Button](./?path=/docs/components-button--default) and Tooltip components.

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

@@ -1,6 +1,17 @@
 "use strict";
 
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _Symbol = require("@babel/runtime-corejs3/core-js-stable/symbol");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+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 _react = _interopRequireDefault(require("react"));
 var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
 var _index = require("../../index");
@@ -8,6 +19,7 @@ var _theme = _interopRequireDefault(require("../../styles/theme"));
 var _testAxe = _interopRequireDefault(require("../../utils/testUtils/testAxe"));
 var _testWrapper = require("../../utils/testUtils/testWrapper");
 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, $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 generator._invoke = function (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); } }; }(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 _context2; _forEachInstanceProperty(_context2 = ["next", "throw", "return"]).call(_context2, 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; this._invoke = function (method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); }; } function maybeInvokeDelegate(delegate, context) { var method = delegate.iterator[context.method]; if (undefined === method) { if (context.delegate = null, "throw" === context.method) { if (delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method)) return ContinueSentinel; context.method = "throw", context.arg = new TypeError("The iterator does not provide a 'throw' method"); } return 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, define(Gp, "constructor", GeneratorFunctionPrototype), define(GeneratorFunctionPrototype, "constructor", GeneratorFunction), 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 (object) { var 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 _context3; 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(_context3 = this.tryEntries).call(_context3, 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 getComponent = function getComponent() {
   var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
   return (0, _testWrapper.render)((0, _react2.jsx)(_index.TooltipTrigger, props, (0, _react2.jsx)(_index.Button, props.buttonProps, "Mock Button"), (0, _react2.jsx)(_index.Tooltip, null, "Tooltip Content")));
@@ -81,4 +93,38 @@ test('passing in width applies the correct width to the container', function ()
   });
   var arrow = _testWrapper.screen.getByTestId('popover-container');
   expect(arrow).toHaveStyle('width: 100px');
-});
+});
+test('tooltip closes after closeDelay when mouse leaves trigger', /*#__PURE__*/(0, _asyncToGenerator2["default"])( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+  var closeDelay, button;
+  return _regeneratorRuntime().wrap(function _callee$(_context) {
+    while (1) {
+      switch (_context.prev = _context.next) {
+        case 0:
+          closeDelay = 5000;
+          getComponent({
+            closeDelay: closeDelay
+          });
+          button = _testWrapper.screen.getByRole('button');
+          _testWrapper.fireEvent.mouseEnter(button);
+          expect(_testWrapper.screen.queryByRole('tooltip')).toBeInTheDocument();
+          _testWrapper.fireEvent.mouseLeave(button);
+          _context.next = 8;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('tooltip')).toBeInTheDocument();
+          }, {
+            timeout: closeDelay / 2 + 100
+          });
+        case 8:
+          _context.next = 10;
+          return (0, _testWrapper.waitFor)(function () {
+            expect(_testWrapper.screen.queryByRole('tooltip')).not.toBeInTheDocument();
+          }, {
+            timeout: closeDelay + 100
+          });
+        case 10:
+        case "end":
+          return _context.stop();
+      }
+    }
+  }, _callee);
+})));

package/lib/cjs/utils/designUtils/figmaLinks.js

@@ -38,7 +38,8 @@ var FIGMA_LINKS = {
     "default": 'https://www.figma.com/file/bpbEw54gTTcdIiZs4PKK1p/Astro-Specs?type=design&node-id=218-1442&t=8Wwd3tIBh3GEjCJB-0'
   },
   helpHint: {
-    "default": 'https://www.figma.com/file/Oa6VYtJcUJzEJuuRp0p4ls/Astro?type=design&node-id=0%3A4534&t=We3h7LaaFJQnxdSy-1'
+    "default": 'https://www.figma.com/file/Oa6VYtJcUJzEJuuRp0p4ls/Astro?type=design&node-id=0%3A4534&t=We3h7LaaFJQnxdSy-1',
+    withLink: 'https://www.figma.com/file/bpbEw54gTTcdIiZs4PKK1p/Astro-Specs?type=design&node-id=28958%3A40081&mode=design&t=WmSYPx1hR8kxFiXf-1'
   },
   icon: {
     "default": 'https://www.figma.com/file/bpbEw54gTTcdIiZs4PKK1p/Astro-Specs?type=design&node-id=24360%3A49754&t=3b86het2R9G2Zyo2-1'

package/lib/components/HelpHint/HelpHint.js

@@ -1,14 +1,16 @@
 import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
-var _excluded = ["children", "tooltipProps", "iconButtonProps"];
-import React, { forwardRef, useRef } from 'react';
-import { useFocusRing } from 'react-aria';
+var _excluded = ["align", "arrowCrossOffset", "children", "className", "closeDelay", "direction", "hasNoArrow", "iconButtonProps", "isDarkMode", "isNotFlippable", "offset", "popoverProps"];
+import _setTimeout from "@babel/runtime-corejs3/core-js-stable/set-timeout";
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+import React, { forwardRef, useEffect, useImperativeHandle, useRef, useState } from 'react';
+import { FocusScope, mergeProps, useFocusRing, useFocusWithin, useOverlayPosition, useOverlayTrigger } from 'react-aria';
+import { useOverlayTriggerState } from 'react-stately';
 import { useHover } from '@react-aria/interactions';
 import PropTypes from 'prop-types';
-import { v4 as uuid } from 'uuid';
-import { Icon } from '../..';
-import IconButton from '../IconButton';
-import TooltipTrigger, { Tooltip } from '../TooltipTrigger';
+import { Box, Icon, IconButton, PopoverContainer } from '../..';
+import { useStatusClasses } from '../../hooks';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var HelpIcon = function HelpIcon() {
   return ___EmotionJSX("svg", {
@@ -26,42 +28,158 @@ var HelpIcon = function HelpIcon() {
   }));
 };
 var HelpHint = /*#__PURE__*/forwardRef(function (props, ref) {
-  var children = props.children,
-    tooltipProps = props.tooltipProps,
+  var _context;
+  var align = props.align,
+    arrowCrossOffset = props.arrowCrossOffset,
+    children = props.children,
+    className = props.className,
+    closeDelay = props.closeDelay,
+    direction = props.direction,
+    hasNoArrow = props.hasNoArrow,
     iconButtonProps = props.iconButtonProps,
+    isDarkMode = props.isDarkMode,
+    isNotFlippable = props.isNotFlippable,
+    offset = props.offset,
+    popoverProps = props.popoverProps,
     others = _objectWithoutProperties(props, _excluded);
-  var tooltipId = uuid();
-  var buttonRef = useRef();
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isFocusWithinOverlay = _useState2[0],
+    setIsFocusWithinOverlay = _useState2[1];
+  var _useFocusWithin = useFocusWithin({
+      onFocusWithinChange: function onFocusWithinChange(isFocusWithin) {
+        return setIsFocusWithinOverlay(isFocusWithin);
+      }
+    }),
+    focusWithinProps = _useFocusWithin.focusWithinProps;
+  var overlayRef = useRef();
+  var triggerRef = useRef(null);
   var _useFocusRing = useFocusRing(),
     focusProps = _useFocusRing.focusProps,
     isFocusVisible = _useFocusRing.isFocusVisible;
   var _useHover = useHover({}),
     hoverProps = _useHover.hoverProps,
     isHovered = _useHover.isHovered;
-  var isTooltipOpen = isFocusVisible || isHovered;
-  return ___EmotionJSX(TooltipTrigger, _extends({
-    ref: ref,
-    direction: "top"
-  }, others, {
-    isOpen: isTooltipOpen
-  }, tooltipProps), ___EmotionJSX(IconButton, _extends({
-    ref: buttonRef,
-    variant: "hintButton",
+  var _useHover2 = useHover({}),
+    overlayHoverProps = _useHover2.hoverProps,
+    isOverlayHovered = _useHover2.isHovered;
+  var popoverState = useOverlayTriggerState({});
+  var open = popoverState.open,
+    close = popoverState.close,
+    isOpen = popoverState.isOpen;
+  var _useOverlayTrigger = useOverlayTrigger({
+      type: 'dialog'
+    }, popoverState, triggerRef),
+    triggerProps = _useOverlayTrigger.triggerProps,
+    overlayProps = _useOverlayTrigger.overlayProps;
+
+  /* istanbul ignore next */
+  useImperativeHandle(ref, function () {
+    return triggerRef.current;
+  });
+
+  // Set a timeout to close the overlay upon hover / focus loss,
+  // but keep it open if the trigger or overlay are hovered again before it closes.
+  useEffect(function () {
+    var timeout;
+    if (isHovered || isOverlayHovered || isFocusWithinOverlay) {
+      open();
+    } else {
+      timeout = _setTimeout(close, closeDelay || 1000);
+    }
+    return function () {
+      clearTimeout(timeout);
+    };
+  }, [isHovered, isOverlayHovered, isFocusWithinOverlay, open, close, closeDelay]);
+  useEffect(function () {
+    if (isOpen) {
+      return triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current.setAttribute('aria-expanded', 'true');
+    }
+    return triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current.setAttribute('aria-expanded', 'false');
+  }, [isOpen]);
+  var _useOverlayPosition = useOverlayPosition({
+      targetRef: triggerRef,
+      overlayRef: overlayRef,
+      placement: _concatInstanceProperty(_context = "".concat(direction, " ")).call(_context, align),
+      offset: 15,
+      isOpen: isOpen,
+      onClose: close,
+      shouldUpdatePosition: true,
+      shouldFlip: !isNotFlippable
+    }),
+    positionProps = _useOverlayPosition.overlayProps,
+    placement = _useOverlayPosition.placement;
+  var _useStatusClasses = useStatusClasses(className, {
+      isDarkMode: isDarkMode
+    }),
+    classNames = _useStatusClasses.classNames;
+  return ___EmotionJSX(Box, _extends({}, others, {
+    ref: ref
+  }), ___EmotionJSX(IconButton, _extends({
+    ref: triggerRef,
     "aria-label": "label help hint",
     "data-testid": "help-hint__button",
-    "aria-describedby": isTooltipOpen ? tooltipId : null
-  }, iconButtonProps, hoverProps, focusProps), ___EmotionJSX(Icon, {
+    variant: "hintButton"
+  }, mergeProps(triggerProps, iconButtonProps, focusProps, hoverProps)), ___EmotionJSX(Icon, {
     icon: HelpIcon
-  })), ___EmotionJSX(Tooltip, _extends({}, tooltipProps, {
-    role: "tooltip",
-    "aria-live": "polite",
-    id: tooltipId
-  }), children));
+  })), ___EmotionJSX(PopoverContainer, _extends({
+    arrowCrossOffset: arrowCrossOffset,
+    arrowProps: {
+      width: '8px',
+      height: '4px'
+    },
+    className: classNames,
+    direction: direction,
+    hasNoArrow: hasNoArrow,
+    isDismissable: !isOpen,
+    isNonModal: true,
+    isOpen: isOpen,
+    onClose: close,
+    placement: placement,
+    ref: overlayRef
+  }, mergeProps(overlayProps, positionProps, popoverProps, overlayHoverProps), focusWithinProps), ___EmotionJSX(FocusScope, {
+    restoreFocus: true,
+    autoFocus: isFocusVisible
+  }, ___EmotionJSX(Box, {
+    variant: "helpHint.popoverContainer"
+  }, children))));
 });
 HelpHint.propTypes = {
-  /** Props object that is spread directly into the tooltip element. */
-  tooltipProps: PropTypes.shape({}),
+  /** Props object that is spread directly into the popover element. */
+  popoverProps: PropTypes.shape({}),
   /** Props object that is spread directly into the IconButton element. */
-  iconButtonProps: PropTypes.shape({})
+  iconButtonProps: PropTypes.shape({}),
+  /** Defaults to true, displays dark popover with white text */
+  isDarkMode: PropTypes.bool,
+  /** Where the popover menu opens relative to its trigger. */
+  direction: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+  /**
+     * Whether the popover is prevented from flipping directions when insufficient space is
+     * available for the given `direction` placement.
+     */
+  isNotFlippable: PropTypes.bool,
+  /** Alignment of the popover menu relative to the trigger. */
+  align: PropTypes.oneOf(['start', 'end', 'middle']),
+  /**
+   * Allows to add an arrow to popover container
+   */
+  hasNoArrow: PropTypes.bool,
+  /** Popover offset relative to its trigger. */
+  offset: PropTypes.number,
+  /** Arrow offset relative to the left of the popover.
+   * Must be passed as a px or percentage. */
+  arrowCrossOffset: PropTypes.string,
+  /** The additional offset applied along the cross axis
+   * between the element and its anchor element. */
+  crossOffset: PropTypes.number,
+  /** Amount of time before the popover closes */
+  closeDelay: PropTypes.number
+};
+HelpHint.defaultProps = {
+  align: 'middle',
+  direction: 'top',
+  hasNoArrow: false,
+  isDarkMode: true,
+  isNotFlippable: false
 };
 export default HelpHint;

package/lib/components/HelpHint/HelpHint.mdx

@@ -6,7 +6,7 @@ import { Meta } from '@storybook/addon-docs';
 
 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 tooltip displays, nor should it be used to communicate important information.
+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
 
@@ -27,6 +27,6 @@ These keys provide additional functionality to the component.
 #### Screen Readers
 
 This component uses the following attributes to assist screen readers:
-- The trigger button uses the **`aria-desribedby`** attribute, which announces the tooltip text.
+- 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/components/HelpHint/HelpHint.stories.js

@@ -1,7 +1,9 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
 import React from 'react';
 import { withDesign } from 'storybook-addon-designs';
 import DocsLayout from '../../../.storybook/storybookDocsLayout';
-import { Box, HelpHint } from '../../index';
+import { Box, HelpHint, Link, Text } from '../../index';
+import { isSafari } from '../../styles/safariAgent';
 import { FIGMA_LINKS } from '../../utils/designUtils/figmaLinks.js';
 import HelpHintReadme from './HelpHint.mdx';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -18,14 +20,14 @@ export 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...'
   }
 };
 export var Default = function Default(args) {
@@ -39,15 +41,44 @@ Default.parameters = {
     url: FIGMA_LINKS.helpHint["default"]
   }
 };
-export var WithTooltipAndIconButtonProps = function WithTooltipAndIconButtonProps() {
+export var WithPopoverAndIconButtonProps = function WithPopoverAndIconButtonProps() {
   return ___EmotionJSX(Box, {
     p: 50
   }, ___EmotionJSX(HelpHint, {
-    tooltipProps: {
+    popoverProps: {
       direction: 'bottom'
     },
     iconButtonProps: {
       'aria-label': 'Help hint'
     }
-  }, "Text of the tooltip right here..."));
+  }, "Text of the popover right here..."));
+};
+export var ContentWithLink = function ContentWithLink() {
+  return ___EmotionJSX(Box, {
+    p: 70
+  }, ___EmotionJSX(HelpHint, null, ___EmotionJSX(Text, {
+    variant: "popover"
+  }, "Text of the popover right here... "), isSafari ? ___EmotionJSX(Box, {
+    href: "https://uilibrary.ping-eng.com/",
+    as: "a",
+    pl: "xs"
+  }, ___EmotionJSX(Link, {
+    variant: "popover"
+  }, "Learn More")) : ___EmotionJSX(Link, {
+    variant: "popover",
+    href: "https://uilibrary.ping-eng.com/"
+  }, "Learn More")));
+};
+ContentWithLink.parameters = {
+  design: {
+    type: 'figma',
+    url: FIGMA_LINKS.helpHint.withLink
+  }
+};
+export var WithDelay = function WithDelay(args) {
+  return ___EmotionJSX(Box, {
+    p: 50
+  }, ___EmotionJSX(HelpHint, _extends({}, args, {
+    closeDelay: 5000
+  })));
 };

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

@@ -10,6 +10,7 @@ import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
 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) { _defineProperty(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; }
 import { defaultFocus } from '../Button/Buttons.styles';
+import { container } from '../TooltipTrigger/Tooltip.styles.js';
 export var hintButton = {
   bg: 'neutral.90',
   borderColor: 'active',
@@ -45,6 +46,13 @@ export var hintButton = {
     }
   }
 };
+var popoverContainer = _objectSpread(_objectSpread({}, container), {}, {
+  p: '10px',
+  fontSize: 'sm',
+  fontWeight: 1,
+  width: '117px'
+});
 export default {
-  hintButton: hintButton
+  hintButton: hintButton,
+  popoverContainer: popoverContainer
 };