@telus-uds/components-base 1.94.0 → 1.95.0

package/lib/Tooltip/getTooltipPosition.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-function normalizePosition(position) {
+function getAbsolutePosition(position) {
   const {
     left,
     right,
@@ -15,7 +15,7 @@ function normalizePosition(position) {
   } = position;
 
   // adjust the coordinates so that it fits within the window
-  const normalized = {
+  const finalPosition = {
     left: Math.max(0, left),
     right: Math.max(0, right),
     top: Math.max(0, top),
@@ -25,15 +25,14 @@ function normalizePosition(position) {
   const getAbsoluteDiff = (value1, value2) => Math.abs(Math.abs(value1) - Math.abs(value2));
 
   // adjust the width by whatever has been subtracted from left or right
-  normalized.width = width - Math.abs(getAbsoluteDiff(left, normalized.left) - getAbsoluteDiff(right, normalized.right));
-  if (normalized.top !== top) {
-    normalized.bottom += normalized.top - top;
+  finalPosition.width = width - Math.abs(getAbsoluteDiff(left, finalPosition.left) - getAbsoluteDiff(right, finalPosition.right));
+  if (finalPosition.top !== top) {
+    finalPosition.bottom += finalPosition.top - top;
   }
-  const isNormalized = normalized.right !== right || normalized.left !== left || normalized.top !== top;
   return {
-    ...normalized,
+    ...finalPosition,
     ...rest,
-    isNormalized
+    isNormalized: false
   };
 }
 function invertPosition(position) {
@@ -172,7 +171,7 @@ function getTooltipPosition(position, _ref2) {
 
   // prefer 'below' over 'above', since we can always expand the document downwards,
   // and 'above' might cause issues on small viewports with large tooltips
-  return normalizePosition(leastOverflowing.position === 'above' ? findRectByPosition('below', boundingRects) : leastOverflowing);
+  return getAbsolutePosition(leastOverflowing.position === 'above' ? findRectByPosition('below', boundingRects) : leastOverflowing);
 }
 var _default = getTooltipPosition;
 exports.default = _default;

package/lib/index.js

@@ -19,6 +19,7 @@ var _exportNames = {
   CheckboxCard: true,
   CheckboxCardGroup: true,
   ColourToggle: true,
+  DownloadApp: true,
   Divider: true,
   ExpandCollapse: true,
   Accordion: true,
@@ -58,6 +59,7 @@ var _exportNames = {
   Status: true,
   StepTracker: true,
   Tabs: true,
+  TabBar: true,
   Tags: true,
   Timeline: true,
   Tooltip: true,
@@ -178,6 +180,12 @@ Object.defineProperty(exports, "Divider", {
     return _Divider.default;
   }
 });
+Object.defineProperty(exports, "DownloadApp", {
+  enumerable: true,
+  get: function () {
+    return _DownloadApp.default;
+  }
+});
 Object.defineProperty(exports, "ExpandCollapse", {
   enumerable: true,
   get: function () {
@@ -418,6 +426,12 @@ Object.defineProperty(exports, "StepTracker", {
     return _StepTracker.default;
   }
 });
+Object.defineProperty(exports, "TabBar", {
+  enumerable: true,
+  get: function () {
+    return _TabBar.default;
+  }
+});
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
   get: function () {
@@ -593,6 +607,7 @@ Object.keys(_Checkbox).forEach(function (key) {
 var _CheckboxCard = _interopRequireDefault(require("./CheckboxCard"));
 var _CheckboxCardGroup = _interopRequireDefault(require("./CheckboxCardGroup"));
 var _ColourToggle = _interopRequireDefault(require("./ColourToggle"));
+var _DownloadApp = _interopRequireDefault(require("./DownloadApp"));
 var _Divider = _interopRequireDefault(require("./Divider"));
 var _ExpandCollapse = _interopRequireWildcard(require("./ExpandCollapse"));
 var _Feedback = _interopRequireDefault(require("./Feedback"));
@@ -696,6 +711,7 @@ Object.keys(_StackView).forEach(function (key) {
 var _Status = _interopRequireDefault(require("./Status"));
 var _StepTracker = _interopRequireDefault(require("./StepTracker"));
 var _Tabs = _interopRequireDefault(require("./Tabs"));
+var _TabBar = _interopRequireDefault(require("./TabBar"));
 var _Tags = _interopRequireDefault(require("./Tags"));
 var _TextInput = require("./TextInput");
 Object.keys(_TextInput).forEach(function (key) {

package/lib-module/Autocomplete/Autocomplete.js

@@ -106,6 +106,7 @@ const Autocomplete = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
     validation,
     value,
     helpText = '',
+    loadingLabel,
     ...rest
   } = _ref2;
   const {
@@ -341,7 +342,7 @@ const Autocomplete = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
         onLayout: handleMeasure,
         ref: openOverlayRef,
         children: isLoading ? /*#__PURE__*/_jsx(Loading, {
-          label: getCopy('loading')
+          label: loadingLabel ?? getCopy('loading')
         }) : /*#__PURE__*/_jsx(Suggestions, {
           hasResults: getCopy('hasResults'),
           id: "autocomplete",

package/lib-module/DownloadApp/DownloadApp.js

@@ -0,0 +1,160 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+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 { a11yProps, linkProps, hrefAttrsProp, viewProps, getTokensPropType, resolvePressableTokens, variantProp, copyPropTypes, selectSystemProps, useCopy } from '../utils';
+import { useThemeTokensCallback } from '../ThemeProvider';
+import defaultDictionary from './dictionary';
+import { jsx as _jsx } from "react/jsx-runtime";
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, linkProps, viewProps]);
+const selectOuterStyles = _ref => {
+  let {
+    borderColor,
+    borderWidth,
+    borderGap,
+    borderRadius,
+    padding
+  } = _ref;
+  return {
+    outline: 'none',
+    borderColor,
+    borderWidth,
+    borderGap,
+    borderRadius,
+    padding
+  };
+};
+const DownloadApp = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
+  let {
+    copy = 'en',
+    dictionary = defaultDictionary,
+    type = 'ios',
+    href,
+    onPress,
+    tokens = {},
+    variant = {},
+    ...props
+  } = _ref2;
+  const getCopy = useCopy({
+    dictionary,
+    copy
+  });
+  const {
+    hrefAttrs,
+    rest
+  } = hrefAttrsProp.bundle(props);
+  const selectedProps = selectProps({
+    accessibilityRole: href ? 'link' : 'button',
+    href,
+    onPress: linkProps.handleHref({
+      href,
+      onPress
+    }),
+    hrefAttrs,
+    ...rest
+  });
+  const getDownloadAppTokens = useThemeTokensCallback('DownloadApp', tokens, variant);
+  const resolveDownloadAppTokens = pressableState => {
+    const themeTokens = resolvePressableTokens(getDownloadAppTokens, pressableState, {});
+    return selectOuterStyles(themeTokens);
+  };
+  const {
+    androidENIcon,
+    androidFRIcon,
+    iosENIcon,
+    iosFRIcon
+  } = getDownloadAppTokens();
+  const imageResources = {
+    en: {
+      android: androidENIcon,
+      ios: iosENIcon
+    },
+    fr: {
+      android: androidFRIcon,
+      ios: iosFRIcon
+    }
+  };
+  const IconComponent = imageResources[copy][type];
+  return /*#__PURE__*/_jsx(Pressable, {
+    ref: ref,
+    style: pressState => [resolveDownloadAppTokens(pressState), staticStyles.row],
+    ...selectedProps,
+    children: /*#__PURE__*/_jsx(IconComponent, {
+      style: staticImageSizes[type][copy],
+      alt: type === 'ios' ? getCopy('altTextIos') : getCopy('altTextAndroid')
+    })
+  });
+});
+DownloadApp.displayName = 'DownloadApp';
+const dictionaryContentShape = PropTypes.shape({
+  altTextAndroid: PropTypes.string.isRequired,
+  altTextIos: PropTypes.string.isRequired
+});
+DownloadApp.propTypes = {
+  ...selectedSystemPropTypes,
+  copy: copyPropTypes,
+  /**
+   * Override the default dictionary, by passing the complete dictionary object for `en` and `fr`
+   */
+  dictionary: PropTypes.shape({
+    en: dictionaryContentShape,
+    fr: dictionaryContentShape
+  }),
+  /**
+   * Select the type of image to show.
+   */
+  type: PropTypes.oneOf(['android', 'ios']),
+  /**
+   * It's a simple link that opens the Download Button instead of the onPress function.
+   */
+  href: PropTypes.string,
+  /**
+   * Function called when the button is pressed. Required unless the button has a href.
+   */
+  onPress: PropTypes.func,
+  /**
+   * DownloadApp tokens.
+   */
+  tokens: getTokensPropType('DownloadApp'),
+  /**
+   * DownloadApp variant.
+   */
+  variant: variantProp.propType
+};
+const staticStyles = StyleSheet.create({
+  row: {
+    ...Platform.select({
+      web: {
+        display: 'inline-flex',
+        width: 'fit-content'
+      },
+      default: {
+        alignSelf: 'flex-start'
+      }
+    })
+  }
+});
+const staticImageSizes = {
+  android: {
+    en: {
+      width: 162,
+      height: 48
+    },
+    fr: {
+      width: 162,
+      height: 48
+    }
+  },
+  ios: {
+    en: {
+      width: 144,
+      height: 48
+    },
+    fr: {
+      width: 152,
+      height: 48
+    }
+  }
+};
+export default DownloadApp;

package/lib-module/DownloadApp/dictionary.js

@@ -0,0 +1,10 @@
+export default {
+  en: {
+    altTextAndroid: 'Get it on Google Play',
+    altTextIos: 'Download on the App Store'
+  },
+  fr: {
+    altTextAndroid: 'Disponible sur Google Play',
+    altTextIos: 'Télécharger dans l’App Store'
+  }
+};

package/lib-module/DownloadApp/index.js

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

package/lib-module/Icon/IconText.js

@@ -2,6 +2,8 @@ import React from 'react';
 import PropTypes from 'prop-types';
 import Platform from "react-native-web/dist/exports/Platform";
 import View from "react-native-web/dist/exports/View";
+import Text from "react-native-web/dist/exports/Text";
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
 import Icon, { iconComponentPropTypes } from './Icon';
 import { getStackedContent } from '../StackView';
 import { spacingProps } from '../utils';
@@ -15,6 +17,7 @@ import { spacingProps } from '../utils';
  *  - within a container with `flexDirection: 'row'`
  */
 import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
 const IconText = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   var _iconProps$tokens, _iconProps$tokens2;
   let {
@@ -59,6 +62,15 @@ const IconText = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   });
   const mobile = Platform.OS === 'android' ? iconAdjustedAndroid : iconAdjustedIOS;
   const adjustedContainer = Platform.OS === 'web' ? iconContent : mobile;
+  const adjustedContainerWithPosition = /*#__PURE__*/_jsx(View, {
+    style: staticStyles.adjustedContainer,
+    children: adjustedContainer
+  });
+  if (iconPosition === 'inline') {
+    return /*#__PURE__*/_jsxs(Text, {
+      children: [children, " ", adjustedContainerWithPosition]
+    });
+  }
   return getStackedContent(iconPosition === 'left' ? [adjustedContainer, children] : [children, adjustedContainer], {
     space,
     direction: 'row'
@@ -73,9 +85,9 @@ IconText.propTypes = {
    */
   space: spacingProps.types.spacingValue,
   /**
-   * Whether the icon should be to the left of the content or the right of the content.
+   * Whether the icon should be to the left of the content, the right of the content or inline with the content.
    */
-  iconPosition: PropTypes.oneOf(['left', 'right']),
+  iconPosition: PropTypes.oneOf(['left', 'right', 'inline']),
   /**
    * A valid UDS icon component imported from a UDS palette.
    */
@@ -94,4 +106,9 @@ IconText.propTypes = {
   /* eslint-enable react/no-unused-prop-types */
 };
 
+const staticStyles = StyleSheet.create({
+  adjustedContainer: {
+    position: 'absolute'
+  }
+});
 export default IconText;

package/lib-module/Link/LinkBase.js

@@ -238,9 +238,9 @@ LinkBase.propTypes = {
    */
   icon: PropTypes.elementType,
   /**
-   * When `icon` is provided, use `iconPosition` to place the Icon to the left or right side of Link.
+   * When `icon` is provided, use `iconPosition` to place the Icon to the left, right or inline with Link.
    */
-  iconPosition: PropTypes.oneOf(['left', 'right']),
+  iconPosition: PropTypes.oneOf(['left', 'right', 'inline']),
   /**
    * On Web if href is passed, React Native Web maps this object's props to
    * `rel`, `target` and `download` attrs.

package/lib-module/Modal/Modal.js

@@ -153,7 +153,7 @@ const Modal = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
     if (Platform.OS === 'web') {
       const handleFocus = () => {
         // If the focus is on the last item of the web modal container, move it to the close button
-        if (document.activeElement === focusTrapRef.current) {
+        if (document.activeElement === focusTrapRef.current && closeButtonRef.current) {
           closeButtonRef.current.focus();
         }
         return undefined;

package/lib-module/TabBar/TabBar.js

@@ -0,0 +1,125 @@
+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 TabBarItem from './TabBarItem';
+import { useThemeTokens } from '../ThemeProvider';
+import { variantProp, getTokensPropType, selectSystemProps, a11yProps, viewProps } from '../utils';
+import { jsx as _jsx } from "react/jsx-runtime";
+const selectTabBarContainerStyles = _ref => {
+  let {
+    paddingTop,
+    paddingBottom,
+    borderTopWidth,
+    borderTopColor,
+    backgroundColor
+  } = _ref;
+  return {
+    paddingTop,
+    paddingBottom,
+    borderTopWidth,
+    borderTopColor,
+    backgroundColor
+  };
+};
+const selectTabBarItemContainerStyles = _ref2 => {
+  let {
+    paddingLeft,
+    paddingRight,
+    gap
+  } = _ref2;
+  return {
+    paddingLeft,
+    paddingRight,
+    gap
+  };
+};
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps]);
+
+/**
+ * TabBar component renders a navigation bar with multiple TabBarItems.
+ * It allows users to switch between different views or sections.
+ *
+ * @component
+ * @example
+ * const items = [
+ *   { id: '1', label: 'Home', icon: <HomeIcon />, iconActive: <HomeActiveIcon /> },
+ *   { id: '2', label: 'Profile', icon: <ProfileIcon />, iconActive: <ProfileActiveIcon /> },
+ * ]
+ * return (
+ *   <TabBar
+ *     items={items}
+ *     initiallySelectedItem="1"
+ *     onChange={(itemId) => console.log(itemId)}
+ *   />
+ * )
+ */
+
+const TabBar = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
+  let {
+    items = [],
+    initiallySelectedItem = '0',
+    onChange,
+    variant,
+    tokens,
+    ...rest
+  } = _ref3;
+  const [isSelected, setIsSelected] = React.useState(initiallySelectedItem);
+  const themeTokens = useThemeTokens('TabBar', tokens, variant);
+  const handlePress = itemId => {
+    setIsSelected(itemId);
+    onChange === null || onChange === void 0 ? void 0 : onChange(itemId);
+  };
+  return /*#__PURE__*/_jsx(View, {
+    ref: ref,
+    style: [styles.tabBar, selectTabBarContainerStyles(themeTokens)],
+    ...selectProps(rest),
+    children: /*#__PURE__*/_jsx(View, {
+      style: [styles.tabBarItem, selectTabBarItemContainerStyles(themeTokens)],
+      children: items.map((item, index) => /*#__PURE__*/_jsx(TabBarItem, {
+        label: item.label,
+        href: item.href,
+        isSelected: isSelected === item.id,
+        icon: item.icon,
+        iconActive: item.iconActive,
+        onPress: () => handlePress(item.id),
+        id: `tab-item-${index}`,
+        accessibilityRole: "tablist"
+      }, item.id))
+    })
+  });
+});
+TabBar.displayName = 'TabBar';
+TabBar.propTypes = {
+  ...selectedSystemPropTypes,
+  /** Array of TabBarItems to be displayed in TabBar */
+  items: PropTypes.arrayOf(PropTypes.shape({
+    id: PropTypes.string.isRequired,
+    icon: PropTypes.node,
+    iconActive: PropTypes.node,
+    label: PropTypes.string.isRequired,
+    href: PropTypes.string
+  })).isRequired,
+  /** Id of the initially selected item. */
+  initiallySelectedItem: PropTypes.number,
+  /** Callback function to handle item selection change. */
+  onChange: PropTypes.func,
+  /** Variant of TabBar for styling purposes. */
+  variant: variantProp.propType,
+  /** Tokens for theming and styling. */
+  tokens: getTokensPropType('TabBar')
+};
+const styles = StyleSheet.create({
+  tabBar: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center'
+  },
+  tabBarItem: {
+    flex: 1,
+    flexDirection: 'row',
+    justifyContent: 'space-between',
+    width: '100%'
+  }
+});
+export default TabBar;

package/lib-module/TabBar/TabBarItem.js

@@ -0,0 +1,177 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import Pressable from "react-native-web/dist/exports/Pressable";
+import View from "react-native-web/dist/exports/View";
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
+import { getTokensPropType, resolvePressableTokens, variantProp } from '../utils';
+import { useThemeTokensCallback } from '../ThemeProvider';
+import Typography from '../Typography';
+import Spacer from '../Spacer';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const selectTypographyStyles = (_ref, isSelected) => {
+  let {
+    fontWeight,
+    color,
+    lineHeight,
+    fontName,
+    activeColor
+  } = _ref;
+  return {
+    fontWeight,
+    color: isSelected ? activeColor : color,
+    lineHeight,
+    fontName
+  };
+};
+const selectIconContainerStyles = _ref2 => {
+  let {
+    paddingTop,
+    paddingBottom
+  } = _ref2;
+  return {
+    paddingTop,
+    paddingBottom,
+    alignItems: 'center'
+  };
+};
+const selectIconStyles = (_ref3, isSelected) => {
+  let {
+    iconSize,
+    iconColor,
+    activeColor
+  } = _ref3;
+  return {
+    size: iconSize,
+    color: isSelected ? activeColor : iconColor
+  };
+};
+const selectContainerStyles = _ref4 => {
+  let {
+    borderRadius,
+    backgroundColor
+  } = _ref4;
+  return {
+    borderRadius,
+    backgroundColor,
+    alignSelf: 'center',
+    alignItems: 'center'
+  };
+};
+const TabBarItem = /*#__PURE__*/React.forwardRef((_ref5, ref) => {
+  let {
+    href,
+    variant,
+    tokens,
+    label,
+    isSelected,
+    id,
+    onPress,
+    icon: IconComponent,
+    iconActive: IconActiveComponent,
+    accessibilityRole = 'tab'
+  } = _ref5;
+  const getTokens = useThemeTokensCallback('TabBarItem', tokens, variant);
+  const getPressableStyle = _ref6 => {
+    let {
+      pressed,
+      focused,
+      hovered
+    } = _ref6;
+    const resolvedTokens = resolvePressableTokens(getTokens, {
+      pressed,
+      focused,
+      hovered
+    }, {
+      isSelected
+    });
+    return {
+      ...resolvedTokens,
+      outline: 'none' // removes the default browser :focus outline
+    };
+  };
+
+  return /*#__PURE__*/_jsx(Pressable, {
+    ref: ref,
+    href: href,
+    nativeID: id,
+    onPress: onPress,
+    style: _ref7 => {
+      let {
+        pressed,
+        focused,
+        hovered
+      } = _ref7;
+      return [styles.flexContainer, getPressableStyle({
+        pressed,
+        focused,
+        hovered
+      })];
+    },
+    accessibilityRole: accessibilityRole,
+    testID: id,
+    children: pressableState => {
+      const resolvedTokens = getPressableStyle(pressableState);
+      return /*#__PURE__*/_jsxs(View, {
+        style: selectContainerStyles(resolvedTokens),
+        children: [/*#__PURE__*/_jsx(View, {
+          style: [selectIconContainerStyles(resolvedTokens), styles.iconContainer],
+          children: isSelected ? IconActiveComponent && /*#__PURE__*/_jsx(IconActiveComponent, {
+            ...selectIconStyles(resolvedTokens, isSelected)
+          }) : IconComponent && /*#__PURE__*/_jsx(IconComponent, {
+            ...selectIconStyles(resolvedTokens)
+          })
+        }), /*#__PURE__*/_jsx(Spacer, {
+          space: 1
+        }), /*#__PURE__*/_jsx(Typography, {
+          variant: {
+            size: 'micro'
+          },
+          tokens: selectTypographyStyles(resolvedTokens, isSelected),
+          align: "center",
+          children: label
+        }), /*#__PURE__*/_jsx(Spacer, {
+          space: 1
+        })]
+      });
+    }
+  });
+});
+TabBarItem.displayName = 'TabBarItem';
+TabBarItem.propTypes = {
+  /** The icon to be displayed when the item is not selected. */
+  icon: PropTypes.elementType,
+  /** The icon to be displayed when the item is selected. */
+  iconActive: PropTypes.elementType,
+  /** Tokens for theming and styling the TabBarItem. */
+  tokens: getTokensPropType('TabBarItem'),
+  /** Variant of the TabBarItem for styling purposes. */
+  variant: variantProp.propType,
+  /** Callback function to handle press events. */
+  onPress: PropTypes.func,
+  /** URL to navigate to when the item is pressed. */
+  href: PropTypes.string,
+  /** Indicates whether the item is selected. */
+  isSelected: PropTypes.bool,
+  /** Unique identifier for the item. */
+  id: PropTypes.string,
+  /** Label text for the item. */
+  label: PropTypes.string.isRequired,
+  /** Accessibility role for the item. */
+  accessibilityRole: PropTypes.string
+};
+const styles = StyleSheet.create({
+  flexContainer: {
+    flex: 1,
+    alignItems: 'center'
+  },
+  iconContainer: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    minWidth: 44,
+    minHeight: 40,
+    aspectRatio: 1.1
+  }
+});
+export default TabBarItem;

package/lib-module/TabBar/index.js

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

package/lib-module/TextInput/TextInputBase.js

@@ -42,7 +42,8 @@ const selectInputStyles = function (_ref, themeOptions, inactive, type) {
   // jump around if the border width changes (avoiding NaN and negative padding)
   const offsetBorder = value => typeof value === 'number' ? Math.max(0, value - borderWidth) : value;
   const textStyles = applyTextStyles({
-    fontName,
+    fontName: isPassword ? undefined : fontName,
+    // In this case, we don't want to apply the fontName to the input if it's a password because Monotype don't have support for the masked characters in mobile.
     fontSize,
     lineHeight,
     fontWeight,