@telus-uds/components-base 1.96.0 → 1.97.1

package/lib-module/HorizontalScroll/HorizontalScrollButton.js

@@ -1,79 +0,0 @@
-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 { variantProp, getTokensPropType, useCopy, copyPropTypes, a11yProps } from '../utils';
-import { useThemeTokens } from '../ThemeProvider';
-import IconButton from '../IconButton';
-import dictionary from './dictionary';
-import { jsx as _jsx } from "react/jsx-runtime";
-const selectContainerStyles = _ref => {
-  let {
-    offset
-  } = _ref;
-  return {
-    marginTop: offset ? -offset : 0
-  };
-};
-
-/**
- * Button within a Tabs component showing users that content is available to the left or
- * right, scrolling a screen's worth of content left or right when pressed.
- *
- * This is rendered automatically by `Tabs` and isn't intended be used directly.
- *
- * @TODO when IconButton is complete and stable revisit this and update interaction state styles.
- */
-const HorizontalScrollButton = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
-  let {
-    direction = 'next',
-    icon,
-    offset,
-    onPress,
-    variant,
-    tokens,
-    copy
-  } = _ref2;
-  const themeTokens = useThemeTokens('HorizontalScrollButton', tokens, variant);
-  const getCopy = useCopy({
-    dictionary,
-    copy
-  });
-  const label = direction === 'previous' ? getCopy('previousText') : getCopy('nextText');
-  return /*#__PURE__*/_jsx(View, {
-    style: [staticStyles.absolute, staticStyles[direction], selectContainerStyles({
-      offset
-    })],
-    children: /*#__PURE__*/_jsx(IconButton, {
-      accessibilityLabel: label,
-      icon: icon,
-      onPress: onPress,
-      ref: ref,
-      tokens: themeTokens,
-      variant: variant,
-      ...a11yProps.nonFocusableProps
-    })
-  });
-});
-HorizontalScrollButton.displayName = 'HorizontalScrollButton';
-const staticStyles = StyleSheet.create({
-  absolute: {
-    position: 'absolute'
-  },
-  previous: {
-    left: 0
-  },
-  next: {
-    right: 0
-  }
-});
-HorizontalScrollButton.propTypes = {
-  tokens: getTokensPropType('HorizontalScrollButton'),
-  variant: variantProp.propType,
-  copy: copyPropTypes,
-  direction: PropTypes.oneOf(['previous', 'next']),
-  offset: PropTypes.number,
-  icon: PropTypes.elementType,
-  onPress: PropTypes.func.isRequired
-};
-export default HorizontalScrollButton;

package/lib-module/HorizontalScroll/ScrollViewEnd.js

@@ -1,46 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import ScrollView from "react-native-web/dist/exports/ScrollView";
-import debounce from 'lodash.debounce';
-import { jsx as _jsx } from "react/jsx-runtime";
-const DEBOUNCE_MS = 100;
-
-/**
- * A wrapper for ScrollView that supports an `onScrollEnd` function.
- *
- * React Native Web hasn't got around to implementing any scroll end handlers yet,
- * so we need to work around it with debouncing on `onScroll`. See:
- * https://github.com/necolas/react-native-web/issues/1021
- */
-const ScrollViewEnd = /*#__PURE__*/React.forwardRef((_ref, ref) => {
-  let {
-    onScrollEnd,
-    onScroll = null,
-    ...props
-  } = _ref;
-  // Return debounced function directly from useCallback so it has .cancel method etc.
-  // Linter complains this stops it automatically scanning the deps, but we can check them manually.
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  const debounceScrollEnd = React.useCallback(debounce(event => onScrollEnd(event), DEBOUNCE_MS), [onScrollEnd]);
-
-  // Call any onScroll handler immediately, and any onScrollEnd handler after 100ms of no scrolling
-  const handleScroll = event => {
-    if (typeof onScroll === 'function') onScroll(event);
-    if (typeof onScrollEnd === 'function') debounceScrollEnd(event);
-  };
-
-  // Cancel any lingering debounce timeouts on dismount
-  React.useEffect(() => debounceScrollEnd.cancel);
-  return /*#__PURE__*/_jsx(ScrollView, {
-    ref: ref,
-    ...props,
-    onScroll: handleScroll,
-    scrollEventThrottle: DEBOUNCE_MS / 2
-  });
-});
-ScrollViewEnd.displayName = 'ScrollViewEnd';
-ScrollViewEnd.propTypes = {
-  onScrollEnd: PropTypes.func.isRequired,
-  onScroll: PropTypes.func
-};
-export default ScrollViewEnd;

