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

package/lib/Feedback/Feedback.js

@@ -1,23 +1,43 @@
-import React from 'react';
-import { StyleSheet, Text, View } from 'react-native';
-import PropTypes from 'prop-types';
-import { applyTextStyles, useThemeTokens } from '../ThemeProvider';
-import { a11yProps, getTokensPropType, selectTokens, variantProp } from '../utils';
-import StackView from '../StackView';
+"use strict";
 
-const selectStyles = tokens => selectTokens('Feedback', tokens);
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _Text = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Text"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _StackView = _interopRequireDefault(require("../StackView"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const selectStyles = tokens => (0, _utils.selectTokens)('Feedback', tokens);
 
 const selectTitleTextStyles = ({
   titleFontSize,
   ...tokens
-}) => applyTextStyles(selectTokens('Typography', { ...tokens,
+}) => (0, _ThemeProvider.applyTextStyles)((0, _utils.selectTokens)('Typography', { ...tokens,
   fontSize: titleFontSize
 }));
 
 const selectContentTextStyles = ({
   contentFontSize,
   ...tokens
-}) => applyTextStyles(selectTokens('Typography', { ...tokens,
+}) => (0, _ThemeProvider.applyTextStyles)((0, _utils.selectTokens)('Typography', { ...tokens,
   fontSize: contentFontSize
 }));
 
@@ -63,7 +83,7 @@ const Feedback = ({
   variant,
   ...rest
 }) => {
-  const themeTokens = useThemeTokens('Feedback', tokens, { ...variant,
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Feedback', tokens, { ...variant,
     validation
   });
   const {
@@ -74,56 +94,65 @@ const Feedback = ({
   } = themeTokens;
   const titleTextStyles = selectTitleTextStyles(themeTokens);
   const contentTextStyles = selectContentTextStyles(themeTokens);
-  const content = typeof children === 'string' ? /*#__PURE__*/React.createElement(Text, {
-    style: contentTextStyles
-  }, children) : children;
-  const accessibilityProps = a11yProps.select({
+  const content = typeof children === 'string' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+    style: contentTextStyles,
+    children: children
+  }) : children;
+
+  const accessibilityProps = _utils.a11yProps.select({
     accessibilityRole: validation === 'error' ? 'alert' : undefined,
     ...rest
   });
-  return /*#__PURE__*/React.createElement(View, Object.assign({
-    style: selectStyles(themeTokens)
-  }, accessibilityProps, {
-    nativeID: id
-  }), /*#__PURE__*/React.createElement(StackView, {
-    space: space
-  }, title !== undefined && /*#__PURE__*/React.createElement(View, {
-    style: staticStyles.title
-  }, IconComponent && /*#__PURE__*/React.createElement(View, {
-    style: selectIconContainerStyles(themeTokens)
-  }, /*#__PURE__*/React.createElement(IconComponent, {
-    tokens: selectIconTokens(themeTokens)
-  })), /*#__PURE__*/React.createElement(Text, {
-    style: titleTextStyles
-  }, title)), content && typeof content === 'function' ? content({
-    textStyles: contentTextStyles,
-    variant
-  }) : content));
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+    style: selectStyles(themeTokens),
+    ...accessibilityProps,
+    nativeID: id,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.default, {
+      space: space,
+      children: [title !== undefined && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+        style: staticStyles.title,
+        children: [IconComponent && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: selectIconContainerStyles(themeTokens),
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, { ...selectIconTokens(themeTokens)
+          })
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+          style: titleTextStyles,
+          children: title
+        })]
+      }), content && typeof content === 'function' ? content({
+        textStyles: contentTextStyles,
+        variant
+      }) : content]
+    })
+  });
 };
 
 Feedback.propTypes = {
   /**
    * Emphasized summary of the feedback. If an icon is set, it is rendered next to the title.
    */
-  title: PropTypes.string,
+  title: _propTypes.default.string,
 
   /**
    * Feedback content rendered below the title. A render function `({textStyles, variant}) => {}` is supported.
    */
-  children: PropTypes.oneOfType([PropTypes.string, PropTypes.node, PropTypes.func]),
+  children: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.node, _propTypes.default.func]),
 
   /**
    * Use to visually mark the Feedback as valid or invalid.
    */
-  validation: PropTypes.oneOf(['error', 'success']),
+  validation: _propTypes.default.oneOf(['error', 'success']),
 
   /** @ignore */
