@telus-uds/components-base 0.0.2-prerelease.4 → 0.0.2-prerelease.8

package/lib/Progress/ProgressBar.js

@@ -0,0 +1,146 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _ProgressBarBackground = _interopRequireDefault(require("./ProgressBarBackground"));
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const selectBarStyles = ({
+  backgroundColor,
+  borderRadius,
+  outlineWidth,
+  outlineColor
+}, percentage) => ({
+  backgroundColor,
+  borderRadius,
+  outlineWidth,
+  outlineColor,
+  width: "".concat(percentage, "%")
+});
+/**
+ * The `ProgressBar` is a visual representation of linear progression.
+ * It provides simple but important information at a quick glance.
+ *
+ * ## Props
+ *
+ * - Use `percentage` prop to indicate completion
+ *
+ * ## Tokens
+ *
+ * - Use the following tokens to customize the appearance:
+ *   - `backgroundColor` for the background color of the progress bar,
+ *   - `borderRadius` for the rounded corners,
+ *   - `outlineColor` to control the color of the border (outline),
+ *   - `outlineWidth` to change the outline width.
+ *
+ * ## Variants
+ *
+ * - Use the following variants to render specific types of progress bars:
+ *   - `negative`: set to `true` if you wish to use the negative theming for progress bar filling,
+ *   - `inactive`: set to `true` if you wish to style the progress bar as inactive.
+ *
+ * ## Usability and A11y guidelines
+ *
+ * `ProgressBar` component accepts all the standard accessibility properties including the ones that
+ * are specific to the `progressbar` role. By default the following props are used:
+ *
+ * - `accessibilityRole` (`role`): `progressbar`,
+ * - `accessibilityValue.min` (`aria-valuemin`): `0`,
+ * - `accessibilityValue.max` (`aria-valuemax`): `100`,
+ * - `accessibilityValue.now` (`aria-valuenow`): `percentage`,
+ * - `accessibilityValue.text` (`aria-valuetext`): `%{percentage}%`,
+ *
+ */
+
+
+const ProgressBar = ({
+  children = null,
+  percentage = 0,
+  tokens,
+  variant,
+  ...rest
+}) => {
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('ProgressBar', tokens, variant);
+
+  if (percentage < 0) {
+    throw new Error('ProgressBar: `percentage` must be a positive number');
+  } else if (percentage > 100) {
+    throw new Error('ProgressBar: `percentage` cannot exceed 100');
+  }
+
+  const accessibilityProps = {
+    accessibilityRole: 'progressbar',
+    accessibilityValue: {
+      min: 0,
+      max: 100,
+      now: percentage,
+      text: "".concat(percentage, "%")
+    },
+    ..._propTypes2.a11yProps.select(rest)
+  };
+  return percentage > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: [staticStyles.bar, selectBarStyles(themeTokens, percentage)],
+    ...accessibilityProps,
+    children: children !== null && children !== void 0 ? children : /*#__PURE__*/(0, _jsxRuntime.jsx)(_ProgressBarBackground.default, {
+      variant: variant
+    })
+  }) : null;
+};
+
+ProgressBar.propTypes = {
+  /**
+   * Optional children that can be used to customize the progress bar filling.
+   */
+  children: _propTypes.default.node,
+
+  /**
+   * Accessibility label for the progress bar.
+   */
+  accessibilityLabel: _propTypes.default.string.isRequired,
+
+  /**
+   * Percentage of completion.
+   */
+  percentage: _propTypes.default.number,
+
+  /**
+   * Progress bar tokens.
+   */
+  tokens: (0, _utils.getTokensPropType)('ProgressBar'),
+
+  /**
+   * Progress bar variant.
+   */
+  variant: _utils.variantProp.propType
+};
+var _default = ProgressBar;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
+  bar: {
+    height: '100%',
+    outlineStyle: 'solid',
+    overflow: 'hidden',
+    position: 'absolute'
+  }
+});