package/lib-module/HorizontalScroll/ScrollViewEnd.native.js

@@ -1,26 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import ScrollView from "react-native-web/dist/exports/ScrollView";
-/**
- * A wrapper for ScrollView that supports an `onScrollEnd` function.
- *
- * React Native has two scroll end handlers, we want to treat them both the same.
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-const ScrollViewEnd = /*#__PURE__*/React.forwardRef((_ref, ref) => {
-  let {
-    onScrollEnd,
-    ...props
-  } = _ref;
-  return /*#__PURE__*/_jsx(ScrollView, {
-    ref: ref,
-    ...props,
-    onScrollEndDrag: onScrollEnd,
-    onMomentumScrollEnd: onScrollEnd
-  });
-});
-ScrollViewEnd.displayName = 'ScrollViewEnd';
-ScrollViewEnd.propTypes = {
-  onScrollEnd: PropTypes.func.isRequired
-};
-export default ScrollViewEnd;

package/lib-module/HorizontalScroll/dictionary.js

@@ -1,11 +0,0 @@
-export default {
-  en: {
-    // English text from TDS Community `Tabs`
-    previousLabel: 'Move menu to the left',
-    nextLabel: 'Move menu to the right'
-  },
-  fr: {
-    previousLabel: 'Déplacer le menu vers la gauche',
-    nextLabel: 'Déplacer le menu vers la droite'
-  }
-};

package/lib-module/HorizontalScroll/index.js

@@ -1,11 +0,0 @@
-import HorizontalScroll, { selectHorizontalScrollTokens } from './HorizontalScroll';
-import { useItemPositions, getItemPositionScrollTarget, getItemPositionLayoutHandler, itemPositionsPropType } from './itemPositions';
-export default HorizontalScroll;
-export { default as HorizontalScrollButton } from './HorizontalScrollButton';
-export const horizontalScrollUtils = {
-  selectHorizontalScrollTokens,
-  useItemPositions,
-  getItemPositionScrollTarget,
-  getItemPositionLayoutHandler,
-  itemPositionsPropType
-};

package/lib-module/HorizontalScroll/itemPositions.js

@@ -1,113 +0,0 @@
-import { useRef, useState } from 'react';
-import PropTypes from 'prop-types';
-
-// Utilities to assist scrolling a parent so that it snaps neatly to an appropriate child.
-
-/**
- * @typedef ItemPositionPosition
- * @property {number} [ItemPositionItem.start] - optional theme scale variants e.g. compact, wide
- * @property {number} [ItemPositionItem.end] - optional override to force a particular pixel size
- *
- * @typedef {Object.<number, ItemPositionItem>} ItemPositionPositions - ref object of start/end coordinates
- *
- * @typedef ItemPositions
- * @property {number} ItemPositions.contentWidth - current width of potentially-overflowing content inside scrollable
- * @property {number} ItemPositions.containerWidth - current width of non-overflowing outer scroll container
- * @property {number} ItemPositions.scrollOffset - current x position of the left edge of the visible section of the scrollable content
- * @property {ItemPositionPositions} ItemPositions.positions - `{ start, end }` coordinates of each scrollable content item, by index
- * @property {(targetX: number) => void)} ItemPositions.scrollTo - function to scroll to a co-ordinate, applying scrolling logic
- * @property {() => void)} ItemPositions.setIsReady - function to call when layout has been calculated and itemPositions data is ready
- */
-
-/**
- * Takes a desired scroll target coordinate and returns a valid coordinate
- * that, when not scrolling to one end or another, snaps to the start of an item,
- * making sure any "scroll back" button doesn't overlap the first item.
- *
- * @param {number} x - the intended coordinate to scroll to
- * @param {number} scrollMax - the highest posible coordinate to scroll to
- * @param {ItemPositionPositions} positions - positions list from `useItemPositions` ref
- * @param {number} [buttonClearance] - offset to allow space for a button
- * @returns {number}
- */
-export const getItemPositionScrollTarget = function (x, scrollMax, positions) {
-  let buttonClearance = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 0;
-  if (x <= 0) return 0;
-  if (x >= scrollMax) return scrollMax;
-
-  // If not scrolling all the way to the start or end, stop
-  // where the first item is not coverred by the scroll previous button
-  const targetItem = Object.values(positions).find(_ref => {
-    let {
-      start,
-      end
-    } = _ref;
-    return start <= x && end > x;
-  });
-
-  // If there's no target item we're landing at a gap between items
-  const targetX = targetItem ? targetItem.start : x;
-  return Math.max(0, targetX - buttonClearance);
-};
-
-/**
- * Returns a handler for React Native's `onLayout` which updates the values of
- * the ref object returned from `useItemPositions`.
- *
- * @param {ItemPositionPositions} positions
- * @param {number} index
- * @returns {function}
- */
-export const getItemPositionLayoutHandler = (positions, index) => {
-  const handleLayout = _ref2 => {
-    let {
-      nativeEvent: {
-        layout: {
-          width,
-          x
-        }
-      }
-    } = _ref2;
-    /* eslint-disable-next-line no-param-reassign */
-    positions[index] = {
-      start: x,
-      end: x + width
-    };
-  };
-  return handleLayout;
-};
-
-/**
- * Wrapper for `useRef` which gives a mutable object in which item start/end coordinates,
- * scrollTo method and content/container widths may be set and updated without causing a re-render.
- *
- * @returns {[ItemPositions, isReady: bool]} tuple array of:
- *  - current ref object `{ positions, contentWidth, containerWidth, scrollOffset, scrollTo, setIsReady }`
- *  - boolean that updates to `true` (causing a re-render) after the first time `setIsReady` is called
- */
-export const useItemPositions = () => {
-  const [isReady, setIsReady] = useState(false);
-  return [useRef({
-    positions: {},
-    scrollTo: () => {},
-    contentWidth: 0,
-    containerWidth: 0,
-    scrollOffset: 0,
-    setIsReady
-  }).current, isReady];
-};
-
-/**
- * PropType for the ref object returned by `useItemPositions`
- */
-export const itemPositionsPropType = PropTypes.exact({
-  positions: PropTypes.objectOf(PropTypes.shape({
-    start: PropTypes.number,
-    end: PropTypes.number
-  })),
-  scrollTo: PropTypes.func,
-  contentWidth: PropTypes.number,
-  containerWidth: PropTypes.number,
-  scrollOffset: PropTypes.number,
-  setIsReady: PropTypes.func
-});

