@pingux/astro 2.221.6-alpha.0 → 2.234.0-alpha.0

package/lib/components/EmptyState/EmptyState.styles.js

@@ -0,0 +1,15 @@
+var container = {
+  flexDirection: 'column',
+  alignItems: 'center',
+  justifyContent: 'center',
+  // Fill the parent (e.g. the ListView placeholder wrapper) so the content
+  // centers vertically. Falls back to auto height when the parent has none.
+  height: '100%',
+  width: '100%',
+  gap: 'sm',
+  py: 'lg',
+  textAlign: 'center'
+};
+export default {
+  container: container
+};

package/lib/components/EmptyState/EmptyState.test.js

@@ -0,0 +1,220 @@
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _Symbol from "@babel/runtime-corejs3/core-js-stable/symbol";
+import _Object$create from "@babel/runtime-corejs3/core-js-stable/object/create";
+import _bindInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/bind";
+import _Object$getPrototypeOf from "@babel/runtime-corejs3/core-js-stable/object/get-prototype-of";
+import _Object$setPrototypeOf from "@babel/runtime-corejs3/core-js-stable/object/set-prototype-of";
+import _Symbol$asyncIterator from "@babel/runtime-corejs3/core-js-stable/symbol/async-iterator";
+import _Promise from "@babel/runtime-corejs3/core-js-stable/promise";
+import _Symbol$iterator from "@babel/runtime-corejs3/core-js-stable/symbol/iterator";
+import _reverseInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/reverse";
+import _typeof from "@babel/runtime-corejs3/helpers/esm/typeof";
+import _asyncToGenerator from "@babel/runtime-corejs3/helpers/esm/asyncToGenerator";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+function _regeneratorRuntime() { "use strict"; var r = _regenerator(), e = r.m(_regeneratorRuntime), t = (_Object$getPrototypeOf ? _Object$getPrototypeOf(e) : e.__proto__).constructor; function n(r) { var e = "function" == typeof r && r.constructor; return !!e && (e === t || "GeneratorFunction" === (e.displayName || e.name)); } var o = { "throw": 1, "return": 2, "break": 3, "continue": 3 }; function a(r) { var e, t; return function (n) { e || (e = { stop: function stop() { return t(n.a, 2); }, "catch": function _catch() { return n.v; }, abrupt: function abrupt(r, e) { return t(n.a, o[r], e); }, delegateYield: function delegateYield(r, o, a) { return e.resultName = o, t(n.d, _regeneratorValues(r), a); }, finish: function finish(r) { return t(n.f, r); } }, t = function t(r, _t, o) { n.p = e.prev, n.n = e.next; try { return r(_t, o); } finally { e.next = n.n; } }), e.resultName && (e[e.resultName] = n.v, e.resultName = void 0), e.sent = n.v, e.next = n.n; try { return r.call(this, e); } finally { n.p = e.prev, n.n = e.next; } }; } return (_regeneratorRuntime = function _regeneratorRuntime() { return { wrap: function wrap(e, t, n, o) { return r.w(a(e), t, n, o && _reverseInstanceProperty(o).call(o)); }, isGeneratorFunction: n, mark: r.m, awrap: function awrap(r, e) { return new _OverloadYield(r, e); }, AsyncIterator: _regeneratorAsyncIterator, async: function async(r, e, t, o, u) { return (n(e) ? _regeneratorAsyncGen : _regeneratorAsync)(a(r), e, t, o, u); }, keys: _regeneratorKeys, values: _regeneratorValues }; })(); }
+function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof _Symbol && _Symbol$iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
+function _regeneratorKeys(e) { var n = Object(e), r = []; for (var t in n) r.unshift(t); return function e() { for (; r.length;) if ((t = r.pop()) in n) return e.value = t, e.done = !1, e; return e.done = !0, e; }; }
+function _regeneratorAsync(n, e, r, t, o) { var a = _regeneratorAsyncGen(n, e, r, t, o); return a.next().then(function (n) { return n.done ? n.value : a.next(); }); }
+function _regeneratorAsyncGen(r, e, t, o, n) { return new _regeneratorAsyncIterator(_regenerator().w(r, e, t, o), n || _Promise); }
+function _regeneratorAsyncIterator(t, e) { function n(r, o, i, f) { try { var c = t[r](o), u = c.value; return u instanceof _OverloadYield ? e.resolve(u.v).then(function (t) { n("next", t, i, f); }, function (t) { n("throw", t, i, f); }) : e.resolve(u).then(function (t) { c.value = t, i(c); }, function (t) { return n("throw", t, i, f); }); } catch (t) { f(t); } } var r; this.next || (_regeneratorDefine2(_regeneratorAsyncIterator.prototype), _regeneratorDefine2(_regeneratorAsyncIterator.prototype, "function" == typeof _Symbol && _Symbol$asyncIterator || "@asyncIterator", function () { return this; })), _regeneratorDefine2(this, "_invoke", function (t, o, i) { function f() { return new e(function (e, r) { n(t, i, e, r); }); } return r = r ? r.then(f, f) : f(); }, !0); }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof _Symbol ? _Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = _Object$create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: _bindInstanceProperty(d).call(d, e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = _Object$getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = _Object$create(c); function f(e) { return _Object$setPrototypeOf ? _Object$setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = _Object$create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = _Object$defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _OverloadYield(e, d) { this.v = e, this.k = d; }
+import React from 'react';
+import userEvent from '@testing-library/user-event';
+import onyxTheme from '../../styles/themes/next-gen';
+import { render, screen } from '../../utils/testUtils/testWrapper';
+import { universalComponentTests } from '../../utils/testUtils/universalComponentTest';
+import EmptyState from '.';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var CustomIcon = function CustomIcon() {
+  return ___EmotionJSX("svg", {
+    "data-testid": "custom-icon"
+  });
+};
+var defaultProps = {};
+
+// EmptyState is an Onyx-only component, so it is tested under the Onyx theme.
+var getComponent = function getComponent() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(___EmotionJSX(EmptyState, _extends({}, defaultProps, props)), {
+    providerTheme: onyxTheme
+  });
+};
+
+// Needs to be added to each components test file
+universalComponentTests({
+  renderComponent: function renderComponent(props) {
+    return ___EmotionJSX(EmptyState, _extends({}, defaultProps, props));
+  }
+});
+test('renders default heading', function () {
+  getComponent();
+  expect(screen.getByText('No items exist')).toBeInTheDocument();
+});
+test('renders default icon with an accessible title', function () {
+  getComponent();
+  expect(screen.getByTitle('Empty state icon')).toBeInTheDocument();
+});
+test('does not render a description by default', function () {
+  getComponent();
+  expect(screen.queryByText(/Take action/)).not.toBeInTheDocument();
+});
+test('does not render a button by default', function () {
+  getComponent();
+  expect(screen.queryByRole('button')).not.toBeInTheDocument();
+});
+test('renders a custom heading', function () {
+  getComponent({
+    heading: 'No results found'
+  });
+  expect(screen.getByText('No results found')).toBeInTheDocument();
+  expect(screen.queryByText('No items exist')).not.toBeInTheDocument();
+});
+test('renders a custom description when provided', function () {
+  getComponent({
+    description: 'Try a different query.'
+  });
+  expect(screen.getByText('Try a different query.')).toBeInTheDocument();
+});
+test('renders a custom icon when provided', function () {
+  getComponent({
+    icon: CustomIcon
+  });
+  expect(screen.getByTestId('custom-icon')).toBeInTheDocument();
+  expect(screen.queryByTitle('Empty state icon')).not.toBeInTheDocument();
+});
+test('does not render the button when only buttonLabel is provided', function () {
+  getComponent({
+    buttonLabel: 'Add Item'
+  });
+  expect(screen.queryByRole('button', {
+    name: /Add Item/i
+  })).not.toBeInTheDocument();
+});
+test('does not render the button when only onButtonPress is provided', function () {
+  getComponent({
+    onButtonPress: jest.fn()
+  });
+  expect(screen.queryByRole('button')).not.toBeInTheDocument();
+});
+test('renders the button when buttonLabel and onButtonPress are provided', /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+  var onButtonPress, button;
+  return _regeneratorRuntime().wrap(function _callee$(_context) {
+    while (1) switch (_context.prev = _context.next) {
+      case 0:
+        onButtonPress = jest.fn();
+        getComponent({
+          buttonLabel: 'Add Item',
+          onButtonPress: onButtonPress
+        });
+        button = screen.getByRole('button', {
+          name: /Add Item/i
+        });
+        expect(button).toBeInTheDocument();
+        _context.next = 6;
+        return userEvent.click(button);
+      case 6:
+        expect(onButtonPress).toHaveBeenCalledTimes(1);
+      case 7:
+      case "end":
+        return _context.stop();
+    }
+  }, _callee);
+})));
+test('buttonProps are spread onto the underlying button', function () {
+  getComponent({
+    buttonLabel: 'Add Item',
+    onButtonPress: jest.fn(),
+    buttonProps: {
+      'data-testid': 'custom-button'
+    }
+  });
+  var button = screen.getByTestId('custom-button');
+  expect(button).toHaveAttribute('type', 'button');
+});
+test('buttonProps override the default button props', function () {
+  getComponent({
+    buttonLabel: 'Add Item',
+    onButtonPress: jest.fn(),
+    buttonProps: {
+      'data-testid': 'custom-button',
+      sx: {
+        borderRadius: '0px'
+      }
+    }
+  });
+  expect(screen.getByTestId('custom-button')).toBeInTheDocument();
+});
+test('iconProps are spread onto the underlying icon', function () {
+  getComponent({
+    iconProps: {
+      'data-testid': 'empty-state-icon'
+    }
+  });
+  expect(screen.getByTestId('empty-state-icon')).toBeInTheDocument();
+});
+test('headerProps are spread onto the underlying heading Text', function () {
+  getComponent({
+    headerProps: {
+      'data-testid': 'empty-state-heading'
+    }
+  });
+  expect(screen.getByTestId('empty-state-heading')).toBeInTheDocument();
+});
+test('headerProps override the default heading variant', function () {
+  getComponent({
+    headerProps: {
+      variant: 'bodyStrong'
+    }
+  });
+  expect(screen.getByText('No items exist')).toBeInTheDocument();
+});
+test('iconProps override the default icon title', function () {
+  getComponent({
+    iconProps: {
+      title: {
+        name: 'Custom icon title'
+      }
+    }
+  });
+  expect(screen.getByTitle('Custom icon title')).toBeInTheDocument();
+  expect(screen.queryByTitle('Empty state icon')).not.toBeInTheDocument();
+});
+test('renders custom children', function () {
+  getComponent({
+    children: ___EmotionJSX("a", {
+      href: "upgrade"
+    }, "Upgrade now")
+  });
+  expect(screen.getByRole('link', {
+    name: /Upgrade now/i
+  })).toBeInTheDocument();
+  expect(screen.queryByRole('button')).not.toBeInTheDocument();
+});
+test('children take priority over the built-in button', function () {
+  getComponent({
+    children: ___EmotionJSX("a", {
+      href: "upgrade"
+    }, "Upgrade now"),
+    buttonLabel: 'Add Item',
+    onButtonPress: jest.fn()
+  });
+  expect(screen.getByRole('link', {
+    name: /Upgrade now/i
+  })).toBeInTheDocument();
+  expect(screen.queryByRole('button', {
+    name: /Add Item/i
+  })).not.toBeInTheDocument();
+});
+test('spreads container props onto the root element', function () {
+  getComponent({
+    'data-testid': 'empty-container',
+    id: 'empty-id',
+    sx: {
+      my: 'xl'
+    }
+  });
+  var container = screen.getByTestId('empty-container');
+  expect(container).toHaveAttribute('id', 'empty-id');
+});

