@telus-uds/components-base 0.0.2-prerelease.6 → 1.0.0

package/lib/Select/Select.js

@@ -0,0 +1,342 @@
+"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 = /*#__PURE__*/(0, _react.forwardRef)(({
+  value,
+  initialValue,
+  onChange,
+  children,
+  inactive,
+  readOnly,
+  placeholder,
+  validation,
+  tokens,
+  variant,
+  testID,
+  ...rest
+}, ref) => {
+  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, {
+        ref: ref,
+        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.displayName = 'Select';
+Select.propTypes = { ..._propTypes2.default.types,
+
+  /**
+   * Initial value for the uncontrolled version.
+   */
+  initialValue: _propTypes.default.string,
+
+  /**
+   * Current value to be set as selected.
+   */
+  value: _propTypes.default.string,
+
+  /**
+   * Callback to be called when the value changes.
+   */
+  onChange: _propTypes.default.func,
+
+  /**
+   * An array of items or item groups to be used as options.
+   */
+  children: (0, _utils.componentPropType)(['Item', 'Group']),
+
+  /**
+   * Whether the select is disabled.
+   */
+  inactive: _propTypes.default.bool,
+
+  /**
+   * Whether the select is read-only.
+   */
+  readOnly: _propTypes.default.bool,
+
+  /**
+   * A placeholder to provide instructions (such as "Please select...")
+   * as an unselectable option
+   */
+  placeholder: _propTypes.default.string,
+
+  /**
+   * Select tokens.
+   */
+  tokens: (0, _utils.getTokensPropType)('Select'),
+
+  /**
+   * Select variant.
+   */
+  variant: _utils.variantProp.propType,
+
+  /**
+   * Dedicated ID for testing.
+   */
+  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,29 @@
-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 = _interopRequireWildcard(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 _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 selectItemStyles({
   backgroundColor,
@@ -27,7 +47,7 @@ function selectItemStyles({
     paddingTop,
     paddingBottom,
     justifyContent,
-    ...verticalAlignRow(verticalAlign)
+    ...(0, _ThemeProvider.verticalAlignRow)(verticalAlign)
   };
 }
 /**
@@ -37,7 +57,7 @@ function selectItemStyles({
  */
 
 
-const Item = ({
+const Item = /*#__PURE__*/(0, _react.forwardRef)(({
   children,
   itemId,
   groupId,
@@ -50,21 +70,23 @@ const Item = ({
   accessibilityRole = 'link',
   testID,
   ...props
-}) => {
+}, ref) => {
   const handlePress = () => onPress(itemId, groupId);
 
   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,60 +98,64 @@ 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, {
+    ref: ref,
+    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
+      });
+    }
   });
-};
-
+});
+Item.displayName = 'Item';
 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;

package/lib/SideNav/ItemContent.js

@@ -1,9 +1,28 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import { View, StyleSheet } from 'react-native';
-import Typography from '../Typography';
-import { selectTokens, getTokensPropType } from '../utils';
-export function selectAccentStyles(tokens) {
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.selectAccentStyles = selectAccentStyles;
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _Typography = _interopRequireDefault(require("../Typography"));
+
+var _utils = require("../utils");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function selectAccentStyles(tokens) {
   return {
     left: tokens.accentOffset,
     top: tokens.accentPadding,
@@ -17,22 +36,29 @@ export function selectAccentStyles(tokens) {
  * Content inside an item or control in a SideNav, themed by the SideNavItem theme
  */
 
+
 const ItemContent = ({
   children,
   tokens
-}) => /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Typography, {
-  tokens: selectTokens('Typography', tokens)
-}, children), /*#__PURE__*/React.createElement(View, {
-  style: [staticStyles.absolute, selectAccentStyles(tokens)]
-}));
+}) => /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+  children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
+    tokens: (0, _utils.selectTokens)('Typography', tokens),
+    children: children
+  }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: [staticStyles.absolute, selectAccentStyles(tokens)]
+  })]
+});
 
 ItemContent.propTypes = {
-  tokens: getTokensPropType('SideNavItem'),
-  children: PropTypes.node
+  tokens: (0, _utils.getTokensPropType)('SideNavItem'),
+  children: _propTypes.default.node
 };
-const staticStyles = StyleSheet.create({
+
+const staticStyles = _StyleSheet.default.create({
   absolute: {
     position: 'absolute'
   }
 });
-export default ItemContent;
+
+var _default = ItemContent;
+exports.default = _default;