@telus-uds/components-base 3.7.1 → 3.9.0

package/lib/esm/ActivityIndicator/sharedProptypes.js

@@ -0,0 +1,61 @@
+import PropTypes from 'prop-types';
+
+/**
+ * PropTypes for the 3 variants of the ActivityIndicator:
+ *   - InlineIndicator
+ *   - OverlayIndicator
+ *   - FullScreenIndicator
+ */
+export const activityIndicatorVariantProps = PropTypes.shape({
+  /**
+   * Indicates the variant style for the ActivityIndicator
+   * */
+  variant: PropTypes.object,
+  /**
+   * Size of the dots
+   * */
+  dotSize: PropTypes.number,
+  /**
+   * Size of the ActivityIndicator Spinner
+   * */
+  size: PropTypes.number,
+  /**
+   * Primary color (Spinner)
+   * */
+  color: PropTypes.string,
+  /**
+   * Secondary color (background) of the indicator
+   * */
+  indicatorBackgroundColor: PropTypes.string,
+  /**
+   * Thickness of the ActivityIndicator Spinner
+   * */
+  thickness: PropTypes.number,
+  /**
+   * Indicates if the ActivityIndicator is static
+   * (not animated)
+   * */
+  isStatic: PropTypes.bool
+}).isRequired;
+export const activityIndicatorCommonProps = {
+  /**
+   * Props used by RenderActivityIndicator
+   * */
+  variantProps: activityIndicatorVariantProps,
+  /**
+   * Shows or hide the label
+   * */
+  showLabel: PropTypes.bool,
+  /**
+   * A visually hidden accessible label describing the action taking place
+   */
+  label: PropTypes.string,
+  /**
+   * Position of the label relative to ActivityIndicator
+   */
+  labelPosition: PropTypes.oneOf(['top', 'bottom', 'left', 'right']),
+  /**
+   * Map of flex-direction position for label
+   * */
+  labelMapping: PropTypes.object.isRequired
+};

package/lib/esm/Card/Card.js

@@ -126,6 +126,7 @@ const Card = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
   const selected = interactiveCard?.variant?.selected;
   const inactive = interactiveCard?.variant?.inactive;
   const selectionType = interactiveCard?.selectionType;
