@elliemae/ds-chat 2.0.0-alpha.1 → 2.0.0-alpha.13

package/esm/parts/chat-container-messages-list/ChatContainerMessagesList.js

@@ -1,41 +1,62 @@
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.filter.js';
 import _jsx from '@babel/runtime/helpers/esm/jsx';
 import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import 'core-js/modules/esnext.async-iterator.some.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.some.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import 'core-js/modules/esnext.async-iterator.map.js';
+import 'core-js/modules/esnext.iterator.map.js';
+import 'core-js/modules/esnext.async-iterator.find.js';
+import 'core-js/modules/esnext.iterator.find.js';
 import React from 'react';
 import { describe } from 'react-desc';
 import { useVirtual } from 'react-virtual';
-import DSButton from '@elliemae/ds-basic/Button';
+import DSButton from '@elliemae/ds-button';
 import { ChatBubble } from '../bubble/ChatBubble.js';
 import { BUBBLE_TYPES } from '../bubble/props.js';
 import { MessageDelimiter } from '../message-delimiter/MessageDelimiter.js';
 import { SystemMessage } from '../system-message/SystemMessage.js';
-import { StyledWrapperListItem, StyledWrapper, StyledChatContainerContentList, StyledChatContainerContentListScroll, StyledLoadMoreContainer } from './styled.js';
+import { ListItem, StyledWrapperListItem, StyledWrapper, StyledChatContainerContentList, StyledChatContainerContentListScroll, StyledLoadMoreContainer } from './styled.js';
 import { listProps, defaultProps } from './props.js';
+import { useValidateProps } from './config/useValidateProps.js';
 import { jsx } from 'react/jsx-runtime';
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
 
-const getPadding = hasMoreItems => {
+const getPadding = _ref => {
+  let {
+    hasMoreItems,
+    bannerPosition,
+    isLoading
+  } = _ref;
   const padding = {
     paddingStart: 0,
     paddingEnd: -5
   };
-  if (hasMoreItems === 'top') padding.paddingStart = 42;else if (hasMoreItems === 'bottom') padding.paddingEnd = 42;
+  if ([hasMoreItems, bannerPosition, isLoading].some(item => item === 'top')) padding.paddingStart = 42;else if ([hasMoreItems, bannerPosition, isLoading].some(item => item === 'bottom')) padding.paddingEnd = 42;
   return padding;
 };
 
 const ChatContainerMessagesList = props => {
+  useValidateProps(props, listProps);
   const {
     sendingText,
+    bannerPosition,
     sendingMessages,
     messages,
     actionRef,
     onScrollEnds,
     getMoreMessages,
     hasMoreItems,
-    isLoading
+    isLoading,
+    bannerRef
   } = props;
+  const loadMoreRef = React.useRef(null);
   const virtualListRef = React.useRef(); // estimateSize should not be really required given what was stated on
   // https://github.com/tannerlinsley/react-virtual/issues/23
 
@@ -47,33 +68,185 @@ const ChatContainerMessagesList = props => {
     size: messages.length,
     parentRef: virtualListRef,
     overscan: 15
-  }, getPadding(hasMoreItems)), {}, {
+  }, getPadding({
+    hasMoreItems,
+    bannerPosition,
+    isLoading
+  })), {}, {
     estimateSize: React.useCallback(() => 80, [])
   }));
   const onScrollStop = React.useCallback(() => {
+    var _virtualListRef$curre;
+
     const {
       bottom,
       top
-    } = virtualListRef.current.getBoundingClientRect();
+    } = (_virtualListRef$curre = virtualListRef.current) === null || _virtualListRef$curre === void 0 ? void 0 : _virtualListRef$curre.getBoundingClientRect();
     const list = virtualListRef.current.querySelectorAll('[data-element="chat-element-list-item"]');
     const indexList = [];
     list.forEach(item => {
       const {
-        top: itemTop
+        top: itemTop,
+        bottom: itemBottom
       } = item.getBoundingClientRect();
-      if (itemTop < bottom && itemTop > top) indexList.push(item.dataset.index);
+      const itemPadding = 10;
+      if (itemTop + itemPadding < bottom && itemBottom - itemPadding > top) indexList.push(item.dataset.index);
     });
     if (onScrollEnds) onScrollEnds(indexList);
     return indexList;
   }, [onScrollEnds]);