package/lib-module/Icon/Icon.js

@@ -1,93 +0,0 @@
-import React from 'react';
-import Platform from "react-native-web/dist/exports/Platform";
-import View from "react-native-web/dist/exports/View";
-import PropTypes from 'prop-types';
-import { useThemeTokens } from '../ThemeProvider';
-import { getTokensPropType, scaleWithText, variantProp } from '../utils';
-import { jsx as _jsx } from "react/jsx-runtime";
-const Icon = /*#__PURE__*/React.forwardRef((_ref, ref) => {
-  let {
-    icon: IconComponent,
-    accessibilityLabel,
-    variant,
-    tokens,
-    scalesWithText = false,
-    style = {},
-    dataSet
-  } = _ref;
-  const themeTokens = useThemeTokens('Icon', tokens, variant);
-  const size = scalesWithText ? scaleWithText(themeTokens.size) : themeTokens.size;
-  const iconContent = /*#__PURE__*/_jsx(IconComponent, {
-    title: accessibilityLabel,
-    size: size,
-    color: themeTokens.color
-  });
-  const paddingStyles = variant !== null && variant !== void 0 && 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 /*#__PURE__*/_jsx(View, {
-        style: {
-          backgroundColor: themeTokens.backgroundColor,
-          borderRadius: themeTokens.borderRadius,
-          ...paddingStyles
-        },
-        children: iconContent
-      });
-    }
-    return iconContent;
-  };
-  return Platform.OS === 'web' ? /*#__PURE__*/_jsx(View, {
-    ref: ref
-    // eslint-disable-next-line react-native/no-inline-styles
-    ,
-    style: {
-      // TODO: systematise animations.
-      // https://github.com/telus/universal-design-system/issues/487
-      transition: 'transform 200ms, color 200ms',
-      transform: [themeTokens.scale ? `scale(${themeTokens.scale})` : '', themeTokens.translateX ? `translateX(${themeTokens.translateX}px)` : '', themeTokens.translateY ? `translateY(${themeTokens.translateY}px)` : ''].filter(exists => exists).join(' '),
-      ...style,
-      backgroundColor: themeTokens.backgroundColor,
-      borderRadius: themeTokens.borderRadius,
-      ...paddingStyles
-    },
-    dataSet: dataSet,
-    children: iconContent
-  }) : getIconContentForMobile();
-});
-Icon.displayName = 'Icon';
-export const iconComponentPropTypes = {
-  variant: variantProp.propType,
-  tokens: getTokensPropType('Icon'),
-  /**
-   * Descriptive label used in web SVG title tag for accessibility
-   */
-  accessibilityLabel: PropTypes.string,
-  /**
-   * controls whether the icon size should be proportionate to any accessibility-related font scaling.
-   */
-  scalesWithText: PropTypes.bool,
-  /**
-   * Custom style object to be applied to the icon component.
-   * This is useful for overriding the default icon style but for cases where desires styles are not available as tokens.
-   *
-   * Note: This prop is only used in web.
-   *
-   * @example
-   * <Icon style={{ color: 'red' }}
-   */
-  style: PropTypes.object
-};
-Icon.propTypes = {
-  ...iconComponentPropTypes,
-  /**
-   * A valid UDS icon component imported from a UDS palette
-   * (e.g.) `import { MyIcon } from @telus-uds/palette-<brand>/build/web/icons`
-   */
-  icon: PropTypes.elementType.isRequired
-};
-export default Icon;