+  const isControl = interactiveCard?.variant?.isControl === true;
   const getThemeTokens = useThemeTokensCallback('Card', interactiveCard?.tokens, {
     interactive: true,
     ...(interactiveCard?.variant || {})
@@ -193,6 +194,9 @@ const Card = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
     cardStyles = themeTokens;
   }
   const renderInputPerSelectionType = props => {
+    if (!isControl) {
+      return null;
+    }
     switch (selectionType) {
       case SelectionType.Checkbox:
         return /*#__PURE__*/_jsx(View, {
@@ -220,17 +224,8 @@ const Card = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
         return null;
     }
   };
-  const renderNoSelectionView = () => /*#__PURE__*/_jsx(View, {
-    style: {
-      paddingTop,
-      paddingBottom,
-      paddingLeft,
-      paddingRight
-    },
-    children: children
-  });
   return /*#__PURE__*/_jsx(_Fragment, {
-    children: /*#__PURE__*/_jsx(CardBase, {
+    children: /*#__PURE__*/_jsxs(CardBase, {
       ref: ref,
       tokens: interactiveCard?.body ? restOfTokens : cardStyles,
       backgroundImage: backgroundImage,
@@ -238,41 +233,39 @@ const Card = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
         media: mediaIds
       },
       ...selectProps(rest),
-      children: interactiveCard?.body ? /*#__PURE__*/_jsxs(_Fragment, {
-        children: [/*#__PURE__*/_jsx(PressableCardBase, {
-          ref: ref,
-          tokens: getThemeTokens,
-          dataSet: dataSet,
-          onPress: onPress,
-          href: interactiveCard?.href,
-          hrefAttrs: interactiveCard?.hrefAttrs,
-          ...selectProps(rest),
-          children: cardState => {
-            const {
-              iconColor: checkColor,
-              inputBackgroundColor: boxBackgroundColor,
-              iconBackgroundColor: checkBackgroundColor
-            } = getThemeTokens({
-              ...cardState,
-              selected,
-              interactive: true,
-              isControl: true
-            }, interactiveCard?.tokens);
-            return /*#__PURE__*/_jsxs(_Fragment, {
-              children: [renderInputPerSelectionType(getInputProps({
-                id,
-                checkColor,
-                boxBackgroundColor,
-                checkBackgroundColor,
-                isControlled: true,
-                isChecked: selected || cardState?.hover,
-                isInactive: inactive,
-                onPress
-              })), typeof interactiveCard?.body === 'function' ? interactiveCard.body(cardState) : interactiveCard.body]
-            });
-          }
-        }), children && selectionType !== SelectionType.None ? renderNoSelectionView() : null]
-      }) : children
+      children: [interactiveCard?.body && /*#__PURE__*/_jsx(PressableCardBase, {
+        ref: ref,
+        tokens: getThemeTokens,
+        dataSet: dataSet,
+        onPress: onPress,
+        href: interactiveCard?.href,
+        hrefAttrs: interactiveCard?.hrefAttrs,
+        ...selectProps(rest),
+        children: cardState => {
+          const {
+            iconColor: checkColor,
+            inputBackgroundColor: boxBackgroundColor,
+            iconBackgroundColor: checkBackgroundColor
+          } = getThemeTokens({
+            ...cardState,
+            selected,
+            interactive: true,
+            isControl
+          }, interactiveCard?.tokens);
+          return /*#__PURE__*/_jsxs(_Fragment, {
+            children: [renderInputPerSelectionType(getInputProps({
+              id,
+              checkColor,
+              boxBackgroundColor,
+              checkBackgroundColor,
+              isControlled: true,
+              isChecked: selected || cardState?.hover,
+              isInactive: inactive,
+              onPress
+            })), typeof interactiveCard?.body === 'function' ? interactiveCard.body(cardState) : interactiveCard.body]
+          });
+        }
+      }), children]
     })
   });
 });

package/lib/esm/ExpandCollapseMini/ExpandCollapseMiniControl.js

@@ -38,7 +38,7 @@ const ExpandCollapseMiniControl = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   const isFocusVisible = Platform.OS === 'web' ? focus && !pressed && !hover : expanded;
   const linkTokens = useThemeTokens('Link', {}, {
     ...variant,
-    quiet: expanded ?? quiet
+    quiet
   }, {
     focus: isFocusVisible,
     hover,

package/lib/esm/List/ListItemMark.js

@@ -3,6 +3,7 @@ import PropTypes from 'prop-types';
 import View from "react-native-web/dist/exports/View";
 import StyleSheet from "react-native-web/dist/exports/StyleSheet";
 import Icon from '../Icon';
+import { useVariants } from '../utils';
 import { jsx as _jsx } from "react/jsx-runtime";
 export const tokenTypes = {
   itemIconSize: PropTypes.number.isRequired,
@@ -53,6 +54,7 @@ const selectBulletContainerStyles = _ref4 => {
     alignItems: itemBulletContainerAlign
   };
 };
+const getIconColorVariants = iconVariants => iconVariants?.filter(variant => variant[0] === 'color').map(variant => variant[1]);
 
 /**
  * Subcomponent used within ListItem and similar components for rendering bullets or icons
@@ -71,6 +73,10 @@ const ListItemMark = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
   const themeTokens = typeof tokens === 'function' ? tokens() : tokens;
   const sideItemContainerStyles = selectSideItemContainerStyles(themeTokens);
   const bulletContainerStyles = selectBulletContainerStyles(themeTokens);
+
+  // TODO: Remove it when iconColor custom colors are deprecated.
+  const iconVariants = useVariants('Icon');
+  const iconColorVariants = getIconColorVariants(iconVariants);
   if (icon) {
     const iconTokens = selectItemIconTokens(themeTokens);
     return /*#__PURE__*/_jsx(View, {
@@ -78,10 +84,15 @@ const ListItemMark = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
       children: /*#__PURE__*/_jsx(Icon, {
         icon: icon,
         tokens: {
-          size: iconSize ?? iconTokens.size
+          size: iconSize ?? iconTokens.size,
+          ...((iconColor && !iconColorVariants?.includes(iconColor) || !iconColor) && {
+            color: iconColor && !iconColorVariants?.includes(iconColor) ? iconColor : iconTokens.color
+          })
         },
         variant: {
-          color: iconColor ?? iconTokens.color
+          ...(iconColorVariants?.includes(iconColor) && {
+            color: iconColor
+          })
         }
       })
     });

package/lib/esm/MultiSelectFilter/ModalOverlay.js

@@ -10,6 +10,7 @@ import { useThemeTokens } from '../ThemeProvider';
 import dictionary from './dictionary';
 import Card from '../Card';
 import IconButton from '../IconButton';
+import useDetectOutsideClick from '../utils/useDetectOutsideClick';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const staticStyles = StyleSheet.create({
   positioner: {
@@ -55,6 +56,7 @@ const staticStyles = StyleSheet.create({
 });
 const selectContainerStyle = (enableFullscreen, themeTokens) => ({
   borderColor: themeTokens.borderColor,
+  backgroundColor: themeTokens.backgroundColor,
   ...Platform.select({
     web: {
       position: enableFullscreen ? 'fixed' : 'absolute'
@@ -89,13 +91,16 @@ const ModalOverlay = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
     tokens,
     copy,
     onClose,
-    enableFullscreen = false
+    enableFullscreen = false,
+    dismissWhenPressedOutside = false
   } = _ref2;
   const viewport = useViewport();
   const themeTokens = useThemeTokens('Modal', tokens, variant, {
     viewport,
     maxWidth: false
   });
+  const containerRef = React.useRef(ref || null);
+  useDetectOutsideClick(containerRef, onClose, dismissWhenPressedOutside);
   const containerWidthHeight = {
     minWidth: tokens.maxWidth ? maxWidthSize : minWidth,
     minHeight: maxHeight ? maxHeightSize : minHeight,
@@ -103,7 +108,8 @@ const ModalOverlay = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
     maxHeight: maxHeightSize
   };
   const {
-    closeIcon: CloseIconComponent
+    closeIcon: CloseIconComponent,
+    backgroundColor
   } = themeTokens;
   const getCopy = useCopy({
     dictionary,
@@ -112,11 +118,14 @@ const ModalOverlay = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
   const closeLabel = getCopy('closeButton');
   return /*#__PURE__*/_jsx(Portal, {
     children: /*#__PURE__*/_jsx(View, {
-      ref: ref,
+      ref: containerRef,
       onLayout: onLayout,
       style: [overlaidPosition, containerWidthHeight, staticStyles.positioner, !isReady && staticStyles.hidden, selectContainerStyle(enableFullscreen, themeTokens)],
       children: /*#__PURE__*/_jsxs(Card, {
-        tokens: staticStyles.card,
+        tokens: {
+          ...staticStyles.card,
+          backgroundColor
+        },
         children: [/*#__PURE__*/_jsx(View, {
           style: [staticStyles.closeButtonContainer, selectCloseButtonContainerStyles(themeTokens)],
           children: /*#__PURE__*/_jsx(IconButton, {
@@ -150,6 +159,11 @@ ModalOverlay.propTypes = {
   tokens: getTokensPropType('Modal'),
   copy: copyPropTypes,
   onClose: PropTypes.func,
-  enableFullscreen: PropTypes.bool
+  enableFullscreen: PropTypes.bool,
+  /**
+   * If true, clicking outside the content will trigger the a close callback, dismissing the content.
+   * @deprecated This parameter will be removed in the next major release; detection will be always enabled by default.
+   */
+  dismissWhenPressedOutside: PropTypes.bool
 };
 export default ModalOverlay;

package/lib/esm/MultiSelectFilter/MultiSelectFilter.js

@@ -85,6 +85,7 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
     inactive = false,
     rowLimit = 12,
     dictionary = defaultDictionary,
+    dismissWhenPressedOutside = false,
     ...rest
   } = _ref3;
   const viewport = useViewport();
@@ -134,6 +135,7 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
     buttonBackgroundColor,
     iconColorSelected,
     buttonBackgroundColorSelected,
+    containerBorderColor,
     ...restTokens
   } = useThemeTokens('MultiSelectFilter', tokens, {
     ...variant,
@@ -279,7 +281,7 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
             ...headerStyles,
             lineHeight: headerLineHeight
           },
-          children: getCopy('filterByLabel').replace(/%\{filterCategory\}/g, label.toLowerCase())
+          children: getCopy('filterByLabel').replace(/%\{filterCategory\}/g, label)
         })
       })
     }), subtitle && /*#__PURE__*/_jsxs(_Fragment, {
@@ -300,6 +302,7 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
       style: styles.options,
       children: /*#__PURE__*/_jsx(ScrollView, {
         onLayout: handleScrollViewLayout,
+        style: styles.scrollContainer,
         children: /*#__PURE__*/_jsx(Row, {
           distribute: "between",
           onLayout: handleRowLayout,
@@ -318,12 +321,11 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
     })]
   });
   const controlsContent = /*#__PURE__*/_jsxs(_Fragment, {
-    children: [isScrolling ? /*#__PURE__*/_jsx(Divider, {
+    children: [isScrolling && /*#__PURE__*/_jsx(Divider, {
       tokens: {
         color: dividerColor
-      },
-      space: 4
-    }) : /*#__PURE__*/_jsx(Spacer, {
+      }
+    }), /*#__PURE__*/_jsx(Spacer, {
       space: 4
     }), /*#__PURE__*/_jsx(View, {
       style: selectControlsTokens(restTokens),
@@ -380,7 +382,8 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
       minWidth: windowWidth,
       tokens: {
         ...tokens,
-        maxWidth: true
+        maxWidth: true,
+        borderColor: containerBorderColor
       },
       copy: copy,
       isReady: isReady,
@@ -396,8 +399,9 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
         })]
       })
     }), isOpen && viewport !== 'xs' && /*#__PURE__*/_jsxs(ModalOverlay, {
-      overlaidPosition: overlaidPosition,
+      dismissWhenPressedOutside: dismissWhenPressedOutside,
       onClose: onClose,
+      overlaidPosition: overlaidPosition,
       maxHeight: items.length > MAX_ITEMS_THRESHOLD ? true : maxHeight,
       maxHeightSize: maxHeightSize,
       maxWidthSize: maxWidthSize,
@@ -405,7 +409,8 @@ const MultiSelectFilter = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
       minWidth: minWidth,
       tokens: {
         ...tokens,
-        maxWidth: items.length > MAX_ITEMS_THRESHOLD ? true : maxWidth
+        maxWidth: items.length > MAX_ITEMS_THRESHOLD ? true : maxWidth,
+        borderColor: containerBorderColor
       },
       copy: copy,
       isReady: isReady,
@@ -433,6 +438,9 @@ const styles = StyleSheet.create({
   },
   options: {
     flex: 1
+  },
+  scrollContainer: {
+    padding: 1
   }
 });
 
@@ -541,6 +549,11 @@ MultiSelectFilter.propTypes = {
    * Sets the maximum number of items in one column. If number of items are more
    * than the `rowLimit`, they will be rendered in 2 columns.
    */
-  rowLimit: PropTypes.number
+  rowLimit: PropTypes.number,
+  /**
+   * If true, clicking outside the content will trigger the a close callback, dismissing the content.
+   * @deprecated This parameter will be removed in the next major release; detection will be always enabled by default.
+   */
+  dismissWhenPressedOutside: PropTypes.bool
 };
 export default MultiSelectFilter;

package/lib/esm/ToggleSwitch/ToggleSwitch.js

@@ -94,6 +94,17 @@ const selectSwitchStyles = _ref6 => {
     })
   };
 };
+const selectMobileTokens = tokens => ({
+  ...Platform.select({
+    web: {},
+    default: {
+      switchSize: tokens?.mobileSwitchSize,
+      trackHeight: tokens?.mobileTrackHeight,
+      width: tokens?.mobileWidth,
+      trackBorderWidth: tokens?.mobileTrackBorderWidth
+    }
+  })
+});
 const selectLabelStyles = _ref7 => {
   let {
     labelMarginLeft
@@ -146,7 +157,7 @@ const ToggleSwitch = /*#__PURE__*/React.forwardRef((_ref9, ref) => {
     onChange
   });
   const handlePress = event => setValue(!currentValue, event);
-  const getButtonTokens = buttonState => selectButtonTokens(getTokens(buttonState), getTokens(themeTokens));
+  const getButtonTokens = buttonState => selectButtonTokens(getTokens(buttonState, selectMobileTokens(themeTokens)), getTokens(themeTokens, selectMobileTokens(themeTokens)));
   const uniqueId = useUniqueId('toggleSwitch');
   const inputId = id ?? uniqueId;
   return /*#__PURE__*/_jsxs(StackView, {
@@ -179,7 +190,7 @@ const ToggleSwitch = /*#__PURE__*/React.forwardRef((_ref9, ref) => {
       onPress: handlePress,
       ...selectProps(rest),
       children: buttonState => {
-        const stateTokens = getTokens(buttonState);
+        const stateTokens = getTokens(buttonState, selectMobileTokens(themeTokens));
         const IconComponent = stateTokens.icon;
         const switchStyles = selectSwitchStyles(stateTokens);
         const trackStyles = selectTrackStyles(stateTokens);