-  React.useImperativeHandle(actionRef, () => ({
-    scrollToIndex: (a, b = {
+  const onlyFocus = React.useCallback(index => {
+    setTimeout(() => {
+      virtualListRef.current.querySelector("[data-index=\"".concat(index, "\"]")).focus();
+    }, 300);
+  }, []);
+  const scrollAndFocus = React.useCallback(function (index) {
+    let b = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
       align: 'center'
-    }) => {
-      vScroll(a, b);
-    },
-    getMessagesInView: onScrollStop
-  }));
+    };
+    vScroll(index, b);
+    onlyFocus(index);
+  }, [onlyFocus, vScroll]);
+  React.useEffect(() => {
+    if (actionRef && actionRef.current) {
+      actionRef.current.scrollToIndex = function (a) {
+        let b = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+          align: 'center'
+        };
+        vScroll(a, b);
+      };
+
+      actionRef.current.getMessagesInView = onScrollStop;
+
+      actionRef.current.focusToIndex = function (a) {
+        let b = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+          align: 'center'
+        };
+        scrollAndFocus(a, b);
+      };
+
+      actionRef.current.focusToIndexWithoutScroll = onlyFocus;
+
+      actionRef.current.focusToList = a => {
+        var _virtualListRef$curre2;
+
+        (_virtualListRef$curre2 = virtualListRef.current) === null || _virtualListRef$curre2 === void 0 ? void 0 : _virtualListRef$curre2.focus();
+      };
+    }
+  }, [actionRef, onScrollStop, onlyFocus, scrollAndFocus, vScroll]);
+  const handleKey = React.useCallback(e => {
+    const {
+      key
+    } = e;
+    const index = Number(e.currentTarget.dataset.index);
+    e.stopPropagation();
+
+    switch (key) {
+      case 'ArrowUp':
+        e.preventDefault();
+        if (index > 0) virtualListRef.current.querySelector("[data-index=\"".concat(index - 1, "\"]")).focus();
+        break;
+
+      case 'ArrowDown':
+        e.preventDefault();
+
+        if (index < messages.length - 1) {
+          virtualListRef.current.querySelector("[data-index=\"".concat(index + 1, "\"]")).focus();
+        }
+
+        break;
+
+      case 'Home':
+        e.preventDefault();
+        scrollAndFocus(0);
+        break;
+
+      case 'End':
+        e.preventDefault();
+        scrollAndFocus(messages.length - 1);
+        break;
+
+      case 'Tab':
+        e.preventDefault();
+
+        if (hasMoreItems === 'bottom' && !e.shiftKey) {
+          var _loadMoreRef$current;
+
+          (_loadMoreRef$current = loadMoreRef.current) === null || _loadMoreRef$current === void 0 ? void 0 : _loadMoreRef$current.focus();
+        } else if (hasMoreItems === 'top' && e.shiftKey) {
+          var _loadMoreRef$current2;
+
+          (_loadMoreRef$current2 = loadMoreRef.current) === null || _loadMoreRef$current2 === void 0 ? void 0 : _loadMoreRef$current2.focus();
+        } else if (!e.shiftKey) {
+          if (bannerPosition) {
+            bannerRef.current.focusOnWrapper();
+          } else {
+            actionRef.current.focusToComposer();
+          }
+        } else {
+          var _virtualListRef$curre3;
+
+          (_virtualListRef$curre3 = virtualListRef.current) === null || _virtualListRef$curre3 === void 0 ? void 0 : _virtualListRef$curre3.focus();
+        }
+
+        break;
+    }
+  }, [actionRef, hasMoreItems, messages.length, bannerPosition, scrollAndFocus]);
+  const handleListKey = React.useCallback(e => {
+    const {
+      key
+    } = e;
+
+    switch (key) {
+      case 'ArrowUp':
+        e.preventDefault();
+        onlyFocus(onScrollStop().shift());
+        break;
+
+      case 'ArrowDown':
+        e.preventDefault();
+        onlyFocus(onScrollStop().pop());
+        break;
+
+      case 'Home':
+        e.preventDefault();
+        scrollAndFocus(0);
+        break;
+
+      case 'End':
+        e.preventDefault();
+        scrollAndFocus(messages.length - 1);
+        break;
+
+      case 'Tab':
+        if (document.activeElement !== loadMoreRef.current) {
+          if (hasMoreItems === 'bottom' && !e.shiftKey) {
+            var _loadMoreRef$current3;
+
+            e.preventDefault();
+            (_loadMoreRef$current3 = loadMoreRef.current) === null || _loadMoreRef$current3 === void 0 ? void 0 : _loadMoreRef$current3.focus();
+          } else if (hasMoreItems === 'top' && e.shiftKey) {
+            var _loadMoreRef$current4;
+
+            e.preventDefault();
+            (_loadMoreRef$current4 = loadMoreRef.current) === null || _loadMoreRef$current4 === void 0 ? void 0 : _loadMoreRef$current4.focus();
+          } else if (!e.shiftKey) {
+            e.preventDefault();
+            actionRef.current.focusToComposer();
+          }
+        } else if (!e.shiftKey) {
+          e.preventDefault();
+          actionRef.current.focusToComposer();
+        } else {
+          var _virtualListRef$curre4;
+
+          e.preventDefault();
+          (_virtualListRef$curre4 = virtualListRef.current) === null || _virtualListRef$curre4 === void 0 ? void 0 : _virtualListRef$curre4.focus();
+        }
+
+        break;
+    }
+  }, [actionRef, hasMoreItems, messages.length, onScrollStop, onlyFocus, scrollAndFocus]);
   React.useEffect(() => {
     let handlerCallback = null;
     const localVirtualRef = virtualListRef.current;
@@ -104,14 +277,17 @@ const ChatContainerMessagesList = props => {
       position: 'absolute',
       top: 0,
       left: 0,
-      transform: `translateY(${start}px)`,
+      transform: "translateY(".concat(start, "px)"),
       width: '100%'
     };
-    return /*#__PURE__*/jsx("div", {
+    return /*#__PURE__*/jsx(ListItem, {
       "data-element": "chat-element-list-item",
       "data-index": index,
       style: style,
       ref: measureRef,
+      tabIndex: 0,
+      onKeyDown: handleKey,
+      role: "listitem",
       children: /*#__PURE__*/_jsx(StyledWrapperListItem, {
         type: row.type
       }, void 0, row.type === BUBBLE_TYPES.SENDER || row.type === BUBBLE_TYPES.RECIPIENT ?
@@ -120,21 +296,25 @@ const ChatContainerMessagesList = props => {
       jsx(ChatBubble, _objectSpread(_objectSpread({}, row), {}, {
         helpMessage: isSending ? sendingText : row.helpMessage
       })) : null, row.type === BUBBLE_TYPES.DELIMITER ? /*#__PURE__*/jsx(MessageDelimiter, _objectSpread({}, row)) : null, row.type === BUBBLE_TYPES.SYSTEM ? /*#__PURE__*/jsx(SystemMessage, _objectSpread({}, row)) : null)
-    }, `ds-chat-bubble-${index}`);
-  }), [virtualItems, messages, sendingMessages]);
+    }, "ds-chat-bubble-".concat(index, "-").concat(row.dsId, "-").concat(row.type));
+  }), [virtualItems, messages, sendingMessages, handleKey, sendingText]);
   return /*#__PURE__*/_jsx(StyledWrapper, {}, void 0, /*#__PURE__*/jsx(StyledChatContainerContentList, {
     "data-testid": "chat-thread-container",
     tabIndex: 0,
     "aria-live": "polite",
     ref: virtualListRef,
+    role: "list",
+    onKeyDown: handleListKey,
     children: /*#__PURE__*/_jsx(StyledChatContainerContentListScroll, {
-      height: `${totalSize}px`
+      height: "".concat(totalSize, "px")
     }, void 0, render, !isLoading && hasMoreItems ? /*#__PURE__*/_jsx(StyledLoadMoreContainer, {
       hasMoreItems: hasMoreItems
     }, void 0, /*#__PURE__*/_jsx(DSButton, {
       labelText: "Load More",
       buttonType: "secondary",
-      onClick: getMoreMessages
+      onClick: getMoreMessages,
+      "data-testid": "ds-chat-load-more-btn",
+      innerRef: loadMoreRef
     })) : null)
   }));
 };