package/lib-module/Icon/IconText.js

@@ -1,114 +0,0 @@
-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';
-
-/**
- * Returns an icon and some text with a sized gap between them. This is a utility component
- * intended for use when creating components, not intended for use in applications on its own.
- *
- * IconText does not wrap its children, so should be used either:
- *  - inline within a <Text> element
- *  - 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 {
-    space,
-    iconPosition = 'left',
-    icon: IconComponent,
-    iconProps,
-    children
-  } = _ref;
-  const iconContent = IconComponent && /*#__PURE__*/_jsx(Icon, {
-    ref: ref,
-    icon: IconComponent,
-    scalesWithText: true,
-    ...iconProps
-  });
-
-  // Inline images on Android are always baseline-aligned which makes them look misaligned - offset it.
-  // See abandoned issue https://github.com/facebook/react-native/issues/6529
-  const size = (iconProps === null || iconProps === void 0 ? void 0 : (_iconProps$tokens = iconProps.tokens) === null || _iconProps$tokens === void 0 ? void 0 : _iconProps$tokens.size) ?? 0;
-  const valueTranslateY = iconProps === null || iconProps === void 0 ? void 0 : (_iconProps$tokens2 = iconProps.tokens) === null || _iconProps$tokens2 === void 0 ? void 0 : _iconProps$tokens2.translateY;
-  /**
-   * These calculations were carried out using a set of linear equations to calculate that the
-   * position of the icon "->"" is aligned to the first line of the tooltip text on IOS and Android.
-   * The issue was mainly on IOS, the translateY style didn't match with the old calculations.
-   */
-  const resultY = valueTranslateY ? Math.floor(-1 * (valueTranslateY - 4)) : 0;
-  const iconAdjustedAndroid = /*#__PURE__*/_jsx(View, {
-    style: {
-      transform: [{
-        translateY: valueTranslateY ? size * 0.2 : size * 0.01
-      }]
-    },
-    children: iconContent
-  });
-  const iconAdjustedIOS = /*#__PURE__*/_jsx(View, {
-    style: {
-      transform: [{
-        translateY: valueTranslateY ? resultY : size * 0.01
-      }]
-    },
-    children: iconContent
-  });
-  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'
-  });
-});
-IconText.displayName = 'IconText';
-IconText.propTypes = {
-  /* eslint-disable react/no-unused-prop-types */ // eslint is having hard time seeing these props through forwardRef
-  /**
-   * Amount of space to separate the text content and icon. Uses the themes's spacing scale
-   * (see useSpacingScale for more info).
-   */
-  space: spacingProps.types.spacingValue,
-  /**
-   * 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', 'inline']),
-  /**
-   * A valid UDS icon component imported from a UDS palette.
-   */
-  icon: PropTypes.elementType,
-  /**
-   * Props that will be passed to the icon component. By default the icon's `scalesWithText`
-   * prop will be set as "true" so that the icon continues to match the size of the text
-   * if users use accessibility settings to increase text size.
-   */
-  iconProps: PropTypes.exact(iconComponentPropTypes),
-  /**
-   * Content to be rendered alongside the Icon component. Usually this should be a
-   * `<Typography>` component, or a component that renders `<Text>`.
-   */
-  children: PropTypes.node
-  /* eslint-enable react/no-unused-prop-types */
-};
-
-const staticStyles = StyleSheet.create({
-  adjustedContainer: {
-    position: 'absolute'
-  }
-});
-export default IconText;

package/lib-module/Icon/index.js

@@ -1,4 +0,0 @@
-import Icon, { iconComponentPropTypes } from './Icon';
-import IconText from './IconText';
-export default Icon;
-export { iconComponentPropTypes, IconText };