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

package/lib/Button/ButtonGroup.js

@@ -1,27 +1,36 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import { View, Platform } from 'react-native';
-import ButtonBase from './ButtonBase';
-import { useViewport } from '../ViewportProvider';
-import { useThemeTokens } from '../ThemeProvider';
-import { a11yProps, pressProps, variantProp, getTokensPropType } from '../utils/propTypes';
-import { useMultipleInputValues } from '../utils/input';
-
-const selectContainerStyles = ({
-  direction
-}) => ({
-  flexDirection: direction
-});
+"use strict";
 
-const selectItemTokens = ({
-  gap
-}, index) => ({
-  marginLeft: index && gap
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _ButtonBase = _interopRequireDefault(require("./ButtonBase"));
+
+var _StackView = require("../StackView");
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _input = require("../utils/input");
+
+var _pressability = require("../utils/pressability");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 const ButtonGroup = ({
   variant,
-  buttonVariant = {},
   tokens,
   items = [],
   values,
@@ -30,135 +39,124 @@ const ButtonGroup = ({
   onChange,
   readOnly = false,
   inactive = false,
-  accessibilityRole = maxValues === 1 ? 'radioGroup' // radioGroup is cross-platform; only web aria has generic groups
-  : Platform.select({
+  accessibilityRole = maxValues === 1 ? 'radiogroup' // radiogroup is cross-platform; only web aria has generic groups
+  : _Platform.default.select({
     web: 'group',
     default: 'none'
   }),
   ...rest
 }) => {
-  const viewport = useViewport();
-  const themeTokens = useThemeTokens('ButtonGroup', tokens, variant, {
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('ButtonGroup', tokens, variant, {
     viewport
   });
-  const containerStyles = selectContainerStyles(themeTokens);
+  const stackTokens = (0, _propTypes2.selectTokens)('StackView', themeTokens);
+  const {
+    direction,
+    space
+  } = themeTokens;
+  const getButtonTokens = (0, _ThemeProvider.useThemeTokensCallback)('ButtonGroupItem', tokens, variant);
   const {
     currentValues,
     toggleOneValue
-  } = useMultipleInputValues({
+  } = (0, _input.useMultipleInputValues)({
     initialValues,
     values,
     maxValues,
     onChange,
     readOnly
   });
-  const a11y = a11yProps.select({
+
+  const a11y = _propTypes2.a11yProps.select({
     accessibilityRole,
     ...rest
   });
-  const itemA11yRole = a11y.accessibilityRole === 'radioGroup' ? 'radio' : 'checkbox';
-  return /*#__PURE__*/React.createElement(View, Object.assign({
-    style: containerStyles
-  }, a11y), items.map(({
-    label,
-    id = label,
-    accessibilityLabel
-  }, index) => {
-    const itemTokens = selectItemTokens(themeTokens, index);
-    const isSelected = currentValues.includes(id); // Allow handlers to be passed down for blur, hover, focus, pressIn, etc
-
-    const pressHandlers = Object.fromEntries(Object.entries(pressProps.select(rest)).map(([key, handler]) => ({
-      [key]: args => {
-        // Pass each handler data on this button and current selection
-        handler({
-          id,
-          label,
-          currentValues
-        }, ...args);
-      }
-    })));
-
-    const handlePress = () => {
-      if (pressHandlers.onPress) pressHandlers.onPress();
-      toggleOneValue(id);
-    };
-
-    const itemA11y = {
-      accessibilityState: {
-        checked: isSelected
-      },
-      accessibilityRole: itemA11yRole,
-      accessibilityLabel,
-      ...Platform.select({
-        web: {
-          // accessibilityPosInSet etc exists in React Native Web main branch
-          // but not in a release compatible with Expo etc; just use `aria-*`
-          'aria-setsize': items.length,
-          'aria-posinset': index + 1
+
+  const itemA11yRole = a11y.accessibilityRole === 'radiogroup' ? 'radio' : 'checkbox';
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackView.StackWrap, { ...a11y,
+    space: space,
+    direction: direction,
+    tokens: stackTokens,
+    children: items.map(({
+      label,
+      id = label,
+      accessibilityLabel
+    }, index) => {
+      const isSelected = currentValues.includes(id); // Pass an object of relevant component state as first argument for any passed-in press handlers
+
+      const pressHandlers = (0, _pressability.getPressHandlersWithArgs)(rest, [{
+        id,
+        label,
+        currentValues
+      }]);
+
+      const handlePress = () => {
+        if (pressHandlers.onPress) pressHandlers.onPress();
+        toggleOneValue(id);
+      };
+
+      const itemA11y = {
+        accessibilityState: {
+          checked: isSelected
         },
-        default: {}
-      })
-    }; // Ensure button is direct child of group as MacOS voiceover only applies "X of Y" to
-    // "radio" if it's a direct child of "radiogroup", even if aria-posinset etc exists
-    // See also: TODO: make margin the responsibility of a parent
-    // https://github.com/telus/universal-design-system/issues/525
-
-    return /*#__PURE__*/React.createElement(ButtonBase, Object.assign({
-      key: id
-    }, pressHandlers, {
-      onPress: handlePress,
-      variant: {
-        component: 'ButtonGroup',
-        ...buttonVariant
-      },
-      tokens: itemTokens,
-      selected: isSelected,
-      inactive: inactive
-    }, itemA11y), label);
-  }));
+        accessibilityRole: itemA11yRole,
+        accessibilityLabel,
+        ..._propTypes2.a11yProps.getPositionInSet(items.length, index)
+      }; // Ensure button is direct child of group as MacOS voiceover only applies "X of Y" to
+      // "radio" if it's a direct child of "radiogroup", even if aria-posinset etc exists
+
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, { ...pressHandlers,
+        onPress: handlePress,
+        tokens: getButtonTokens,
+        selected: isSelected,
+        inactive: inactive,
+        ...itemA11y,
+        children: label
+      }, id);
+    })
+  });
 };
 
-ButtonGroup.propTypes = { ...a11yProps.propTypes,
-  ...pressProps.propTypes,
-  tokens: getTokensPropType('ButtonGroup'),
-  variant: variantProp.propType,
-  buttonVariant: variantProp.propType,
+ButtonGroup.propTypes = { ..._propTypes2.a11yProps.propTypes,
+  ..._propTypes2.pressProps.propTypes,
+  tokens: (0, _propTypes2.getTokensPropType)('ButtonGroup'),
+  variant: _propTypes2.variantProp.propType,
 
   /**
    * The maximum number of items a user may select at once. Defaults to 1 and behaves
    * like radio buttons. To have no limit and allow any number of selections, pass `null`.
    */
-  maxValues: PropTypes.number,
+  maxValues: _propTypes.default.number,
 
   /**
    * The options a user may select
    */
-  items: PropTypes.arrayOf(PropTypes.shape({
+  items: _propTypes.default.arrayOf(_propTypes.default.shape({
     /**
      * The text displayed to the user in the button, describing this option,
      * passed to the button as its child.
      */
-    label: PropTypes.string.isRequired,
+    label: _propTypes.default.string.isRequired,
 
     /**
      * An optional accessibility label may be passed to ButtonGroup Buttons
      * which is applied as normal for a React Native accessibilityLabel prop.
      */
-    accessibilityLabel: PropTypes.string,
+    accessibilityLabel: _propTypes.default.string,
 
     /**
      * An optional unique string may be provided to identify this option,
      * which will be used in code and passed to any onChange function.
      * If not provided, the label is used.
      */
-    id: PropTypes.string
+    id: _propTypes.default.string
   })),
 
   /**
    * If provided, this function is called when the current selection is changed
    * and is passed an array of the `id`s of all currently selected `items`.
    */
-  onChange: PropTypes.func,
+  onChange: _propTypes.default.func,
 
   /**
    * If the selected item(s) in the button group are to be controlled externally by
@@ -166,13 +164,14 @@ ButtonGroup.propTypes = { ...a11yProps.propTypes,
    * Passing an array for "values" makes the ButtonGroup a "controlled" component that
    * expects its state to be handled via `onChange` and so doesn't handle it itself.
    */
-  values: PropTypes.arrayOf(PropTypes.string),
+  values: _propTypes.default.arrayOf(_propTypes.default.string),
 
   /**
    * If `values` is not passed, making the ButtonGroup an "uncontrolled" component
    * managing its own selected state, a default set of selections may be provided.
    * Changing the `initialValues` does not change the user's selections.
    */
-  initialValues: PropTypes.arrayOf(PropTypes.string)
+  initialValues: _propTypes.default.arrayOf(_propTypes.default.string)
 };
-export default ButtonGroup;
+var _default = ButtonGroup;
+exports.default = _default;

package/lib/Button/ButtonLink.js

@@ -1,28 +1,56 @@
-import React from 'react';
-import ButtonBase from './ButtonBase';
-import buttonPropTypes from './propTypes';
-import { a11yProps, hrefAttrsProp, linkProps } from '../utils/propTypes';
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _ButtonBase = _interopRequireDefault(require("./ButtonBase"));
+
+var _propTypes = _interopRequireWildcard(require("./propTypes"));
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+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 }; }
+
 /**
  * `ButtonLink` is a component with the semantics and behaviour of a link, but with the visual appearance of a button.
  * ButtonLink is a block-level component and should not be used inline.
  */
-
 const ButtonLink = ({
   accessibilityRole = 'link',
+  tokens,
+  variant,
   ...props
 }) => {
   const {
     hrefAttrs,
     rest
-  } = hrefAttrsProp.bundle(props);
-  return /*#__PURE__*/React.createElement(ButtonBase, Object.assign({
+  } = _propTypes2.hrefAttrsProp.bundle(props);
+
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('Button', tokens, variant);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, {
     accessibilityRole: accessibilityRole,
-    hrefAttrs: hrefAttrs
-  }, rest));
+    tokens: getTokens,
+    hrefAttrs: hrefAttrs,
+    ...rest
+  });
 };
 
-ButtonLink.propTypes = { ...a11yProps.types,
-  ...buttonPropTypes,
-  ...linkProps.types
+ButtonLink.propTypes = { ..._propTypes2.a11yProps.types,
+  ..._propTypes.default,
+  ..._propTypes2.linkProps.types,
+  children: _propTypes.textAndA11yText
 };
-export default ButtonLink;
+var _default = ButtonLink;
+exports.default = _default;

package/lib/Button/index.js

@@ -1,4 +1,31 @@
-import Button from './Button';
-import ButtonLink from './ButtonLink';
-import ButtonGroup from './ButtonGroup';
-export { Button, ButtonGroup, ButtonLink };
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Button", {
+  enumerable: true,
+  get: function () {
+    return _Button.default;
+  }
+});
+Object.defineProperty(exports, "ButtonLink", {
+  enumerable: true,
+  get: function () {
+    return _ButtonLink.default;
+  }
+});
+Object.defineProperty(exports, "ButtonGroup", {
+  enumerable: true,
+  get: function () {
+    return _ButtonGroup.default;
+  }
+});
+
+var _Button = _interopRequireDefault(require("./Button"));
+
+var _ButtonLink = _interopRequireDefault(require("./ButtonLink"));
+
+var _ButtonGroup = _interopRequireDefault(require("./ButtonGroup"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/lib/Button/propTypes.js

@@ -1,27 +1,50 @@
-import PropTypes from 'prop-types';
-import { variantProp } from '../utils/propTypes';
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.textAndA11yText = void 0;
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _airbnbPropTypes = _interopRequireDefault(require("airbnb-prop-types"));
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _A11yText = _interopRequireDefault(require("../A11yText"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const textAndA11yText = _airbnbPropTypes.default.childrenOf(_propTypes.default.oneOfType([_airbnbPropTypes.default.elementType(_A11yText.default), _propTypes.default.string]));
+
+exports.textAndA11yText = textAndA11yText;
 const buttonPropTypes = {
   /**
    * If true, prevents the button from being pressed, changes the cursor (on web) and accessibility
    * attributes to communicate this to the user, and applies `inactive: true` appearances from the theme
    */
-  inactive: PropTypes.bool,
+  inactive: _propTypes.default.bool,
 
   /**
    * Alias for `inactive`
    */
-  disabled: PropTypes.bool,
+  disabled: _propTypes.default.bool,
 
   /**
-   * Button's children must be either a text string, or a render function which is passed an object of
+   * Button's children must be either:
+   *  - One or more text strings and / or A11yText components
+   *  - A render function with contents that responds to current button state by being passed an object of:
+   * ```
    * { hovered<bool>, focused<bool>, pressed<bool>, inactive<bool>, selected<bool>, textStyles<RNStyle> }
+   * ```
    */
-  children: PropTypes.oneOfType([PropTypes.string, PropTypes.func]).isRequired,
+  children: _propTypes.default.oneOfType([_propTypes.default.func, textAndA11yText]).isRequired,
 
   /**
    * Function called when the button is pressed. Required unless the button has a href.
    */
-  onPress: PropTypes.func,
-  variant: variantProp.propType
+  onPress: _propTypes.default.func,
+  variant: _propTypes2.variantProp.propType
 };
-export default buttonPropTypes;
+var _default = buttonPropTypes;
+exports.default = _default;

package/lib/Card/Card.js

@@ -1,32 +1,28 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import { View } from 'react-native';
-import { applyShadowToken, useThemeTokens } from '../ThemeProvider';
-import { getTokensPropType, variantProp } from '../utils';
-import { useViewport } from '../ViewportProvider';
-import { a11yProps } from '../utils/propTypes'; // Ensure explicit selection of tokens
+"use strict";
 
-const selectStyles = ({
-  backgroundColor,
-  borderColor,
-  borderRadius,
-  borderWidth,
-  paddingBottom,
-  paddingLeft,
-  paddingRight,
-  paddingTop,
-  shadow
-}) => ({
-  backgroundColor,
-  borderColor,
-  borderRadius,
-  borderWidth,
-  paddingBottom,
-  paddingLeft,
-  paddingRight,
-  paddingTop,
-  ...applyShadowToken(shadow)
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _CardBase = _interopRequireDefault(require("./CardBase"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
 /**
  * A basic card component, unstyled by default.
  *
@@ -75,29 +71,28 @@ const selectStyles = ({
  * you automatically make inaccessible its children, which may or may not be appropriate
  * depending on what you are trying to achieve.
  */
-
-
 const Card = ({
   children,
   tokens,
   variant,
   ...rest
 }) => {
-  const viewport = useViewport();
-  const themeTokens = useThemeTokens('Card', tokens, variant, {
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Card', tokens, variant, {
     viewport
   });
-  const cardStyle = selectStyles(themeTokens);
-  const a11y = a11yProps.select(rest);
-  return /*#__PURE__*/React.createElement(View, Object.assign({
-    style: cardStyle
-  }, a11y), children);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_CardBase.default, {
+    tokens: themeTokens,
+    ...rest,
+    children: children
+  });
 };
 
 Card.propTypes = {
-  children: PropTypes.node,
-  tokens: getTokensPropType('Card'),
-  variant: variantProp.propType,
-  ...a11yProps.types
+  children: _propTypes.default.node,
+  tokens: (0, _utils.getTokensPropType)('Card'),
+  variant: _utils.variantProp.propType,
+  ..._propTypes2.a11yProps.types
 };
-export default Card;
+var _default = Card;
+exports.default = _default;

package/lib/Card/CardBase.js

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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 _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _propTypes2 = require("../utils/propTypes");
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Ensure explicit selection of tokens
+const selectStyles = ({
+  flex,
+  backgroundColor,
+  borderColor,
+  borderRadius,
+  borderWidth,
+  paddingBottom,
+  paddingLeft,
+  paddingRight,
+  paddingTop,
+  minWidth,
+  shadow
+}) => ({
+  flex,
+  backgroundColor,
+  borderColor,
+  borderRadius,
+  borderWidth,
+  paddingBottom,
+  paddingLeft,
+  paddingRight,
+  paddingTop,
+  minWidth,
+  ...(0, _ThemeProvider.applyShadowToken)(shadow)
+});
+/**
+ * A themeless base component for Card which components can apply theme tokens to. Not
+ * intended to be used in apps or sites directly: build themed components on top of this.
+ */
+
+
+const CardBase = ({
+  children,
+  tokens,
+  ...rest
+}) => {
+  const cardStyle = selectStyles(typeof tokens === 'function' ? tokens() : tokens);
+  const props = { ..._propTypes2.a11yProps.select(rest),
+    ..._propTypes2.viewProps.select(rest)
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: cardStyle,
+    ...props,
+    children: children
+  });
+};
+
+CardBase.propTypes = {
+  children: _propTypes.default.node,
+  tokens: (0, _utils.getTokensPropType)('Card'),
+  ..._propTypes2.a11yProps.types
+};
+var _default = CardBase;
+exports.default = _default;