package/esm/parts/chat-container-messages-list/config/useValidateProps.js

@@ -0,0 +1,7 @@
+import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';
+
+const useValidateProps = (props, propTypes) => {
+  useValidateTypescriptPropTypes(props, propTypes);
+};
+
+export { useValidateProps };

package/esm/parts/chat-container-messages-list/props.js

@@ -7,22 +7,18 @@ const defaultProps = {
   onScrollEnds: () => [],
   getMoreMessages: noop,
   sendingMessages: undefined,
-  sendingText: 'Sending'
+  sendingText: 'Sending',
+  bannerPosition: undefined,
+  bannerRef: undefined
 };
 const listProps = {
   messages: PropTypes.arrayOf(PropTypes.object).description('The array of out-of-the-box items you want to render inside the ChatMessageList').defaultValue(defaultProps.messages),
-  actionRef: PropTypes.func.description(`Reference: 
-        { 
-          scrollToIndex: (n: number) => void,
-          getMessagesInView: () => number[],
-        }
-        
-      `).defaultValue(defaultProps.messages),
-  onScrollEnds: PropTypes.func.description(`Called when the scroll stops.`),
+  actionRef: PropTypes.object.description("Reference: \n        { \n          scrollToIndex: (n: number) => void,\n          getMessagesInView: () => number[],\n          focusToIndex: (n: number) => void,\n          focusToIndexWithoutScroll: (n: number) => void,\n          focusToList: () => void,\n          focusToComposer: () => void,\n          focusToSend: () => void,\n        }\n        \n      ").defaultValue(defaultProps.actionRef),
+  onScrollEnds: PropTypes.func.description("Called when the scroll stops."),
   isLoading: PropTypes.oneOf(['top', 'bottom', undefined]).description('Keeps the load more space while the loading is in progress'),
   hasMoreItems: PropTypes.oneOf(['top', 'bottom', undefined]).description('Show Load More button at the `top` or `bottom` of the container'),
   getMoreMessages: PropTypes.func.description('Called when the user clicks on load more').defaultValue(defaultProps.getMoreMessages),
-  sendingMessages: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.number])).description('Array of ids of sending messages').defaultValue(defaultProps.sendingMessages),
+  sendingMessages: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.string), PropTypes.arrayOf(PropTypes.number)]).description('Array of ids of sending messages').defaultValue(defaultProps.sendingMessages),
   sendingText: PropTypes.string.description('Label description for messages in sending status').defaultValue(defaultProps.sendingText)
 };
 