-  id: PropTypes.string,
-  tokens: getTokensPropType('Feedback'),
-  variant: variantProp.propType
+  id: _propTypes.default.string,
+  tokens: (0, _utils.getTokensPropType)('Feedback'),
+  variant: _utils.variantProp.propType
 };
-export default Feedback;
-const staticStyles = StyleSheet.create({
+var _default = Feedback;
+exports.default = _default;
+
+const staticStyles = _StyleSheet.default.create({
   title: {
     display: 'flex',
     flexDirection: 'row',

package/lib/Feedback/index.js

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

package/lib/Fieldset/Fieldset.js

@@ -0,0 +1,160 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _Feedback = _interopRequireDefault(require("../Feedback"));
+
+var _utils = require("../utils");
+
+var _FieldsetContainer = _interopRequireDefault(require("./FieldsetContainer"));
+
+var _StackView = require("../StackView");
+
+var _InputLabel = _interopRequireDefault(require("../InputLabel"));
+
+var _useInputSupports = _interopRequireDefault(require("../InputSupports/useInputSupports"));
+
+var _Legend = _interopRequireDefault(require("./Legend"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * An alternative to InputSupports for groups of input elements that, on web, are to be
+ * wrapped in a `<fieldset>` tag, with label content displated in a `<legend>` tag.
+ *
+ * Follows the same theming and most of the same props as InputSupports.
+ */
+const Fieldset = ({
+  space,
+  feedback,
+  feedbackPosition = 'top',
+  validation,
+  legend,
+  hint,
+  hintPosition,
+  tooltip,
+  inactive,
+  accessibilityRole,
+  name: fieldsetName,
+  children
+}) => {
+  // Skips `inputId` because a fieldset' legend describes multiple inputs
+  const {
+    hintId,
+    feedbackId,
+    a11yProps
+  } = (0, _useInputSupports.default)({
+    feedback,
+    hint,
+    label: legend,
+    validation
+  });
+  const legendContent = legend && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Legend.default, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_InputLabel.default, {
+      label: legend,
+      hint: hint,
+      hintPosition: hintPosition,
+      hintId: hintId,
+      tooltip: tooltip
+    })
+  });
+  const feedbackContent = feedback && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Feedback.default, {
+    id: feedbackId,
+    title: feedback,
+    validation: validation
+  }); // Some accessibility patterns depend on elements being direct children, e.g. fieldset -> legend,
+  // and on MacOS voiceover, radiogroup -> radio. To allow elements to be direct children of the
+  // fieldset as much as possible, but also allow different spacing within content and between
+  // fieldset / feedback / etc, wrap resolved children in a fragment, and stack with `preserveFragments`.
+
+  const childContent = /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: typeof children === 'function' ? children({
+      a11yProps
+    }) : children
+  });
+  const orderedContent = feedbackPosition === 'bottom' ? [legendContent, feedbackContent, childContent] : [legendContent, childContent, feedbackContent];
+  const stackedContent = (0, _StackView.getStackedContent)(orderedContent, {
+    space,
+    preserveFragments: true
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FieldsetContainer.default, {
+    inactive: inactive,
+    accessibilityRole: accessibilityRole,
+    name: fieldsetName,
+    children: stackedContent
+  });
+};
+
+Fieldset.propTypes = {
+  children: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.node]),
+
+  /**
+   * The accessibility role of the `<fieldset>` element itself. Other React Native accessibility
+   * props are not supported because there is not an appropriate counterpart for Fieldsets.
+   */
+  accessibilityRole: _propTypes.default.string,
+
+  /**
+   * The amout of space between legend, feedback and content; according  to the theme's spacing scale.
+   * Either a number corresponding to a position on the theme's spacing scale (1 is smallest, 2 is second smallest, etc),
+   * or, a SpacingObject with viewport keys and options (see `useSpacingScale` for details).
+   */
+  space: _utils.spacingProps.types.spacingValue,
+
+  /**
+   * The text for the fieldset's legend, describing the fieldset content.
+   */
+  legend: _propTypes.default.string,
+
+  /**
+   * A short description of the expected input.
+   */
+  hint: _propTypes.default.string,
+
+  /**
+   * Position of the hint relative to label.
+   */
+  hintPosition: _propTypes.default.oneOf(['inline', 'below']),
+
+  /**
+   * A detailed description of validation error/success or additional instructions.
+   * Visual variant is determined based on the `validation` prop.
+   */
+  feedback: _propTypes.default.string,
+
+  /**
+   * Position of the feedback block relative to the fieldset's content.
+   */
+  feedbackPosition: _propTypes.default.oneOf(['above', 'below']),
+
+  /**
+   * If true, the fieldset is treated as inactive (setting `disabled` attribute on web).
+   */
+  inactive: _propTypes.default.bool,
+
+  /**
+   * Content of an optional `Tooltip`. If set, a tooltip button will be shown next to the label.
+   */
+  tooltip: _propTypes.default.string,
+
+  /**
+   * On web, this is passed to the `<fieldset>`'s `name` attribute.
+   */
+  name: _propTypes.default.string,
+
+  /**
+   * Use to visually mark an input as valid or invalid.
+   */
+  validation: _propTypes.default.oneOf(['error', 'success'])
+};
+var _default = Fieldset;
+exports.default = _default;

