@pingux/astro 2.215.0-alpha.0 → 2.217.0-alpha.0

package/lib/cjs/components/PanelHeader/PanelHeader.js

@@ -25,7 +25,7 @@ var _hooks = require("../../hooks");
 var _index = require("../../index");
 var _listViewItemAttributes = require("../ListViewItem/listViewItemAttributes");
 var _react2 = require("@emotion/react");
-var _excluded = ["avatarProps", "children", "className", "data", "headerProps", "headerWrapperProps", "slots", "subtextProps"];
+var _excluded = ["avatarProps", "children", "className", "data", "headerProps", "headerWrapperProps", "isCopyable", "slots", "subtextProps"];
 function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 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) { (0, _defineProperty2["default"])(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; }
@@ -38,6 +38,7 @@ var PanelHeader = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     data = _ref.data,
     headerProps = _ref.headerProps,
     headerWrapperProps = _ref.headerWrapperProps,
+    isCopyable = _ref.isCopyable,
     slots = _ref.slots,
     subtextProps = _ref.subtextProps,
     others = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
@@ -101,7 +102,12 @@ var PanelHeader = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     variant: text || subtext ? 'panelHeader.data' : 'panelHeader.emptyData'
   }, renderLeftContent(), (text || subtext) && (0, _react2.jsx)(_index.Box, headerWrapperPropsSpread, text && (0, _react2.jsx)(_index.Text, (0, _extends2["default"])({}, headerPropsSpread, {
     variant: "panelHeaderText"
-  }), text), subtext && (0, _react2.jsx)(_index.Text, {
+  }), text), subtext && isCopyable ? (0, _react2.jsx)(_index.CopyText, {
+    mode: "nonClickableContent",
+    textToCopy: subtext
+  }, (0, _react2.jsx)(_index.Text, {
+    variant: "panelHeaderSubtext"
+  }, subtext)) : subtext && (0, _react2.jsx)(_index.Text, {
     variant: "panelHeaderSubtext"
   }, subtext)));
   return (0, _react2.jsx)(_index.Box, (0, _extends2["default"])({
@@ -123,6 +129,7 @@ var PanelHeader = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
   }, children)));
 });
 PanelHeader.propTypes = _objectSpread(_objectSpread({}, _listViewItemAttributes.SharedItemPropTypes), {}, {
+  isCopyable: _propTypes["default"].bool,
   slots: _propTypes["default"].shape({
     rightOfData: _propTypes["default"].node
   })

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

@@ -5,7 +5,7 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = exports.WithSubtext = exports.WithImage = exports.WithExtraLongText = exports.WithControls = exports.WithBreadcrumbs = exports.WithAvatar = exports.Default = exports.BreadcrumbsWithExtraLongText = void 0;
+exports["default"] = exports.WithSubtext = exports.WithImage = exports.WithExtraLongText = exports.WithCopyableSubtext = exports.WithControls = exports.WithBreadcrumbs = exports.WithAvatar = exports.Default = exports.BreadcrumbsWithExtraLongText = void 0;
 var _objectDestructuringEmpty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/objectDestructuringEmpty"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _react = _interopRequireDefault(require("react"));
@@ -172,8 +172,20 @@ var BreadcrumbsWithExtraLongText = exports.BreadcrumbsWithExtraLongText = functi
     }
   }, (0, _react2.jsx)(_index.PanelHeaderCloseButton, null));
 };
