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

package/lib/Select/Picker.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _utils = require("../utils");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const Picker = ({
+  value,
+  onChange,
+  onFocus,
+  onBlur,
+  onMouseOver,
+  onMouseOut,
+  style,
+  inactive,
+  children,
+  placeholder,
+  nativeID,
+  testID,
+  ...rest
+}) => {
+  const {
+    accessibilityLabel,
+    accessibilityDescribedBy,
+    accessibilityInvalid
+  } = rest;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("select", {
+    style: style,
+    onMouseOver: onMouseOver,
+    onMouseOut: onMouseOut,
+    onFocus: onFocus,
+    onBlur: onBlur,
+    disabled: inactive,
+    value: value || (placeholder !== undefined ? placeholder.value : undefined),
+    onChange: event => onChange(event.target.value),
+    id: nativeID,
+    "aria-label": accessibilityLabel,
+    "aria-describedby": accessibilityDescribedBy,
+    "aria-invalid": accessibilityInvalid,
+    "data-testid": testID,
+    children: [placeholder !== undefined && /*#__PURE__*/(0, _jsxRuntime.jsx)("option", {
+      value: placeholder.value,
+      disabled: true,
+      hidden: true,
+      children: placeholder.label
+    }), children]
+  });
+};
+
+var _default = Picker;
+exports.default = _default;
+Picker.propTypes = {
+  value: _propTypes.default.string,
+  onChange: _propTypes.default.func,
+  onFocus: _propTypes.default.func,
+  onBlur: _propTypes.default.func,
+  onMouseOver: _propTypes.default.func,
+  onMouseOut: _propTypes.default.func,
+  style: _propTypes.default.object,
+  inactive: _propTypes.default.bool,
+  children: (0, _utils.componentPropType)(['Item', 'Group']),
+  placeholder: _propTypes.default.shape({
+    value: _propTypes.default.string,
+    label: _propTypes.default.string
+  }),
+  nativeID: _propTypes.default.string,
+  testID: _propTypes.default.string
+};

package/lib/Select/Picker.native.js

@@ -0,0 +1,115 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _reactNativePickerSelect = _interopRequireDefault(require("react-native-picker-select"));
+
+var _utils = require("../utils");
+
+var _Group = _interopRequireDefault(require("./Group"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+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; }
+
+// styling of the native input is very limited, most of the styles have to be applied to an additional View
+const selectAndroidInputStyles = ({
+  height = 0,
+  paddingBottom = 0,
+  paddingTop = 0,
+  borderWidth = 0,
+  color
+}) => ({
+  height: height - paddingTop - paddingBottom - 2 * borderWidth,
+  color
+}); // the native input has a side padding of 8px, which can't be adjusted, so we have to account for that in the container
+
+
+const selectAndroidContainerStyles = ({
+  paddingLeft = 0,
+  paddingRight = 0,
+  ...rest
+}) => ({
+  paddingLeft: paddingLeft > 8 ? paddingLeft - 8 : 0,
+  paddingRight: paddingRight > 8 ? paddingRight - 8 : 0,
+  ...rest
+});
+
+const Picker = ({
+  value,
+  onChange,
+  onFocus,
+  onBlur,
+  style,
+  inactive,
+  children,
+  placeholder,
+  ...rest
+}) => {
+  // ungroup items, since there's no way to support groups on native
+  const flatChildren = _react.Children.toArray(children).flatMap(child => {
+    if (child.type === _Group.default) {
+      return child.props.children;
+    }
+
+    return child;
+  });
+
+  const items = flatChildren.map(({
+    props
+  }) => ({
+    label: props.children,
+    value: props.value
+  }));
+  const picker = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativePickerSelect.default, {
+    touchableWrapperProps: _utils.a11yProps.select(rest),
+    onOpen: onFocus,
+    onClose: onBlur,
+    disabled: inactive,
+    items: items,
+    value: value,
+    onValueChange: onChange,
+    style: {
+      inputIOS: style,
+      inputAndroid: selectAndroidInputStyles(style)
+    },
+    placeholder: placeholder !== undefined ? placeholder : {}
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: _Platform.default.OS === 'android' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+      style: selectAndroidContainerStyles(style),
+      children: picker
+    }) : picker
+  });
+};
+
+var _default = Picker;
+exports.default = _default;
+Picker.propTypes = {
+  value: _propTypes.default.string,
+  onChange: _propTypes.default.func,
+  onFocus: _propTypes.default.func,
+  onBlur: _propTypes.default.func,
+  style: _propTypes.default.object,
+  inactive: _propTypes.default.bool,
+  children: (0, _utils.componentPropType)(['Item', 'Group']),
+  placeholder: _propTypes.default.shape({
+    value: _propTypes.default.string,
+    label: _propTypes.default.string
+  })
+};