package/lib/Progress/ProgressBarBackground.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _ImageBackground = _interopRequireDefault(require("react-native-web/dist/cjs/exports/ImageBackground"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _utils = require("../utils");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const inactiveBackground = "%3Csvg xmlns='http://www.w3.org/2000/svg' width='100%25' height='24'%3E%3Cdefs%3E%3Cpattern id='DisabledProgress7' patternUnits='userSpaceOnUse' width='8' height='8'%3E%3Crect width='8' height='8' fill='%23B2B9BF'%3E%3C/rect%3E%3Ccircle cx='4' cy='4' r='2' fill='%23676E73' stroke='%23676E73' stroke-width='0'%3E%3C/circle%3E%3Ccircle cx='0' cy='0' r='2' fill='%23676E73' stroke='%23676E73' stroke-width='0'%3E%3C/circle%3E%3Ccircle cx='0' cy='8' r='2' fill='%23676E73' stroke='%23676E73' stroke-width='0'%3E%3C/circle%3E%3Ccircle cx='8' cy='0' r='2' fill='%23676E73' stroke='%23676E73' stroke-width='0'%3E%3C/circle%3E%3Ccircle cx='8' cy='8' r='2' fill='%23676E73' stroke='%23676E73' stroke-width='0'%3E%3C/circle%3E%3C/pattern%3E%3C/defs%3E%3Cpath d='M 0 0 L 0 140 L 2000 2000 L 2000 0 Z' style='fill: url("%23DisabledProgress7");'%3E%3C/path%3E%3C/svg%3E";
+const negativeBackground = "%3Csvg xmlns='http://www.w3.org/2000/svg' width='100%25' height='24'%3E%3Cdefs%3E%3Cpattern id='NegativeProgress6' patternUnits='userSpaceOnUse' width='8' height='8'%3E%3Crect width='8' height='8' fill='%23C12335'%3E%3C/rect%3E%3Cpath d='M 0,8 l 8,-8 M -2,2 l 4,-4 M 6,10 l 4,-4' stroke-width='2' shape-rendering='auto' stroke='%23e7adb4' stroke-linecap='square'%3E%3C/path%3E%3C/pattern%3E%3C/defs%3E%3Cpath d='M 0 0 L 0 140 L 2000 2000 L 2000 0 Z' style='fill: url("%23NegativeProgress6");'%3E%3C/path%3E%3C/svg%3E";
+
+const ProgressBarBackground = ({
+  variant
+}) => {
+  let source = null;
+
+  if (variant !== null && variant !== void 0 && variant.inactive) {
+    source = inactiveBackground;
+  } else if (variant !== null && variant !== void 0 && variant.negative) {
+    source = negativeBackground;
+  } else {
+    return null;
+  }
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ImageBackground.default, {
+    source: {
+      uri: "data:image/svg+xml,".concat(source)
+    },
+    style: staticStyles.imageBackground
+  });
+};
+
+ProgressBarBackground.propTypes = {
+  /**
+   * Progress bar variant.
+   */
+  variant: _utils.variantProp.propType
+};
+var _default = ProgressBarBackground;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
+  imageBackground: {
+    height: '100%'
+  }
+});

