@telus-uds/components-base 1.81.0 → 1.83.0

package/lib-module/ProductCard/ProductCard.js

@@ -0,0 +1,231 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
+import View from "react-native-web/dist/exports/View";
+import Image from "react-native-web/dist/exports/Image";
+import { useViewport } from '../ViewportProvider';
+import { useThemeTokens } from '../ThemeProvider';
+import defaultDictionary from './dictionary';
+import { selectSystemProps, getTokensPropType, htmlAttrs, viewProps, useInputValue, useCopy, a11yProps } from '../utils';
+import Badge from '../Badge';
+import PriceLockup from '../PriceLockup';
+import Typography from '../Typography';
+import { Button } from '../Button';
+import StackView from '../StackView';
+import Box from '../Box';
+import Icon from '../Icon';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([htmlAttrs, viewProps, a11yProps]);
+const selectProductCardTokens = _ref => {
+  let {
+    borderStyle,
+    borderColor,
+    borderWidth,
+    borderRadius,
+    paddingHorizontal,
+    paddingVertical
+  } = _ref;
+  return {
+    borderStyle,
+    borderColor,
+    borderWidth,
+    borderRadius,
+    paddingHorizontal,
+    paddingVertical
+  };
+};
+const ProductCard = _ref2 => {
+  var _getCopy;
+  let {
+    copy = 'en',
+    dictionary = defaultDictionary,
+    image = {
+      src: '',
+      alt: ''
+    },
+    cardId,
+    isSelected,
+    onSelect,
+    tokens,
+    ...rest
+  } = _ref2;
+  const viewport = useViewport();
+  const themeTokens = useThemeTokens('ProductCard', tokens, {
+    viewport
+  });
+  const getCopy = useCopy({
+    copy,
+    dictionary
+  });
+  const {
+    currentValue,
+    setValue
+  } = useInputValue();
+  const hasClicked = isSelected || currentValue;
+  const handlePress = event => {
+    if (cardId) {
+      onSelect(cardId);
+    } else {
+      setValue(!currentValue, event);
+    }
+  };
+  const renderButton = hasClicked ? /*#__PURE__*/_jsx(Box, {
+    vertical: 1,
+    children: /*#__PURE__*/_jsxs(StackView, {
+      space: 2,
+      direction: "row",
+      children: [/*#__PURE__*/_jsx(Icon, {
+        icon: themeTokens.selectedButtonIcon,
+        variant: {
+          color: 'success'
+        }
+      }), /*#__PURE__*/_jsx(Typography, {
+        variant: {
+          size: 'h4'
+        },
+        tokens: {
+          fontWeight: 400
+        },
+        children: getCopy('selectedButtonLabel')
+      })]
+    })
+  }) : /*#__PURE__*/_jsx(Button, {
+    onPress: handlePress,
+    variant: {
+      purpose: 'primary',
+      size: 'small',
+      width: 'full'
+    },
+    children: getCopy('buttonLabel')
+  });
+  return /*#__PURE__*/_jsxs(View, {
+    ...selectProps(rest),
+    style: [selectProductCardTokens(themeTokens), staticStyles.container],
+    children: [image !== null && image !== void 0 && image.src ? /*#__PURE__*/_jsx(View, {
+      style: staticStyles.imageContainer,
+      children: /*#__PURE__*/_jsx(Image, {
+        source: image.src,
+        style: staticStyles.image,
+        alt: image.alt,
+        accessibilityLabel: image.alt,
+        resizeMethod: "resize",
+        accessibilityIgnoresInvertColors: true
+      })
+    }) : null, /*#__PURE__*/_jsx(View, {
+      style: staticStyles.textContainer,
+      children: /*#__PURE__*/_jsx(Box, {
+        left: 3,
+        children: /*#__PURE__*/_jsxs(StackView, {
+          space: 1,
+          children: [getCopy('badgeText') ? /*#__PURE__*/_jsx(Badge, {
+            variant: {
+              outline: true,
+              purpose: 'editorial'
+            },
+            children: getCopy('badgeText')
+          }) : null, /*#__PURE__*/_jsx(Typography, {
+            variant: {
+              size: 'h6'
+            },
+            children: getCopy('brandName')
+          }), /*#__PURE__*/_jsx(Typography, {
+            variant: {
+              size: 'h4',
+              colour: 'brand'
+            },
+            tokens: {
+              fontWeight: 400
+            },
+            children: getCopy('productName')
+          }), /*#__PURE__*/_jsxs(StackView, {
+            space: 3,
+            divider: true,
+            direction: "row",
+            children: [/*#__PURE__*/_jsx(PriceLockup, {
+              ...getCopy('primaryPrice'),
+              size: "small",
+              ratePosition: "bottom"
+            }), (_getCopy = getCopy('secondaryPrice')) !== null && _getCopy !== void 0 && _getCopy.price ? /*#__PURE__*/_jsx(PriceLockup, {
+              ...getCopy('secondaryPrice'),
+              size: "small",
+              ratePosition: "bottom"
+            }) : null]
+          }), /*#__PURE__*/_jsx(Box, {
+            top: 2,
+            children: /*#__PURE__*/_jsxs(StackView, {
+              space: 2,
+              children: [/*#__PURE__*/_jsx(Typography, {
+                variant: {
+                  size: 'h6'
+                },
+                tokens: {
+                  fontWeight: 500
+                },
+                children: getCopy('term')
+              }), getCopy('buttonLabel') ? /*#__PURE__*/_jsx(Box, {
+                top: 1,
+                children: renderButton
+              }) : null]
+            })
+          })]
+        })
+      })
+    })]
+  });
+};
+ProductCard.displayName = 'ProductCard';
+
+// If a language dictionary entry is provided, it must contain every key
+const dictionaryContentShape = PropTypes.shape({
+  badgeText: PropTypes.string,
+  brandName: PropTypes.string.isRequired,
+  productName: PropTypes.string.isRequired,
+  primaryPrice: PropTypes.object.isRequired,
+  secondaryPrice: PropTypes.object,
+  term: PropTypes.string.isRequired,
+  buttonLabel: PropTypes.string.isRequired,
+  selectedButtonLabel: PropTypes.string.isRequired
+});
+ProductCard.propTypes = {
+  ...selectedSystemPropTypes,
+  image: PropTypes.shape({
+    src: PropTypes.oneOfType([PropTypes.string, PropTypes.node]),
+    alt: PropTypes.string
+  }),
+  /**
+   * Select English or French copy for the place holder labels.
+   * You may also pass in a custom dictionary object.
+   */
+  copy: PropTypes.oneOfType([PropTypes.oneOf(['en', 'fr'])]),
+  /**
+   * Override the default dictionary, by passing the complete dictionary object for `en` and `fr`
+   */
+  dictionary: PropTypes.shape({
+    en: dictionaryContentShape,
+    fr: dictionaryContentShape
+  }),
+  tokens: getTokensPropType('ProductCard')
+};
+export default ProductCard;
+const staticStyles = StyleSheet.create({
+  container: {
+    flexDirection: 'row',
+    flex: 1
+  },
+  imageContainer: {
+    width: '30%',
+    minWidth: 96,
+    maxWidth: 96
+  },
+  image: {
+    resizeMode: 'contain',
+    width: '100%',
+    height: undefined,
+    // This is to maintain the aspect ratio
+    aspectRatio: 0.8
+  },
+  textContainer: {
+    width: '70%'
+  }
+});