package/lib/Fieldset/FieldsetContainer.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _cssReset = _interopRequireDefault(require("./cssReset"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * On Web, wraps children with a HTML `<fieldset>` and sets its attributes as necessary.
+ */
+const FieldsetContainer = ({
+  children,
+  inactive,
+  accessibilityRole,
+  name: fieldsetName
+}) => /*#__PURE__*/(0, _jsxRuntime.jsx)("fieldset", {
+  disabled: inactive,
+  style: _cssReset.default,
+  role: accessibilityRole,
+  name: fieldsetName,
+  children: children
+});
+
+FieldsetContainer.propTypes = {
+  accessibilityRole: _propTypes.default.string,
+  children: _propTypes.default.node,
+  inactive: _propTypes.default.bool,
+  name: _propTypes.default.string
+};
+var _default = FieldsetContainer;
+exports.default = _default;

package/lib/Fieldset/FieldsetContainer.native.js

@@ -0,0 +1,33 @@
+"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 _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// No equivalent of `<fieldset>` on native, so just apply accessibility role to container.
+// If a11y testing finds any additional handling is needed at the container level, add it here.
+const FieldsetContainer = ({
+  children,
+  accessibilityRole
+}) => /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+  accessibilityRole: accessibilityRole,
+  children: children
+});
+
+FieldsetContainer.propTypes = {
+  children: _propTypes.default.node,
+  accessibilityRole: _propTypes.default.string
+};
+var _default = FieldsetContainer;
+exports.default = _default;

package/lib/Fieldset/Legend.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _cssReset = _interopRequireDefault(require("./cssReset"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * On Web, wraps children in HTML `<legend>` tag.
+ * On Native, `<legend>` does not exist, wraps in a width 100% block to follow <legend>'s behaviour in a flex.
+ */
+const Legend = ({
+  children
+}) => /*#__PURE__*/(0, _jsxRuntime.jsx)("legend", {
+  style: _cssReset.default,
+  children: children
+});
+
+Legend.propTypes = {
+  children: _propTypes.default.node
+};
+var _default = Legend;
+exports.default = _default;

package/lib/Fieldset/Legend.native.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * On Web, wraps children in HTML `<legend>` tag.
+ * On Native, `<legend>` does not exist, wraps in a width 100% block to follow <legend>'s behaviour in a flex.
+ */
+const Legend = ({
+  children
+}) => /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+  style: staticStyles.stretch,
+  children: children
+});
+
+Legend.propTypes = {
+  children: _propTypes.default.node
+};
+
+const staticStyles = _StyleSheet.default.create({
+  stretch: {
+    width: '100%',
+    flexGrow: 1
+  }
+});
+
+var _default = Legend;
+exports.default = _default;

package/lib/Fieldset/cssReset.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+// React Native Web has no built-in `fieldset` or `legend` support.
+// This reset makes them consistent with other RNW views.
+// Can't use RN stylesheets because it's not an RN element (RNW's createElement tooling is unstable).
+// Using CSS `all` doesn't work well as an inline style.
+// https://github.com/necolas/react-native-web/issues/1385
+var _default = {
+  margin: 'unset',
+  padding: 'unset',
+  float: 'unset',
+  border: 'unset',
+  width: 'unset',
+  display: 'flex',
+  flexDirection: 'column'
+};
+exports.default = _default;

package/lib/Fieldset/index.js

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