package/lib/Select/Select.js

@@ -0,0 +1,300 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _Picker = _interopRequireDefault(require("./Picker"));
+
+var _InputSupports = _interopRequireDefault(require("../InputSupports"));
+
+var _propTypes2 = _interopRequireDefault(require("../InputSupports/propTypes"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+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; }
+
+const selectInputStyles = ({
+  backgroundColor,
+  color,
+  borderWidth = 0,
+  borderColor,
+  borderRadius,
+  paddingTop,
+  paddingBottom,
+  paddingLeft = 0,
+  paddingRight,
+  fontName,
+  fontSize,
+  fontWeight,
+  lineHeight,
+  icon,
+  iconSize = 0,
+  validationIcon,
+  validationIconSize = 0,
+  height
+}, inactive) => {
+  // Subtract border width from padding so overall input width/height doesn't
+  // jump around if the border width changes (avoiding NaN and negative padding)
+  const offsetBorder = value => typeof value === 'number' ? Math.max(0, value - borderWidth) : value;
+
+  const textStyles = (0, _ThemeProvider.applyTextStyles)({
+    fontName,
+    fontSize,
+    lineHeight,
+    fontWeight
+  });
+
+  const webStyles = _Platform.default.select({
+    web: {
+      appearance: 'none',
+      WebkitAppearance: 'none',
+      // since iOS Safari needs a prefix
+      outline: 'none',
+      cursor: inactive ? 'not-allowed' : undefined,
+      opacity: inactive ? 1 : undefined // override Chrome's default fadeout of a disabled select
+
+    }
+  });
+
+  let paddingWithIcons = paddingRight;
+
+  if (_Platform.default.OS !== 'android') {
+    if (icon) {
+      paddingWithIcons += iconSize;
+    }
+
+    if (validationIcon) {
+      paddingWithIcons += validationIconSize;
+    }
+  }
+
+  return {
+    backgroundColor,
+    color,
+    borderWidth,
+    borderColor,
+    borderRadius,
+    paddingLeft: offsetBorder(paddingLeft),
+    paddingRight: offsetBorder(paddingWithIcons),
+    paddingTop: offsetBorder(paddingTop),
+    paddingBottom: offsetBorder(paddingBottom),
+    height,
+    ...textStyles,
+    ...webStyles
+  };
+};
+
+const selectOuterBorderStyles = ({
+  outerBackgroundColor,
+  outerBorderWidth,
+  outerBorderColor,
+  borderRadius
+}) => ({
+  background: outerBackgroundColor,
+  ...(0, _ThemeProvider.applyOuterBorder)({
+    outerBorderColor,
+    outerBorderWidth,
+    borderRadius
+  })
+});
+
+const selectIconTokens = ({
+  iconSize,
+  iconColor
+}) => ({
+  size: iconSize,
+  color: iconColor
+});
+
+const selectIconContainerStyles = ({
+  paddingRight,
+  paddingBottom
+}) => ({
+  paddingRight,
+  paddingBottom
+});
+
+const selectValidationIconTokens = ({
+  validationIconSize,
+  validationIconColor
+}) => ({
+  size: validationIconSize,
+  color: validationIconColor
+});
+
+const selectValidationIconContainerStyles = ({
+  icon,
+  iconSize = 0,
+  paddingRight = 0,
+  paddingBottom
+}) => ({
+  paddingRight: icon ? paddingRight + iconSize : paddingRight,
+  paddingBottom
+});
+/**
+ * A basic form single-choice select component. Use in forms or individually to receive user's input.
+ *
+ * ## Usage criteria
+ * - Include a `placeholder` to provide instructions such as "Please select..." as an unselectable option (recommended)
+ * - Use when options are between 7-15 (recommended)
+ * - For options are 6 and under, use `Radio` groups or `ButtonGroup`.
+ * - For options 15 and above, look for alternatives (e.g grouping into categories, or input field with auto-complete etc.)
+ *
+ * ## Controlled component
+ * If it is required that the state of the `Select` be controlled by the application or other external methods,
+ * `value` and `onChange` props must be passed to the `Select`.
+ * If the `Select` value should not be changed by user input, a `readOnly` prop must be provided.
+ *
+ * ## Uncontrolled component
+ * If it is not necessary to control the `Select` state, you can create one without a value prop.
+ * In this case its value can be accessed within the `onChange` callback. Use the `initialValue` prop to set the
+ * default value for an uncontrolled `Select`.
+ *
+ * ## Getting feedback for entered values
+ * Use the `feedback` prop to give the user feedback regarding their selection.
+ * You can affirm that the user's selection 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.
+ *
+ * ## Using a tooltip
+ * When a more in-depth explanation is needed to fill out a `Select` properly, the tooltip prop may be used.
+ *
+ * ## Grouping options
+ * `Select` supports option groups. Use a `Select.Group` component to render an `<optgroup>` element with its items.
+ * NOTE: this does not work on native platforms - the grouped items will be shown at the same level as the non-grouped items.
+ *
+ */
+
+
+const Select = ({
+  value,
+  initialValue,
+  onChange,
+  children,
+  inactive,
+  readOnly,
+  placeholder,
+  validation,
+  tokens,
+  variant,
+  testID,
+  ...rest
+}) => {
+  const {
+    currentValue,
+    setValue
+  } = (0, _utils.useInputValue)({
+    value,
+    initialValue,
+    onChange,
+    readOnly
+  });
+  const [isFocused, setIsFocused] = (0, _react.useState)(false);
+
+  const handleFocus = () => setIsFocused(true);
+
+  const handleBlur = () => setIsFocused(false);
+
+  const [isHovered, setIsHovered] = (0, _react.useState)(false);
+
+  const handleMouseOver = () => setIsHovered(true);
+
+  const handleMouseOut = () => setIsHovered(false);
+
+  const {
+    props: supportsProps
+  } = _propTypes2.default.select(rest);
+
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Select', tokens, variant, {
+    focus: isFocused,
+    hover: isHovered,
+    inactive,
+    validation
+  });
+  const {
+    icon: IconComponent,
+    validationIcon: ValidationIconComponent
+  } = themeTokens;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_InputSupports.default, { ...supportsProps,
+    children: ({
+      a11yProps,
+      inputId
+    }) => /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+      style: selectOuterBorderStyles(themeTokens),
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Picker.default, {
+        style: selectInputStyles(themeTokens, inactive),
+        onFocus: handleFocus,
+        onBlur: handleBlur,
+        onMouseOver: handleMouseOver,
+        onMouseOut: handleMouseOut,
+        onChange: setValue,
+        value: currentValue,
+        inactive: inactive,
+        placeholder: placeholder !== undefined ? {
+          label: placeholder,
+          value: ''
+        } : undefined,
+        ...a11yProps,
+        nativeID: inputId,
+        testID: testID,
+        children: children
+      }), ValidationIconComponent && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        pointerEvents: "none",
+        style: [staticStyles.iconContainer, selectValidationIconContainerStyles(themeTokens)],
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ValidationIconComponent, {
+          tokens: selectValidationIconTokens(themeTokens)
+        })
+      }), IconComponent && _Platform.default.OS !== 'android' &&
+      /*#__PURE__*/
+      // we can't hide the default caret of a native picker on android
+      (0, _jsxRuntime.jsx)(_View.default, {
+        pointerEvents: "none",
+        style: [staticStyles.iconContainer, selectIconContainerStyles(themeTokens)],
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, { ...selectIconTokens(themeTokens)
+        })
+      })]
+    })
+  });
+};
+
+Select.propTypes = { ..._propTypes2.default.types,
+  initialValue: _propTypes.default.string,
+  value: _propTypes.default.string,
+  onChange: _propTypes.default.func,
+  children: (0, _utils.componentPropType)(['Item', 'Group']),
+  inactive: _propTypes.default.bool,
+  readOnly: _propTypes.default.bool,
+  placeholder: _propTypes.default.string,
+  tokens: (0, _utils.getTokensPropType)('Select'),
+  variant: _utils.variantProp.propType,
+  testID: _propTypes.default.string
+};
+var _default = Select;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
+  iconContainer: {
+    position: 'absolute',
+    right: 0,
+    bottom: 0
+  }
+});