package/lib-module/ProductCard/dictionary.js

@@ -0,0 +1,38 @@
+export default {
+  en: {
+    badgeText: '',
+    brandName: 'Brand name',
+    productName: 'Product name',
+    primaryPrice: {
+      price: '00',
+      signDirection: 'left',
+      rateText: '/month'
+    },
+    secondaryPrice: {
+      price: '',
+      signDirection: 'left',
+      rateText: 'Upfront'
+    },
+    term: '24 months | 0% APR Bring-it-Back applied',
+    buttonLabel: 'Select this phone',
+    selectedButtonLabel: 'Selected phone'
+  },
+  fr: {
+    badgeText: '',
+    brandName: 'Brand name',
+    productName: 'Product name',
+    primaryPrice: {
+      price: '00',
+      signDirection: 'right',
+      rateText: '/mois'
+    },
+    secondaryPrice: {
+      price: '',
+      signDirection: 'right',
+      rateText: "d'acompte"
+    },
+    term: '24 mois | TAP de 0% | avec Option retour',
+    buttonLabel: 'Sélectionner ce téléphone',
+    selectedButtonLabel: 'Téléphone sélectionné'
+  }
+};

package/lib-module/ProductCard/index.js

@@ -0,0 +1,2 @@
+import ProductCard from './ProductCard';
+export default ProductCard;

