@telus-uds/components-base 3.23.0 → 3.25.0

package/lib/esm/Listbox/GroupControl.js

@@ -7,6 +7,7 @@ import { useThemeTokens } from '../ThemeProvider';
 import Icon from '../Icon';
 import Spacer from '../Spacer';
 import { useListboxContext } from './ListboxContext';
+import { variantProp } from '../utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const styles = StyleSheet.create({
   container: {
@@ -53,19 +54,23 @@ const GroupControl = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     hover,
     focus,
     label,
-    id
+    id,
+    variant = {}
   } = _ref;
   const {
     selectedId,
     setSelectedId
   } = useListboxContext();
-  const tokens = useThemeTokens('Listbox', {}, {}, {
+  const isSecondLevel = variant?.secondLevel === true;
+  const tokens = useThemeTokens('Listbox', variant, {}, {
     expanded,
     pressed,
     hover,
     current: selectedId === id && id !== undefined,
-    focus
+    focus,
+    secondLevel: isSecondLevel
   });
+  const displayIcon = isSecondLevel ? tokens.secondLevelParentIcon : tokens.groupIcon;
   return /*#__PURE__*/_jsxs(View, {
     onPress: () => setSelectedId(id),
     style: [styles.container, selectContainerStyles(tokens)],
@@ -76,8 +81,8 @@ const GroupControl = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     }), /*#__PURE__*/_jsx(Spacer, {
       space: 1,
       direction: "row"
-    }), tokens.groupIcon && /*#__PURE__*/_jsx(Icon, {
-      icon: tokens.groupIcon,
+    }), displayIcon && /*#__PURE__*/_jsx(Icon, {
+      icon: displayIcon,
       tokens: {
         color: tokens.groupColor
       },
@@ -94,6 +99,7 @@ GroupControl.propTypes = {
   pressed: PropTypes.bool,
   hover: PropTypes.bool,
   focus: PropTypes.bool,
-  label: PropTypes.string
+  label: PropTypes.string,
+  variant: variantProp.propType
 };
 export default GroupControl;

package/lib/esm/Listbox/Listbox.js

@@ -10,11 +10,14 @@ import ListboxGroup from './ListboxGroup';
 import ListboxItem from './ListboxItem';
 import { ListboxContext } from './ListboxContext';
 import DropdownOverlay from './ListboxOverlay';
+import defaultDictionary from './dictionary';
 import { jsx as _jsx } from "react/jsx-runtime";
 const styles = StyleSheet.create({
   container: {
     padding: 0,
-    margin: 0
+    margin: 0,
+    position: 'relative',
+    overflow: 'visible'
   }
 });
 const selectContainerStyles = tokens => ({
@@ -34,12 +37,15 @@ const Listbox = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     LinkRouter,
     itemRouterProps,
     onClose,
+    copy = 'en',
+    dictionary = defaultDictionary,
     variant,
     tokens,
     testID
   } = _ref;
   const initialOpen = getInitialOpen(items, defaultSelectedId);
   const [selectedId, setSelectedId] = React.useState(defaultSelectedId);
+  const [activeSecondLevelGroup, setActiveSecondLevelGroup] = React.useState(null);
   const listboxTokens = useThemeTokens('Listbox', tokens, variant);
 
   // We need to keep track of each item's ref in order to be able to
@@ -89,11 +95,14 @@ const Listbox = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     }
     return () => {};
   }, [onClose, handleKeydown]);
+  const contextValue = {
+    selectedId,
+    setSelectedId,
+    activeSecondLevelGroup,
+    setActiveSecondLevelGroup
+  };
   return /*#__PURE__*/_jsx(ListboxContext.Provider, {
-    value: {
-      selectedId,
-      setSelectedId
-    },
+    value: contextValue,
     children: /*#__PURE__*/_jsx(ExpandCollapse, {
       initialOpen: initialOpen,
       maxOpen: 1,
@@ -115,6 +124,9 @@ const Listbox = /*#__PURE__*/React.forwardRef((_ref, ref) => {
             itemRefs.current[index] = currentItemRef;
             return currentItemRef;
           };
+          if (!nestedItems && activeSecondLevelGroup) {
+            return null;
+          }
           return nestedItems ? /*#__PURE__*/_createElement(ListboxGroup, {
             ...item,
             expandProps: expandProps,
@@ -123,7 +135,12 @@ const Listbox = /*#__PURE__*/React.forwardRef((_ref, ref) => {
             prevItemRef: itemRefs.current[index - 1] ?? null,
             nextItemRef: itemRefs.current[index + 1] ?? null,
             ref: index === 0 ? firstItemRef : itemRef,
-            key: itemId
+            key: itemId,
+            copy: copy,
+            dictionary: dictionary,
+            variant: variant,
+            tokens: tokens,
+            onClose: onClose
           }) : /*#__PURE__*/_createElement(ListboxItem, {
             ...item,
             key: itemId,
@@ -132,7 +149,9 @@ const Listbox = /*#__PURE__*/React.forwardRef((_ref, ref) => {
             itemRouterProps: itemRouterProps,
             prevItemRef: itemRefs.current[index - 1] ?? null,
             nextItemRef: itemRefs.current[index + 1] ?? null,
-            ref: index === 0 ? firstItemRef : itemRef
+            ref: index === 0 ? firstItemRef : itemRef,
+            variant: variant,
+            tokens: tokens
           });
         })
       })
@@ -168,6 +187,21 @@ Listbox.propTypes = {
    * Test ID for testing
    */
   testID: PropTypes.string,
+  /**
+   * Select English or French copy
+   */
+  copy: PropTypes.oneOf(['en', 'fr']),
+  /**
+   * Override the default dictionary, by passing the complete dictionary object for `en` and `fr`
+   */
+  dictionary: PropTypes.shape({
+    en: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    }),
+    fr: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    })
+  }),
   /**
    * Listbox variant
    */

package/lib/esm/Listbox/ListboxGroup.js

@@ -4,21 +4,36 @@ import PropTypes from 'prop-types';
 import View from "react-native-web/dist/exports/View";
 import StyleSheet from "react-native-web/dist/exports/StyleSheet";
 import Platform from "react-native-web/dist/exports/Platform";
-import { withLinkRouter } from '../utils';
+import { withLinkRouter, variantProp, copyPropTypes } from '../utils';
+import { useThemeTokens } from '../ThemeProvider';
 import ExpandCollapse from '../ExpandCollapse';
 import ListboxItem from './ListboxItem';
 import { useListboxContext } from './ListboxContext';
 import GroupControl from './GroupControl';
-import { jsx as _jsx } from "react/jsx-runtime";
+import SecondLevelHeader from './SecondLevelHeader';
+import defaultDictionary from './dictionary';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const styles = StyleSheet.create({
   groupWrapper: {
     margin: 0,
     padding: 0,
-    overflow: 'hidden'
+    overflow: 'visible'
   },
   list: {
     margin: 0,
     padding: 0
+  },
+  secondLevelContainer: {
+    margin: 0,
+    padding: 0,
+    width: '100%',
+    display: 'flex',
+    flexDirection: 'column'
+  },
+  secondLevelList: {
+    margin: 0,
+    padding: 0,
+    width: '100%'
   }
 });
 const getAccessibilityRole = () => Platform.select({
@@ -26,7 +41,15 @@ const getAccessibilityRole = () => Platform.select({
   android: 'none',
   web: 'listitem'
 });
-const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
+const selectSecondLevelContainerStyles = _ref => {
+  let {
+    secondLevelHeaderBackgroundColor
+  } = _ref;
+  return {
+    backgroundColor: secondLevelHeaderBackgroundColor
+  };
+};
+const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
   let {
     id,
     label,
@@ -36,11 +59,79 @@ const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     expandProps,
     onLastItemBlur,
     nextItemRef,
-    prevItemRef
-  } = _ref;
+    prevItemRef,
+    copy = 'en',
+    dictionary = defaultDictionary,
+    variant = {},
+    tokens = {},
+    onClose
+  } = _ref2;
   const {
-    selectedId
+    selectedId,
+    activeSecondLevelGroup,
+    setActiveSecondLevelGroup
   } = useListboxContext();
+  const [secondLevelOpen, setSecondLevelOpen] = React.useState(false);
+  const isSecondLevel = variant?.secondLevel === true;
+  const listboxTokens = useThemeTokens('Listbox', variant, tokens);
+  const groupId = id ?? label;
+  const handleGroupClick = React.useCallback(() => {
+    if (isSecondLevel) {
+      setSecondLevelOpen(true);
+      setActiveSecondLevelGroup(groupId);
+    }
+  }, [isSecondLevel, groupId, setActiveSecondLevelGroup]);
+  const handleBackClick = React.useCallback(() => {
+    setSecondLevelOpen(false);
+    setActiveSecondLevelGroup(null);
+  }, [setActiveSecondLevelGroup]);
+  const handleCloseClick = React.useCallback(() => {
+    setSecondLevelOpen(false);
+    setActiveSecondLevelGroup(null);
+    if (onClose) {
+      onClose();
+    }
+  }, [setActiveSecondLevelGroup, onClose]);
+  if (isSecondLevel && activeSecondLevelGroup && activeSecondLevelGroup !== groupId) {
+    return null;
+  }
+  if (isSecondLevel && secondLevelOpen) {
+    return /*#__PURE__*/_jsxs(View, {
+      style: [styles.secondLevelContainer, selectSecondLevelContainerStyles(listboxTokens)],
+      children: [/*#__PURE__*/_jsx(SecondLevelHeader, {
+        label: label,
+        onBack: handleBackClick,
+        onClose: handleCloseClick,
+        copy: copy,
+        dictionary: dictionary,
+        variant: variant,
+        tokens: tokens
+      }), /*#__PURE__*/_jsx(View, {
+        style: styles.secondLevelList,
+        children: items && items.map((item, index) => {
+          return /*#__PURE__*/_jsx(ListboxItem, {
+            id: item.id ?? item.label,
+            ...item,
+            selected: item.id && item.id === selectedId || item.label && item.label === selectedId,
+            isChild: false,
+            LinkRouter: LinkRouter,
+            linkRouterProps: linkRouterProps,
+            variant: variant,
+            tokens: tokens,
+            ...(index === 0 && {
+              prevItemRef
+            }),
+            ...(index === items.length - 1 && {
+              nextItemRef
+            }),
+            ...(index === items.length - 1 && {
+              onBlur: onLastItemBlur
+            })
+          }, item.label);
+        })
+      })]
+    });
+  }
 
   // TODO: implement keyboard navigation via refs for grouped items separately here
   return /*#__PURE__*/_jsx(View, {
@@ -66,9 +157,16 @@ const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
       control: controlProps => /*#__PURE__*/_jsx(GroupControl, {
         id: id ?? label,
         ...controlProps,
-        label: label
+        label: label,
+        variant: variant
       }),
       ...expandProps,
+      ...(isSecondLevel && {
+        open: false
+      }),
+      ...(isSecondLevel && {
+        onPress: handleGroupClick
+      }),
       tokens: {
         contentPaddingLeft: 0,
         contentPaddingRight: 0,
@@ -81,7 +179,7 @@ const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
         contentPanelBackgroundColor: 'transparent'
       },
       controlRef: ref,
-      children: /*#__PURE__*/_jsx(View, {
+      children: !isSecondLevel && /*#__PURE__*/_jsx(View, {
         style: styles.list,
         children: items.map((item, index) => {
           return /*#__PURE__*/_jsx(ListboxItem, {
@@ -91,6 +189,8 @@ const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
             isChild: true,
             LinkRouter: LinkRouter,
             linkRouterProps: linkRouterProps,
+            variant: variant,
+            tokens: tokens,
             ...(index === 0 && {
               prevItemRef
             }),
@@ -109,6 +209,10 @@ const ListboxGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
 ListboxGroup.displayName = 'ListboxGroup';
 ListboxGroup.propTypes = {
   ...withLinkRouter.propTypes,
+  /**
+   * Unique identifier for the group
+   */
+  id: PropTypes.string,
   label: PropTypes.string,
   items: PropTypes.arrayOf(PropTypes.shape({
     href: PropTypes.string,
@@ -121,6 +225,33 @@ ListboxGroup.propTypes = {
   /**
    * Use this callback to redirect the focus after it leaves the last item of the group.
    */
-  onLastItemBlur: PropTypes.func
+  onLastItemBlur: PropTypes.func,
+  /**
+   * Select English or French copy
+   */
+  copy: copyPropTypes,
+  /**
+   * Override the default dictionary, by passing the complete dictionary object for `en` and `fr`
+   */
+  dictionary: PropTypes.shape({
+    en: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    }),
+    fr: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    })
+  }),
+  /**
+   * Variant configuration for secondLevel behavior
+   */
+  variant: variantProp.propType,
+  /**
+   * Custom tokens
+   */
+  tokens: PropTypes.object,
+  /**
+   * Callback when the menu is closed
+   */
+  onClose: PropTypes.func
 };
 export default ListboxGroup;

package/lib/esm/Listbox/ListboxOverlay.js

@@ -31,9 +31,10 @@ const DropdownOverlay = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     minWidth,
     onLayout,
     tokens,
-    testID
+    testID,
+    variant
   } = _ref;
-  const systemTokens = useThemeTokens('Listbox', {}, {});
+  const systemTokens = useThemeTokens('Listbox', variant, tokens);
   return /*#__PURE__*/_jsx(View, {
     ref: ref,
     onLayout: onLayout,
@@ -45,11 +46,14 @@ const DropdownOverlay = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     children: /*#__PURE__*/_jsx(Card, {
       tokens: {
         shadow: systemTokens.shadow,
+        borderRadius: systemTokens.borderRadius,
+        ...(Platform.OS === 'web' && {
+          overflowY: 'hidden'
+        }),
         paddingBottom: paddingVertical,
         paddingTop: paddingVertical,
         paddingLeft: paddingHorizontal,
-        paddingRight: paddingHorizontal,
-        ...tokens
+        paddingRight: paddingHorizontal
       },
       children: children
     })
@@ -77,6 +81,7 @@ DropdownOverlay.propTypes = {
   minWidth: PropTypes.number,
   onLayout: PropTypes.func,
   tokens: PropTypes.object,
-  testID: PropTypes.string
+  testID: PropTypes.string,
+  variant: PropTypes.object
 };
 export default Platform.OS === 'web' ? withPortal(DropdownOverlay) : DropdownOverlay;

package/lib/esm/Listbox/SecondLevelHeader.js

@@ -0,0 +1,194 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import View from "react-native-web/dist/exports/View";
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
+import Text from "react-native-web/dist/exports/Text";
+import Pressable from "react-native-web/dist/exports/Pressable";
+import { useThemeTokens } from '../ThemeProvider';
+import { useCopy, variantProp, copyPropTypes } from '../utils';
+import Icon from '../Icon';
+import IconButton from '../IconButton';
+import Divider from '../Divider';
+import defaultDictionary from './dictionary';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const styles = StyleSheet.create({
+  headerContainer: {
+    width: '100%'
+  },
+  headerContent: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    width: '100%'
+  },
+  leftSection: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    flex: 1
+  },
+  backIcon: {
+    marginRight: 8,
+    flexShrink: 0
+  },
+  labelText: {
+    flex: 1
+  },
+  closeButton: {
+    flexShrink: 0
+  },
+  dividerContainer: {
+    width: '100%'
+  }
+});
+const selectHeaderContainerStyles = _ref => {
+  let {
+    secondLevelHeaderBackgroundColor
+  } = _ref;
+  return {
+    backgroundColor: secondLevelHeaderBackgroundColor
+  };
+};
+const selectHeaderContentStyles = _ref2 => {
+  let {
+    secondLevelHeaderPaddingTop,
+    secondLevelHeaderPaddingBottom,
+    secondLevelHeaderPaddingLeft,
+    secondLevelHeaderPaddingRight
+  } = _ref2;
+  return {
+    paddingTop: secondLevelHeaderPaddingTop,
+    paddingBottom: secondLevelHeaderPaddingBottom,
+    paddingLeft: secondLevelHeaderPaddingLeft,
+    paddingRight: secondLevelHeaderPaddingRight
+  };
+};
+const selectLabelTextStyles = _ref3 => {
+  let {
+    secondLevelBackLinkFontName,
+    secondLevelBackLinkFontWeight,
+    secondLevelBackLinkFontSize,
+    secondLevelBackLinkColor
+  } = _ref3;
+  return {
+    fontFamily: `${secondLevelBackLinkFontName}${secondLevelBackLinkFontWeight}normal`,
+    fontSize: secondLevelBackLinkFontSize,
+    color: secondLevelBackLinkColor
+  };
+};
+
+/**
+ * SecondLevelHeader component for Listbox secondLevel variant.
+ * Displays a header with back button icon, title text, and close button (IconButton),
+ * separated from content by a Divider.
+ */
+const SecondLevelHeader = /*#__PURE__*/React.forwardRef((_ref4, ref) => {
+  let {
+    label,
+    onBack,
+    onClose,
+    copy = 'en',
+    dictionary = defaultDictionary,
+    tokens: tokensProp = {},
+    variant = {}
+  } = _ref4;
+  const tokens = useThemeTokens('Listbox', variant, tokensProp);
+  const getCopy = useCopy({
+    dictionary,
+    copy
+  });
+  const {
+    secondLevelBackIcon,
+    secondLevelBackIconColor,
+    secondLevelCloseIcon,
+    secondLevelCloseIconSize,
+    secondLevelCloseButtonBorderWidth,
+    secondLevelCloseButtonPadding,
+    secondLevelDividerColor,
+    secondLevelDividerWidth
+  } = tokens;
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.headerContainer, selectHeaderContainerStyles(tokens)],
+    ref: ref,
+    children: [/*#__PURE__*/_jsxs(View, {
+      style: [styles.headerContent, selectHeaderContentStyles(tokens)],
+      children: [/*#__PURE__*/_jsxs(Pressable, {
+        onPress: onBack,
+        style: styles.leftSection,
+        children: [/*#__PURE__*/_jsx(View, {
+          style: styles.backIcon,
+          children: /*#__PURE__*/_jsx(Icon, {
+            icon: secondLevelBackIcon,
+            tokens: {
+              color: secondLevelBackIconColor
+            },
+            variant: {
+              size: 'micro'
+            }
+          })
+        }), /*#__PURE__*/_jsx(Text, {
+          numberOfLines: 1,
+          style: [styles.labelText, selectLabelTextStyles(tokens)],
+          children: label
+        })]
+      }), /*#__PURE__*/_jsx(View, {
+        style: styles.closeButton,
+        children: /*#__PURE__*/_jsx(IconButton, {
+          icon: secondLevelCloseIcon,
+          onPress: onClose,
+          accessibilityLabel: getCopy('closeMenu'),
+          tokens: {
+            iconSize: secondLevelCloseIconSize,
+            borderWidth: secondLevelCloseButtonBorderWidth,
+            padding: secondLevelCloseButtonPadding
+          }
+        })
+      })]
+    }), /*#__PURE__*/_jsx(View, {
+      style: styles.dividerContainer,
+      children: /*#__PURE__*/_jsx(Divider, {
+        tokens: {
+          color: secondLevelDividerColor,
+          width: secondLevelDividerWidth
+        }
+      })
+    })]
+  });
+});
+SecondLevelHeader.displayName = 'SecondLevelHeader';
+SecondLevelHeader.propTypes = {
+  /**
+   * The label text to display (typically the parent item label)
+   */
+  label: PropTypes.string.isRequired,
+  /**
+   * Callback when back button is clicked
+   */
+  onBack: PropTypes.func.isRequired,
+  /**
+   * Callback when close button is clicked
+   */
+  onClose: PropTypes.func.isRequired,
+  /**
+   * Select English or French copy
+   */
+  copy: copyPropTypes,
+  /**
+   * Override the default dictionary, by passing the complete dictionary object for `en` and `fr`
+   */
+  dictionary: PropTypes.shape({
+    en: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    }),
+    fr: PropTypes.shape({
+      closeMenu: PropTypes.string.isRequired
+    })
+  }),
+  /**
+   * Custom tokens to override theme tokens
+   */
+  tokens: PropTypes.object,
+  /**
+   * Variant configuration
+   */
+  variant: variantProp.propType
+};
+export default SecondLevelHeader;

package/lib/esm/Listbox/dictionary.js

@@ -0,0 +1,8 @@
+export default {
+  en: {
+    closeMenu: 'Close menu'
+  },
+  fr: {
+    closeMenu: 'Fermer le menu'
+  }
+};