@telus-uds/components-base 1.96.0 → 1.97.1

package/lib-module/Button/ButtonGroup.js

@@ -1,272 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import ABBPropTypes from 'airbnb-prop-types';
-import Platform from "react-native-web/dist/exports/Platform";
-import ButtonBase from './ButtonBase';
-import { StackWrap } from '../StackView';
-import Fieldset from '../Fieldset';
-import { useViewport } from '../ViewportProvider';
-import { useThemeTokens, useThemeTokensCallback } from '../ThemeProvider';
-import { a11yProps, containUniqueFields, focusHandlerProps, pressProps, getTokensPropType, selectSystemProps, selectTokens, useMultipleInputValues, variantProp, viewProps } from '../utils';
-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 ButtonGroup = /*#__PURE__*/React.forwardRef((_ref, ref) => {
-  let {
-    variant,
-    buttonVariant,
-    tokens,
-    items = [],
-    values,
-    initialValues,
-    maxValues = 1,
-    onChange,
-    readOnly = false,
-    inactive = false,
-    legend,
-    tooltip,
-    hint,
-    hintPosition = 'inline',
-    validation,
-    feedback,
-    name: inputGroupName,
-    copy,
-    iconPosition,
-    accessibilityRole = maxValues === 1 ? 'radiogroup' // radiogroup is cross-platform; only web aria has generic groups
-    : Platform.select({
-      web: 'group',
-      default: 'none'
-    }),
-    ...rest
-  } = _ref;
-  const viewport = useViewport();
-  const themeTokens = useThemeTokens('ButtonGroup', tokens, variant, {
-    viewport
-  });
-  const stackTokens = selectTokens('StackView', themeTokens);
-  const {
-    direction,
-    space,
-    fieldSpace,
-    borderRadius,
-    backgroundColor,
-    padding,
-    gap
-  } = themeTokens;
-  const getButtonTokens = useThemeTokensCallback('ButtonGroupItem', tokens, variant);
-  const {
-    currentValues,
-    toggleOneValue
-  } = useMultipleInputValues({
-    initialValues,
-    values,
-    maxValues,
-    onChange,
-    readOnly
-  });
-  const systemProps = selectProps({
-    accessibilityRole,
-    ...rest
-  });
-  const itemA11yRole = systemProps.accessibilityRole === 'radiogroup' ? 'radio' : 'checkbox';
-  const uniqueFields = ['id', 'label'];
-  if (!containUniqueFields(items, uniqueFields)) {
-    throw new Error(`ButtonGroup items must have unique ${uniqueFields.join(', ')}`);
-  }
-
-  // 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;
-  return /*#__PURE__*/_jsx(Fieldset, {
-    ...systemProps,
-    ref: ref,
-    name: inputGroupName,
-    legend: legend,
-    tooltip: tooltip,
-    hint: hint,
-    hintPosition: hintPosition,
-    space: fieldSpace,
-    feedback: feedback,
-    readOnly: readOnly,
-    inactive: inactive,
-    validation: validation,
-    accessibilityRole: accessibilityRole,
-    style: {
-      borderRadius,
-      backgroundColor,
-      padding,
-      ...(Platform.OS === 'web' ? {
-        gap,
-        width: 'fit-content'
-      } : {
-        alignSelf: 'flex-start'
-      })
-    },
-    ...selectProps(rest),
-    children: /*#__PURE__*/_jsx(StackWrap, {
-      accessibilityRole: innerRole,
-      space: space,
-      direction: direction,
-      tokens: stackTokens,
-      gap: gap,
-      ref: ref,
-      children: items.map((_ref2, index) => {
-        let {
-          label,
-          id = label,
-          accessibilityLabel,
-          ref: itemRef,
-          ...itemRest
-        } = _ref2;
-        const isSelected = currentValues.includes(id);
-
-        // Pass an object of relevant component state as first argument for any passed-in press handlers
-        const pressHandlers = getPressHandlersWithArgs(rest, [{
-          id,
-          label,
-          currentValues
-        }]);
-        const handlePress = event => {
-          if (pressHandlers.onPress) pressHandlers.onPress(event);
-          toggleOneValue(id, event);
-        };
-        const iconProp = itemRest.icon || undefined;
-        const itemA11y = {
-          accessibilityState: {
-            checked: isSelected
-          },
-          accessibilityRole: itemA11yRole,
-          accessibilityLabel,
-          ...a11yProps.getPositionInSet(items.length, index)
-        };
-
-        // Ensure button is direct child of group as MacOS voiceover only applies "X of Y" to
-        // "radio" if it's a direct child of "radiogroup", even if aria-posinset etc exists
-        return /*#__PURE__*/_jsx(ButtonBase, {
-          ref: itemRef,
-          variant: buttonVariant,
-          ...pressHandlers,
-          onPress: handlePress,
-          tokens: getButtonTokens,
-          selected: isSelected,
-          inactive: inactive,
-          icon: iconProp,
-          ...selectItemProps({
-            ...itemRest,
-            ...itemA11y
-          }),
-          iconPosition: iconPosition,
-          children: label
-        }, id);
-      })
-    })
-  });
-});
-ButtonGroup.displayName = 'ButtonGroup';
-ButtonGroup.propTypes = {
-  ...selectedSystemPropTypes,
-  tokens: getTokensPropType('ButtonGroup'),
-  /**
-   * To allow Button specific variant
-   */
-  buttonVariant: variantProp.propType,
-  /**
-   * Default variant prop
-   */
-  variant: variantProp.propType,
-  /**
-   * The maximum number of items a user may select at once. Defaults to 1 and behaves
-   * like radio buttons. To have no limit and allow any number of selections, pass `null`.
-   */
-  maxValues: PropTypes.number,
-  /**
-   * The options a user may select
-   */
-  items: PropTypes.arrayOf(PropTypes.shape({
-    ...selectedItemPropTypes,
-    /**
-     * The text displayed to the user in the button, describing this option,
-     * passed to the button as its child.
-     */
-    label: PropTypes.string.isRequired,
-    /**
-     * An optional accessibility label may be passed to ButtonGroup Buttons
-     * which is applied as normal for a React Native accessibilityLabel prop.
-     */
-    accessibilityLabel: PropTypes.string,
-    /**
-     * An optional unique string may be provided to identify this option,
-     * which will be used in code and passed to any onChange function.
-     * If not provided, the label is used.
-     */
-    id: PropTypes.string,
-    /**
-     * An optional ref for one individual button in the ButtonGroup
-     */
-    ref: ABBPropTypes.ref()
-  })),
-  /**
-   * If provided, this function is called when the current selection is changed
-   * and is passed an array of the `id`s of all currently selected `items`.
-   */
-  onChange: PropTypes.func,
-  /**
-   * If the selected item(s) in the button group are to be controlled externally by
-   * a parent component, pass an array of strings as well as an `onChange` handler.
-   * Passing an array for "values" makes the ButtonGroup a "controlled" component that
-   * expects its state to be handled via `onChange` and so doesn't handle it itself.
-   */
-  values: PropTypes.arrayOf(PropTypes.string),
-  /**
-   * If `values` is not passed, making the ButtonGroup an "uncontrolled" component
-   * managing its own selected state, a default set of selections may be provided.
-   * Changing the `initialValues` does not change the user's selections.
-   */
-  initialValues: PropTypes.arrayOf(PropTypes.string),
-  /**
-   * Defines if the icon will be displayed on the right or left side of the label.
-   */
-  iconPosition: PropTypes.oneOf(['left', 'right']),
-  /**
-   * Main text used to describe this group, used in Fieldset's Legend element.
-   */
-  legend: PropTypes.string,
-  /**
-   * Optional additional text giving more detail to help a user make a choice.
-   */
-  hint: PropTypes.string,
-  /**
-   * Position of the hint relative to label. Use `below` to display a larger hint below the label.
-   */
-  hintPosition: PropTypes.oneOf(['inline', 'below']),
-  /**
-   * Optional tooltip text content to include alongside the legend and hint.
-   */
-  tooltip: PropTypes.string,
-  /**
-   * Current validation status of the group, passed to the feedback element if there is one.
-   */
-  validation: PropTypes.oneOf(['error', 'success']),
-  /**
-   * If provided, a Feedback element is rendered containing this text.
-   */
-  feedback: PropTypes.string,
-  /**
-   * If true, the buttons cannot be selected by the user and simply show their current state.
-   */
-  readOnly: PropTypes.bool,
-  /**
-   * If true, the buttons cannot be interacted with, elements are set as `disabled` and if the
-   * theme supports `inactive` appearances rules, these are applied.
-   */
-  inactive: PropTypes.bool,
-  /**
-   * On Web, this is passed to the `name` attribute of the fieldset.
-   */
-  name: PropTypes.string,
-  /**
-   * Sets the language of microcopy in subcomponents (e.g. Tooltip's default accessibility label).
-   */
-  copy: PropTypes.oneOf(['en', 'fr'])
-};
-export default ButtonGroup;

