@telus-uds/components-base 2.5.0 → 3.0.0

package/lib/cjs/Tabs/TabsItem.js

@@ -0,0 +1,245 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+var _Text = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Text"));
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+var _ThemeProvider = require("../ThemeProvider");
+var _utils = require("../utils");
+var _Spacer = _interopRequireDefault(require("../Spacer"));
+var _HorizontalScroll = require("../HorizontalScroll");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
+const {
+  itemPositionsPropType,
+  getItemPositionLayoutHandler
+} = _HorizontalScroll.horizontalScrollUtils;
+const selectHighlightBarStyles = _ref => {
+  let {
+    highlightColor,
+    highlightBarBorderRadius = 0,
+    highlightBarBorderWidth = 0,
+    highlightBarHeight = 0
+  } = _ref;
+  return {
+    backgroundColor: highlightColor,
+    borderColor: highlightColor,
+    height: highlightBarHeight + highlightBarBorderWidth * 2,
+    borderRadius: highlightBarBorderRadius,
+    borderWidth: highlightBarBorderWidth,
+    bottom: -1 * (highlightBarHeight + highlightBarBorderWidth),
+    left: 0,
+    right: 0,
+    zIndex: 1 + highlightBarBorderWidth
+  };
+};
+const selectHighlightTriangleStyles = _ref2 => {
+  let {
+    highlightColor,
+    highlightTriangleSize
+  } = _ref2;
+  return {
+    container: {
+      bottom: 0 - highlightTriangleSize * 2
+    },
+    triangle: {
+      height: 0,
+      width: 0,
+      borderWidth: highlightTriangleSize,
+      borderTopColor: highlightColor,
+      borderBottomColor: 'transparent',
+      borderLeftColor: 'transparent',
+      borderRightColor: 'transparent'
+    }
+  };
+};
+const selectContainerStyles = _ref3 => {
+  let {
+    backgroundColor,
+    borderColor,
+    borderWidth = 0,
+    borderRadius,
+    paddingHorizontal = 0,
+    paddingVertical = 0
+  } = _ref3;
+  return {
+    backgroundColor,
+    borderColor,
+    borderWidth,
+    borderRadius,
+    paddingHorizontal: paddingHorizontal - borderWidth,
+    paddingVertical: paddingVertical - borderWidth
+  };
+};
+
+/**
+ * Item within a Tabs component representing one tab of content. May be rendered as a link
+ * or as a "menuitem" button depending on whether 'href' is passed.
+ *
+ * This is rendered automatically by `Tabs` and isn't intended be used directly.
+ */
+const TabsItem = /*#__PURE__*/_react.default.forwardRef((_ref4, ref) => {
+  let {
+    href,
+    variant,
+    tokens,
+    selected,
+    itemPositions,
+    index,
+    children,
+    accessibilityRole,
+    accessibilityCurrent = _Platform.default.OS === 'web' && accessibilityRole === 'link' && selected ? 'page' : undefined,
+    accessibilityState = accessibilityRole === 'tab' ? {
+      selected
+    } : undefined,
+    id,
+    render,
+    ...rawRest
+  } = _ref4;
+  // Convert onClick etc to onPress etc if used in an integration
+  const {
+    onPress,
+    ...rest
+  } = _utils.clickProps.toPressProps(rawRest);
+  const {
+    themeOptions
+  } = (0, _ThemeProvider.useTheme)();
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('TabsItem', tokens, variant);
+  const resolveTokens = pressableState => (0, _utils.resolvePressableTokens)(getTokens, pressableState, {
+    selected
+  });
+  const getPressableStyle = pressableState => {
+    const {
+      maxWidth
+    } = resolveTokens(pressableState);
+    return [{
+      maxWidth
+    }, _Platform.default.OS === 'web' && {
+      outline: 'none'
+    }];
+  };
+  const handleLayout = getItemPositionLayoutHandler(itemPositions.positions, index);
+
+  // On press, update the selection, call any press handler, and open any href in platform-appropriate way
+  const openHref = href && _utils.linkProps.handleHref({
+    href
+  });
+  const handlePress = onPress || openHref ? function () {
+    if (onPress) onPress(...arguments);
+    if (openHref) openHref(...arguments);
+  } : undefined;
+  const selectedProps = selectProps({
+    accessibilityRole,
+    accessibilityCurrent,
+    accessibilityState,
+    ...rest
+  });
+  _react.default.useEffect(() => {
+    // If this is selected while off-screen, scroll it into view
+    if (selected) {
+      const position = itemPositions.positions[index];
+      const scrollEnd = itemPositions.scrollOffset + itemPositions.containerWidth;
+      if (
+      // is off the right edge, or
+      scrollEnd && position?.end > scrollEnd ||
+      // is off the left edge
+      typeof position?.start === 'number' && position.start < itemPositions.scrollOffset) {
+        itemPositions.scrollTo(position.start);
+      }
+    }
+    // itemPositions is a ref object so this should only re-run when `selected` (or `index`) change
+  }, [selected, index, itemPositions]);
+  if (render) return render({
+    selected,
+    handlePress
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    ref: ref,
+    onPress: handlePress,
+    href: href,
+    style: getPressableStyle,
+    onLayout: handleLayout,
+    nativeID: id,
+    ...selectedProps,
+    children: pressableState => {
+      const {
+        space,
+        textAlign,
+        ...themeTokens
+      } = resolveTokens(pressableState);
+      const hasHighlightBar = Boolean(themeTokens.highlightBarHeight);
+      const highlightBarStyle = hasHighlightBar && selectHighlightBarStyles(themeTokens);
+      const hasHighlightTriangle = Boolean(themeTokens.highlightTriangleSize);
+      const highlightTriangleStyle = hasHighlightTriangle && selectHighlightTriangleStyles(themeTokens);
+      const containerStyles = selectContainerStyles(themeTokens);
+      const textStyles = (0, _ThemeProvider.applyTextStyles)({
+        ...(0, _utils.selectTokens)('Typography', themeTokens),
+        themeOptions,
+        textAlign
+      });
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+        style: staticStyles.container,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: containerStyles,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: textStyles,
+            children: children
+          })
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
+          space: space
+        }), hasHighlightBar && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.absolute, highlightBarStyle]
+        }), hasHighlightTriangle && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.absolute, highlightTriangleStyle.container],
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: highlightTriangleStyle.triangle
+          })
+        })]
+      });
+    }
+  });
+});
+TabsItem.displayName = 'TabsItem';
+TabsItem.propTypes = {
+  ...selectedSystemPropTypes,
+  tokens: (0, _utils.getTokensPropType)('TabsItem'),
+  variant: _utils.variantProp.propType,
+  onPress: _propTypes.default.func,
+  href: _propTypes.default.string,
+  index: _propTypes.default.number,
+  selected: _propTypes.default.bool,
+  itemPositions: itemPositionsPropType,
+  children: _propTypes.default.string,
+  id: _propTypes.default.string,
+  render: _propTypes.default.func
+};
+const staticStyles = _StyleSheet.default.create({
+  center: {
+    alignItems: 'center'
+  },
+  absolute: {
+    position: 'absolute',
+    alignItems: 'center',
+    left: 0,
+    right: 0
+  },
+  container: {
+    flexGrow: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    ..._Platform.default.select({
+      web: {
+        pointerEvents: 'none'
+      }
+    })
+  }
+});
+var _default = exports.default = (0, _utils.withLinkRouter)(TabsItem);

