@telus-uds/components-base 1.63.0 → 1.65.0

package/lib-module/Checkbox/CheckboxButton.js

@@ -0,0 +1,174 @@
+import React, { forwardRef } from 'react';
+import PropTypes from 'prop-types';
+import Platform from "react-native-web/dist/exports/Platform";
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
+import View from "react-native-web/dist/exports/View";
+import CheckboxInput from './CheckboxInput';
+import { applyShadowToken, useThemeTokens } from '../ThemeProvider';
+import { a11yProps, getTokensSetPropType, selectSystemProps, selectTokens, viewProps } from '../utils';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps]);
+
+const selectInputStyles = (_ref, isChecked) => {
+  let {
+    iconBackgroundColor,
+    inputBorderColor,
+    inputBorderRadius,
+    inputBorderWidth,
+    inputBackgroundColor,
+    inputHeight,
+    inputOutlineColor,
+    inputOutlineWidth,
+    inputOutlineOffset,
+    inputShadow,
+    inputWidth
+  } = _ref;
+  return {
+    borderColor: inputBorderColor,
+    borderWidth: inputBorderWidth,
+    borderRadius: inputBorderRadius,
+    backgroundColor: isChecked ? iconBackgroundColor : inputBackgroundColor,
+    height: inputHeight,
+    width: inputWidth,
+    ...applyShadowToken(inputShadow),
+    ...Platform.select({
+      web: {
+        outlineStyle: 'solid',
+        outlineColor: inputOutlineColor,
+        outlineWidth: inputOutlineWidth,
+        outlineOffset: inputOutlineOffset
+      }
+    })
+  };
+};
+
+const selectIconTokens = _ref2 => {
+  let {
+    icon,
+    iconColor,
+    iconSize
+  } = _ref2;
+  return {
+    icon,
+    color: iconColor,
+    size: iconSize
+  };
+};
+
+const tokenKeys = ['checkedBackgroundColor', 'checkedSize', 'inputBackgroundColor', 'inputBorderColor', 'inputBorderWidth', 'inputOutlineColor', 'inputOutlineWidth', 'inputSize', 'outerBorderColor', 'outerBorderWidth', 'outerBorderGap', 'inputSize'];
+export const selectCheckboxTokens = (themeTokens, prefix) => selectTokens(tokenKeys, themeTokens, prefix);
+/**
+ * The visual toggle of a checkbox input. Is not interactive on its own, should be used inside
+ * an interactive parent that passes down props when interacted with. Used in CheckboxCard
+ */
+
+const CheckboxButton = /*#__PURE__*/forwardRef((_ref3, ref) => {
+  let {
+    isChecked,
+    tokens,
+    inactive,
+    defaultChecked,
+    inputId,
+    iconId,
+    isControlled,
+    handleChange,
+    name: inputName,
+    value,
+    ...rest
+  } = _ref3;
+  const {
+    icon: IconComponent,
+    ...stateTokens
+  } = useThemeTokens('Checkbox', {}, {
+    checked: isChecked
+  });
+  const iconTokens = selectIconTokens(stateTokens);
+  return /*#__PURE__*/_jsx(View, { ...selectProps(rest),
+    children: /*#__PURE__*/_jsxs(View, {
+      style: [staticStyles.defaultInputStyles, selectInputStyles(stateTokens, isChecked)],
+      testID: inputId,
+      children: [/*#__PURE__*/_jsx(CheckboxInput, {
+        ref: ref,
+        checked: isChecked,
+        defaultChecked: defaultChecked,
+        disabled: inactive,
+        id: inputId,
+        isControlled: isControlled,
+        onChange: handleChange,
+        name: inputName,
+        value: value
+      }), isChecked && IconComponent && /*#__PURE__*/_jsx(View, {
+        testID: iconId,
+        children: /*#__PURE__*/_jsx(IconComponent, { ...iconTokens
+        })
+      })]
+    })
+  });
+});
+CheckboxButton.displayName = 'CheckboxButton';
+CheckboxButton.propTypes = { ...selectedSystemPropTypes,
+
+  /**
+   * Use `checked` for controlled Checkbox. For uncontrolled Checkbox, use the `defaultChecked` prop.
+   */
+  isChecked: PropTypes.bool,
+
+  /**
+   * Checkbox tokens.
+   */
+  tokens: getTokensSetPropType(tokenKeys, {
+    allowFunction: true
+  }),
+
+  /**
+   * Whether the corresponding input is disabled or active.
+   */
+  inactive: PropTypes.bool,
+
+  /**
+   * Use `defaultChecked` to provide the initial value for an uncontrolled Checkbox.
+   */
+  defaultChecked: PropTypes.bool,
+
+  /**
+   * Checkbox input ID.
+   */
+  inputId: PropTypes.string,
+
+  /**
+   * Checkbox icon ID.
+   */
+  iconId: PropTypes.string,
+
+  /**
+   * Can control the checkbox on the card.
+   */
+  isControlled: PropTypes.bool,
+
+  /**
+   * Callback called when a controlled checkbox gets interacted with.
+   */
+  handleChange: PropTypes.func,
+
+  /**
+   * Associate this checkbox with a group (set as the name attribute).
+   */
+  name: PropTypes.string,
+
+  /**
+   * The value of the checkbox: true or false
+   */
+  value: PropTypes.bool
+};
+export default CheckboxButton;
+const staticStyles = StyleSheet.create({
+  container: {
+    flexDirection: 'row',
+    alignItems: 'center'
+  },
+  defaultInputStyles: {
+    alignItems: 'center',
+    justifyContent: 'center'
+  }
+});