package/lib-module/Button/ButtonLink.js

@@ -1,50 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import ButtonBase from './ButtonBase';
-import buttonPropTypes, { textAndA11yText } from './propTypes';
-import { a11yProps, hrefAttrsProp, linkProps } from '../utils/props';
-import { useThemeTokensCallback } from '../ThemeProvider';
-import { useViewport } from '../ViewportProvider';
-
-/**
- * `ButtonLink` is a component with the semantics and behaviour of a link, but with the visual appearance of a button.
- * ButtonLink is a block-level component and should not be used inline.
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-const ButtonLink = /*#__PURE__*/React.forwardRef((_ref, ref) => {
-  let {
-    accessibilityRole = 'link',
-    tokens,
-    variant,
-    dataSet,
-    ...props
-  } = _ref;
-  const {
-    hrefAttrs,
-    rest
-  } = hrefAttrsProp.bundle(props);
-  const viewport = useViewport();
-  const buttonVariant = {
-    viewport,
-    ...variant
-  };
-  const getTokens = useThemeTokensCallback('Button', tokens, buttonVariant);
-  return /*#__PURE__*/_jsx(ButtonBase, {
-    ref: ref,
-    accessibilityRole: accessibilityRole,
-    tokens: getTokens,
-    hrefAttrs: hrefAttrs,
-    dataSet: dataSet,
-    ...rest
-  });
-});
-ButtonLink.displayName = 'ButtonLink';
-ButtonLink.propTypes = {
-  ...a11yProps.types,
-  ...buttonPropTypes,
-  ...linkProps.types,
-  children: textAndA11yText,
-  dataSet: PropTypes.object,
-  accessibilityRole: PropTypes.string
-};
-export default ButtonLink;

