@telus-uds/components-base 0.0.2-prerelease.1 → 0.0.2-prerelease.10

package/lib/Button/ButtonLink.js

@@ -1,30 +1,56 @@
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+"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 }; }
 
-import React from 'react';
-import ButtonBase from './ButtonBase';
-import buttonPropTypes from './propTypes';
-import { a11yProps, hrefAttrsProp, linkProps } from '../utils/propTypes';
 /**
  * `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, _extends({
+  } = _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

@@ -0,0 +1,98 @@
+"use strict";
+
+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.
+ *
+ * ## Component API
+ *
+ * ### Background
+ *
+ * In order to control the background of a card, the following tokens are currently
+ * supported:
+ *
+ * - `backgroundColor`
+ *
+ * ### Border
+ *
+ * The following border tokens can be used:
+ *
+ * - `borderColor`
+ * - `borderRadius`
+ * - `borderWidth`
+ *
+ * ### Padding
+ *
+ * Please use the following tokens to control the padding:
+ *
+ * - `paddingBottom`
+ * - `paddingLeft`
+ * - `paddingRight`
+ * - `paddingTop`
+ *
+ * Note that various viewport sizes are supported as well.
+ *
+ * ### Shadow
+ *
+ * Feel free to use the following properties within the `shadow` token:
+ *
+ * - `inset`: boolean
+ * - `color`: string
+ * - `offsetX`: number
+ * - `offsetY`: number
+ * - `blur`: number
+ * - `spread`: number
+ *
+ * ## Accessibility
+ *
+ * Card supports all the common a11y props. Please remember that by marking a card as `accessible`
+ * 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 = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Card', tokens, variant, {
+    viewport
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_CardBase.default, {
+    tokens: themeTokens,
+    ...rest,
+    children: children
+  });
+};
+
+Card.propTypes = {
+  children: _propTypes.default.node,
+  tokens: (0, _utils.getTokensPropType)('Card'),
+  variant: _utils.variantProp.propType,
+  ..._propTypes2.a11yProps.types
+};
+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;

package/lib/Card/PressableCardBase.js

@@ -0,0 +1,137 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.selectPressableCardTokens = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _ViewportProvider = require("../ViewportProvider");
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+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 }; }
+
+const tokenKeys = [...(0, _utils.getTokenNames)('Card'), // Outer border tokens. TODO: centralise common token sets like these as part of
+// https://github.com/telus/universal-design-system/issues/782
+'outerBorderColor', 'outerBorderWidth', 'outerBorderGap'];
+
+const selectPressableCardTokens = tokens => Object.fromEntries(tokenKeys.map(key => [key, tokens[key]]));
+/**
+ * A pressable themeless base component that handles pressable states and passes tokens
+ * based on these to an outer border and a base Card component. Not intended to be used in
+ * apps or sites directly: build themed components on top of this.
+ */
+
+
+exports.selectPressableCardTokens = selectPressableCardTokens;
+
+const PressableCardBase = ({
+  children,
+  tokens,
+  checked,
+  validation,
+  inactive,
+  href,
+  hrefAttrs,
+  onPress,
+  accessibilityRole = href ? 'link' : undefined,
+  ...rest
+}) => {
+  const viewport = (0, _ViewportProvider.useViewport)();
+
+  const a11y = _propTypes2.a11yProps.select({ ...rest,
+    accessibilityRole
+  });
+
+  const additionalState = {
+    checked,
+    validation,
+    inactive,
+    viewport
+  };
+
+  const getCardState = pressableState => (0, _utils.resolvePressableState)(pressableState, additionalState);
+
+  const getTokens = pressableState => (0, _ThemeProvider.validateThemeTokens)((0, _utils.resolvePressableTokens)(tokens, pressableState, additionalState), (0, _utils.getTokensSetPropType)(tokenKeys, {
+    requireAll: true
+  }), 'PressableCard');
+
+  const getCardTokens = pressableState => (0, _utils.selectTokens)('Card', getTokens(pressableState));
+
+  const getOuterBorderStyle = pressableState => {
+    const {
+      flex,
+      minWidth,
+      outerBorderColor,
+      outerBorderGap = 0,
+      outerBorderWidth = 0,
+      borderRadius
+    } = getTokens(pressableState);
+    return {
+      flex,
+      minWidth: minWidth + outerBorderGap + outerBorderWidth,
+      ...(0, _ThemeProvider.applyOuterBorder)({
+        outerBorderColor,
+        outerBorderGap,
+        outerBorderWidth,
+        borderRadius
+      }),
+      ..._Platform.default.select({
+        web: {
+          outline: 'none'
+        }
+      })
+    };
+  };
+
+  const handleChange = _utils.linkProps.handleHref({
+    href,
+    onPress
+  });
+
+  const handleKeyDown = event => {
+    // The expected keyboard shortcut for selecting a focused item is the Space key
+    if ((event === null || event === void 0 ? void 0 : event.key) === ' ') handleChange(event);
+  };
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    href: href,
+    onPress: handleChange,
+    onKeyDown: handleKeyDown,
+    hrefAttrs: hrefAttrs,
+    style: getOuterBorderStyle,
+    ...a11y,
+    children: pressableState => /*#__PURE__*/(0, _jsxRuntime.jsx)(_CardBase.default, {
+      tokens: getCardTokens(pressableState),
+      children: typeof children === 'function' ? children(getCardState(pressableState)) : children
+    })
+  });
+};
+
+PressableCardBase.propTypes = {
+  children: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.node]),
+  tokens: (0, _utils.getTokensSetPropType)(tokenKeys, {
+    requireAll: true,
+    allowFunction: true
+  }),
+  variant: _utils.variantProp.propType,
+  ..._propTypes2.a11yProps.types
+};
+var _default = PressableCardBase;
+exports.default = _default;

package/lib/Card/index.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  PressableCardBase: true
+};
+Object.defineProperty(exports, "PressableCardBase", {
+  enumerable: true,
+  get: function () {
+    return _PressableCardBase.default;
+  }
+});
+exports.default = void 0;
+
+var _Card = _interopRequireDefault(require("./Card"));
+
+var _PressableCardBase = _interopRequireWildcard(require("./PressableCardBase"));
+
+Object.keys(_PressableCardBase).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _PressableCardBase[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _PressableCardBase[key];
+    }
+  });
+});
+
+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 }; }
+
+var _default = _Card.default;
+exports.default = _default;