package/lib-module/CheckboxCard/CheckboxCard.js

@@ -0,0 +1,200 @@
+import React, { forwardRef } from 'react';
+import PropTypes from 'prop-types';
+import StyleSheet from "react-native-web/dist/exports/StyleSheet";
+import Text from "react-native-web/dist/exports/Text";
+import View from "react-native-web/dist/exports/View";
+import { applyTextStyles, useTheme, useThemeTokensCallback } from '../ThemeProvider';
+import { a11yProps, focusHandlerProps, getTokensPropType, selectSystemProps, selectTokens, useInputValue, useUniqueId, variantProp, viewProps } from '../utils';
+import { PressableCardBase, selectPressableCardTokens } from '../Card';
+import StackView from '../StackView';
+import CheckboxButton, { selectCheckboxTokens } from '../Checkbox/CheckboxButton';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, focusHandlerProps, viewProps]);
+const CheckboxCard = /*#__PURE__*/forwardRef((_ref, ref) => {
+  let {
+    tokens,
+    variant,
+    title,
+    children,
+    inactive,
+    defaultChecked,
+    checked,
+    name: inputName,
+    value,
+    id,
+    iconId,
+    onChange,
+    ...rest
+  } = _ref;
+  const {
+    currentValue: isChecked,
+    setValue: setIsChecked,
+    isControlled
+  } = useInputValue({
+    value: checked,
+    initialValue: defaultChecked,
+    onChange
+  });
+
+  const handleChange = event => {
+    if (!inactive) {
+      setIsChecked(!isChecked, event);
+    }
+  };
+
+  const uniqueId = useUniqueId('CheckboxCard');
+  const inputId = id ?? uniqueId;
+  const uniqueIconId = useUniqueId('CheckboxIcon');
+  const iconCheckboxId = iconId ?? uniqueIconId;
+  const getTokens = useThemeTokensCallback('CheckboxCard', tokens, variant);
+
+  const getCardTokens = cardState => selectPressableCardTokens(getTokens(cardState));
+
+  const {
+    themeOptions
+  } = useTheme();
+  const selectedProps = selectProps({
+    accessibilityRole: 'checkbox',
+    accessibilityState: {
+      checked: isChecked,
+      disabled: inactive
+    },
+    ...rest
+  });
+  return /*#__PURE__*/_jsx(PressableCardBase, {
+    ref: ref,
+    inactive: inactive,
+    checked: isChecked,
+    tokens: getCardTokens,
+    onPress: handleChange,
+    ...selectedProps,
+    children: cardState => {
+      const {
+        checkboxSpace,
+        contentSpace,
+        ...themeTokens
+      } = getTokens(cardState);
+      const checkboxTokens = selectCheckboxTokens(themeTokens, 'checkbox');
+      const titleTokens = selectTokens('Typography', themeTokens);
+      const textStyle = applyTextStyles({ ...titleTokens,
+        themeOptions
+      });
+      return /*#__PURE__*/_jsxs(StackView, {
+        direction: "row",
+        space: checkboxSpace,
+        children: [/*#__PURE__*/_jsx(View, {
+          style: [staticStyles.alignWithText, {
+            height: textStyle.lineHeight
+          }],
+          children: /*#__PURE__*/_jsx(CheckboxButton, {
+            tokens: checkboxTokens,
+            isControlled: isControlled,
+            isChecked: isChecked,
+            inactive: inactive,
+            defaultChecked: defaultChecked,
+            inputId: inputId,
+            iconId: iconCheckboxId,
+            handleChange: handleChange,
+            name: inputName,
+            value: value
+          })
+        }), /*#__PURE__*/_jsxs(StackView, {
+          direction: "column",
+          space: contentSpace,
+          tokens: {
+            flexShrink: 1
+          },
+          children: [title ? /*#__PURE__*/_jsx(Text, {
+            style: textStyle,
+            children: title
+          }) : null, typeof children === 'function' ? children(cardState, textStyle) : children]
+        })]
+      });
+    }
+  });
+});
+CheckboxCard.displayName = 'CheckboxCard';
+CheckboxCard.propTypes = { ...selectedSystemPropTypes,
+
+  /**
+   * Content to be displayed at the top of the card alongside the checkbox
+   */
+  title: PropTypes.string,
+
+  /**
+   * Additional content to be displayed below the checkbox.
+   */
+  children: PropTypes.oneOfType([PropTypes.node, PropTypes.func]),
+
+  /**
+   * Use `checked` for controlled checkbox. For uncontrolled checkbox, use the `defaultChecked` prop.
+   */
+  checked: PropTypes.bool,
+
+  /**
+   * Use `defaultChecked` to provide the initial value for an uncontrolled checkbox.
+   */
+  defaultChecked: PropTypes.bool,
+
+  /**
+   * An optional checkboxdescription.
+   */
+  description: PropTypes.string,
+
+  /**
+   * Checkbox card ID.
+   */
+  id: PropTypes.string,
+
+  /**
+   * Checkbox icon ID.
+   */
+  iconId: PropTypes.string,
+
+  /**
+   * Whether the corresponding input is disabled or active.
+   */
+  inactive: PropTypes.bool,
+
+  /**
+   * The label.
+   */
+  label: PropTypes.string,
+
+  /**
+   * Associate this checkbox card with a group (set as the name attribute).
+   */
+  name: PropTypes.string,
+
+  /**
+   * Whether the underlying input triggered a validation error or not.
+   */
+  error: PropTypes.bool,
+
+  /**
+   * The value. Must be unique within the group.
+   */
+  value: PropTypes.oneOfType([PropTypes.string, PropTypes.number, PropTypes.bool]),
+
+  /**
+   * Callback called when a controlled checkbox card gets interacted with.
+   */
+  onChange: PropTypes.func,
+
+  /**
+   * checkbox card tokens.
+   */
+  tokens: getTokensPropType('CheckboxCard'),
+
+  /**
+   * checkbox variant.
+   */
+  variant: variantProp.propType
+};
+export default CheckboxCard;
+const staticStyles = StyleSheet.create({
+  alignWithText: {
+    justifyContent: 'center'
+  }
+});