-var WithExtraLongText = exports.WithExtraLongText = function WithExtraLongText(_ref4) {
+var WithCopyableSubtext = exports.WithCopyableSubtext = function WithCopyableSubtext(_ref4) {
   var args = (0, _extends2["default"])({}, ((0, _objectDestructuringEmpty2["default"])(_ref4), _ref4));
+  return (0, _react2.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, args, {
+    isCopyable: true,
+    data: {
+      icon: _AccountIcon["default"],
+      subtext: 'rad_developer@pingidentity.com',
+      text: 'Fons Vernall',
+      avatarDefaultText: 'FV'
+    }
+  }));
+};
+var WithExtraLongText = exports.WithExtraLongText = function WithExtraLongText(_ref5) {
+  var args = (0, _extends2["default"])({}, ((0, _objectDestructuringEmpty2["default"])(_ref5), _ref5));
   return (0, _react2.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, args, {
     data: {
       avatarDefaultText: 'FV',

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

@@ -1,5 +1,6 @@
 "use strict";
 
+var _typeof = 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");
@@ -7,22 +8,43 @@ var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-s
 var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
 var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors");
 var _Object$defineProperties = require("@babel/runtime-corejs3/core-js-stable/object/define-properties");
-var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Object$defineProperty2 = 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 _bindInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/bind");
+var _Object$getPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/get-prototype-of");
+var _Object$setPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/set-prototype-of");
+var _Symbol$asyncIterator = require("@babel/runtime-corejs3/core-js-stable/symbol/async-iterator");
+var _Promise = require("@babel/runtime-corejs3/core-js-stable/promise");
+var _Symbol$iterator = require("@babel/runtime-corejs3/core-js-stable/symbol/iterator");
+var _reverseInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/reverse");
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
 var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/object/define-property"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/asyncToGenerator"));
+var _defineProperty3 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _react = _interopRequireDefault(require("react"));
 var _AccountIcon = _interopRequireDefault(require("@pingux/mdi-react/AccountIcon"));
 var _react2 = require("@testing-library/react");
+var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
 var _index = require("../../index");
 var _images = require("../../utils/devUtils/constants/images");
 var _testWrapper = require("../../utils/testUtils/testWrapper");
 var _universalComponentTest = require("../../utils/testUtils/universalComponentTest");
 var _PanelHeader = require("./PanelHeader");
 var _react3 = require("@emotion/react");
+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$defineProperty2; 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; }
 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) { (0, _defineProperty2["default"])(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; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var _context4, _context5; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context4 = ownKeys(Object(t), !0)).call(_context4, function (r) { (0, _defineProperty3["default"])(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context5 = ownKeys(Object(t))).call(_context5, function (r) { _Object$defineProperty2(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
 var defaultProps = {
   data: {
     text: 'testText',
@@ -78,6 +100,96 @@ describe('PanelHeader', function () {
     });
     _testWrapper.screen.getByRole('switch');
   });
+  describe('isCopyable', function () {
+    var originalClipboard = _objectSpread({}, global.navigator.clipboard);
+    beforeEach(function () {
+      var mockClipboard = {
+        writeText: jest.fn()
+      };
+      (0, _defineProperty2["default"])(window, 'navigator', {
+        value: {
+          clipboard: mockClipboard
+        },
+        configurable: true
+      });
+    });
+    afterEach(function () {
+      (0, _defineProperty2["default"])(window, 'navigator', {
+        value: {
+          clipboard: originalClipboard
+        },
+        configurable: true
+      });
+      jest.resetAllMocks();
+    });
+    test('renders copy button when isCopyable is true and subtext is present', function () {
+      (0, _testWrapper.render)((0, _react3.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, defaultProps, {
+        isCopyable: true
+      })));
+      expect(_testWrapper.screen.getByRole('button', {
+        name: 'copy to clipboard'
+      })).toBeInTheDocument();
+    });
+    test('does not render copy button when isCopyable is omitted and subtext is present', function () {
+      (0, _testWrapper.render)((0, _react3.jsx)(_index.PanelHeader, defaultProps));
+      expect(_testWrapper.screen.queryByRole('button', {
+        name: 'copy to clipboard'
+      })).not.toBeInTheDocument();
+    });
+    test('does not render copy button when isCopyable is false and subtext is present', function () {
+      (0, _testWrapper.render)((0, _react3.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, defaultProps, {
+        isCopyable: false
+      })));
+      expect(_testWrapper.screen.queryByRole('button', {
+        name: 'copy to clipboard'
+      })).not.toBeInTheDocument();
+    });
+    test('does not render copy button when isCopyable is true and subtext is absent', function () {
+      var propsWithoutSubtext = {
+        data: {
+          text: 'testText'
+        }
+      };
+      (0, _testWrapper.render)((0, _react3.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, propsWithoutSubtext, {
+        isCopyable: true
+      })));
+      expect(_testWrapper.screen.queryByRole('button', {
+        name: 'copy to clipboard'
+      })).not.toBeInTheDocument();
+    });
+    test('clicking copy button calls navigator.clipboard.writeText with the subtext value', /*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+      var copyButton;
+      return _regeneratorRuntime().wrap(function _callee2$(_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            (0, _testWrapper.render)((0, _react3.jsx)(_index.PanelHeader, (0, _extends2["default"])({}, defaultProps, {
+              isCopyable: true
+            })));
+            copyButton = _testWrapper.screen.getByRole('button', {
+              name: 'copy to clipboard'
+            });
+            _context3.next = 4;
+            return (0, _react2.act)(/*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+              return _regeneratorRuntime().wrap(function _callee$(_context2) {
+                while (1) switch (_context2.prev = _context2.next) {
+                  case 0:
+                    return _context2.abrupt("return", _userEvent["default"].click(copyButton));
+                  case 1:
+                  case "end":
+                    return _context2.stop();
+                }
+              }, _callee);
+            })));
+          case 4:
+            expect(navigator.clipboard.writeText).toHaveBeenCalledTimes(1);
+            expect(navigator.clipboard.writeText).toHaveBeenCalledWith(defaultProps.data.subtext);
+          case 6:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee2);
+    })));
+  });
 });
 test('renders icon if both icon and image are passed', function () {
   getComponent();

package/lib/cjs/components/PanelHeader/stories/OnyxPanelHeaderComponent.js

@@ -71,6 +71,14 @@ var PanelHeaderComponent = function PanelHeaderComponent() {
       rightOfData: breadcrumbs
     }
   }, (0, _react2.jsx)(_.PanelHeaderCloseButton, null)), (0, _react2.jsx)(_.PanelHeader, {
+    isCopyable: true,
+    data: {
+      icon: _AccountIcon["default"],
+      subtext: 'rad_developer@pingidentity.com',
+      text: 'Fons Vernall',
+      avatarDefaultText: 'FV'
+    }
+  }), (0, _react2.jsx)(_.PanelHeader, {
     data: {
       avatarDefaultText: 'FV',
       icon: _AccountIcon["default"],

package/lib/cjs/components/Table/Table.mdx

@@ -5,10 +5,9 @@ import * as TableStories from './Table.stories';
 
 # Table
 
-Data tables display information in a grid-like format of rows and columns. 
-They organize information in a way that’s easy to scan so that users can look for patterns and develop insights from data. 
+The `Table` component (along with `TableCaption`, `TableHead`, `TableBody`, etc.) is a drop-in replacement for HTML table elements. This means it lacks internal state and logic. **NOTE:** For most cases, it’s recommended to use `TableBase` instead.
 
-Column header names describe the type of content displayed in each column. 
+Column header names describe the type of content displayed in each column.
 Each row contains data related to a single entity.
 
 Tables should:

package/lib/cjs/components/TableBase/Convenience/TableBaseEmptyState.stories.js

@@ -0,0 +1,73 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.WithAddButton = exports.Default = exports.Customization = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _react = _interopRequireDefault(require("react"));
+var _storybookDocsLayout = _interopRequireDefault(require("../../../../.storybook/storybookDocsLayout"));
+var _index = require("../../../index");
+var _react2 = require("@emotion/react");
+var _default = exports["default"] = {
+  title: 'Components/TableBase/Convenience/TableBaseEmptyState',
+  component: _index.TableBaseEmptyState,
+  parameters: {
+    docs: {
+      page: function page() {
+        return (0, _react2.jsx)(_storybookDocsLayout["default"], null);
+      }
+    }
+  },
+  argTypes: {
+    headerLabel: {
+      control: {
+        type: 'text'
+      }
+    },
+    descriptionLabel: {
+      control: {
+        type: 'text'
+      }
+    },
+    addButtonLabel: {
+      control: {
+        type: 'text'
+      }
+    },
+    defaultIcon: {
+      control: false
+    }
+  },
+  args: {
+    headerLabel: 'No items exist',
+    descriptionLabel: 'Take action by doing x, y, z'
+  }
+};
+var Default = exports.Default = function Default(args) {
+  return (0, _react2.jsx)(_index.TableBaseEmptyState, args);
+};
+var WithAddButton = exports.WithAddButton = function WithAddButton(args) {
+  return (0, _react2.jsx)(_index.TableBaseEmptyState, (0, _extends2["default"])({}, args, {
+    addButtonLabel: "Add Item"
+  }));
+};
+var Customization = exports.Customization = function Customization() {
+  return (0, _react2.jsx)(_index.Box, {
+    isRow: false,
+    gap: "xl"
+  }, (0, _react2.jsx)(_index.TableBaseEmptyState, {
+    headerLabel: "No users found",
+    descriptionLabel: "Add your first user to get started.",
+    addButtonLabel: "New User"
+  }), (0, _react2.jsx)(_index.TableBaseEmptyState, {
+    headerLabel: "No results",
+    descriptionLabel: "Try adjusting your search or filters."
+  }), (0, _react2.jsx)(_index.TableBaseEmptyState, {
+    headerLabel: "Nothing here yet",
+    descriptionLabel: "Create a new entry to see it listed here.",
+    addButtonLabel: "Create Entry"
+  }));
+};

package/lib/cjs/components/TableBase/Customization/CustomEmptyState.stories.js

@@ -0,0 +1,62 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.CustomEmptyState = void 0;
+var _storybookDocsLayout = _interopRequireDefault(require("../../../../.storybook/storybookDocsLayout"));
+var _index = require("../../../index");
+var _react = require("@emotion/react");
+var _default = exports["default"] = {
+  title: 'Components/TableBase/Customization',
+  component: _index.TableBase,
+  parameters: {
+    docs: {
+      page: function page() {
+        return (0, _react.jsx)(_storybookDocsLayout["default"], null);
+      }
+    }
+  }
+};
+var headers = [{
+  key: 'name',
+  name: 'Name'
+}, {
+  key: 'email',
+  name: 'Email'
+}, {
+  key: 'status',
+  name: 'Status'
+}];
+var CustomEmptyState = exports.CustomEmptyState = function CustomEmptyState() {
+  return (0, _react.jsx)(_index.Card, {
+    variant: "cards.tableWrapper"
+  }, (0, _react.jsx)(_index.TableBase, {
+    caption: "Custom empty state",
+    "aria-label": "table with custom empty state",
+    renderEmptyState: function renderEmptyState() {
+      return (0, _react.jsx)(_index.TableBaseEmptyState, {
+        headerLabel: "No resources found",
+        descriptionLabel: "Try adjusting your search or filters.",
+        addButtonLabel: "Add Resource"
+      });
+    }
+  }, (0, _react.jsx)(_index.THead, {
+    columns: headers
+  }, function (column) {
+    return (0, _react.jsx)(_index.Column, {
+      key: column.key,
+      minWidth: 200
+    }, column.name);
+  }), (0, _react.jsx)(_index.TBody, {
+    items: []
+  }, function () {
+    return (0, _react.jsx)(_index.Row, {
+      key: "unused"
+    }, function () {
+      return (0, _react.jsx)(_index.Cell, null, (0, _react.jsx)(_index.Text, null, "-"));
+    });
+  })));
+};

package/lib/cjs/components/TableBase/TableBase.js

@@ -15,13 +15,14 @@ _Object$defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
+var _set = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/set"));
 var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/map"));
 var _setTimeout2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/set-timeout"));
 var _map2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/map"));
 var _from = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/array/from"));
-var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/slicedToArray"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
 var _focus = require("@react-aria/focus");
@@ -32,13 +33,59 @@ var _visuallyHidden = require("@react-aria/visually-hidden");
 var _table2 = require("@react-stately/table");
 var _ = require("../..");
 var _hooks = require("../../hooks");
+var _TableBaseEmptyState = _interopRequireDefault(require("./TableBaseEmptyState"));
 var _react2 = require("@emotion/react");
-var _excluded = ["caption", "selectionMode", "selectionBehavior", "hasSelectionCheckboxes", "isStickyHeader", "className", "isLastColumnSticky", "onResizeStart", "onResize", "onResizeEnd", "onRowAction"],
-  _excluded2 = ["caption"],
-  _excluded3 = ["type", "children", "className", "isSticky"];
+var _excluded = ["children", "items", "renderEmptyState", "loadingState"],
+  _excluded2 = ["caption", "selectionMode", "selectionBehavior", "hasSelectionCheckboxes", "isStickyHeader", "className", "isLastColumnSticky", "loadingState", "renderEmptyState", "onResizeStart", "onResize", "onResizeEnd", "onRowAction"],
+  _excluded3 = ["caption"],
+  _excluded4 = ["type", "children", "className", "isSticky"]; // Strips react-stately collection props that must not reach the DOM tbody element.
 function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 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 _context5, _context6; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context5 = ownKeys(Object(t), !0)).call(_context5, function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context6 = ownKeys(Object(t))).call(_context6, function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+var omitTableBodyProps = function omitTableBodyProps(_ref) {
+  var children = _ref.children,
+    items = _ref.items,
+    renderEmptyState = _ref.renderEmptyState,
+    loadingState = _ref.loadingState,
+    rest = (0, _objectWithoutProperties2["default"])(_ref, _excluded);
+  return rest;
+};
+var LOADING_STATES = new _set["default"](['loading', 'sorting']);
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+var BoxCell = function BoxCell(props) {
+  return (0, _react2.jsx)(_.Box, (0, _extends2["default"])({
+    as: "td",
+    display: "table-cell"
+  }, props));
+};
+function LoadingOrEmptyState(_ref2) {
+  var _renderEmptyState;
+  var loadingState = _ref2.loadingState,
+    collectionSize = _ref2.collectionSize,
+    colSpan = _ref2.colSpan,
+    renderEmptyState = _ref2.renderEmptyState;
+  if (collectionSize > 0) return null;
+  if (loadingState && LOADING_STATES.has(loadingState)) {
+    return (0, _react2.jsx)(_.Box, {
+      as: "tr",
+      display: "table-row"
+    }, (0, _react2.jsx)(BoxCell, {
+      colSpan: colSpan
+    }, (0, _react2.jsx)(_.Loader, {
+      variant: "loader.withinDataTable"
+    })));
+  }
+  return (0, _react2.jsx)(_.Box, {
+    as: "tr",
+    display: "table-row"
+  }, (0, _react2.jsx)(BoxCell, {
+    colSpan: colSpan,
+    sx: {
+      textAlign: 'center'
+    }
+  }, (_renderEmptyState = renderEmptyState === null || renderEmptyState === void 0 ? void 0 : renderEmptyState()) !== null && _renderEmptyState !== void 0 ? _renderEmptyState : (0, _react2.jsx)(_TableBaseEmptyState["default"], null)));
+}
 var useHandleFocusRef = function useHandleFocusRef(ref) {
   _react["default"].useEffect(function () {
     var el = ref.current;
@@ -68,11 +115,13 @@ var TableBase = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
     isStickyHeader = _props$isStickyHeader === void 0 ? false : _props$isStickyHeader,
     className = props.className,
     isLastColumnSticky = props.isLastColumnSticky,
+    loadingState = props.loadingState,
+    renderEmptyState = props.renderEmptyState,
     onResizeStart = props.onResizeStart,
     onResize = props.onResize,
     onResizeEnd = props.onResizeEnd,
     onRowAction = props.onRowAction,
-    others = (0, _objectWithoutProperties2["default"])(props, _excluded);
+    others = (0, _objectWithoutProperties2["default"])(props, _excluded2);
   var tableRef = (0, _hooks.useLocalOrForwardRef)(ref);
   var headerRef = (0, _react.useRef)(null);
   var scrollRef = (0, _react.useRef)(null);
@@ -231,18 +280,12 @@ var TableBase = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
   })), (0, _react2.jsx)(TableRowGroup, (0, _extends2["default"])({
     ref: bodyRef,
     type: "tbody"
-  }, collection.body.props), collection.size === 0 && (0, _react2.jsx)(_.Box, {
-    as: "tr",
-    role: "row",
-    key: "loading",
-    "data-testid": "loading",
-    alignItems: "center",
-    justifyContent: "center",
-    px: "lg",
-    py: "md"
-  }, (0, _react2.jsx)(_.Loader, {
-    variant: "loader.withinDataTable"
-  })), (0, _map2["default"])(_context3 = (0, _from["default"])(collection.body.childNodes)).call(_context3, function (row) {
+  }, omitTableBodyProps(collection.body.props)), (0, _react2.jsx)(LoadingOrEmptyState, {
+    loadingState: loadingState,
+    collectionSize: collection.size,
+    colSpan: collection.columns.length,
+    renderEmptyState: renderEmptyState
+  }), (0, _map2["default"])(_context3 = (0, _from["default"])(collection.body.childNodes)).call(_context3, function (row) {
     var _context4, _collection$getChildr, _collection$getChildr2;
     return (0, _react2.jsx)(TableRow, {
       key: row.key,
@@ -271,7 +314,7 @@ var TableBase = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
 });
 var TableCaption = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
   var caption = props.caption,
-    others = (0, _objectWithoutProperties2["default"])(props, _excluded2);
+    others = (0, _objectWithoutProperties2["default"])(props, _excluded3);
   if (!caption) {
     return null;
   }
@@ -288,7 +331,7 @@ var TableRowGroup = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
     children = props.children,
     className = props.className,
     isSticky = props.isSticky,
-    others = (0, _objectWithoutProperties2["default"])(props, _excluded3);
+    others = (0, _objectWithoutProperties2["default"])(props, _excluded4);
   var _useTableRowGroup = (0, _table.useTableRowGroup)(),
     rowGroupProps = _useTableRowGroup.rowGroupProps;
   var _useStatusClasses2 = (0, _hooks.useStatusClasses)(className, {