@spaced-out/ui-design-system 0.1.66 → 0.1.68

package/lib/components/Table/Table.docs.js.flow

@@ -0,0 +1,476 @@
+export const TABLE_DOCS = {
+  argTypes: {
+    headers: {
+      type: {required: true},
+      description:
+        'Provide an array of objects to render the header, each object should consist of label(*), key(*), sortable, sticky and render function',
+      control: {
+        type: 'object',
+      },
+      table: {
+        type: {
+          summary:
+            '{label: React.Node, key: $Keys<T>, className?: string, filterIcon?: React.Node, filtered?: boolean, subtext?: string, sortable?: boolean, headerIconClassName?: string, sticky?: boolean, render?: React.ComponentType<{data: T, extras?: U, className?: string, selected?: boolean,}>, }',
+        },
+      },
+    },
+    entries: {
+      type: {required: true},
+      description:
+        'Provide an array of object. Each object belong on one row in the table. Each object should have id and all the keys with values that is being passed in headers array',
+      control: {
+        type: 'object',
+      },
+      table: {
+        type: {
+          summary: 'Array<T>',
+        },
+      },
+    },
+    classNames: {
+      description:
+        'Provide optional classNames to be applied to the wrapper, table, tableHeader, tableBody, tableRow, or checkbox',
+      control: {
+        type: 'object',
+      },
+      table: {
+        type: {
+          summary:
+            '{wrapper?: string, table?: string, tableHeader?: string, tableBody?: string, tableRow?: string, checkbox?: string}',
+        },
+      },
+    },
+    Row: {
+      description: 'Custom Row component to be passed to table',
+      table: {
+        type: {summary: 'TableRow<T, U>'},
+      },
+    },
+    sortable: {
+      description:
+        'Sort Icon will appear in right side of column\'s header with column level true sortable value',
+      name: 'sortable',
+      options: [false, true],
+      control: 'boolean',
+      table: {
+        type: {summary: 'boolean'},
+        defaultValue: {summary: true},
+      },
+    },
+    showHeader: {
+      description: 'Show or hide header',
+      options: [false, true],
+      control: 'boolean',
+      table: {
+        type: {summary: 'boolean'},
+        defaultValue: {summary: true},
+      },
+    },
+    defaultSortKey: {
+      description:
+        'key name for which table should be sorted by default. headers array should have sortable true for that key object',
+      control: {
+        type: 'text',
+      },
+      table: {
+        type: {summary: 'string'},
+      },
+    },
+    // defaultSortDirection?: 'asc' | 'desc' | 'original',
+    defaultSortDirection: {
+      description: 'default sorting direction for the defaultSortKey column',
+
+      control: {
+        type: 'text',
+      },
+      table: {
+        type: {summary: '\'asc\' | \'desc\' | \'original\''},
+      },
+    },
+    selectedKeys: {
+      description:
+        'array of keys which are selected. This prop is also used to decide weather to show checkboxes or not. So, pass an empty array incase no row is selected.',
+      control: {
+        type: 'object',
+      },
+      table: {
+        type: {summary: 'string[]'},
+      },
+    },
+    //onSelect?: (keys: string[]) => mixed
+    onSelect: {
+      description: 'callback function when any row is selected',
+      action: 'selected',
+      type: {summary: '(keys: string[]) => mixed'},
+    },
+    idName: {
+      description: 'name of key in row objects that has to be used as id',
+    },
+    //onSort?: (key: $Keys<T>
+    onSort: {
+      description: 'callback function when any table is sorted',
+      action: 'sorted',
+      type: {summary: '(key: $Keys<T>, direction: SortDirection) => void'},
+    },
+    isLoading: {
+      description:
+        'to wait for data to populate in table and show loading state when entries array is empty.',
+      options: [false, true],
+      control: 'boolean',
+      table: {
+        type: {summary: 'boolean'},
+        defaultValue: {summary: false},
+      },
+    },
+    emptyText: {
+      description: 'Provide component to be shown in case of empty data',
+      table: {
+        type: {summary: 'React.Component'},
+      },
+    },
+    customLoader: {
+      description:
+        'Provide optional component to be shown in case of loading state. It will override the default loader.',
+      table: {
+        type: {summary: 'React.Component'},
+      },
+    },
+    disabled: {
+      description: 'disable all the checkboxes of each row in the table',
+      options: [false, true],
+      control: 'boolean',
+      table: {
+        type: {summary: 'boolean'},
+        defaultValue: {summary: false},
+      },
+    },
+    borderRadius: {
+      description:
+        'Border Radius of all four corners of the table. Default value is borderRadiusMedium i.e., 12px.',
+      control: 'text',
+      table: {
+        type: {summary: 'string'},
+        defaultValue: {summary: '12px'},
+      },
+    },
+    stickyHeader: {
+      description:
+        'Sticky header will stick the header to the top of the table when scrolling. This would only work if the table wrapper is scrollable.',
+      control: 'boolean',
+      table: {
+        type: {summary: 'boolean'},
+        defaultValue: {summary: false},
+      },
+    },
+  },
+  parameters: {
+    componentSubtitle: 'Generates a Table component.',
+    docs: {
+      description: {
+        component: `
+\`\`\`js
+import {
+  Table,
+  StaticTable,
+  DefaultRow,
+  BasicSingleCell,
+  DateCell,
+  DoubleCell,
+  SingleCell,
+  MonogramCell,
+  TableActionBar,
+  ButtonCta,
+  DropdownCta,
+  TableTopBar,
+  TableBottomBar
+} from "@spaced-out/ui-design-system/lib/components/Table";
+\`\`\`
+Table component internally uses HTML Table, Thead, Tbody, Tr, Th and Td tags. It accepts entries and headers for showing table.
+The Table component takes care of lots of things for you but it's not a magical component, it wraps a lot of behavior, so you can have,
+for instance, a static table with no sorting options.
+
+StaticTables work just like regular tables, except they don't have interactive headers, so you lose sorting.
+But remember, a regular interactive table uses a static table under the hood,
+so how does it work? You can think of the StaticTable as a kind of controlled table component.
+except that traditionally we'd update the entries prop and rerender from that.
+That would work just fine, but instead we can just pass in the keys we care about. By using StaticTable,
+we can simplify filtering and sorting outside of the table while the table keeps a stable value reference to all the entities.
+
+To make any of rows selectable, we can do that by also passing in another property, selectedKeys.
+
+Let's say we want to also make any of the rows selectable, we can do that by also passing in another property, selectedKeys.
+
+### Custom Cells
+
+It's possible you need to render out a custom cell, not just the default cell.
+There are two ways to do that. If you only need to modify a single cell,
+you can simply add a render: \`React.ComponentType<{data: T, extras?: U}>\`
+key to any given header item.
+
+This cell renderer receives the _whole row_ of data, not just the individual cell, it's up to you what to do with it.
+
+### With Table Top, Bottom Bar and Actions
+
+You can attach a top, bottom and action bar to the table by adding \`TableTopBar\`, \`TableBottomBar\` and \`TableActionBar\` components.
+There are just semantic components which just provide padding and border standardization. You can add any component inside these components.
+These also accept **className** prop.
+
+### Best Practices
+* A Data Table should always have a \`TableTopBar\`
+* Use \`stickyHeader\` prop to make the header sticky
+* Always assign a height to the table wrapper to make it scrollable
+* Manage the Table's Wrapper height effectively when using \`TableActionBar\` component
+* Always use local \`ButtonCta\` and \`DropdownCta\` for actions in Action bar. These components are
+just CSS Wrappers for Button and SimpleButtonDropdown components
+* Use ButtonCta component to add a button CTA in the \`TableActionBar\`
+* Use DropdownCta component to add a dropdown CTA button in the \`TableActionBar\` for screen width less than size1280(1280px)
+
+\`\`\`jsx
+<Table
+  headers={TABLE_HEADERS}
+  entries={TABLE_DATA}
+  stickyHeader={true}
+  classNames={{
+    wrapper: classify(css.tableWrapper, {
+      [css.withActionBar]: getNumberOfEntriesSelected() > 0,
+    })
+  }}
+/>
+\`\`\`
+
+\`\`\`css
+.tableWrapper {
+  height: calc(sizeFullViewportHeight - size160);
+}
+
+.tableWrapper.withActionBar {
+  height: calc((sizeFullViewportHeight - size160) - actionBarHeight);
+}
+\`\`\`
+
+### Usage
+
+\`\`\`jsx
+const TABLE_HEADERS = [
+  { label: "Name", key: "name", sortable: true, className: css.mediumColumn },
+  { label: "Tel", key: "phone", sortable: true, className: css.mediumColumn },
+];
+
+const TABLE_DATA = [
+  {
+    id: "1",
+    name: "Alice",
+    phone: "123-456-7890",
+  },
+  {
+    id: "2",
+    name: "Bob",
+    phone: "987-654-3210",
+  },
+];
+
+export const _TableExample = (): React.Node => {
+  return (
+    <div className={css.container}>
+      {/* Top Bar with Filters */}
+      <TableTopBar>
+        <div className={css.left}>
+          <SubTitleMedium className={css.title}>Basic Data Table</SubTitleMedium>
+          <SearchInput />
+        </div>
+      </TableTopBar>
+
+      {/* Table */}
+      <Table
+        headers={TABLE_HEADERS}
+        entries={TABLE_DATA}
+        isLoading={isLoading}
+        stickyHeader={true}
+        borderRadius={'0'}
+        selectedKeys={staticTableKeysAcrossPages[currPage] || []}
+        onSelect={(keys) => {
+          setSelectAllEntries(false);
+          setStaticTableKeysAcrossPages({
+            ...staticTableKeysAcrossPages,
+            [currPage]: keys,
+          });
+        }}
+        classNames={{
+          wrapper: classify(css.tableWrapper, {
+            [css.withActionBar]: getNumberOfEntriesSelected() > 0,
+          })
+        }}
+      />
+
+      {/* Table Actions */}
+      {getNumberOfEntriesSelected() > 0 && (
+        <TableActionBar className={css.actionBar}>
+          <div className={css.leftActionSlot}>
+            <ButtonCta
+              onClick={() => {
+                setSelectAllEntries(true);
+                setStaticTableKeysAcrossPages({
+                  ...staticTableKeysAcrossPages,
+                  [currPage]: tableEntries.map((entry) => entry.id),
+                });
+              }}
+            >
+              Select all items
+            </ButtonCta>
+            {getNumberOfEntriesSelected() > 0 && (
+              <BodySmall color="inversePrimary">
+                {getNumberOfEntriesSelected() entries selected}
+              </BodySmall>
+            )}
+          </div>
+          <div className={classify(css.middleActionSlot, css.fullTable)}>
+            <ButtonCta size="small" iconLeftName="folder-plus">
+              Add to group
+            </ButtonCta>
+          </div>
+          <div className={classify(css.middleActionSlot, css.smallTable)}>
+            <ButtonCta size="small" iconLeftName="folder-plus">
+              Add to group
+            </ButtonCta>
+            <DropdownCta
+              ariaLabel="Icon Button Dropdown"
+              iconLeftName="ellipsis"
+              options={[
+                {
+                  iconLeft: 'layer-plus',
+                  key: '1',
+                  label: 'Create group',
+                },
+              ]}
+              selectedKeys={selectedKeys}
+              onOptionSelect={() => setSelectedKeys([])}
+              size="small"
+            />
+          </div>
+          <div className={css.rightActionSlot}>
+            <ButtonCta
+              iconLeftName="close"
+              onClick={() => {
+                setSelectAllEntries(false);
+                setStaticTableKeysAcrossPages({});
+              }}
+            >
+              Close
+            </ButtonCta>
+          </div>
+        </TableActionBar>
+      )}
+
+      {/* Bottom Bar with Pagination */}
+      <TableBottomBar>
+        <Pagination
+          currentPage={currPage}
+          totalPages={totalPages}
+          onChange={(page) => {
+            onMove(page || 1);
+          }}
+        >
+          <SubTitleExtraSmall color="secondary">
+            Showing page {currPage} of {totalPages}
+          </SubTitleExtraSmall>
+        </Pagination>
+      </TableBottomBar>
+    </div>
+  );
+};
+\`\`\`
+
+\`\`\`css
+@value actionBarHeight: size50;
+
+.container {
+  width: sizeFluid;
+}
+
+.left {
+  display: flex;
+  align-items: center;
+}
+
+.title {
+  margin-right: spaceMedium;
+}
+
+.mediumColumn {
+  width: calc(sizeFluid / 5);
+}
+
+.tableWrapper {
+  height: calc(sizeFullViewportHeight - size160);
+}
+
+.actionBar {
+  display: flex;
+  align-items: center;
+  gap: spaceXSmall;
+}
+
+.tableWrapper.withActionBar {
+  height: calc((sizeFullViewportHeight - size160) - actionBarHeight);
+}
+
+.leftActionSlot,
+.rightActionSlot,
+.middleActionSlot {
+  display: flex;
+  gap: spaceSmall;
+  align-items: center;
+}
+
+.leftActionSlot,
+.rightActionSlot {
+  width: calc(sizeFluid / 4);
+}
+
+.leftActionSlot {
+  justify-content: flex-start;
+}
+
+.middleActionSlot {
+  width: calc(sizeFluid / 2);
+  justify-content: center;
+  gap: spaceXXSmall;
+}
+
+.rightActionSlot {
+  justify-content: flex-end;
+}
+
+.smallTable {
+  display: none;
+}
+
+@media only screen and (max-width: size1280) {
+  .fullTable {
+    display: none;
+  }
+
+  .smallTable {
+    display: flex;
+  }
+}
+
+.dangerText {
+  color: colorTextDanger;
+}
+
+.dangerText:hover,
+.dangerText:active,
+.dangerText:focus {
+  color: colorTextDanger;
+}
+
+\`\`\`
+        `,
+      },
+    },
+    storySource: {
+      componentPath: '/src/components/Table/Table.js',
+    },
+  },
+};