package/lib-module/Button/index.js

@@ -1,5 +0,0 @@
-import Button from './Button';
-import ButtonLink from './ButtonLink';
-import ButtonGroup from './ButtonGroup';
-import ButtonDropdown from './ButtonDropdown';
-export { Button, ButtonDropdown, ButtonGroup, ButtonLink };

package/lib-module/Button/propTypes.js

@@ -1,46 +0,0 @@
-import PropTypes from 'prop-types';
-import ABBPropTypes from 'airbnb-prop-types';
-import { variantProp, getTokensPropType } from '../utils/props';
-import A11yText from '../A11yText';
-import { iconComponentPropTypes } from '../Icon';
-export const textAndA11yText = ABBPropTypes.childrenOf(PropTypes.oneOfType([ABBPropTypes.elementType(A11yText), PropTypes.string]));
-const buttonPropTypes = {
-  tokens: getTokensPropType('Button'),
-  /**
-   * If true, prevents the button from being pressed, changes the cursor (on web) and accessibility
-   * attributes to communicate this to the user, and applies `inactive: true` appearances from the theme
-   */
-  inactive: PropTypes.bool,
-  /**
-   * Alias for `inactive`
-   */
-  disabled: PropTypes.bool,
-  /**
-   * Button's children must be either:
-   *  - One or more text strings and / or A11yText components
-   *  - A render function with contents that responds to current button state by being passed an object of:
-   * ```
-   * { hovered<bool>, focused<bool>, pressed<bool>, inactive<bool>, selected<bool>, textStyles<RNStyle> }
-   * ```
-   */
-  children: PropTypes.oneOfType([PropTypes.func, textAndA11yText]).isRequired,
-  /**
-   * Function called when the button is pressed. Required unless the button has a href.
-   */
-  onPress: PropTypes.func,
-  /**
-   * Optional variant that may be passed down to the link's icon if there is one
-   */
-  iconProps: PropTypes.exact(iconComponentPropTypes),
-  /**
-   * When `icon` is provided, use `iconPosition` to place the Icon to the left or right side of the button.
-   */
-  iconPosition: PropTypes.oneOf(['left', 'right']),
-  /**
-   * A function component for an SVG icon to render inside the link. Inherits size and color from
-   * the link and any Typography the link is nested inside.
-   */
-  icon: PropTypes.func,
-  variant: variantProp.propType
-};
-export default buttonPropTypes;