package/lib-module/CheckboxCard/index.js

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

package/lib-module/StackView/StackView.js

@@ -80,10 +80,13 @@ const StackView = /*#__PURE__*/forwardRef((_ref, ref) => {
     viewport
   });
   const flexStyles = selectFlexStyles(themeTokens);
+  const size = {
+    width: themeTokens.width
+  };
   return /*#__PURE__*/_jsx(View, {
     ref: ref,
     ...selectedProps,
-    style: [flexStyles, staticStyles[direction]],
+    style: [flexStyles, staticStyles[direction], size],
     children: content
   });
 });

package/lib-module/Tabs/Tabs.js

@@ -1,4 +1,5 @@
 import React, { forwardRef, useCallback } from 'react';
+import Platform from "react-native-web/dist/exports/Platform";
 import PropTypes from 'prop-types';
 import ABBPropTypes from 'airbnb-prop-types';
 import { useThemeTokens } from '../ThemeProvider';
@@ -26,6 +27,17 @@ const getDefaultTabItemAccessibilityRole = parentRole => {
       return undefined;
   }
 };
+
+const getStackViewTokens = variant => {
+  const equalWidth = variant === null || variant === void 0 ? void 0 : variant.equalWidth;
+  return Platform.select({
+    web: {
+      justifyContent: equalWidth ? 'space-evenly' : 'flex-start',
+      width: equalWidth ? '100%' : 'auto'
+    },
+    default: {}
+  });
+};
 /**
  * Tabs renders a horizontally-scrolling menu of selectable buttons which may link
  * to a page or control what content is displayed on this page.
@@ -76,6 +88,7 @@ const Tabs = /*#__PURE__*/forwardRef((_ref, ref) => {
   const restProps = selectProps(rest);
   const parentAccessibilityRole = restProps.accessibilityRole ?? 'tablist';
   const defaultTabItemAccessibiltyRole = getDefaultTabItemAccessibilityRole(parentAccessibilityRole);
+  const stackViewTokens = getStackViewTokens(variant);
   return /*#__PURE__*/_jsx(HorizontalScroll, {
     ref: ref,
     ScrollButton: HorizontalScrollButton,
@@ -87,6 +100,7 @@ const Tabs = /*#__PURE__*/forwardRef((_ref, ref) => {
     children: /*#__PURE__*/_jsx(StackView, {
       space: space,
       direction: "row",
+      tokens: stackViewTokens,
       children: items.map((_ref3, index) => {
         let {
           href,

package/lib-module/index.js

@@ -8,6 +8,7 @@ export * from './Carousel';
 export { default as Listbox } from './Listbox';
 export { default as Checkbox } from './Checkbox';
 export * from './Checkbox';
+export { default as CheckboxCard } from './CheckboxCard';
 export { default as Divider } from './Divider';
 export { default as ExpandCollapse, Accordion } from './ExpandCollapse';
 export { default as Feedback } from './Feedback';

package/package.json

@@ -11,7 +11,7 @@
     "@floating-ui/react-native": "^0.8.1",
     "@gorhom/portal": "^1.0.14",
     "@telus-uds/system-constants": "^1.3.0",
-    "@telus-uds/system-theme-tokens": "^2.41.1",
+    "@telus-uds/system-theme-tokens": "^2.42.0",
     "airbnb-prop-types": "^2.16.0",
     "lodash.debounce": "^4.0.8",
     "lodash.merge": "^4.6.2",
@@ -73,5 +73,5 @@
   "standard-engine": {
     "skip": true
   },
-  "version": "1.63.0"
+  "version": "1.65.0"
 }

package/src/Checkbox/CheckboxButton.jsx

@@ -0,0 +1,180 @@
+import React, { forwardRef } from 'react'
+import PropTypes from 'prop-types'
+import { Platform, StyleSheet, View } from 'react-native'
+
+import CheckboxInput from './CheckboxInput'
+import { applyShadowToken, useThemeTokens } from '../ThemeProvider'
+import {
+  a11yProps,
+  getTokensSetPropType,
+  selectSystemProps,
+  selectTokens,
+  viewProps
+} from '../utils'
+
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
+const selectInputStyles = (
+  {
+    iconBackgroundColor,
+    inputBorderColor,
+    inputBorderRadius,
+    inputBorderWidth,
+    inputBackgroundColor,
+    inputHeight,
+    inputOutlineColor,
+    inputOutlineWidth,
+    inputOutlineOffset,
+    inputShadow,
+    inputWidth
+  },
+  isChecked
+) => ({
+  borderColor: inputBorderColor,
+  borderWidth: inputBorderWidth,
+  borderRadius: inputBorderRadius,
+  backgroundColor: isChecked ? iconBackgroundColor : inputBackgroundColor,
+  height: inputHeight,
+  width: inputWidth,
+  ...applyShadowToken(inputShadow),
+  ...Platform.select({
+    web: {
+      outlineStyle: 'solid',
+      outlineColor: inputOutlineColor,
+      outlineWidth: inputOutlineWidth,
+      outlineOffset: inputOutlineOffset
+    }
+  })
+})
+
+const selectIconTokens = ({ icon, iconColor, iconSize }) => ({
+  icon,
+  color: iconColor,
+  size: iconSize
+})
+
+const tokenKeys = [
+  'checkedBackgroundColor',
+  'checkedSize',
+  'inputBackgroundColor',
+  'inputBorderColor',
+  'inputBorderWidth',
+  'inputOutlineColor',
+  'inputOutlineWidth',
+  'inputSize',
+  'outerBorderColor',
+  'outerBorderWidth',
+  'outerBorderGap',
+  'inputSize'
+]
+
+export const selectCheckboxTokens = (themeTokens, prefix) =>
+  selectTokens(tokenKeys, themeTokens, prefix)
+
+/**
+ * The visual toggle of a checkbox input. Is not interactive on its own, should be used inside
+ * an interactive parent that passes down props when interacted with. Used in CheckboxCard
+ */
+const CheckboxButton = forwardRef(
+  (
+    {
+      isChecked,
+      tokens,
+      inactive,
+      defaultChecked,
+      inputId,
+      iconId,
+      isControlled,
+      handleChange,
+      name: inputName,
+      value,
+      ...rest
+    },
+    ref
+  ) => {
+    const { icon: IconComponent, ...stateTokens } = useThemeTokens(
+      'Checkbox',
+      {},
+      { checked: isChecked }
+    )
+    const iconTokens = selectIconTokens(stateTokens)
+
+    return (
+      <View {...selectProps(rest)}>
+        <View
+          style={[staticStyles.defaultInputStyles, selectInputStyles(stateTokens, isChecked)]}
+          testID={inputId}
+        >
+          <CheckboxInput
+            ref={ref}
+            checked={isChecked}
+            defaultChecked={defaultChecked}
+            disabled={inactive}
+            id={inputId}
+            isControlled={isControlled}
+            onChange={handleChange}
+            name={inputName}
+            value={value}
+          />
+          {isChecked && IconComponent && (
+            <View testID={iconId}>
+              <IconComponent {...iconTokens} />
+            </View>
+          )}
+        </View>
+      </View>
+    )
+  }
+)
+CheckboxButton.displayName = 'CheckboxButton'
+
+CheckboxButton.propTypes = {
+  ...selectedSystemPropTypes,
+  /**
+   * Use `checked` for controlled Checkbox. For uncontrolled Checkbox, use the `defaultChecked` prop.
+   */
+  isChecked: PropTypes.bool,
+  /**
+   * Checkbox tokens.
+   */
+  tokens: getTokensSetPropType(tokenKeys, { allowFunction: true }),
+  /**
+   * Whether the corresponding input is disabled or active.
+   */
+  inactive: PropTypes.bool,
+  /**
+   * Use `defaultChecked` to provide the initial value for an uncontrolled Checkbox.
+   */
+  defaultChecked: PropTypes.bool,
+  /**
+   * Checkbox input ID.
+   */
+  inputId: PropTypes.string,
+  /**
+   * Checkbox icon ID.
+   */
+  iconId: PropTypes.string,
+  /**
+   * Can control the checkbox on the card.
+   */
+  isControlled: PropTypes.bool,
+  /**
+   * Callback called when a controlled checkbox gets interacted with.
+   */
+  handleChange: PropTypes.func,
+  /**
+   * Associate this checkbox with a group (set as the name attribute).
+   */
+  name: PropTypes.string,
+  /**
+   * The value of the checkbox: true or false
+   */
+  value: PropTypes.bool
+}
+
+export default CheckboxButton
+
+const staticStyles = StyleSheet.create({
+  container: { flexDirection: 'row', alignItems: 'center' },
+  defaultInputStyles: { alignItems: 'center', justifyContent: 'center' }
+})