package/lib/Progress/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _Progress = _interopRequireDefault(require("./Progress"));
+
+var _ProgressBar = _interopRequireDefault(require("./ProgressBar"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+_Progress.default.Bar = _ProgressBar.default;
+var _default = _Progress.default;
+exports.default = _default;

package/lib/Radio/Radio.js

@@ -0,0 +1,292 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+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 _LabelContent = _interopRequireDefault(require("../InputLabel/LabelContent"));
+
+var _RadioButton = _interopRequireWildcard(require("./RadioButton"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _StackView = _interopRequireDefault(require("../StackView"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// @todo move `LabelContent` outside of the `InputLabel` and fix
+// the issue with the cursor not being pointer on Web
+const selectContainerStyles = ({
+  containerBackgroundColor,
+  containerBorderRadius,
+  containerOpacity,
+  containerPaddingBottom,
+  containerPaddingLeft,
+  containerPaddingRight,
+  containerPaddingTop,
+  containerShadow
+}) => ({
+  backgroundColor: containerBackgroundColor,
+  borderRadius: containerBorderRadius,
+  opacity: containerOpacity,
+  paddingBottom: containerPaddingBottom,
+  paddingLeft: containerPaddingLeft,
+  paddingRight: containerPaddingRight,
+  paddingTop: containerPaddingTop,
+  ...(0, _ThemeProvider.applyShadowToken)(containerShadow)
+});
+
+const selectDescriptionStyles = ({
+  containerPaddingLeft = 0,
+  descriptionFontSize,
+  descriptionLineHeight,
+  descriptionMarginLeft,
+  inputSize,
+  labelMarginLeft = 0
+}) => ({
+  marginLeft: descriptionMarginLeft !== null && descriptionMarginLeft !== void 0 ? descriptionMarginLeft : containerPaddingLeft + inputSize + labelMarginLeft,
+  ...(0, _ThemeProvider.applyTextStyles)({
+    fontSize: descriptionFontSize,
+    lineHeight: descriptionLineHeight
+  })
+});
+
+const selectLabelStyles = ({
+  labelColor,
+  labelFontName,
+  labelFontSize,
+  labelFontWeight,
+  labelMarginLeft,
+  labelLineHeight
+}) => (0, _ThemeProvider.applyTextStyles)({
+  color: labelColor,
+  fontName: labelFontName,
+  fontWeight: labelFontWeight,
+  fontSize: labelFontSize,
+  lineHeight: labelLineHeight,
+  marginLeft: labelMarginLeft
+});
+/**
+ * Basic Radio component.
+ *
+ * ## Component API
+ *
+ * Use `label` prop to provide a label for the radio button. For a disabled `Radio` set the `inactive` prop to `true`.
+ *
+ * ### Controlled version
+ *
+ * If the radio button is controlled from outside, it needs to receive `checked` and `onChange` props.
+ *
+ * ### Uncontrolled version
+ *
+ * In case of uncontrolled radio button you can use `defaultChecked` prop to provide the initial value.
+ * Whenever the radio button gets toggled, it calls the `onChange` callback with the new value (boolean).
+ *
+ * ### Using within forms
+ *
+ * You can pass `name` and `value` props if you need a particular radio button to be a part of a radio group
+ * on a form.
+ *
+ * ### Validation
+ *
+ * You can mark a radio button as failing validation by setting the `error` prop to `true`.
+ *
+ * ## A11y guidelines
+ *
+ * Radio component accepts all the common accessibility props, but also sets some defaults, including
+ * accessibility role `'radio'` and accessibility state that depends on the other props (`checked`, `inactive`)
+ * or the internal state in case of uncontrolled radio button.
+ *
+ */
+
+
+const Radio = ({
+  checked,
+  defaultChecked,
+  description,
+  error = false,
+  id,
+  inactive,
+  label,
+  name: inputName,
+  onChange,
+  tokens,
+  value,
+  variant,
+  ...rest
+}) => {
+  const {
+    currentValue: isChecked,
+    setValue: setIsChecked,
+    isControlled
+  } = (0, _utils.useInputValue)({
+    value: checked,
+    initialValue: defaultChecked,
+    onChange
+  }, 'useRadioValue');
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('Radio', tokens, {
+    checked: isChecked,
+    inactive,
+    error,
+    ...variant
+  });
+
+  const handleChange = () => {
+    if (!inactive && !isChecked) {
+      setIsChecked(true);
+    }
+  };
+
+  const handleKeyDown = e => {
+    // The expected keyboard shortcut for activating a radio is the Space key
+    if ((e === null || e === void 0 ? void 0 : e.key) === ' ') handleChange();
+  };
+
+  const accessibilityProps = _propTypes2.a11yProps.select(rest);
+
+  const uniqueId = (0, _utils.useUniqueId)('radio');
+  const inputId = id !== null && id !== void 0 ? id : uniqueId;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    disabled: inactive,
+    onKeyDown: handleKeyDown,
+    onPress: handleChange,
+    accessibilityRole: "radio",
+    accessibilityState: {
+      checked: isChecked,
+      disabled: inactive
+    },
+    ...accessibilityProps,
+    children: ({
+      focused: focus,
+      hovered: hover,
+      pressed
+    }) => {
+      const stateTokens = getTokens({
+        focus,
+        hover,
+        pressed
+      });
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.default, {
+        space: 0,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+          style: [staticStyles.container, selectContainerStyles(stateTokens)],
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_RadioButton.default, {
+            tokens: (0, _RadioButton.selectRadioButtonTokens)(stateTokens),
+            isControlled: isControlled,
+            isChecked: isChecked,
+            inactive: inactive,
+            defaultChecked: defaultChecked,
+            inputId: inputId,
+            handleChange: handleChange,
+            name: inputName,
+            value: value
+          }), Boolean(label) && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: selectLabelStyles(stateTokens),
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_LabelContent.default, {
+              forId: inputId,
+              children: label
+            })
+          })]
+        }), Boolean(description) && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+          style: selectDescriptionStyles(getTokens()),
+          children: description
+        })]
+      });
+    }
+  });
+};
+
+Radio.propTypes = { ..._propTypes2.a11yProps.propTypes,
+
+  /**
+   * Use `checked` for controlled Radio. For uncontrolled Radio, use the `defaultChecked` prop.
+   */
+  checked: _propTypes.default.bool,
+
+  /**
+   * Use `defaultChecked` to provide the initial value for an uncontrolled Radio.
+   */
+  defaultChecked: _propTypes.default.bool,
+
+  /**
+   * An optional radio button description.
+   */
+  description: _propTypes.default.string,
+
+  /**
+   * Radio button ID.
+   */
+  id: _propTypes.default.string,
+
+  /**
+   * Whether the corresponding input is disabled or active.
+   */
+  inactive: _propTypes.default.bool,
+
+  /**
+   * The label.
+   */
+  label: _propTypes.default.string,
+
+  /**
+   * Associate this radio button with a group (set as the name attribute).
+   */
+  name: _propTypes.default.string,
+
+  /**
+   * Whether the underlying input triggered a validation error or not.
+   */
+  error: _propTypes.default.bool,
+
+  /**
+   * The value. Must be unique within the group.
+   */
+  value: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.bool]),
+
+  /**
+   * Callback called when a controlled radio button gets interacted with.
+   */
+  onChange: _propTypes.default.func,
+
+  /**
+   * Radio tokens.
+   */
+  tokens: (0, _utils.getTokensPropType)('Radio'),
+
+  /**
+   * Radio variant.
+   */
+  variant: _utils.variantProp.propType
+};
+var _default = Radio;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
+  container: {
+    flexDirection: 'row',
+    alignItems: 'center'
+  }
+});