package/lib/cjs/Tabs/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Tabs = _interopRequireDefault(require("./Tabs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _default = exports.default = _Tabs.default;

package/lib/cjs/Tags/Tags.js

@@ -0,0 +1,252 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _airbnbPropTypes = _interopRequireDefault(require("airbnb-prop-types"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _Text = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Text"));
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+var _ButtonBase = _interopRequireDefault(require("../Button/ButtonBase"));
+var _Icon = _interopRequireDefault(require("../Icon"));
+var _StackView = require("../StackView");
+var _ViewportProvider = require("../ViewportProvider");
+var _ThemeProvider = require("../ThemeProvider");
+var _utils = require("../utils");
+var _pressability = require("../utils/pressability");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
+const [selectItemProps, selectedItemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.focusHandlerProps, _utils.pressProps, _utils.viewProps]);
+const separateIconTextTokens = (_ref, returnRest) => {
+  let {
+    icon,
+    iconPosition,
+    iconSpace,
+    iconSize,
+    iconColor,
+    iconBackground,
+    iconBorderRadius,
+    iconAlignSelf,
+    iconPadding,
+    iconTranslateX,
+    iconTranslateY,
+    ...rest
+  } = _ref;
+  return returnRest ? rest : {
+    icon,
+    iconPosition,
+    iconSpace,
+    iconWrapperStyle: {
+      backgroundColor: iconBackground,
+      borderRadius: iconBorderRadius,
+      alignSelf: iconAlignSelf,
+      padding: iconPadding,
+      ..._Platform.default.select({
+        // TODO: https://github.com/telus/universal-design-system/issues/487
+        web: {
+          transition: 'color 200ms, background 200ms'
+        }
+      })
+    },
+    iconTokens: {
+      size: iconSize,
+      color: iconColor,
+      translateX: iconTranslateX,
+      translateY: iconTranslateY
+    }
+  };
+};
+const selectIconTextTokens = tokens => separateIconTextTokens(tokens, false);
+const selectNonIconTextTokens = tokens => separateIconTextTokens(tokens, true);
+const Tags = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
+  let {
+    variant,
+    tokens,
+    items = [],
+    values,
+    initialValues,
+    maxValues,
+    onChange,
+    readOnly = false,
+    inactive = false,
+    accessibilityRole = _Platform.default.select({
+      web: 'group',
+      default: 'none'
+    }),
+    ...rest
+  } = _ref2;
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Tags', tokens, variant, {
+    viewport
+  });
+  const stackTokens = (0, _utils.selectTokens)('StackView', themeTokens);
+  const {
+    direction,
+    space
+  } = themeTokens;
+  const getItemTokens = (0, _ThemeProvider.useThemeTokensCallback)('TagsItem', tokens, variant);
+  const getButtonTokens = buttonState =>
+  // Remove icon-text-related tokens, since we want to handle them ourselves, not use ButtonBase's handling
+  (0, _utils.selectTokens)('Button', selectNonIconTextTokens(getItemTokens(buttonState)));
+  const {
+    currentValues,
+    toggleOneValue
+  } = (0, _utils.useMultipleInputValues)({
+    initialValues,
+    values,
+    maxValues,
+    onChange,
+    readOnly
+  });
+  const selectedProps = selectProps({
+    accessibilityRole,
+    ...rest
+  });
+  const itemA11yRole = 'checkbox';
+  const uniqueFields = ['id', 'label'];
+  if (!(0, _utils.containUniqueFields)(items, uniqueFields)) {
+    throw new Error(`Tags items must have unique ${uniqueFields.join(', ')}`);
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackView.StackWrap, {
+    ref: ref,
+    ...selectedProps,
+    space: space,
+    direction: direction,
+    tokens: stackTokens,
+    children: items.map((_ref3, index) => {
+      let {
+        label,
+        id = label,
+        ref: itemRef,
+        ...itemRest
+      } = _ref3;
+      const isSelected = currentValues.includes(id);
+
+      // Pass an object of relevant component state as first argument for any passed-in press handlers
+      const pressHandlers = (0, _pressability.getPressHandlersWithArgs)(rest, [{
+        id,
+        label,
+        currentValues
+      }]);
+      const handlePress = event => {
+        if (pressHandlers.onPress) pressHandlers.onPress(event);
+        toggleOneValue(id, event);
+      };
+      const itemProps = selectItemProps({
+        accessibilityState: {
+          checked: isSelected
+        },
+        accessibilityRole: itemA11yRole,
+        ..._utils.a11yProps.getPositionInSet(items.length, index),
+        ...itemRest
+      });
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, {
+        ref: itemRef,
+        ...pressHandlers,
+        onPress: handlePress,
+        tokens: getButtonTokens,
+        selected: isSelected,
+        inactive: inactive,
+        ...itemProps,
+        children: _ref4 => {
+          let {
+            textStyles,
+            ...buttonState
+          } = _ref4;
+          // TODO: once Icon/IconButton designs are stable, see if this sort of styling around
+          // an icon should go in Icon itself, or possibly via an IconText token set. Related issues:
+          // - Icon: https://github.com/telus/universal-design-system/issues/327
+          // - IconButton: https://github.com/telus/universal-design-system/issues/281
+          // - Token sets: https://github.com/telus/universal-design-system/issues/782
+
+          const itemTokens = getItemTokens(buttonState);
+          const {
+            iconTokens,
+            iconPosition,
+            iconSpace,
+            iconWrapperStyle,
+            icon: IconComponent
+          } = selectIconTextTokens(itemTokens);
+          const iconContent = IconComponent ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: iconWrapperStyle,
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.default, {
+              icon: IconComponent,
+              tokens: iconTokens
+            })
+          }) : null;
+          const textContent = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: textStyles,
+            children: label
+          });
+          return (0, _StackView.getStackedContent)(iconPosition === 'left' ? [iconContent, textContent] : [textContent, iconContent], {
+            space: iconSpace,
+            direction: 'row'
+          });
+        }
+      }, id);
+    })
+  });
+});
+Tags.displayName = 'Tags';
+Tags.propTypes = {
+  ...selectedSystemPropTypes,
+  tokens: (0, _utils.getTokensPropType)('Tags'),
+  variant: _utils.variantProp.propType,
+  /**
+   * If provided, sets a maximum number of items a user may select at once.
+   */
+  maxValues: _propTypes.default.number,
+  /**
+   * The options a user may select
+   */
+  items: _propTypes.default.arrayOf(_propTypes.default.shape({
+    ...selectedItemPropTypes,
+    /**
+     * The text displayed to the user in the button, describing this option,
+     * passed to the button as its child.
+     */
+    label: _propTypes.default.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.default.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.default.string,
+    /**
+     * An optional ref for one individual Tag button in the tags
+     */
+    ref: _airbnbPropTypes.default.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.default.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.default.arrayOf(_propTypes.default.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.default.arrayOf(_propTypes.default.string),
+  /**
+   * AccesibilityRole for the Tags
+   */
+  accessibilityRole: _propTypes.default.string
+};
+var _default = exports.default = Tags;

package/lib/cjs/Tags/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Tags = _interopRequireDefault(require("./Tags"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _default = exports.default = _Tags.default;

package/lib/cjs/TextInput/TextArea.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _utils = require("../utils");
+var _InputSupports = _interopRequireDefault(require("../InputSupports"));
+var _TextInputBase = _interopRequireDefault(require("./TextInputBase"));
+var _ThemeProvider = require("../ThemeProvider");
+var _propTypes = _interopRequireDefault(require("./propTypes"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.focusHandlerProps, _utils.inputSupportsProps, _utils.textInputHandlerProps, _utils.textInputProps, _utils.viewProps]);
+
+/**
+ * Use to collect long-form information such as product feedback or support queries.
+ * Due to React Native's implementation of `TextInput` it's not possible to access the current value by passing a ref.
+ * The `TextArea` height will automatically increase when new lines are added - this behavior can be limited within the theme.
+ *
+ * ## Controlled component
+ * If it is required that the state of the `TextArea` be controlled by the application or other external methods,
+ * `value` and `onChange` props must be passed to the `TextArea`.
+ * If the `TextArea` value should not be changed by user input, a `readOnly` prop must be provided.
+ *
+ * ## Uncontrolled component
+ * If it is not necessary to control the `TextArea` state, you can create one without a value prop.
+ * In this case its value can be accessed within the `onChange` callback.
+ *
+ * ## Getting feedback for entered values
+ * Use the `feedback` prop to give the user feedback regarding their input.
+ * You can affirm that the user's input was correct, or highlight errors that must be corrected, using the `validation` prop.
+ * Keep feedback text as brief as possible, should be limited to text and links.
+ *
+ * ## Supplying a hint
+ * Use the `hint` prop to succinctly clarify attributes of the expected input data, such as the expected format,
+ * or an indicator that the field is optional.
+ * It is a more usable and accessible option than the HTML `placeholder` attribute.
+ */
+const TextArea = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
+  let {
+    tokens,
+    variant = {},
+    ...rest
+  } = _ref;
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('TextArea', tokens, variant);
+  const [inputHeight, setInputHeight] = _react.default.useState();
+
+  // adjust the text area's height as new lines are added to the content
+  const onHeightChange = _ref2 => {
+    let {
+      nativeEvent: {
+        contentSize: {
+          height
+        }
+      }
+    } = _ref2;
+    // on native this is happens out of the box
+    if (_Platform.default.OS === 'web') {
+      setInputHeight(height);
+    }
+  };
+  const {
+    supportsProps,
+    ...selectedProps
+  } = selectProps(rest);
+  const inputProps = {
+    ...selectedProps,
+    multiline: true,
+    onContentSizeChange: onHeightChange,
+    height: inputHeight,
+    tokens: themeTokens
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_InputSupports.default, {
+    ...supportsProps,
+    inputValue: selectedProps?.value,
+    children: _ref3 => {
+      let {
+        inputId,
+        ...props
+      } = _ref3;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_TextInputBase.default, {
+        ref: ref,
+        nativeID: inputId,
+        ...props,
+        ...inputProps,
+        variant: {
+          ...variant,
+          validation: props.validation
+        }
+      });
+    }
+  });
+});
+TextArea.displayName = 'TextArea';
+TextArea.propTypes = {
+  ...selectedSystemPropTypes,
+  ..._propTypes.default,
+  tokens: (0, _utils.getTokensPropType)('TextArea', 'TextInput'),
+  // TODO: support both TextArea and TextInput tokens
+  variant: _utils.variantProp.propType
+};
+var _default = exports.default = TextArea;