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

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, {

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

@@ -1,6 +1,13 @@
 "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");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+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 _Symbol = require("@babel/runtime-corejs3/core-js-stable/symbol");
 var _Object$create = require("@babel/runtime-corejs3/core-js-stable/object/create");
@@ -12,12 +19,11 @@ 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 _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
-var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
 var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = exports.WithStickyHeader = exports.WithResizableColumns = exports.WithPagination = exports.WithMinMaxColumnWidth = exports.WithLastColumnSticky = exports.RowActions = exports.MultiSelection = exports.DynamicWithSorting = exports.Default = void 0;
+exports["default"] = exports.WithStickyHeader = exports.WithResizableColumns = exports.WithPagination = exports.WithMinMaxColumnWidth = exports.WithLoadingState = exports.WithLastColumnSticky = exports.WithEmptyState = exports.RowActions = exports.MultiSelection = exports.DynamicWithSorting = exports.DefaultEmptyStateWithButton = exports.DefaultEmptyState = exports.Default = void 0;
 var _set = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/set"));
 var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
 var _slice = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/slice"));
@@ -27,6 +33,7 @@ var _sort = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stabl
 var _find = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/find"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/asyncToGenerator"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/slicedToArray"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
 var _react = _interopRequireWildcard(require("react"));
 var _i18n = require("@react-aria/i18n");
 var _data = require("@react-stately/data");
@@ -47,17 +54,20 @@ function _regeneratorAsyncIterator(t, e) { function n(r, o, i, f) { try { var c
 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; }
+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 _default = exports["default"] = {
   title: 'Components/TableBase',
   component: _.TableBase,
+  argTypes: _tableBaseAttributes.tableBaseArgTypes,
+  args: _objectSpread({}, _tableBaseAttributes.tableBaseArgs),
   parameters: {
     docs: {
       page: function page() {
         return (0, _react2.jsx)(_react["default"].Fragment, null, (0, _react2.jsx)(_TableBase["default"], null), (0, _react2.jsx)(_storybookDocsLayout["default"], null));
       }
     }
-  },
-  argTypes: _tableBaseAttributes.tableBaseArgTypes
+  }
 };
 var headers = [{
   key: 'type',
@@ -98,28 +108,28 @@ var statusVariant = {
   Active: 'tableBaseBadge.healthy',
   Inactive: 'tableBaseBadge.secondary'
 };
-var Default = exports.Default = function Default() {
-  return (0, _react2.jsx)(_.Card, {
-    variant: "cards.tableWrapper"
-  }, (0, _react2.jsx)(_.TableBase, {
-    caption: "Lorem ipsum",
-    "aria-label": "table"
-  }, (0, _react2.jsx)(_.THead, {
-    columns: headers
-  }, function (column) {
-    return (0, _react2.jsx)(_.Column, {
-      key: column.key,
-      minWidth: 200
-    }, column.name);
-  }), (0, _react2.jsx)(_.TBody, {
-    items: objects
-  }, function (item) {
-    return (0, _react2.jsx)(_.Row, {
-      key: item.id
-    }, function (columnKey) {
-      return (0, _react2.jsx)(_.Cell, null, item[columnKey]);
-    });
-  })));
+var Default = exports.Default = {
+  render: function render(args) {
+    var isEmpty = args.loadingState === 'loading' || args.loadingState === 'sorting';
+    return (0, _react2.jsx)(_.Card, {
+      variant: "cards.tableWrapper"
+    }, (0, _react2.jsx)(_.TableBase, args, (0, _react2.jsx)(_.THead, {
+      columns: headers
+    }, function (column) {
+      return (0, _react2.jsx)(_.Column, {
+        key: column.key,
+        minWidth: 200
+      }, column.name);
+    }), (0, _react2.jsx)(_.TBody, {
+      items: isEmpty ? [] : objects
+    }, function (item) {
+      return (0, _react2.jsx)(_.Row, {
+        key: item.id
+      }, function (columnKey) {
+        return (0, _react2.jsx)(_.Cell, null, item[columnKey]);
+      });
+    })));
+  }
 };
 var MultiSelection = exports.MultiSelection = function MultiSelection() {
   var _React$useState = _react["default"].useState(new _set["default"](['1', '3'])),
@@ -471,6 +481,114 @@ var WithLastColumnSticky = exports.WithLastColumnSticky = function WithLastColum
     });
   })));
 };