package/lib-module/ProductCardGroup/ProductCardGroup.js

@@ -0,0 +1,69 @@
+import React, { useState } from 'react';
+import PropTypes from 'prop-types';
+import View from "react-native-web/dist/exports/View";
+import { selectSystemProps, htmlAttrs, viewProps, a11yProps } from '../utils';
+import ProductCard from '../ProductCard';
+import { StackWrap } from '../StackView';
+import { jsx as _jsx } from "react/jsx-runtime";
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([htmlAttrs, viewProps, a11yProps]);
+const ProductCardGroup = _ref => {
+  let {
+    productCards,
+    maxSelection = 1,
+    ...rest
+  } = _ref;
+  const [selectedCardIds, setSelectedCardIds] = useState([]);
+  const handleSelect = id => {
+    const isAlreadySelected = selectedCardIds.includes(id);
+    let updatedSelectedCardIds;
+    if (isAlreadySelected) {
+      updatedSelectedCardIds = selectedCardIds.filter(cardId => cardId !== id);
+    } else if (maxSelection && selectedCardIds.length >= maxSelection) {
+      updatedSelectedCardIds = selectedCardIds.filter((_, index) => index !== 0).concat(id);
+    } else {
+      updatedSelectedCardIds = [...selectedCardIds, id];
+    }
+    setSelectedCardIds(updatedSelectedCardIds);
+  };
+  return /*#__PURE__*/_jsx(View, {
+    ...selectProps(rest),
+    children: /*#__PURE__*/_jsx(StackWrap, {
+      direction: {
+        xs: 'column',
+        lg: 'row'
+      },
+      space: 4,
+      children: productCards.map((cardProperties, index) => {
+        const cardId = cardProperties.id || index;
+        return /*#__PURE__*/_jsx(View, {
+          children: /*#__PURE__*/_jsx(ProductCard, {
+            cardId: cardId,
+            isSelected: selectedCardIds.includes(cardId),
+            onSelect: handleSelect,
+            ...cardProperties
+          }, cardId)
+        }, cardId);
+      })
+    })
+  });
+};
+ProductCardGroup.displayName = 'ProductCardGroup';
+ProductCardGroup.propTypes = {
+  ...selectedSystemPropTypes,
+  /**
+   * The maximum number of ProductCards a user may select at once. Defaults to 1.
+   * To have no limit and allow any number of selections, pass `null`.
+   */
+  maxSelection: PropTypes.number,
+  /**
+   * Props to be passed to the `ProductCard` component.
+   * id is required for each card.
+   * You may also pass in a custom dictionary object.
+   */
+  productCards: PropTypes.arrayOf(PropTypes.shape({
+    id: PropTypes.string.isRequired,
+    image: PropTypes.object,
+    dictionary: PropTypes.object
+  })).isRequired
+};
+export default ProductCardGroup;

package/lib-module/ProductCardGroup/index.js