package/lib/Select/index.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _Select = _interopRequireDefault(require("./Select"));
+
+var _Group = _interopRequireDefault(require("./Group"));
+
+var _Item = _interopRequireDefault(require("./Item"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+_Select.default.Group = _Group.default;
+_Select.default.Item = _Item.default;
+var _default = _Select.default;
+exports.default = _default;

package/lib/SideNav/Item.js

@@ -1,9 +1,25 @@
-import React from 'react';
-import { Pressable } from 'react-native';
-import PropTypes from 'prop-types';
-import { variantProp, getTokensPropType, a11yProps, hrefAttrsProp, linkProps } from '../utils';
-import { useThemeTokensCallback, verticalAlignRow } from '../ThemeProvider';
-import ItemContent from './ItemContent';
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _utils = require("../utils");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _ItemContent = _interopRequireDefault(require("./ItemContent"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function selectItemStyles({
   backgroundColor,
@@ -27,7 +43,7 @@ function selectItemStyles({
     paddingTop,
     paddingBottom,
     justifyContent,
-    ...verticalAlignRow(verticalAlign)
+    ...(0, _ThemeProvider.verticalAlignRow)(verticalAlign)
   };
 }
 /**
@@ -56,15 +72,17 @@ const Item = ({
   const {
     hrefAttrs,
     rest
-  } = hrefAttrsProp.bundle(props);
-  const linkPropSet = linkProps.select({
+  } = _utils.hrefAttrsProp.bundle(props);
+
+  const linkPropSet = _utils.linkProps.select({
     accessibilityRole,
     href,
     onPress: handlePress,
-    ...hrefAttrsProp.spread(hrefAttrs),
+    hrefAttrs,
     ...rest
   });
-  const getTokens = useThemeTokensCallback('SideNavItem', tokens, variant);
+
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('SideNavItem', tokens, variant);
 
   const getAppearanceState = ({
     hovered
@@ -76,18 +94,20 @@ const Item = ({
 
   const getPressableStyle = pressableState => selectItemStyles(getTokens(getAppearanceState(pressableState)));
 
-  return /*#__PURE__*/React.createElement(Pressable, Object.assign({
-    style: getPressableStyle
-  }, linkPropSet, {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    style: getPressableStyle,
+    ...linkPropSet,
     accessibilityState: {
       selected: isActive
     },
-    testID: testID
-  }), pressableState => {
-    const themeTokens = getTokens(getAppearanceState(pressableState));
-    return /*#__PURE__*/React.createElement(ItemContent, {
-      tokens: themeTokens
-    }, children);
+    testID: testID,
+    children: pressableState => {
+      const themeTokens = getTokens(getAppearanceState(pressableState));
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ItemContent.default, {
+        tokens: themeTokens,
+        children: children
+      });
+    }
   });
 };
 
@@ -95,41 +115,42 @@ Item.propTypes = {
   /**
    * Text content of the `Item`.
    */
-  children: PropTypes.node.isRequired,
+  children: _propTypes.default.node.isRequired,
 
   /**
    * @ignore
    * Set internally in `SideNav` render function - used to keep track of active item.
    */
-  itemId: PropTypes.string,
+  itemId: _propTypes.default.string,
 
   /**
    * @ignore
    * Set internally in `SideNav` render function - used to keep track of expanded items groups.
    */
-  groupId: PropTypes.string,
-  onPress: PropTypes.func,
-  href: PropTypes.string,
+  groupId: _propTypes.default.string,
+  onPress: _propTypes.default.func,
+  href: _propTypes.default.string,
 
   /**
    * On Web if href is passed, React Native Web maps this object's props to
-   * `rel`, `target` and (>= RNW 0.15.0) `download` attrs.
+   * `rel`, `target` and `download` attrs.
    */
-  hrefAttrs: PropTypes.shape(hrefAttrsProp.types),
+  hrefAttrs: _propTypes.default.shape(_utils.hrefAttrsProp.types),
 
   /**
    * @ignore
    * Set internally in `SideNav` render function.
    */
-  isActive: PropTypes.bool,
+  isActive: _propTypes.default.bool,
 
   /**
    * @ignore
    * Set internally in `SideNav.ItemsGroup` render function. Used to mark expanded `ItemsGroup` parent.
    */
-  isExpanded: PropTypes.bool,
-  tokens: getTokensPropType('SideNavItem'),
-  variant: variantProp.propType,
-  ...a11yProps.types
+  isExpanded: _propTypes.default.bool,
+  tokens: (0, _utils.getTokensPropType)('SideNavItem'),
+  variant: _utils.variantProp.propType,
+  ..._utils.a11yProps.types
 };
-export default Item;
+var _default = Item;
+exports.default = _default;