package/lib/components/Table/TableActionBar.js

@@ -3,20 +3,54 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TableActionBar = void 0;
+exports.TableActionBar = exports.DropdownCta = exports.ButtonCta = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _classify = require("../../utils/classify");
+var _Button = require("../Button");
+var _ButtonDropdown = require("../ButtonDropdown");
 var _TableBarModule = _interopRequireDefault(require("./TableBar.module.css"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-const TableActionBar = _ref => {
+const ButtonCta = _ref => {
+  let {
+    classNames,
+    ...props
+  } = _ref;
+  return /*#__PURE__*/React.createElement(_Button.Button, _extends({}, props, {
+    "data-testid": "table-action-bar-button-cta",
+    type: "primary",
+    size: "small",
+    classNames: {
+      ...classNames,
+      wrapper: _TableBarModule.default.buttonCta
+    }
+  }));
+};
+exports.ButtonCta = ButtonCta;
+const DropdownCta = _ref2 => {
+  let {
+    classNames,
+    ...props
+  } = _ref2;
+  return /*#__PURE__*/React.createElement(_ButtonDropdown.SimpleButtonDropdown, _extends({}, props, {
+    "data-testid": "table-action-bar-dropdown-cta",
+    type: "primary",
+    size: "small",
+    classNames: {
+      ...classNames,
+      buttonWrapper: _TableBarModule.default.buttonCta
+    }
+  }));
+};
+exports.DropdownCta = DropdownCta;
+const TableActionBar = _ref3 => {
   let {
     children,
     className,
     ...props
-  } = _ref;
+  } = _ref3;
   return /*#__PURE__*/React.createElement("div", _extends({}, props, {
     className: (0, _classify.classify)(_TableBarModule.default.tableActionBar, className),
     "data-testid": "table-action-bar"

package/lib/components/Table/TableActionBar.js.flow

@@ -3,6 +3,10 @@
 import * as React from 'react';
 
 import {classify} from '../../utils/classify';
+import type {ButtonProps} from '../Button';
+import {Button} from '../Button';
+import type {SimpleButtonDropdownProps} from '../ButtonDropdown';
+import {SimpleButtonDropdown} from '../ButtonDropdown';
 
 import css from './TableBar.module.css';
 
@@ -13,6 +17,29 @@ export type TableActionBarProps = {
   ...
 };
 
+export const ButtonCta = ({classNames, ...props}: ButtonProps): React.Node => (
+  <Button
+    {...props}
+    data-testid="table-action-bar-button-cta"
+    type="primary"
+    size="small"
+    classNames={{...classNames, wrapper: css.buttonCta}}
+  />
+);
+
+export const DropdownCta = ({
+  classNames,
+  ...props
+}: SimpleButtonDropdownProps): React.Node => (
+  <SimpleButtonDropdown
+    {...props}
+    data-testid="table-action-bar-dropdown-cta"
+    type="primary"
+    size="small"
+    classNames={{...classNames, buttonWrapper: css.buttonCta}}
+  />
+);
+
 export const TableActionBar = ({
   children,
   className,

package/lib/components/Table/TableBar.module.css

@@ -1,7 +1,14 @@
 @value (spaceNone, spaceXXSmall, spaceXSmall, spaceSmall, spaceMedium, spaceHalfFluid, spaceNegHalfFluid) from '../../styles/variables/_space.css';
 @value (size2, size22, size48, size50, size60, size240, size300, sizeFluid) from '../../styles/variables/_size.css';
-@value (borderRadiusMedium, borderRadiusNone) from '../../styles/variables/_border.css';
-@value (colorBackgroundTertiary, colorFillPrimary) from '../../styles/variables/_color.css';
+@value (borderRadiusMedium, borderRadiusNone, borderWidthPrimary) from '../../styles/variables/_border.css';
+@value (
+  colorBackgroundTertiary,
+  colorFillPrimary,
+  colorButtonFillTableActionEnabled,
+  colorButtonFillTableActionHovered,
+  colorButtonFillTableActionPressed,
+  colorButtonFillTableActionBorder
+) from '../../styles/variables/_color.css';
 @value (elevationMenu) from '../../styles/variables/_elevation.css';
 
 .tableBar {
@@ -39,3 +46,16 @@
   width: sizeFluid;
   padding: spaceXSmall spaceSmall spaceXSmall spaceMedium;
 }
+
+.buttonCta {
+  border: borderWidthPrimary solid colorButtonFillTableActionBorder;
+  background-color: colorButtonFillTableActionEnabled;
+}
+
+.buttonCta:hover {
+  background-color: colorButtonFillTableActionHovered;
+}
+
+.buttonCta:active {
+  background-color: colorButtonFillTableActionPressed;
+}

package/lib/components/Tooltip/Tooltip.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.Tooltip = exports.DELAY_MOTION_DURATION_TYPES = void 0;
+exports.Tooltip = exports.ELEVATION_TYPES = exports.DELAY_MOTION_DURATION_TYPES = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _react2 = require("@floating-ui/react");
 var ELEVATION = _interopRequireWildcard(require("../../styles/variables/_elevation"));
@@ -26,6 +26,20 @@ const DELAY_MOTION_DURATION_TYPES = Object.freeze({
   slowest: 'slowest'
 });
 exports.DELAY_MOTION_DURATION_TYPES = DELAY_MOTION_DURATION_TYPES;
+const ELEVATION_TYPES = Object.freeze({
+  none: 'none',
+  card: 'card',
+  tooltip: 'tooltip',
+  menu: 'menu',
+  backdrop: 'backdrop',
+  modal: 'modal',
+  toast: 'toast'
+});
+exports.ELEVATION_TYPES = ELEVATION_TYPES;
+const getElevationValue = elevation => {
+  const elevationKey = 'elevation' + (0, _string.capitalize)(elevation);
+  return ELEVATION[elevationKey] || elevation;
+};
 const Tooltip = _ref => {
   let {
     classNames,
@@ -36,7 +50,7 @@ const Tooltip = _ref => {
     bodyMaxLines = 2,
     titleMaxLines = 1,
     delayMotionDuration = 'none',
-    elevation = ELEVATION['elevationTooltip'],
+    elevation = 'tooltip',
     hidden
   } = _ref;
   const [isOpen, setIsOpen] = React.useState(false);
@@ -80,7 +94,7 @@ const Tooltip = _ref => {
     style: {
       position: strategy,
       ...floatingStyles,
-      '--tooltip-elevation': elevation
+      '--tooltip-elevation': getElevationValue(elevation)
     }
   }, getFloatingProps()), !!title && /*#__PURE__*/React.createElement(_Truncate.Truncate, {
     line: titleMaxLines,

package/lib/components/Tooltip/Tooltip.js.flow

@@ -53,6 +53,18 @@ export type DelayMotionDurationType = $Values<
   typeof DELAY_MOTION_DURATION_TYPES,
 >;
 
+export const ELEVATION_TYPES = Object.freeze({
+  none: 'none',
+  card: 'card',
+  tooltip: 'tooltip',
+  menu: 'menu',
+  backdrop: 'backdrop',
+  modal: 'modal',
+  toast: 'toast',
+});
+
+export type ElevationType = $Values<typeof ELEVATION_TYPES>;
+
 export type PlacementType =
   | 'top'
   | 'top-start'
@@ -82,6 +94,11 @@ export type TooltipProps = {
   children: any,
 };
 
+const getElevationValue = (elevation: string): string => {
+  const elevationKey = 'elevation' + capitalize(elevation);
+  return ELEVATION[elevationKey] || elevation;
+};
+
 export const Tooltip = ({
   classNames,
   children,
@@ -91,7 +108,7 @@ export const Tooltip = ({
   bodyMaxLines = 2,
   titleMaxLines = 1,
   delayMotionDuration = 'none',
-  elevation = ELEVATION['elevationTooltip'],
+  elevation = 'tooltip',
   hidden,
 }: TooltipProps): React.Node => {
   const [isOpen, setIsOpen] = React.useState(false);
@@ -151,7 +168,7 @@ export const Tooltip = ({
                 style={{
                   position: strategy,
                   ...floatingStyles,
-                  '--tooltip-elevation': elevation,
+                  '--tooltip-elevation': getElevationValue(elevation),
                 }}
                 {...getFloatingProps()}
               >