@@ -0,0 +1,2 @@
+import ProductCardGroup from './ProductCardGroup';
+export default ProductCardGroup;

package/lib-module/Radio/Radio.js

@@ -240,7 +240,7 @@ Radio.propTypes = {
   /**
    * The label.
    */
-  label: PropTypes.string,
+  label: PropTypes.oneOfType([PropTypes.string, PropTypes.node]),
   /**
    * Associate this radio button with a group (set as the name attribute).
    */

package/lib-module/index.js

@@ -33,6 +33,8 @@ export { default as Notification } from './Notification';
 export { default as OrderedList } from './OrderedList';
 export { default as Pagination } from './Pagination';
 export { default as PriceLockup } from './PriceLockup';
+export { default as ProductCard } from './ProductCard';
+export { default as ProductCardGroup } from './ProductCardGroup';
 export { default as Progress } from './Progress';
 export { default as QuickLinks } from './QuickLinks';
 export { default as QuickLinksFeature } from './QuickLinksFeature';

package/package.json

@@ -11,7 +11,7 @@
     "@floating-ui/react-native": "^0.8.1",
     "@gorhom/portal": "^1.0.14",
     "@telus-uds/system-constants": "^1.3.0",
-    "@telus-uds/system-theme-tokens": "^2.53.0",
+    "@telus-uds/system-theme-tokens": "^2.54.0",
     "airbnb-prop-types": "^2.16.0",
     "css-mediaquery": "^0.1.2",
     "expo-linear-gradient": "^12.5.0",
@@ -85,6 +85,6 @@
   "standard-engine": {
     "skip": true
   },
-  "version": "1.81.0",
+  "version": "1.83.0",
   "types": "types/index.d.ts"
 }

package/src/Autocomplete/Autocomplete.jsx

@@ -217,6 +217,8 @@ const Autocomplete = forwardRef(
       if (!isControlled && inputRef?.current) inputRef.current.value = newValue
 
       if (nested) setNestedSelectedValue(newValue)
+
+      inputRef.current.focus()
     }
 
     /**
@@ -253,11 +255,12 @@ const Autocomplete = forwardRef(
         setNestedSelectedValue(null)
       } else if (
         event.type === 'keydown' &&
-        event.key === 'ArrowDown' &&
+        (event.key === 'ArrowDown' || event.key === 'Tab') &&
         isExpanded &&
         !isLoading &&
         targetRef?.current
       ) {
+        event.preventDefault()
         targetRef.current.focus()
       }
     }

package/src/Icon/Icon.jsx

@@ -26,6 +26,31 @@ const Icon = forwardRef(
       <IconComponent title={accessibilityLabel} size={size} color={themeTokens.color} />
     )
 
+    const paddingStyles = variant?.padding
+      ? {
+          padding: themeTokens.width,
+          width: themeTokens.size + themeTokens.width * 2, // sets the diameter of the circle which is the size of the icon plus twice the general padding established to obtain a perfect circle
+          height: themeTokens.size + themeTokens.width * 2
+        }
+      : {}
+
+    const getIconContentForMobile = () => {
+      if (Object.keys(paddingStyles).length) {
+        return (
+          <View
+            style={{
+              backgroundColor: themeTokens.backgroundColor,
+              borderRadius: themeTokens.borderRadius,
+              ...paddingStyles
+            }}
+          >
+            {iconContent}
+          </View>
+        )
+      }
+      return iconContent
+    }
+
     return Platform.OS === 'web' ? (
       <View
         ref={ref}
@@ -41,14 +66,17 @@ const Icon = forwardRef(
           ]
             .filter((exists) => exists)
             .join(' '),
-          ...style
+          ...style,
+          backgroundColor: themeTokens.backgroundColor,
+          borderRadius: themeTokens.borderRadius,
+          ...paddingStyles
         }}
         dataSet={dataSet}
       >
         {iconContent}
       </View>
     ) : (
-      iconContent
+      getIconContentForMobile()
     )
   }
 )