+var WithLoadingState = exports.WithLoadingState = function WithLoadingState() {
+  return (0, _react2.jsx)(_.Card, {
+    variant: "cards.tableWrapper"
+  }, (0, _react2.jsx)(_.TableBase, {
+    caption: "Lorem ipsum",
+    "aria-label": "table",
+    loadingState: "loading"
+  }, (0, _react2.jsx)(_.THead, {
+    columns: headers
+  }, function (column) {
+    return (0, _react2.jsx)(_.Column, {
+      key: column.key,
+      minWidth: 200
+    }, column.name);
+  }), (0, _react2.jsx)(_.TBody, {
+    items: []
+  }, function () {
+    return (0, _react2.jsx)(_.Row, {
+      key: "unused"
+    }, function () {
+      return (0, _react2.jsx)(_.Cell, null, "Hello 0");
+    });
+  })));
+};
+var WithEmptyState = exports.WithEmptyState = function WithEmptyState() {
+  return (0, _react2.jsx)(_.Card, {
+    variant: "cards.tableWrapper"
+  }, (0, _react2.jsx)(_.TableBase, {
+    caption: "Custom empty state",
+    "aria-label": "table with custom empty state",
+    renderEmptyState: function renderEmptyState() {
+      return (0, _react2.jsx)("div", null, "No data available");
+    }
+  }, (0, _react2.jsx)(_.THead, {
+    columns: headers
+  }, function (column) {
+    return (0, _react2.jsx)(_.Column, {
+      key: column.key,
+      minWidth: 200
+    }, column.name);
+  }), (0, _react2.jsx)(_.TBody, {
+    items: []
+  }, function () {
+    return (0, _react2.jsx)(_.Row, {
+      key: "unused"
+    }, function () {
+      return (0, _react2.jsx)(_.Cell, null, "Hello 2");
+    });
+  })));
+};
+var DefaultEmptyState = exports.DefaultEmptyState = function DefaultEmptyState() {
+  return (0, _react2.jsx)(_.Card, {
+    variant: "cards.tableWrapper"
+  }, (0, _react2.jsx)(_.TableBase, {
+    caption: "Default empty state",
+    "aria-label": "table with default empty state"
+  }, (0, _react2.jsx)(_.THead, {
+    columns: headers
+  }, function (column) {
+    return (0, _react2.jsx)(_.Column, {
+      key: column.key,
+      minWidth: 200
+    }, column.name);
+  }), (0, _react2.jsx)(_.TBody, {
+    items: []
+  }, function () {
+    return (0, _react2.jsx)(_.Row, {
+      key: "unused"
+    }, function () {
+      return (0, _react2.jsx)(_.Cell, null, "Hello 1");
+    });
+  })));
+};
+var DefaultEmptyStateWithButton = exports.DefaultEmptyStateWithButton = function DefaultEmptyStateWithButton() {
+  var handleAddItem = function handleAddItem() {
+    // eslint-disable-next-line no-console
+    console.log('Add button clicked!');
+  };
+  return (0, _react2.jsx)(_.Card, {
+    variant: "cards.tableWrapper"
+  }, (0, _react2.jsx)(_.TableBase, {
+    caption: "Empty state with action button",
+    "aria-label": "table with empty state and action button",
+    renderEmptyState: function renderEmptyState() {
+      return (0, _react2.jsx)(_.TableBaseEmptyState, {
+        headerLabel: "No items available",
+        descriptionLabel: "Click the button below to add a new item",
+        addButtonLabel: "Add Item",
+        onAddButtonPress: handleAddItem
+      });
+    }
+  }, (0, _react2.jsx)(_.THead, {
+    columns: headers
+  }, function (column) {
+    return (0, _react2.jsx)(_.Column, {
+      key: column.key,
+      minWidth: 200
+    }, column.name);
+  }), (0, _react2.jsx)(_.TBody, {
+    items: []
+  }, function () {
+    return (0, _react2.jsx)(_.Row, {
+      key: "unused"
+    }, function () {
+      return (0, _react2.jsx)(_.Cell, null, "Hello 3");
+    });
+  })));
+};
 var RowActions = exports.RowActions = function RowActions() {
   var _useState3 = (0, _react.useState)(null),
     _useState4 = (0, _slicedToArray2["default"])(_useState3, 2),

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

@@ -560,6 +560,101 @@ test('Arrow Left move the focus to next cell', /*#__PURE__*/(0, _asyncToGenerato
     }
   }, _callee10);
 })));