package/lib-module/Card/Card.js

@@ -1,330 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import View from "react-native-web/dist/exports/View";
-import { useThemeTokens, useThemeTokensCallback, useResponsiveThemeTokens, useTheme } from '../ThemeProvider';
-import { getTokensPropType, variantProp, StyleSheet, createMediaQueryStyles } from '../utils';
-import { useViewport } from '../ViewportProvider';
-import { a11yProps, linkProps, selectSystemProps, viewProps, responsiveProps } from '../utils/props';
-import CardBase from './CardBase';
-import PressableCardBase from './PressableCardBase';
-import CheckboxButton from '../Checkbox/CheckboxButton';
-import RadioButton from '../Radio/RadioButton';
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Fragment as _Fragment } from "react/jsx-runtime";
-import { jsxs as _jsxs } from "react/jsx-runtime";
-const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps, linkProps]);
-const SelectionType = {
-  Checkbox: 'checkbox',
-  Radio: 'radiogroup',
-  None: undefined
-};
-const selectInputStyle = _ref => {
-  let {
-    paddingTop,
-    paddingRight
-  } = _ref;
-  return {
-    position: 'absolute',
-    top: paddingTop,
-    right: paddingRight
-  };
-};
-const getInputProps = _ref2 => {
-  let {
-    id,
-    checkColor,
-    boxBackgroundColor,
-    checkBackgroundColor,
-    isControlled,
-    isChecked,
-    isInactive,
-    handleChange
-  } = _ref2;
-  return {
-    inputId: id,
-    tokens: {
-      iconColor: checkColor,
-      inputBackgroundColor: boxBackgroundColor,
-      iconBackgroundColor: checkBackgroundColor
-    },
-    isControlled,
-    isChecked,
-    inactive: isInactive,
-    handleChange
-  };
-};
-
-/**
- * A basic card component, unstyled by default.
- *
- * ## Component API
- *
- * ### Background
- *
- * In order to control the background of a card, the following tokens are currently
- * supported:
- *
- * - `backgroundColor`
- *
- * ### Border
- *
- * The following border tokens can be used:
- *
- * - `borderColor`
- * - `borderRadius`
- * - `borderWidth`
- *
- * ### Padding
- *
- * Please use the following tokens to control the padding:
- *
- * - `paddingBottom`
- * - `paddingLeft`
- * - `paddingRight`
- * - `paddingTop`
- *
- * Note that various viewport sizes are supported as well.
- *
- * ### Shadow
- *
- * Feel free to use the following properties within the `shadow` token:
- *
- * - `inset`: boolean
- * - `color`: string
- * - `offsetX`: number
- * - `offsetY`: number
- * - `blur`: number
- * - `spread`: number
- *
- * ## Accessibility
- *
- * Card supports all the common a11y props. Please remember that by marking a card as `accessible`
- * you automatically make inaccessible its children, which may or may not be appropriate
- * depending on what you are trying to achieve.
- */
-const Card = /*#__PURE__*/React.forwardRef((_ref3, ref) => {
-  var _interactiveCard$vari, _interactiveCard$vari2;
-  let {
-    children,
-    tokens,
-    variant,
-    dataSet,
-    onPress,
-    id,
-    interactiveCard,
-    backgroundImage,
-    ...rest
-  } = _ref3;
-  const viewport = useViewport();
-  const {
-    themeOptions
-  } = useTheme();
-  const {
-    enableMediaQueryStyleSheet
-  } = themeOptions;
-  const useTokens = enableMediaQueryStyleSheet ? useResponsiveThemeTokens : useThemeTokens;
-  const themeTokens = useTokens('Card', tokens, variant, !enableMediaQueryStyleSheet && {
-    viewport
-  });
-  const selected = interactiveCard === null || interactiveCard === void 0 ? void 0 : (_interactiveCard$vari = interactiveCard.variant) === null || _interactiveCard$vari === void 0 ? void 0 : _interactiveCard$vari.selected;
-  const inactive = interactiveCard === null || interactiveCard === void 0 ? void 0 : (_interactiveCard$vari2 = interactiveCard.variant) === null || _interactiveCard$vari2 === void 0 ? void 0 : _interactiveCard$vari2.inactive;
-  const selectionType = interactiveCard === null || interactiveCard === void 0 ? void 0 : interactiveCard.selectionType;
-  const getThemeTokens = useThemeTokensCallback('Card', interactiveCard === null || interactiveCard === void 0 ? void 0 : interactiveCard.tokens, {
-    interactive: true,
-    ...((interactiveCard === null || interactiveCard === void 0 ? void 0 : interactiveCard.variant) || {})
-  });
-  // When interactive area is present, spacing tokens should only be applied
-  // to individual Card sections, not Card as a whole
-  const {
-    paddingTop,
-    paddingBottom,
-    paddingLeft,
-    paddingRight,
-    ...restOfTokens
-  } = selectionType ? getThemeTokens() : themeTokens;
-  const {
-    inputBackgroundColor,
-    iconBackgroundColor,
-    iconColor,
-    icon,
-    inputBorderRadius,
-    inputHeight,
-    inputWidth,
-    iconSize,
-    inputShadow,
-    inputBorderWidth,
-    inputBorderColor
-  } = getThemeTokens();
-  const checkboxTokens = {
-    inputBackgroundColor,
-    iconBackgroundColor,
-    icon,
-    iconColor,
-    inputBorderRadius,
-    inputHeight,
-    inputWidth,
-    iconSize,
-    inputShadow,
-    inputBorderWidth,
-    inputBorderColor
-  };
-  const radioTokens = {
-    iconBackgroundColor,
-    iconColor,
-    containerShadow: inputShadow,
-    icon,
-    inputBackgroundColor,
-    inputBorderRadius,
-    inputSize: inputHeight,
-    checkedSize: iconSize,
-    inputBorderWidth,
-    inputBorderColor
-  };
-  let cardStyles;
-  let mediaIds;
-  if (enableMediaQueryStyleSheet) {
-    const mediaQueryStyleSheet = createMediaQueryStyles(themeTokens);
-    const {
-      ids,
-      styles
-    } = StyleSheet.create({
-      card: mediaQueryStyleSheet
-    });
-    cardStyles = styles.card;
-    mediaIds = ids.card;
-  } else {
-    cardStyles = themeTokens;
-  }
-  const renderInputPerSelectionType = props => {
-    switch (selectionType) {
-      case SelectionType.Checkbox:
-        return /*#__PURE__*/_jsx(View, {
-          style: selectInputStyle(getThemeTokens()),
-          children: /*#__PURE__*/_jsx(CheckboxButton, {
-            ...props,
-            tokens: {
-              ...checkboxTokens,
-              ...(props === null || props === void 0 ? void 0 : props.tokens)
-            }
-          })
-        });
-      case SelectionType.Radio:
-        return /*#__PURE__*/_jsx(View, {
-          style: selectInputStyle(getThemeTokens()),
-          children: /*#__PURE__*/_jsx(RadioButton, {
-            ...props,
-            tokens: {
-              ...radioTokens,
-              ...(props === null || props === void 0 ? void 0 : props.tokens)
-            }
-          })
-        });
-      default:
-        return null;
-    }
-  };
-  const renderNoSelectionView = () => /*#__PURE__*/_jsx(View, {
-    style: {
-      paddingTop,
-      paddingBottom,
-      paddingLeft,
-      paddingRight
-    },
-    children: children
-  });
-  return /*#__PURE__*/_jsx(_Fragment, {
-    children: /*#__PURE__*/_jsx(CardBase, {
-      ref: ref,
-      tokens: interactiveCard !== null && interactiveCard !== void 0 && interactiveCard.body ? restOfTokens : cardStyles,
-      backgroundImage: backgroundImage,
-      dataSet: mediaIds && {
-        media: mediaIds
-      },
-      ...selectProps(rest),
-      children: interactiveCard !== null && interactiveCard !== void 0 && interactiveCard.body ? /*#__PURE__*/_jsxs(_Fragment, {
-        children: [/*#__PURE__*/_jsx(PressableCardBase, {
-          ref: ref,
-          tokens: getThemeTokens,
-          dataSet: dataSet,
-          onPress: onPress,
-          ...selectProps(rest),
-          children: cardState => {
-            const {
-              iconColor: checkColor,
-              inputBackgroundColor: boxBackgroundColor,
-              iconBackgroundColor: checkBackgroundColor
-            } = getThemeTokens({
-              ...cardState,
-              selected,
-              interactive: true,
-              isControl: true
-            }, interactiveCard === null || interactiveCard === void 0 ? void 0 : interactiveCard.tokens);
-            return /*#__PURE__*/_jsxs(_Fragment, {
-              children: [renderInputPerSelectionType(getInputProps({
-                id,
-                checkColor,
-                boxBackgroundColor,
-                checkBackgroundColor,
-                isControlled: true,
-                isChecked: selected || (cardState === null || cardState === void 0 ? void 0 : cardState.hover),
-                isInactive: inactive,
-                onPress
-              })), typeof (interactiveCard === null || interactiveCard === void 0 ? void 0 : interactiveCard.body) === 'function' ? interactiveCard.body(cardState) : interactiveCard.body]
-            });
-          }
-        }), children && selectionType !== SelectionType.None ? renderNoSelectionView() : null]
-      }) : children
-    })
-  });
-});
-Card.displayName = 'Card';
-Card.propTypes = {
-  ...selectedSystemPropTypes,
-  /**
-   * Card content.
-   */
-  children: PropTypes.node,
-  /**
-   * Card tokens.
-   */
-  tokens: getTokensPropType('Card'),
-  /**
-   * Card variant.
-   */
-  variant: variantProp.propType,
-  /**
-   * Function to call on pressing the card.
-   * Note: This is only available when `interactiveCard` prop is used.
-   */
-  onPress: PropTypes.func,
-  /**
-   * Card ID.
-   */
-  id: PropTypes.string,
-  /**
-   * Object to set interactive card's properties
-   * - body: The body of the interactive card, can be any renderable node
-   * - tokens: The tokens to be used for the interactive card
-   * - selectionType: If the card has `isControl` variant set to `true`, the selectionType can have one of the following options: 
-        - `radiogroup`
-        - `checkbox`
-   * - variant: The variant to be used for the interactive card
-   */
-  interactiveCard: PropTypes.shape({
-    body: PropTypes.oneOfType([PropTypes.node, PropTypes.func]),
-    tokens: getTokensPropType('Card'),
-    selectionType: PropTypes.oneOf(Object.values(SelectionType)),
-    variant: variantProp.propType
-  }),
-  /**
-   * Apply background image to the card.
-   */
-  backgroundImage: PropTypes.shape({
-    // The image src is either a URI string or a number (when a local image src is bundled in IOS or Android app)
-    // src is an object when used responsively to provide different image sources for different screen sizes
-    src: PropTypes.oneOfType([PropTypes.string, PropTypes.number, PropTypes.object]).isRequired,
-    alt: PropTypes.string,
-    resizeMode: responsiveProps.getTypeOptionallyByViewport(PropTypes.oneOf(['cover', 'contain', 'stretch', 'repeat', 'center']))
-  })
-};
-export default Card;