@telus-uds/components-base 0.0.2-prerelease.7 → 1.0.1

package/lib/List/List.js

@@ -1,31 +1,55 @@
-import React, { cloneElement, Children } from 'react';
-import { View, Platform } from 'react-native';
-import PropTypes from 'prop-types';
-import { getTokensPropType, variantProp, componentPropType } from '../utils';
-import { a11yProps } from '../utils/propTypes';
-import ListItem from './ListItem';
+"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 _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _utils = require("../utils");
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _ListItem = _interopRequireDefault(require("./ListItem"));
+
+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; }
+
 /**
  * A Unordered List component has a child a ListItem that
  * allows icon, dividers and customized typography
  */
-
-const List = ({
+const List = /*#__PURE__*/(0, _react.forwardRef)(({
   children,
   showDivider,
   tokens,
   variant,
   ...rest
-}) => {
-  const accessibilityRole = Platform.select({
+}, ref) => {
+  const accessibilityRole = _Platform.default.select({
     web: 'list',
     default: 'none'
   });
-  const a11y = a11yProps.select(rest);
-  const items = Children.map(children, (child, index) => {
-    if (child.type.name === ListItem.name) {
-      return /*#__PURE__*/cloneElement(child, {
+
+  const a11y = _propTypes2.a11yProps.select(rest);
+
+  const items = _react.Children.map(children, (child, index) => {
+    if (child.type.name === _ListItem.default.name) {
+      return /*#__PURE__*/(0, _react.cloneElement)(child, {
         showDivider,
-        isLastItem: index + 1 === Children.count(children),
+        isLastItem: index + 1 === _react.Children.count(children),
         tokens,
         variant
       });
@@ -33,20 +57,25 @@ const List = ({
 
     return child;
   });
-  return /*#__PURE__*/React.createElement(View, Object.assign({
-    accessibilityRole: accessibilityRole
-  }, a11y), items);
-};
 
-List.Item = ListItem;
-List.propTypes = { ...a11yProps.types,
-  tokens: getTokensPropType('List'),
-  variant: variantProp.propType,
-  children: componentPropType('ListItem'),
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    ref: ref,
+    accessibilityRole: accessibilityRole,
+    ...a11y,
+    children: items
+  });
+});
+List.displayName = 'List';
+List.Item = _ListItem.default;
+List.propTypes = { ..._propTypes2.a11yProps.types,
+  tokens: (0, _utils.getTokensPropType)('List'),
+  variant: _utils.variantProp.propType,
+  children: (0, _utils.componentPropType)('ListItem'),
 
   /**
    * In case it is not the last item allow display divider
    */
-  showDivider: PropTypes.bool
+  showDivider: _propTypes.default.bool
 };
-export default List;
+var _default = List;
+exports.default = _default;

package/lib/List/ListItem.js

@@ -1,8 +1,33 @@
-import React from 'react';
-import { View, Platform, Text, StyleSheet } from 'react-native';
-import PropTypes from 'prop-types';
-import { useThemeTokens, applyTextStyles } from '../ThemeProvider';
-import { getTokensPropType, variantProp } from '../utils';
+"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 _Text = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Text"));
+
+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 _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 selectBulletStyles = ({
   itemBulletWidth,
@@ -43,7 +68,7 @@ const selectItemStyles = ({
   itemFontSize,
   itemLineHeight,
   itemFontName
-}) => applyTextStyles({
+}) => (0, _ThemeProvider.applyTextStyles)({
   fontWeight: itemFontWeight,
   fontSize: itemFontSize,
   lineHeight: itemLineHeight,
@@ -71,7 +96,7 @@ const selectDividerStyles = ({
  */
 
 
-const ListItem = ({
+const ListItem = /*#__PURE__*/(0, _react.forwardRef)(({
   tokens,
   variant,
   icon,
@@ -80,8 +105,8 @@ const ListItem = ({
   showDivider,
   children,
   isLastItem
-}) => {
-  const themeTokens = useThemeTokens('List', tokens, variant);
+}, ref) => {
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('List', tokens, variant);
   const itemStyles = selectItemStyles(themeTokens);
   const itemBlockStyles = selectItemBlockStyles(themeTokens);
   const dividerStyles = selectDividerStyles(themeTokens);
@@ -89,7 +114,8 @@ const ListItem = ({
   const itemBulletStyles = selectBulletStyles(themeTokens);
   const iconTokens = selectItemIconTokens(themeTokens);
   const sideItemContainerStyles = selectSideItemContainerStyles(themeTokens);
-  const accessibilityRole = Platform.select({
+
+  const accessibilityRole = _Platform.default.select({
     web: 'listitem',
     default: 'item'
   });
@@ -104,12 +130,16 @@ const ListItem = ({
 
   const renderItem = () => {
     if (areChildrenStrings()) {
-      return /*#__PURE__*/React.createElement(Text, {
-        style: itemStyles
-      }, children);
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+        style: itemStyles,
+        children: children
+      });
     }
 
-    return /*#__PURE__*/React.createElement(View, null, children);
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+      style: staticStyles.wrap,
+      children: children
+    });
   };
   /**
    * Function responsible returning styling, in case the item is the last shouldn't
@@ -137,71 +167,79 @@ const ListItem = ({
 
 
   const renderMarker = () => {
-    const IconComponent = icon || /*#__PURE__*/React.createElement(React.Fragment, null);
+    const IconComponent = icon || /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {});
 
     if (icon) {
-      return /*#__PURE__*/React.createElement(View, {
-        style: [sideItemContainerStyles, areChildrenStrings() ? staticStyles.centeredIcons : undefined]
-      }, /*#__PURE__*/React.createElement(IconComponent, {
-        tokens: { ...iconTokens,
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        style: [sideItemContainerStyles, areChildrenStrings() ? staticStyles.centeredIcons : undefined],
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, {
           size: iconSize || iconTokens.size,
           color: iconColor || iconTokens.color
-        }
-      }));
+        })
+      });
     }
 
-    return /*#__PURE__*/React.createElement(View, {
-      style: [sideItemContainerStyles, itemBulletContainerStyles]
-    }, /*#__PURE__*/React.createElement(View, {
-      style: itemBulletStyles,
-      testID: "unordered-item-bullet"
-    }));
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+      style: [sideItemContainerStyles, itemBulletContainerStyles],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        style: itemBulletStyles,
+        testID: "unordered-item-bullet"
+      })
+    });
   };
 
-  return /*#__PURE__*/React.createElement(View, {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+    ref: ref,
     style: [staticStyles.itemContainer, getContainerStyle()],
-    accessibilityRole: accessibilityRole
-  }, renderMarker(), renderItem());
-};
+    accessibilityRole: accessibilityRole,
+    children: [renderMarker(), renderItem()]
+  });
+});
+ListItem.displayName = 'ListItem';
 
-const staticStyles = StyleSheet.create({
+const staticStyles = _StyleSheet.default.create({
   itemContainer: {
     flexDirection: 'row'
   },
   centeredIcons: {
     justifyContent: 'center'
+  },
+  wrap: {
+    flex: 1
   }
 });
+
 ListItem.propTypes = {
-  tokens: getTokensPropType('List'),
-  variant: variantProp.propType,
-  children: PropTypes.node.isRequired,
+  tokens: (0, _utils.getTokensPropType)('List'),
+  variant: _utils.variantProp.propType,
+  children: _propTypes.default.node.isRequired,
 
   /**
    * Renders side item icon
    */
-  icon: PropTypes.func,
+  icon: _propTypes.default.func,
 
   /**
    * Will set display icon color
    */
-  iconColor: PropTypes.string,
+  iconColor: _propTypes.default.string,
 
   /**
    * Allow the user define the icon size if not defined the theme's file
    */
-  iconSize: PropTypes.number,
+  iconSize: _propTypes.default.number,
 
   /**
    * @ignore
    * Defined by parent if it's last item on the list
    */
-  isLastItem: PropTypes.bool,
+  isLastItem: _propTypes.default.bool,
 
   /**
    * @ignore
    * In case it is not the last item allow display divider
    */
-  showDivider: PropTypes.bool
+  showDivider: _propTypes.default.bool
 };
-export default ListItem;
+var _default = ListItem;
+exports.default = _default;

package/lib/List/index.js

@@ -1,2 +1,13 @@
-import List from './List';
-export default List;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _List = _interopRequireDefault(require("./List"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var _default = _List.default;
+exports.default = _default;

package/lib/Modal/Modal.js

@@ -0,0 +1,231 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _TouchableWithoutFeedback = _interopRequireDefault(require("react-native-web/dist/cjs/exports/TouchableWithoutFeedback"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _Modal = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Modal"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _ButtonBase = _interopRequireDefault(require("../Button/ButtonBase"));
+
+var _dictionary = _interopRequireDefault(require("./dictionary"));
+
+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 selectContainerStyles = ({
+  containerPaddingLeft,
+  containerPaddingRight,
+  containerPaddingTop,
+  containerPaddingBottom,
+  maxWidth,
+  height
+}) => ({
+  height,
+  maxWidth,
+  paddingLeft: containerPaddingLeft,
+  paddingRight: containerPaddingRight,
+  paddingTop: containerPaddingTop,
+  paddingBottom: containerPaddingBottom
+});
+
+const selectModalStyles = ({
+  backgroundColor,
+  borderRadius,
+  height,
+  paddingLeft,
+  paddingRight,
+  paddingTop,
+  paddingBottom,
+  shadow
+}) => ({
+  backgroundColor,
+  borderRadius,
+  height,
+  paddingLeft,
+  paddingRight,
+  paddingTop,
+  paddingBottom,
+  ...(0, _ThemeProvider.applyShadowToken)(shadow)
+});
+
+const selectBackdropStyles = ({
+  backdropColor,
+  backdropOpacity
+}) => ({
+  backgroundColor: backdropColor,
+  opacity: backdropOpacity
+});
+
+const selectCloseButtonContainerStyles = ({
+  paddingRight,
+  paddingTop
+}) => ({
+  paddingRight,
+  paddingTop
+});
+
+const selectCloseIconProps = ({
+  closeIconSize,
+  closeIconColor
+}) => ({
+  size: closeIconSize,
+  color: closeIconColor
+});
+/**
+ * A modal window is a secondary window that opens on top of the main one.
+ * Users have to interact with it before they can carry out their task and return to the main window.
+ * Use to reveal additional information to a user after they have performed an explicit interaction.
+ * They are a strongly discouraged pattern; it's preferred to have all relevant information within a page,
+ * and irrelevant information either linked externally or omitted.
+ *
+ * - Must only appear after a customer interaction, not on page load or any other circumstance
+ * - Open a modal based on explicit customer action e.g. clicking on a button/link/form field
+ * - Only one modal should be "current" at any time
+ * - Read [WebAIM's documentation](https://www.w3.org/TR/wai-aria-practices/examples/dialog-modal/dialog.html) to create accessible modals
+ * - Don’t use modals to reinforce or repeat information already available in the parent page or view
+ * - Don’t use modals consecutively
+ */
+
+
+const Modal = /*#__PURE__*/(0, _react.forwardRef)(({
+  children,
+  isOpen,
+  onClose,
+  maxWidth,
+  tokens,
+  variant,
+  copy
+}, ref) => {
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Modal', tokens, variant, {
+    viewport,
+    maxWidth
+  });
+  const {
+    closeIcon: CloseIconComponent
+  } = themeTokens;
+  const getCopy = (0, _utils.useCopy)({
+    dictionary: _dictionary.default,
+    copy
+  });
+  const closeLabel = getCopy('closeButton');
+
+  const handleClose = () => {
+    if (typeof onClose === 'function') onClose();
+  };
+
+  const handleKeyUp = event => {
+    if (event.key === 'Escape') onClose();
+  };
+
+  if (!isOpen) {
+    return null;
+  } // TODO: replace the close button with IconButton when implemented (https://github.com/telus/universal-design-system/issues/281)
+
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Modal.default, {
+    transparent: true,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+      style: [staticStyles.positioningContainer],
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        style: [staticStyles.sizingContainer, selectContainerStyles(themeTokens)],
+        pointerEvents: "box-none" // don't capture backdrop press events
+        ,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+          ref: ref,
+          style: [staticStyles.modal, selectModalStyles(themeTokens)],
+          onKeyUp: handleKeyUp,
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: [staticStyles.closeButtonContainer, selectCloseButtonContainerStyles(themeTokens)],
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, {
+              onPress: handleClose,
+              accessibilityRole: "button",
+              accessibilityLabel: closeLabel,
+              children: // TODO: add close button interactive states after IconButton is done
+              () => /*#__PURE__*/(0, _jsxRuntime.jsx)(CloseIconComponent, { ...selectCloseIconProps(themeTokens)
+              })
+            })
+          }), children]
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_TouchableWithoutFeedback.default, {
+        onPress: handleClose,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.backdrop, selectBackdropStyles(themeTokens)]
+        })
+      })]
+    })
+  });
+});
+Modal.displayName = 'Modal';
+Modal.propTypes = {
+  children: _propTypes.default.oneOfType([_propTypes.default.node, _propTypes.default.arrayOf(_propTypes.default.node)]),
+  copy: _utils.copyPropTypes,
+  isOpen: _propTypes.default.bool,
+  onClose: _propTypes.default.func,
+  maxWidth: _propTypes.default.bool,
+  tokens: (0, _utils.getTokensPropType)('Modal'),
+  variant: _utils.variantProp.propType
+};
+var _default = Modal;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
+  backdrop: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    right: 0,
+    bottom: 0,
+    zIndex: -1,
+    ..._Platform.default.select({
+      web: {
+        cursor: 'pointer'
+      }
+    })
+  },
+  positioningContainer: {
+    flexBasis: '100%',
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
+  sizingContainer: {
+    maxHeight: '100%',
+    // so that the container can expand up to the full viewport height
+    width: '100%' // ensure that the modal actually expands to the set maxWidth
+
+  },
+  modal: {
+    maxHeight: '100%' // so that the modal can expand vertically up to the  sizing container's height (exclusive of its vertical padding)
+
+  },
+  closeButtonContainer: {
+    position: 'absolute',
+    top: 0,
+    right: 0
+  }
+});

package/lib/Modal/dictionary.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = {
+  en: {
+    // English text from TDS Community `Modal`
+    closeButton: 'Close'
+  },
+  fr: {
+    closeButton: 'Fermer'
+  }
+};
+exports.default = _default;

package/lib/Modal/index.js

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