+var renderWithLoadingState = function renderWithLoadingState(loadingState) {
+  return (0, _react2.render)((0, _react3.jsx)(_TableBase["default"], {
+    "aria-label": "table",
+    loadingState: loadingState
+  }, (0, _react3.jsx)(_index.THead, {
+    columns: headers
+  }, function (head) {
+    return (0, _react3.jsx)(_index.Column, {
+      key: head.key
+    }, head.name);
+  }), (0, _react3.jsx)(_index.TBody, {
+    items: []
+  }, function () {
+    return (0, _react3.jsx)(_index.Row, null, (0, _react3.jsx)(_index.Cell, null, "A"), (0, _react3.jsx)(_index.Cell, null, "B"), (0, _react3.jsx)(_index.Cell, null, "C"));
+  })));
+};
+describe('Loading state', function () {
+  test('renders Loader when loadingState is "loading"', function () {
+    renderWithLoadingState('loading');
+    expect(_react2.screen.getByRole('alert')).toBeInTheDocument();
+  });
+  test('renders Loader when loadingState is "sorting"', function () {
+    renderWithLoadingState('sorting');
+    expect(_react2.screen.getByRole('alert')).toBeInTheDocument();
+  });
+  test('does not render Loader when loadingState is absent', function () {
+    renderWithLoadingState();
+    expect(_react2.screen.queryByRole('alert')).not.toBeInTheDocument();
+  });
+  test('does not render Loader when loadingState is "loadingMore", renders empty state instead (Constraint #6)', function () {
+    renderWithLoadingState('loadingMore');
+    expect(_react2.screen.queryByRole('alert')).not.toBeInTheDocument();
+    expect(_react2.screen.getByText('No items exist')).toBeInTheDocument();
+  });
+});
+describe('Empty state', function () {
+  test('renders default empty state when items is empty and no loadingState', function () {
+    (0, _react2.render)((0, _react3.jsx)(_TableBase["default"], {
+      "aria-label": "table"
+    }, (0, _react3.jsx)(_index.THead, {
+      columns: headers
+    }, function (head) {
+      return (0, _react3.jsx)(_index.Column, {
+        key: head.key
+      }, head.name);
+    }), (0, _react3.jsx)(_index.TBody, {
+      items: []
+    }, function () {
+      return (0, _react3.jsx)(_index.Row, null, (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null));
+    })));
+    expect(_react2.screen.getByText('No items exist')).toBeInTheDocument();
+  });
+  test('renders custom renderEmptyState and not default empty state', function () {
+    (0, _react2.render)((0, _react3.jsx)(_TableBase["default"], {
+      "aria-label": "table",
+      renderEmptyState: function renderEmptyState() {
+        return (0, _react3.jsx)("div", null, "Custom");
+      }
+    }, (0, _react3.jsx)(_index.THead, {
+      columns: headers
+    }, function (head) {
+      return (0, _react3.jsx)(_index.Column, {
+        key: head.key
+      }, head.name);
+    }), (0, _react3.jsx)(_index.TBody, {
+      items: []
+    }, function () {
+      return (0, _react3.jsx)(_index.Row, null, (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null));
+    })));
+    expect(_react2.screen.getByText('Custom')).toBeInTheDocument();
+    expect(_react2.screen.queryByText('No items exist')).not.toBeInTheDocument();
+  });
+  test('renders Loader and not empty state when loadingState is "loading" and items is empty', function () {
+    (0, _react2.render)((0, _react3.jsx)(_TableBase["default"], {
+      "aria-label": "table",
+      loadingState: "loading",
+      renderEmptyState: function renderEmptyState() {
+        return (0, _react3.jsx)("div", null, "Custom");
+      }
+    }, (0, _react3.jsx)(_index.THead, {
+      columns: headers
+    }, function (head) {
+      return (0, _react3.jsx)(_index.Column, {
+        key: head.key
+      }, head.name);
+    }), (0, _react3.jsx)(_index.TBody, {
+      items: []
+    }, function () {
+      return (0, _react3.jsx)(_index.Row, null, (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null), (0, _react3.jsx)(_index.Cell, null));
+    })));
+    expect(_react2.screen.getByRole('alert')).toBeInTheDocument();
+    expect(_react2.screen.queryByText('Custom')).not.toBeInTheDocument();
+    expect(_react2.screen.queryByText('No items exist')).not.toBeInTheDocument();
+  });
+});
 describe('Resizable columns', function () {
   var resizableHeaders = [{
     key: 'name',

package/lib/cjs/components/TableBase/TableBaseEmptyState.d.ts

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