@telus-uds/components-base 3.31.0 → 3.32.0

package/lib/cjs/ColourToggle/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UNAVAILABLE_VARIANT = exports.DICTIONARY_CONTENT_SHAPE = void 0;
+var _propTypes = _interopRequireDefault(require("prop-types"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const UNAVAILABLE_VARIANT = exports.UNAVAILABLE_VARIANT = {
+  DARK: 'dark',
+  LIGHT: 'light'
+};
+const DICTIONARY_CONTENT_SHAPE = exports.DICTIONARY_CONTENT_SHAPE = _propTypes.default.shape({
+  unavailable: _propTypes.default.string
+});

package/lib/cjs/ColourToggle/dictionary.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+const DEFAULT_COLOUR_TOGGLE_DICTIONARY = {
+  en: {
+    unavailable: '(Out of stock)'
+  },
+  fr: {
+    unavailable: '(En rupture de stock)'
+  }
+};
+var _default = exports.default = DEFAULT_COLOUR_TOGGLE_DICTIONARY;

package/lib/cjs/Validator/Validator.js

@@ -206,7 +206,11 @@ const Validator = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
 
   // Sync external value prop to internal state
   _react.default.useEffect(() => {
-    if (value && Number(value).toString() !== 'NaN') {
+    if (value === '') {
+      setCodes(Array(validatorsLength).fill(''));
+      return;
+    }
+    if (Number(value).toString() !== 'NaN') {
       const digits = value.split('').slice(0, validatorsLength);
       const newCodes = Array(validatorsLength).fill('');
       digits.forEach((digit, i) => {

package/lib/esm/Button/ButtonGroup.js

@@ -13,6 +13,8 @@ import { getPressHandlersWithArgs } from '../utils/pressability';
 import { jsx as _jsx } from "react/jsx-runtime";
 const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps]);
 const [selectItemProps, selectedItemPropTypes] = selectSystemProps([a11yProps, focusHandlerProps, pressProps, viewProps]);
+const EQUAL_WIDTH = 'equal';
+const RESPONSIVE_WIDTH = 'responsive';
 const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   let {
     variant,
@@ -57,31 +59,90 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   const isMobileNonContained = Platform.OS !== 'web' && (!variant || variant?.style !== 'contained');
   const themeButtonTokensCallback = useThemeTokensCallback('ButtonGroupItem', tokens, variant);
   const gapValue = useSpacingScale(gap || space);
+  const isWeb = Platform.OS === 'web';
+  const buttonWidthVariant = variant?.width;
   const getButtonTokens = useCallback(state => {
     const themeButtonTokens = themeButtonTokensCallback(state);
     const shouldUseTransparentBackground = isMobileNonContained && !state.selected && !state.pressed && !state.hover && !state.focus;
+    let widthStyle;
+    switch (buttonWidthVariant) {
+      case EQUAL_WIDTH:
+        widthStyle = staticStyles.equalWidth;
+        break;
+      case RESPONSIVE_WIDTH:
+        widthStyle = staticStyles.responsiveWidth;
+        break;
+      // no default
+    }
     return {
       ...themeButtonTokens,
-      ...(variant?.width === 'equal' && staticStyles.equalWidth),
+      ...widthStyle,
       ...(shouldUseTransparentBackground && {
         backgroundColor: 'transparent'
       }),
       alignSelf: themeButtonTokens.width ? 'flex-start' : 'center'
     };
-  }, [themeButtonTokensCallback, isMobileNonContained, variant?.width]);
-  const fieldsetStyles = useMemo(() => ({
-    ...staticStyles.fieldsetBase,
-    borderRadius,
-    backgroundColor: isMobileNonContained ? 'transparent' : backgroundColor || 'transparent',
-    padding,
-    width: variant?.width === 'equal' ? '100%' : 'auto'
-  }), [borderRadius, backgroundColor, padding, variant?.width, isMobileNonContained]);
-  const viewStyles = useMemo(() => ({
-    ...staticStyles.viewBase,
-    flexDirection: direction === 'column' ? 'column' : 'row',
-    gap: gapValue || 0,
-    justifyContent: variant?.width === 'equal' ? 'space-evenly' : 'flex-start'
-  }), [direction, gapValue, variant?.width]);
+  }, [themeButtonTokensCallback, isMobileNonContained, buttonWidthVariant]);
+  const fieldsetStyles = useMemo(() => {
+    let fieldSetBase;
+    switch (buttonWidthVariant) {
+      case EQUAL_WIDTH:
+      case RESPONSIVE_WIDTH:
+        fieldSetBase = staticStyles.fieldSetResponsive;
+        break;
+      default:
+        fieldSetBase = staticStyles.fieldsetBase;
+        break;
+    }
+    return {
+      ...fieldSetBase,
+      borderRadius,
+      backgroundColor: isMobileNonContained ? 'transparent' : backgroundColor || 'transparent',
+      padding
+    };
+  }, [borderRadius, backgroundColor, padding, isMobileNonContained, buttonWidthVariant]);
+  const buttonsContainerStyles = useMemo(() => {
+    let flexWrap;
+    if (isWeb) {
+      flexWrap = 'wrap';
+    } else {
+      switch (buttonWidthVariant) {
+        case EQUAL_WIDTH:
+        case RESPONSIVE_WIDTH:
+          flexWrap = 'nowrap';
+          break;
+        default:
+          flexWrap = 'wrap';
+          break;
+      }
+    }
+    let justifyContent;
+    switch (buttonWidthVariant) {
+      case EQUAL_WIDTH:
+        justifyContent = 'space-evenly';
+        break;
+      default:
+        justifyContent = 'flex-start';
+        break;
+    }
+    let viewBaseStyle;
+    switch (buttonWidthVariant) {
+      case EQUAL_WIDTH:
+      case RESPONSIVE_WIDTH:
+        viewBaseStyle = {};
+        break;
+      default:
+        viewBaseStyle = staticStyles.viewBase;
+        break;
+    }
+    return {
+      ...viewBaseStyle,
+      flexWrap,
+      flexDirection: direction === 'column' ? 'column' : 'row',
+      gap: gapValue || 0,
+      justifyContent
+    };
+  }, [direction, gapValue, buttonWidthVariant, isWeb]);
   const {
     currentValues,
     toggleOneValue
@@ -103,7 +164,7 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   }
 
   // Some web screenreaders e.g. MacOS Voiceover don't handle radiogroups properly unless radio is direct child of radiogroup
-  const innerRole = Platform.OS === 'web' && accessibilityRole === 'radiogroup' ? accessibilityRole : undefined;
+  const buttonsWrapperRole = Platform.OS === 'web' && accessibilityRole === 'radiogroup' ? accessibilityRole : undefined;
   return /*#__PURE__*/_jsx(Fieldset, {
     ...systemProps,
     ref: ref,
@@ -121,8 +182,8 @@ const ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
     style: fieldsetStyles,
     ...selectProps(rest),
     children: /*#__PURE__*/_jsx(View, {
-      accessibilityRole: innerRole,
-      style: viewStyles,
+      accessibilityRole: buttonsWrapperRole,
+      style: buttonsContainerStyles,
       children: items.map((_ref2, index) => {
         let {
           label,
@@ -290,17 +351,24 @@ ButtonGroup.propTypes = {
   copy: PropTypes.oneOf(['en', 'fr'])
 };
 const staticStyles = StyleSheet.create({
+  equalWidth: {
+    width: '100%',
+    flex: 1
+  },
+  responsiveWidth: {
+    width: 'auto'
+  },
   fieldsetBase: {
     alignSelf: 'flex-start',
-    display: 'inline'
+    display: 'inline',
+    width: 'auto'
+  },
+  fieldSetResponsive: {
+    width: '100%'
   },
   viewBase: {
     flexWrap: 'wrap',
     alignItems: 'center'
-  },
-  equalWidth: {
-    width: '100%',
-    flex: 1
   }
 });
 export default ButtonGroup;

package/lib/esm/Card/CardBase.js

@@ -15,9 +15,7 @@ import FlexGridCol from '../FlexGrid/Col';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps]);
 const GRID_COLUMNS = 12;
-const isOverlayColor = color => {
-  return color && typeof color === 'string' && color.startsWith('rgba(');
-};
+const isOverlayColor = color => color && typeof color === 'string' && color.startsWith('rgba(');
 const setBackgroundImage = _ref => {
   let {
     src,
@@ -26,7 +24,8 @@ const setBackgroundImage = _ref => {
     backgroundImagePosition,
     backgroundImageAlign,
     content,
-    cardStyle
+    cardStyle,
+    testID
   } = _ref;
   const borderRadius = cardStyle?.borderRadius || 0;
   const borderWidth = cardStyle?.borderWidth || 0;
@@ -86,6 +85,7 @@ const setBackgroundImage = _ref => {
         style: [staticStyles.imageBackground, backgroundImageStyle],
         role: "img",
         "aria-label": alt,
+        testID: testID,
         children: content
       });
     }
@@ -100,7 +100,8 @@ const setBackgroundImage = _ref => {
         style: [staticStyles.containImage, positionStyles],
         accessible: true,
         accessibilityLabel: alt,
-        accessibilityIgnoresInvertColors: true
+        accessibilityIgnoresInvertColors: true,
+        testID: testID
       }), /*#__PURE__*/_jsx(View, {
         style: staticStyles.contentOverlay,
         children: content
@@ -116,6 +117,7 @@ const setBackgroundImage = _ref => {
     style: staticStyles.imageBackground,
     accessible: true,
     accessibilityLabel: alt,
+    testID: testID,
     children: content
   });
 };
@@ -124,22 +126,13 @@ const selectPaddedContentStyles = _ref2 => {
     paddingTop,
     paddingBottom,
     paddingLeft,
-    paddingRight,
-    borderWidth,
-    borderColor,
-    borderRadius,
-    hasInteractiveBorder
+    paddingRight
   } = _ref2;
   return {
     paddingTop,
     paddingBottom,
     paddingLeft,
-    paddingRight,
-    ...(hasInteractiveBorder ? {
-      borderWidth,
-      borderColor,
-      borderRadius
-    } : {})
+    paddingRight
   };
 };
 const selectInteractiveOverlayStyles = _ref3 => {
@@ -158,12 +151,31 @@ const selectInteractiveOverlayStyles = _ref3 => {
     backgroundColor,
     borderRadius: adjustedBorderRadius,
     pointerEvents: 'none',
-    zIndex: 1
+    zIndex: 3
+  };
+};
+const selectOuterContainerStyles = _ref4 => {
+  let {
+    containerStyle,
+    backgroundColor,
+    borderRadius,
+    borderColor,
+    borderWidth,
+    hasGradientToken
+  } = _ref4;
+  return {
+    ...containerStyle,
+    backgroundColor,
+    borderRadius,
+    ...(hasGradientToken ? {} : {
+      borderColor,
+      borderWidth
+    })
   };
 };
 
 // Ensure explicit selection of tokens
-export const selectStyles = _ref4 => {
+export const selectStyles = function (_ref5) {
   let {
     flex,
     backgroundColor,
@@ -184,7 +196,10 @@ export const selectStyles = _ref4 => {
     gradient,
     maxHeight,
     overflowY
-  } = _ref4;
+  } = _ref5;
+  let {
+    hasBgImage = false
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   const hasGradient = (gradient || backgroundGradient) && Platform.OS === 'web';
   let backgroundImageValue = null;
   if (hasGradient) {
@@ -213,7 +228,11 @@ export const selectStyles = _ref4 => {
     ...(gradient && Platform.OS === 'web' ? {
       backgroundImage: backgroundImageValue,
       backgroundOrigin: `border-box`,
-      boxShadow: `inset 0 1000px ${boxShadowColor}`,
+      // bgImage child fills the content-box and replaces what the inset shadow
+      // used to cover, so we omit it to avoid hiding the image.
+      ...(hasBgImage ? {} : {
+        boxShadow: `inset 0 1000px ${boxShadowColor}`
+      }),
       border: `${borderWidth}px solid transparent`
     } : {}),
     ...(backgroundGradient && Platform.OS === 'web' ? {
@@ -230,7 +249,7 @@ export const selectStyles = _ref4 => {
  * A themeless base component for Card which components can apply theme tokens to. Not
  * intended to be used in apps or sites directly: build themed components on top of this.
  */
-const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
+const CardBase = /*#__PURE__*/React.forwardRef((_ref6, ref) => {
   let {
     children,
     tokens,
@@ -238,15 +257,14 @@ const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
     backgroundImage,
     fullBleedContent,
     cardState,
+    testID,
     ...rest
-  } = _ref5;
+  } = _ref6;
   const resolvedTokens = typeof tokens === 'function' ? tokens(cardState) : tokens;
-  const tokensToUse = backgroundImage && backgroundImage.src ? {
-    ...resolvedTokens,
-    gradient: undefined,
-    backgroundGradient: undefined
-  } : resolvedTokens;
-  const cardStyle = selectStyles(tokensToUse);
+  const hasBgImage = Boolean(backgroundImage && backgroundImage.src);
+  const cardStyle = selectStyles(resolvedTokens, {
+    hasBgImage
+  });
   const props = selectProps(rest);
   let content = children;
   const {
@@ -279,31 +297,29 @@ const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
       ...containerStyle
     } = cardStyle;
     const hasPadding = paddingTop || paddingBottom || paddingLeft || paddingRight;
-    const hasInteractiveBorder = borderWidth && borderWidth > 0;
     const hasInteractiveOverlay = isOverlayColor(backgroundColor);
-    const paddedContent = hasPadding || hasInteractiveBorder ? /*#__PURE__*/_jsx(View, {
+    const outerBackgroundColor = hasInteractiveOverlay ? undefined : backgroundColor;
+    const hasGradientToken = Boolean(resolvedTokens.gradient) && Platform.OS === 'web';
+    const paddedContent = hasPadding ? /*#__PURE__*/_jsx(View, {
       style: selectPaddedContentStyles({
         paddingTop,
         paddingBottom,
         paddingLeft,
-        paddingRight,
-        borderWidth,
-        borderColor,
-        borderRadius,
-        hasInteractiveBorder
+        paddingRight
       }),
       children: children
     }) : children;
     const contentWithOverlay = /*#__PURE__*/_jsxs(_Fragment, {
-      children: [hasInteractiveOverlay && Platform.OS === 'web' && /*#__PURE__*/_jsx(View, {
+      children: [/*#__PURE__*/_jsx(View, {
+        style: staticStyles.contentOverlay,
+        children: paddedContent
+      }), hasInteractiveOverlay && Platform.OS === 'web' && /*#__PURE__*/_jsx(View, {
         style: selectInteractiveOverlayStyles({
           backgroundColor,
           borderRadius,
           borderWidth
-        })
-      }), /*#__PURE__*/_jsx(View, {
-        style: staticStyles.contentOverlay,
-        children: paddedContent
+        }),
+        testID: testID && `${testID}-card-base-bg-overlay`
       })]
     });
     content = setBackgroundImage({
@@ -314,17 +330,23 @@ const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
       backgroundImageAlign,
       content: contentWithOverlay,
       cardStyle: {
-        ...containerStyle,
-        borderRadius
-      }
+        borderRadius,
+        borderWidth
+      },
+      testID: testID && `${testID}-card-base-bg-image`
     });
     return /*#__PURE__*/_jsx(View, {
-      style: {
-        ...containerStyle,
-        borderRadius
-      },
+      style: selectOuterContainerStyles({
+        containerStyle,
+        backgroundColor: outerBackgroundColor,
+        borderRadius,
+        borderColor,
+        borderWidth,
+        hasGradientToken
+      }),
       dataSet: dataSet,
       ref: ref,
+      testID: testID,
       ...props,
       children: content
     });
@@ -364,6 +386,7 @@ const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
       style: containerStyle,
       dataSet: dataSet,
       ref: ref,
+      testID: testID,
       ...props,
       children: /*#__PURE__*/_jsx(FlexGrid, {
         children: /*#__PURE__*/_jsx(FlexGridRow, {
@@ -380,6 +403,7 @@ const CardBase = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
     style: cardStyle,
     dataSet: dataSet,
     ref: ref,
+    testID: testID,
     ...props,
     children: content
   });
@@ -422,6 +446,10 @@ CardBase.propTypes = {
   ...selectedSystemPropTypes,
   children: PropTypes.node,
   tokens: getTokensPropType('Card'),
+  /**
+   * Identifier for testing purposes.
+   */
+  testID: PropTypes.string,
   /**
    * Apply background image to the card.
    */

package/lib/esm/ColourToggle/ColourBubble.js

@@ -3,11 +3,13 @@ import PropTypes from 'prop-types';
 import View from "react-native-web/dist/exports/View";
 import Pressable from "react-native-web/dist/exports/Pressable";
 import Platform from "react-native-web/dist/exports/Platform";
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
 import { resolvePressableTokens } from '../utils/pressability';
 import { applyShadowToken } from '../ThemeProvider';
 import { getTokensPropType } from '../utils';
 import Tooltip from '../Tooltip';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { UNAVAILABLE_VARIANT } from './constants';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const selectGeneralBubbleTokens = _ref => {
   let {
     outerBubbleHeight,
@@ -63,37 +65,70 @@ const selectBorderBubbleTokens = _ref3 => {
     borderRadius: bubbleBorderRadius
   };
 };
-const ColourBubble = /*#__PURE__*/React.forwardRef((_ref4, ref) => {
+const selectOverlayStyles = _ref4 => {
   let {
-    tokens = {},
+    overlayColor,
+    innerBubbleBorderRadius
+  } = _ref4;
+  return {
+    borderRadius: innerBubbleBorderRadius,
+    backgroundColor: overlayColor
+  };
+};
+const selectSlashStyles = (_ref5, unavailable) => {
+  let {
+    slashLightColor,
+    slashDarkColor,
+    slashWidth,
+    slashOffset
+  } = _ref5;
+  return {
+    width: slashWidth,
+    backgroundColor: unavailable === UNAVAILABLE_VARIANT.DARK ? slashDarkColor : slashLightColor,
+    marginLeft: slashOffset
+  };
+};
+const ColourBubble = /*#__PURE__*/React.forwardRef((_ref6, ref) => {
+  let {
+    tokens = () => ({}),
     id,
     colourHexCode,
     colourName,
     isSelected,
     onPress,
-    showTooltip
-  } = _ref4;
+    showTooltip,
+    unavailable,
+    isDisabled
+  } = _ref6;
   const defaultTokens = tokens({
     selected: isSelected
   });
-  const resolveColourBubbleTokens = pressState => resolvePressableTokens(tokens, pressState, {});
-  const themeTokens = React.useMemo(() => tokens(), [tokens]);
-  const pressable = /*#__PURE__*/_jsx(Pressable, {
+  const resolveColourBubbleTokens = pressState => resolvePressableTokens(tokens, isDisabled ? {} : pressState, {});
+  const themeTokens = tokens();
+  const pressable = /*#__PURE__*/_jsxs(Pressable, {
     style: state => [selectGeneralBubbleTokens(resolveColourBubbleTokens(state)), isSelected && selectBorderBubbleTokens(defaultTokens)],
     onPress: onPress,
+    disabled: isDisabled,
+    focusable: !isDisabled,
     accessible: true,
     accessibilityRole: "radio",
     accessibilityLabel: colourName,
     accessibilityState: {
-      checked: isSelected
+      checked: isSelected,
+      disabled: isDisabled
     },
     ref: ref,
     testID: id,
-    children: /*#__PURE__*/_jsx(View, {
+    children: [/*#__PURE__*/_jsx(View, {
       style: [selectInnerBubbleTokens(themeTokens), {
         backgroundColor: colourHexCode
-      }]
-    })
+      }],
+      children: unavailable && /*#__PURE__*/_jsx(View, {
+        style: [StyleSheet.absoluteFillObject, selectOverlayStyles(themeTokens)]
+      })
+    }), unavailable && /*#__PURE__*/_jsx(View, {
+      style: [staticStyles.indicator, selectSlashStyles(themeTokens, unavailable)]
+    })]
   });
   if (showTooltip) {
     return /*#__PURE__*/_jsx(Tooltip, {
@@ -135,6 +170,24 @@ ColourBubble.propTypes = {
   /**
    * When true, wraps the bubble in a Tooltip that displays the colourName on hover (web only).
    */
-  showTooltip: PropTypes.bool
+  showTooltip: PropTypes.bool,
+  /**
+   * When set, renders a diagonal indicator over the bubble. Accepts either 'dark' or 'light' to determine the colour of the indicator.
+   */
+  unavailable: PropTypes.oneOf(Object.values(UNAVAILABLE_VARIANT)),
+  /**
+   * When true, disables interaction on the bubble.
+   */
+  isDisabled: PropTypes.bool
 };
+const staticStyles = StyleSheet.create({
+  indicator: {
+    position: 'absolute',
+    top: '50%',
+    height: 2,
+    transform: [{
+      rotate: '-45deg'
+    }]
+  }
+});
 export default ColourBubble;