package/esm/parts/chat-container-messages-list/styled.js

@@ -1,8 +1,5 @@
 import styled from 'styled-components';
-import '@babel/runtime/helpers/esm/jsx';
-import 'react';
-import '@elliemae/ds-icons/WarningCircleFill';
-import '@elliemae/ds-grid';
+import '../bubble/ChatBubble.js';
 import { BUBBLE_TYPES } from '../bubble/props.js';
 
 const StyledWrapper = /*#__PURE__*/styled.div.withConfig({
@@ -11,11 +8,7 @@ const StyledWrapper = /*#__PURE__*/styled.div.withConfig({
 
 const StyledWrapperListItem = /*#__PURE__*/styled.div.withConfig({
   componentId: "sc-1jhprzr-1"
-})(["min-width:100%;", ";", ";", ";"], props => props.type === BUBBLE_TYPES.SENDER && `padding: ${props.theme.space.xxs} ${props.theme.space.xxs} 0px 13%
-  `, props => props.type === BUBBLE_TYPES.RECIPIENT && `padding: ${props.theme.space.xxs} 13% ${props.theme.space.xxs}
-    ${props.theme.space.xxs}
-  `, props => props.type === BUBBLE_TYPES.SYSTEM && `padding: ${props.theme.space.xxs} 0px
-  `);
+})(["min-width:100%;", ";", ";", ";"], props => props.type === BUBBLE_TYPES.SENDER && "padding: ".concat(props.theme.space.xxs, " ").concat(props.theme.space.xxs, " ").concat(props.theme.space.xxs, " 13%\n  "), props => props.type === BUBBLE_TYPES.RECIPIENT && "padding: ".concat(props.theme.space.xxs, " 13% ").concat(props.theme.space.xxs, "\n    ").concat(props.theme.space.xxs, "\n  "), props => props.type === BUBBLE_TYPES.SYSTEM && "padding: ".concat(props.theme.space.xxs, " 0px\n  "));
 const StyledChatContainerContentList = /*#__PURE__*/styled.div.withConfig({
   componentId: "sc-1jhprzr-2"
 })(["width:100%;height:100%;padding:", ";padding-bottom:0;overflow-y:auto;overflow-x:hidden;"], props => props.theme.space.xs);
@@ -25,5 +18,8 @@ const StyledChatContainerContentListScroll = /*#__PURE__*/styled.div.withConfig(
 const StyledLoadMoreContainer = /*#__PURE__*/styled.div.withConfig({
   componentId: "sc-1jhprzr-4"
 })(["position:absolute;width:calc(100% + ", ");padding:", ";left:-", ";right:-", ";display:grid;justify-content:center;align-items:center;", " ", ""], props => props.theme.space.xxs, props => props.theme.space.xxs, props => props.theme.space.xxs, props => props.theme.space.xxs, props => props.hasMoreItems === 'top' ? 'top: 0;' : '', props => props.hasMoreItems === 'bottom' ? 'bottom: 0;' : '');
+const ListItem = /*#__PURE__*/styled.div.withConfig({
+  componentId: "sc-1jhprzr-5"
+})(["&:focus,&:focus-visible{outline:none;&:after{content:'';display:block;position:absolute;top:0;left:-", ";pointer-events:none;border-radius:2px;background-color:#ebedf0;width:calc(100% + 24px);border:2px solid #1e79c2;height:100%;z-index:-1;}}"], props => props.theme.space.xxs);
 
-export { StyledChatContainerContentList, StyledChatContainerContentListScroll, StyledLoadMoreContainer, StyledWrapper, StyledWrapperListItem };
+export { ListItem, StyledChatContainerContentList, StyledChatContainerContentListScroll, StyledLoadMoreContainer, StyledWrapper, StyledWrapperListItem };

package/esm/parts/chat-empty-state/ChatEmptyState.js

@@ -1,15 +1,21 @@
 import _jsx from '@babel/runtime/helpers/esm/jsx';
+import 'core-js/modules/web.url.to-json.js';
 import { useMemo } from 'react';
+import { describe } from 'react-desc';
 import { Grid } from '@elliemae/ds-grid';
-import Communications from '@elliemae/ds-icons/Communications';
+import { Communications } from '@elliemae/ds-icons';
+import { emptyStateProps, defaultProps } from './props.js';
 import { MessageWrapper, ChatEmptyStateWrapper } from './styled.js';
+import { useValidateProps } from './config/useValidateProps.js';
 
-const ChatEmptyState = ({
-  label,
-  action
-}) => {
+const ChatEmptyState = props => {
   var _Grid, _Grid2;
 
+  useValidateProps(props, ChatEmptyStateListWithSchema.toJSON());
+  const {
+    label,
+    action
+  } = props;
   const MainContent = useMemo(() => /*#__PURE__*/_jsx(Grid, {
     alignItems: "center",
     justifyContent: "center"
@@ -32,4 +38,8 @@ const ChatEmptyState = ({
   }, void 0, MainContent);
 };
 
-export { ChatEmptyState };
+ChatEmptyState.defaultProps = defaultProps;
+const ChatEmptyStateListWithSchema = describe(ChatEmptyState);
+ChatEmptyStateListWithSchema.propTypes = emptyStateProps;
+
+export { ChatEmptyState, ChatEmptyStateListWithSchema };

package/esm/parts/chat-empty-state/config/useValidateProps.js

@@ -0,0 +1,7 @@
+import { useValidatePropTypes } from '@elliemae/ds-props-helpers';
+
+const useValidateProps = (props, schema) => {
+  useValidatePropTypes(props, schema);
+};
+
+export { useValidateProps };

package/esm/parts/chat-empty-state/props.js

@@ -5,7 +5,8 @@ const defaultProps = {
   action: null
 };
 const emptyStateProps = {
-  label: PropTypes.arrayOf(PropTypes.string).description('No Message to show text helper').defaultValue(defaultProps.label)
+  label: PropTypes.arrayOf(PropTypes.string).description('No Message to show text helper').defaultValue(defaultProps.label),
+  action: PropTypes.node.description('action element').defaultValue(defaultProps.action)
 };
 
 export { defaultProps, emptyStateProps };

package/esm/parts/chat-sidebar/SideBarChat.js

@@ -1,50 +1,85 @@
 import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
 import _jsx from '@babel/runtime/helpers/esm/jsx';
-import 'react';
+import 'core-js/modules/web.url.to-json.js';
+import 'core-js/modules/esnext.async-iterator.map.js';
+import 'core-js/modules/esnext.iterator.map.js';
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import React from 'react';
 import { describe } from 'react-desc';
-import MenuExpand from '@elliemae/ds-icons/MenuExpand';
-import MenuCollapse from '@elliemae/ds-icons/MenuCollapse';
+import { MenuCollapse, MenuExpand } from '@elliemae/ds-icons';
 import { StyledSideBarContainer, StyledSideBarButtonsContainer } from './styled.js';
 import { TileButton } from '../tile-button/TileButton.js';
 import { SidebarButton } from '../sidebar-button/SidebarButton.js';
 import { chatSidebarProps, defaultProps } from './props.js';
-import { jsx } from 'react/jsx-runtime';
+import { useValidateProps } from './config/useValidateProps.js';
+import { jsxs, jsx } from 'react/jsx-runtime';
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
 
-const FooterChat = ({
-  expanded,
-  onFooterClose,
-  onFooterExpand,
-  footerButtonExtraProps
-}) => /*#__PURE__*/_jsx(SidebarButton, {
-  dsId: "sidebar_footer",
-  label: null,
-  Icon: !expanded ? MenuCollapse : MenuExpand,
-  onClick: expanded ? onFooterClose : onFooterExpand,
-  "aria-pressed": expanded,
-  "aria-label": footerButtonExtraProps['aria-label']
-});
+const FooterChat = _ref => {
+  let {
+    expanded,
+    onFooterClose,
+    onFooterExpand,
+    footerButtonExtraProps
+  } = _ref;
+  return /*#__PURE__*/_jsx(SidebarButton, {
+    dsId: "sidebar_footer",
+    label: null,
+    Icon: !expanded ? MenuCollapse : MenuExpand,
+    onClick: expanded ? onFooterClose : onFooterExpand,
+    "aria-pressed": expanded,
+    "aria-label": footerButtonExtraProps['aria-label']
+  });
+};
 
-const SideBarChat = ({
-  sidebarItems,
-  expanded,
-  onFooterClose,
-  onFooterExpand,
-  selectedItem,
-  footerButtonExtraProps
-}) => /*#__PURE__*/_jsx(StyledSideBarContainer, {
-  rows: [1, 'auto']
-}, void 0, /*#__PURE__*/_jsx(StyledSideBarButtonsContainer, {}, void 0, sidebarItems.map(p => /*#__PURE__*/jsx(TileButton, _objectSpread(_objectSpread({}, p), {}, {
-  selected: selectedItem === p.dsId
-})))), /*#__PURE__*/_jsx(FooterChat, {
-  expanded: expanded,
-  onFooterClose: onFooterClose,
-  onFooterExpand: onFooterExpand,
-  footerButtonExtraProps: footerButtonExtraProps
-}));
+const SideBarChat = props => {
+  useValidateProps(props, SideBarChatWithSchema.toJSON());
+  const {
+    sidebarItems,
+    expanded,
+    onFooterClose,
+    onFooterExpand,
+    selectedItem,
+    footerButtonExtraProps,
+    tooltipPlacement,
+    enableTooltipWhenIsClosed,
+    actionRef
+  } = props;
+  const {
+    current: listRef
+  } = React.useRef({});
+  const registerReference = React.useCallback(ref => {
+    if (ref) listRef[ref.dataset.key] = ref;
+  }, [listRef]);
+  React.useEffect(() => {
+    if (actionRef.current.listRef) {
+      actionRef.current.listRef = listRef;
+    }
+  }, [sidebarItems, expanded, actionRef, listRef]);
+  return /*#__PURE__*/jsxs(StyledSideBarContainer, {
+    rows: [1, 'auto'],
+    ref: listRef,
+    children: [/*#__PURE__*/_jsx(StyledSideBarButtonsContainer, {}, void 0, sidebarItems.map(p => /*#__PURE__*/jsx(TileButton, _objectSpread(_objectSpread({
+      innerRef: registerReference
+    }, p), {}, {
+      selected: selectedItem === p.dsId,
+      tooltipPlacement: tooltipPlacement,
+      disableTooltip: enableTooltipWhenIsClosed ? false : !expanded
+    }), p.dsId))), /*#__PURE__*/_jsx(FooterChat, {
+      expanded: expanded,
+      onFooterClose: onFooterClose,
+      onFooterExpand: onFooterExpand,
+      footerButtonExtraProps: footerButtonExtraProps
+    })]
+  });
+};
 
 SideBarChat.defaultProps = defaultProps;
 const SideBarChatWithSchema = describe(SideBarChat);

package/esm/parts/chat-sidebar/config/useValidateProps.js

@@ -0,0 +1,7 @@
+import { useValidatePropTypes } from '@elliemae/ds-props-helpers';
+
+const useValidateProps = (props, schema) => {
+  useValidatePropTypes(props, schema);
+};
+
+export { useValidateProps };

package/esm/parts/chat-sidebar/props.js

@@ -11,17 +11,27 @@ const defaultProps = {
   onHeaderClose: noop,
   footerButtonExtraProps: {
     'aria-label': 'expand or collapse button'
+  },
+  tooltipPlacement: 'right',
+  enableTooltipWhenIsClosed: false,
+  actionRef: {
+    current: {
+      listRef: []
+    }
   }
 };
 const chatSidebarProps = {
   sidebarItems: PropTypes.arrayOf(PropTypes.object).description('The array of out-of-the-box items you want to render inside the sidebar nav of the chat').defaultValue(defaultProps.sidebarItems),
   expanded: PropTypes.bool.description('Whether to show the chat expanded or collapsed').defaultValue(defaultProps.expanded),
   selectedItem: PropTypes.string.description('The id of the chat item you want to be opened').defaultValue(defaultProps.selectedItem),
+  tooltipPlacement: PropTypes.oneOf(['top-start', 'top', 'top-end', 'right-start', 'right', 'right-end', 'bottom-end', 'bottom', 'bottom-start', 'left-end', 'left', 'left-start']).description('start placement preferences, as per popperjs placement option').defaultValue("'right'"),
+  enableTooltipWhenIsClosed: PropTypes.bool.description('Enable tooltip when is closed').defaultValue(defaultProps.onFooterExpand),
   onFooterExpand: PropTypes.func.description('The function to call when the chat is opened via the footer').defaultValue(defaultProps.onFooterExpand),
   onFooterClose: PropTypes.func.description('The function to call when the chat is closed via the footer').defaultValue(defaultProps.onFooterClose),
   onHeaderExpand: PropTypes.func.description('The function to call when the chat is opened via the header').defaultValue(defaultProps.onHeaderExpand),
   onHeaderClose: PropTypes.func.description('The function to call when the chat is closed via the header').defaultValue(defaultProps.onHeaderClose),
-  footerButtonExtraProps: PropTypes.object.description('Expand/collapse footer button extra props').defaultValue(defaultProps.footerButtonExtraProps)
+  footerButtonExtraProps: PropTypes.object.description('Expand/collapse footer button extra props').defaultValue(defaultProps.footerButtonExtraProps),
+  actionRef: PropTypes.object.description("Action ref for sidebar\n  {\n    listRef: references to Tiles\n  }\n  ").defaultValue(defaultProps.actionRef)
 };
 
 export { chatSidebarProps, defaultProps };

package/esm/parts/chat-sidebar/styled.js

@@ -4,9 +4,9 @@ import { MIN_WIDTH_SIDEBAR, BUTTON_SIDEBAR_HEIGHT } from '../../styled.js';
 
 const StyledSideBarContainer = /*#__PURE__*/styled(Grid).withConfig({
   componentId: "sc-16uijso-0"
-})(["height:100%;width:", "px;background:", ";border-right:1px solid ", ";"], MIN_WIDTH_SIDEBAR, props => props.theme.colors.neutral['050'], props => props.theme.colors.neutral['100']);
+})(["height:100%;width:", "px;background:", ";border-right:1px solid ", ";overflow:hidden;"], MIN_WIDTH_SIDEBAR, props => props.theme.colors.neutral['050'], props => props.theme.colors.neutral['100']);
 const StyledSideBarButtonsContainer = /*#__PURE__*/styled(Grid).withConfig({
   componentId: "sc-16uijso-1"
-})(["overflow-y:auto;align-items:flex-start;justify-content:flex-start;grid-template-rows:repeat(auto-fill,", "px);"], BUTTON_SIDEBAR_HEIGHT);
+})(["overflow-y:auto;align-items:flex-start;justify-content:flex-start;grid-template-rows:repeat(auto-fill,", "px);overflow-x:hidden;scrollbar-width:thin;&::-webkit-scrollbar{width:6px;}"], BUTTON_SIDEBAR_HEIGHT);
 
 export { StyledSideBarButtonsContainer, StyledSideBarContainer };

package/esm/parts/floating-button/FloatingButton.js

@@ -1,18 +1,27 @@
 import _jsx from '@babel/runtime/helpers/esm/jsx';
 import 'react';
-import Comments from '@elliemae/ds-icons/Comments';
+import { Comments } from '@elliemae/ds-icons';
 import { StyledFloatingButton } from './styled.js';
 import { defaultFloatingButton } from './props.js';
+import { jsx } from 'react/jsx-runtime';
 
 var _Comments;
-const FloatingButton = ({
-  onClick
-}) => /*#__PURE__*/_jsx(StyledFloatingButton, {
-  "data-testid": "chat-floating-button",
-  onClick: onClick
-}, void 0, _Comments || (_Comments = /*#__PURE__*/_jsx(Comments, {
-  size: "l"
-})));
+const FloatingButton = _ref => {
+  let {
+    onClick,
+    onFocus,
+    innerRef
+  } = _ref;
+  return /*#__PURE__*/jsx(StyledFloatingButton, {
+    onFocus: onFocus,
+    ref: innerRef,
+    "data-testid": "chat-floating-button",
+    onClick: onClick,
+    children: _Comments || (_Comments = /*#__PURE__*/_jsx(Comments, {
+      size: "l"
+    }))
+  });
+};
 FloatingButton.defaultProps = defaultFloatingButton;
 
 export { FloatingButton };