package/lib/Radio/RadioButton.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.selectRadioButtonTokens = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _RadioInput = _interopRequireDefault(require("./RadioInput"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// TODO: roll out a standard approach to token sets
+// https://github.com/telus/universal-design-system/issues/782
+const tokenKeys = ['checkedBackgroundColor', 'checkedSize', 'inputBackgroundColor', 'inputBorderColor', 'inputBorderWidth', 'inputOutlineColor', 'inputOutlineWidth', 'inputSize', 'outerBorderColor', 'outerBorderWidth', 'outerBorderGap', 'inputSize'];
+
+const selectRadioButtonTokens = (themeTokens, prefix) => (0, _utils.selectTokens)(tokenKeys, themeTokens, prefix);
+
+exports.selectRadioButtonTokens = selectRadioButtonTokens;
+
+const getBorderRadius = inputSize => inputSize / 2;
+
+const selectCheckedStyles = ({
+  checkedBackgroundColor,
+  checkedSize
+}) => ({
+  backgroundColor: checkedBackgroundColor,
+  borderRadius: checkedSize / 2,
+  height: checkedSize,
+  width: checkedSize
+});
+
+const selectInputStyles = ({
+  inputBackgroundColor,
+  inputBorderColor,
+  inputBorderWidth,
+  inputOutlineColor,
+  inputOutlineWidth,
+  inputSize
+}) => ({
+  borderColor: inputBorderColor,
+  borderRadius: getBorderRadius(inputSize),
+  borderWidth: inputBorderWidth,
+  backgroundColor: inputBackgroundColor,
+  outlineStyle: 'solid',
+  outlineColor: inputOutlineColor,
+  outlineWidth: inputOutlineWidth,
+  height: inputSize,
+  width: inputSize
+});
+
+const selectOuterBorderStyles = ({
+  outerBorderColor,
+  outerBorderWidth,
+  outerBorderGap,
+  inputSize
+}) => ({ ...(0, _ThemeProvider.applyOuterBorder)({
+    outerBorderColor,
+    outerBorderWidth,
+    outerBorderGap,
+    borderRadius: getBorderRadius(inputSize)
+  })
+});
+/**
+ * The visual toggle of a radio input. Is not interactive on its own, should be used inside
+ * an interactive parent that passes down props when interacted with.
+ */
+
+
+const RadioButton = ({
+  isChecked,
+  tokens,
+  inactive,
+  defaultChecked,
+  inputId,
+  isControlled,
+  handleChange,
+  name: inputName,
+  value
+}) => {
+  const themeTokens = (0, _ThemeProvider.validateThemeTokens)((0, _ThemeProvider.resolveThemeTokens)(tokens, {
+    checked: isChecked
+  }), (0, _utils.getTokensSetPropType)(tokenKeys), 'RadioButton');
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: selectOuterBorderStyles(themeTokens),
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+      style: [staticStyles.defaultInputStyles, selectInputStyles(themeTokens, isChecked)],
+      testID: "Radio-Input",
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_RadioInput.default, {
+        checked: isChecked,
+        defaultChecked: defaultChecked,
+        disabled: inactive,
+        id: inputId,
+        isControlled: isControlled,
+        onChange: handleChange,
+        name: inputName,
+        value: value
+      }), isChecked && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        style: selectCheckedStyles(themeTokens),
+        testID: "Radio-Checked"
+      })]
+    })
+  });
+};
+
+RadioButton.propTypes = {
+  isChecked: _propTypes.default.bool,
+  tokens: (0, _utils.getTokensSetPropType)(tokenKeys, {
+    allowFunction: true
+  }),
+  inactive: _propTypes.default.bool,
+  defaultChecked: _propTypes.default.bool,
+  inputId: _propTypes.default.string,
+  isControlled: _propTypes.default.bool,
+  handleChange: _propTypes.default.func,
+  name: _propTypes.default.string,
+  value: _propTypes.default.bool
+};
+
+const staticStyles = _StyleSheet.default.create({
+  defaultInputStyles: {
+    alignItems: 'center',
+    justifyContent: 'center'
+  }
+});
+
+var _default = RadioButton;
+exports.default = _default;