package/lib/components/EmptyState/emptyStateAttributes.js

@@ -0,0 +1,42 @@
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = _filterInstanceProperty(o).call(o, 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 _context, _context2; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(t), !0)).call(_context, function (r) { _defineProperty(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context2 = ownKeys(Object(t))).call(_context2, function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { ariaAttributeBaseArgTypes } from '../../utils/docUtils/ariaAttributes';
+import { funcArg } from '../../utils/docUtils/docArgTypes';
+export var emptyStateArgTypes = _objectSpread({
+  heading: {
+    control: 'text',
+    description: 'The empty-state heading.'
+  },
+  description: {
+    control: 'text',
+    description: 'Optional supporting description.'
+  },
+  buttonLabel: {
+    control: 'text',
+    description: 'Label for the call-to-action button.'
+  },
+  onButtonPress: _objectSpread(_objectSpread({}, funcArg), {}, {
+    description: 'Press handler for the call-to-action button.'
+  }),
+  headerProps: {
+    control: 'object',
+    description: 'Props spread onto the underlying heading Text.'
+  },
+  iconProps: {
+    control: 'object',
+    description: 'Props spread onto the underlying Icon.'
+  },
+  buttonProps: {
+    control: 'object',
+    description: 'Props spread onto the underlying Button.'
+  }
+}, ariaAttributeBaseArgTypes);

package/lib/components/EmptyState/index.js

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

package/lib/components/HelpHint/HelpHint.js

@@ -1,106 +1,60 @@
 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 = ["align", "arrowCrossOffset", "children", "className", "closeDelay", "direction", "hasNoArrow", "iconButtonProps", "isDarkMode", "isNotFlippable", "popoverProps", "tooltipProps"];
-import _setTimeout from "@babel/runtime-corejs3/core-js-stable/set-timeout";
-import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
+var _excluded = ["align", "arrowCrossOffset", "children", "className", "closeDelay", "crossOffset", "direction", "hasNoArrow", "iconButtonProps", "isDarkMode", "isNotFlippable", "offset", "popoverProps", "tooltipProps"];
 import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
-import React, { forwardRef, useEffect, 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 React, { forwardRef, useEffect } from 'react';
+import { FocusScope, mergeProps } from 'react-aria';
+import { astroTokens, astroTokensDark } from '@pingux/onyx-tokens';
 import { Box, Icon, IconButton, PopoverContainer } from '../..';
-import { useGetTheme, useLocalOrForwardRef, useStatusClasses } from '../../hooks';
+import { useGetTheme, useHelpHintPopover, useLocalOrForwardRef, useStatusClasses } from '../../hooks';
 import { isSafari } from '../../styles/safariAgent';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var HelpHint = /*#__PURE__*/forwardRef(function (props, ref) {
-  var _context;
   var align = props.align,
     arrowCrossOffset = props.arrowCrossOffset,
     children = props.children,
     className = props.className,
     closeDelay = props.closeDelay,
+    crossOffset = props.crossOffset,
     direction = props.direction,
     hasNoArrow = props.hasNoArrow,
     iconButtonProps = props.iconButtonProps,
     isDarkMode = props.isDarkMode,
     isNotFlippable = props.isNotFlippable,
+    offset = props.offset,
     popoverProps = props.popoverProps,
     tooltipProps = props.tooltipProps,
     others = _objectWithoutProperties(props, _excluded);
   var _useGetTheme = useGetTheme(),
-    icons = _useGetTheme.icons;
-  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(null);
+    icons = _useGetTheme.icons,
+    isOnyxDark = _useGetTheme.themeState.isOnyxDark;
   var triggerRef = useLocalOrForwardRef(ref);
-  var _useFocusRing = useFocusRing(),
-    focusProps = _useFocusRing.focusProps,
-    isFocusVisible = _useFocusRing.isFocusVisible;
-  var _useHover = useHover({}),
-    overlayHoverProps = _useHover.hoverProps,
-    isOverlayHovered = _useHover.isHovered;
-  var _useHover2 = useHover({}),
-    hoverProps = _useHover2.hoverProps,
-    isTriggerHovered = _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;
-
-  // 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;
-    var isHovered = isTriggerHovered || isOverlayHovered;
-    if (isHovered || isFocusWithinOverlay) {
-      open();
-    } else if (!isFocusWithinOverlay && !isFocusVisible && !isHovered) {
-      timeout = _setTimeout(close, closeDelay || 1000);
-    }
-    return function () {
-      clearTimeout(timeout);
-    };
-  }, [isFocusWithinOverlay, isFocusVisible, isOverlayHovered, isTriggerHovered, close, closeDelay, open]);
+  var _useHelpHintPopover = useHelpHintPopover(triggerRef, {
+      align: align,
+      className: className,
+      closeDelay: closeDelay,
+      crossOffset: crossOffset,
+      direction: direction,
+      isDarkMode: isDarkMode,
+      isNotFlippable: isNotFlippable,
+      offset: offset
+    }),
+    isFocusVisible = _useHelpHintPopover.isFocusVisible,
+    isOpen = _useHelpHintPopover.isOpen,
+    overlayRef = _useHelpHintPopover.overlayRef,
+    popoverContainerProps = _useHelpHintPopover.popoverContainerProps,
+    triggerProps = _useHelpHintPopover.triggerProps;
   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');
+    triggerRef === null || triggerRef === void 0 || triggerRef.current.setAttribute('aria-expanded', isOpen ? 'true' : 'false');
   }, [isOpen, triggerRef]);
-  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;
   var _addIsSafariCompatiblePropToLinkChildren = function addIsSafariCompatiblePropToLinkChildren(element) {
     if (element) {
-      var _context2;
-      return _mapInstanceProperty(_context2 = React.Children).call(_context2, element, function (child) {
+      var _context;
+      return _mapInstanceProperty(_context = React.Children).call(_context, element, function (child) {
         if (! /*#__PURE__*/React.isValidElement(child)) return child;
         return /*#__PURE__*/React.cloneElement(child, {
           children: _addIsSafariCompatiblePropToLinkChildren(child.props.children),
@@ -116,25 +70,26 @@ var HelpHint = /*#__PURE__*/forwardRef(function (props, ref) {
     ref: triggerRef,
     "aria-label": "label help hint",
     "data-testid": "help-hint__button",
-    variant: "hintButton"
-  }, mergeProps(triggerProps, iconButtonProps, focusProps, hoverProps)), ___EmotionJSX(Icon, {
-    icon: icons.helpHint
-  })), ___EmotionJSX(PopoverContainer, _extends({
+    variant: "hintButton",
+    sx: {
+      '&.is-hovered, &.is-focused': {
+        backgroundColor: isOnyxDark ? astroTokensDark.color.common.light : astroTokens.color.common.light
+      }
+    }
+  }, mergeProps(triggerProps, iconButtonProps || {})), ___EmotionJSX(Icon, {
+    icon: icons.helpHint,
+    size: "xs"
+  })), ___EmotionJSX(PopoverContainer, _extends({}, mergeProps(popoverContainerProps, popoverProps || tooltipProps || {}), {
     arrowCrossOffset: arrowCrossOffset,
+    className: classNames,
+    direction: direction,
     arrowProps: {
       width: '8px',
       height: '4px'
     },
-    className: classNames,
-    direction: direction,
     hasNoArrow: hasNoArrow,
-    isDismissable: isFocusWithinOverlay ? !isOpen : true,
-    isNonModal: true,
-    onClose: close,
-    placement: placement !== null && placement !== void 0 ? placement : undefined,
-    ref: overlayRef,
-    isOpen: isOpen
-  }, mergeProps(overlayProps, positionProps, popoverProps || tooltipProps, overlayHoverProps, focusWithinProps)), ___EmotionJSX(FocusScope, {
+    ref: overlayRef
+  }), ___EmotionJSX(FocusScope, {
     restoreFocus: true,
     autoFocus: isFocusVisible
   }, ___EmotionJSX(Box, {

package/lib/components/IconBadge/IconBadge.js

@@ -1,3 +1,11 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
+var _excluded = ["children", "sx", "circleColor", "baseSize", "circleSize", "colorId"];
+function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = _filterInstanceProperty(o).call(o, 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 _context2, _context3; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context2 = ownKeys(Object(t), !0)).call(_context2, function (r) { _defineProperty(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context3 = ownKeys(Object(t))).call(_context3, function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+import _concatInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/concat";
 import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
 import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
 import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
@@ -6,53 +14,64 @@ import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/inst
 import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
 import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
 import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
-import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
-import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
-import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
-import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
-var _excluded = ["children", "sx", "circleColor", "baseSize", "circleSize"];
-function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = _filterInstanceProperty(o).call(o, 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 _context, _context2; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(t), !0)).call(_context, function (r) { _defineProperty(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context2 = ownKeys(Object(t))).call(_context2, function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
 import React, { forwardRef } from 'react';
 import { useGetTheme } from '../../hooks';
 import { Box } from '../../index';
+import getColorFromUUID from '../Avatar/getColorFromUuid';
 import { jsx as ___EmotionJSX } from "@emotion/react";
+export var resolveTwotonePath = function resolveTwotonePath(colorId, twotoneColorNames) {
+  if (!colorId || !twotoneColorNames) return null;
+  var twotoneColor = getColorFromUUID(colorId, twotoneColorNames);
+  return function (slot) {
+    var _context;
+    return _concatInstanceProperty(_context = "twoTone.".concat(slot, ".")).call(_context, twotoneColor);
+  };
+};
+export var injectTwotoneColor = function injectTwotoneColor(icon, slot, twotonePath) {
+  if (!twotonePath || ! /*#__PURE__*/React.isValidElement(icon)) return icon;
+  if ('color' in icon.props) return icon;
+  return /*#__PURE__*/React.cloneElement(icon, {
+    color: twotonePath(slot)
+  });
+};
 var IconBadge = /*#__PURE__*/forwardRef(function (props, ref) {
   var children = props.children,
     sx = props.sx,
     circleColor = props.circleColor,
     baseSize = props.baseSize,
     circleSize = props.circleSize,
+    colorId = props.colorId,
     others = _objectWithoutProperties(props, _excluded);
   var _React$Children$toArr = React.Children.toArray(children),
     _React$Children$toArr2 = _slicedToArray(_React$Children$toArr, 2),
     firstIcon = _React$Children$toArr2[0],
     secondIcon = _React$Children$toArr2[1];
   var _useGetTheme = useGetTheme(),
-    iconBadgeCircleColor = _useGetTheme.iconBadgeCircleColor;
+    iconBadgeCircleColor = _useGetTheme.iconBadgeCircleColor,
+    iconBadgeTwotoneColorNames = _useGetTheme.iconBadgeTwotoneColorNames;
+  var twotonePath = resolveTwotonePath(colorId, iconBadgeTwotoneColorNames);
+  var baseIcon = injectTwotoneColor(firstIcon, 'text', twotonePath);
+  var badgeIcon = injectTwotoneColor(secondIcon, 'secondary', twotonePath);
   return ___EmotionJSX(Box, _extends({
     ref: ref,
     as: "span",
-    sx: _objectSpread({
-      position: 'relative',
+    variant: "iconBadge.container",
+    sx: _objectSpread(_objectSpread(_objectSpread({}, baseSize !== undefined && {
       height: "".concat(baseSize, "px"),
-      width: "".concat(baseSize, "px"),
-      display: 'flex',
-      alignItems: 'top'
-    }, sx)
-  }, others), firstIcon, ___EmotionJSX(Box, {
+      width: "".concat(baseSize, "px")
+    }), twotonePath && {
+      backgroundColor: twotonePath('bg')
+    }), sx)
+  }, others), baseIcon, ___EmotionJSX(Box, {
     as: "span",
-    sx: {
-      position: 'absolute',
-      bottom: '-5.5px',
-      right: '1px',
-      borderRadius: "".concat(circleSize !== undefined && circleSize / 2, "px"),
+    variant: "iconBadge.badgeCircle",
+    sx: _objectSpread(_objectSpread({}, circleSize !== undefined && {
       height: "".concat(circleSize, "px"),
       width: "".concat(circleSize, "px"),
-      alignItems: 'center',
-      justifyContent: 'center',
+      borderRadius: "".concat(circleSize / 2, "px")
+    }), {}, {
       backgroundColor: circleColor || iconBadgeCircleColor
-    }
-  }, secondIcon));
+    })
+  }, badgeIcon));
 });
 export default IconBadge;

package/lib/components/IconBadge/IconBadge.mdx

@@ -12,4 +12,8 @@ The component follows the same pattern as icons. Check [Icon](./?path=/docs/comp
 
 ### Required Components
 
-This component requires the [Icon](./?path=/story/components-icon--default) component. 
+This component requires the [Icon](./?path=/story/components-icon--default) component.
+
+### colorId (Onyx themes)
+
+On Onyx and Onyx dark themes, pass a `colorId` to have the child icons colored with the Onyx twotone palette: the base icon container is filled with `color/twotone/<color>/bg`, the base icon uses `color/twotone/<color>/text`, and the small badge icon uses `color/twotone/<color>/secondary`. The color is assigned deterministically from the id with the same FNV-1a hashing approach as [IconWrapper](./?path=/docs/components-iconwrapper--default) and Avatar. A `color` already set on a child icon takes precedence. See the `Onyx Color Variants` story for the full palette in both themes.