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

package/lib/Tabs/Tabs.js

@@ -0,0 +1,118 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ThemeProvider = require("../ThemeProvider");
+
+var _StackView = _interopRequireDefault(require("../StackView"));
+
+var _utils = require("../utils");
+
+var _HorizontalScroll = _interopRequireWildcard(require("../HorizontalScroll"));
+
+var _TabsItem = _interopRequireDefault(require("./TabsItem"));
+
+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 {
+  selectHorizontalScrollTokens,
+  useItemPositions
+} = _HorizontalScroll.horizontalScrollUtils;
+/**
+ * Tabs renders a horizontally-scrolling menu of selectable buttons which may link
+ * to a page or control what content is displayed on this page.
+ */
+
+const Tabs = ({
+  tokens,
+  itemTokens,
+  scrollButtonTokens,
+  variant,
+  value,
+  initialValue,
+  onChange,
+  items = []
+}) => {
+  const {
+    space,
+    ...themeTokens
+  } = (0, _ThemeProvider.useThemeTokens)('Tabs', tokens, variant);
+  const {
+    currentValue,
+    setValue
+  } = (0, _utils.useInputValue)({
+    value,
+    initialValue,
+    onChange
+  });
+  const [itemPositions, isPositioningReady] = useItemPositions();
+  (0, _utils.useHash)((0, _react.useCallback)((hash, event) => {
+    const hashItem = hash && items.find(({
+      href
+    }) => hash === href);
+    const hashId = hashItem && (hashItem.id || hashItem.label);
+    if (hashId) setTimeout(setValue(hashId, event), 500);
+  }, [items, setValue]), isPositioningReady);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_HorizontalScroll.default, {
+    ScrollButton: _HorizontalScroll.HorizontalScrollButton,
+    itemPositions: itemPositions,
+    tokens: selectHorizontalScrollTokens(themeTokens),
+    scrollButtonTokens: scrollButtonTokens,
+    accessibilityRole: "tablist",
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackView.default, {
+      space: space,
+      direction: "row",
+      children: items.map(({
+        href,
+        label,
+        id
+      }, index) => {
+        const itemId = id !== null && id !== void 0 ? id : label;
+        const isSelected = Boolean(currentValue && currentValue === itemId);
+
+        const handlePress = event => setValue(itemId, event);
+
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_TabsItem.default, {
+          href: href,
+          variant: variant,
+          tokens: itemTokens,
+          onPress: handlePress,
+          selected: isSelected,
+          itemPositions: itemPositions,
+          index: index,
+          children: label
+        }, itemId);
+      })
+    })
+  });
+};
+
+Tabs.propTypes = {
+  items: _propTypes.default.arrayOf(_propTypes.default.shape({
+    href: _propTypes.default.string,
+    label: _propTypes.default.string,
+    id: _propTypes.default.string
+  })),
+  value: _propTypes.default.string,
+  initialValue: _propTypes.default.string,
+  onChange: _propTypes.default.func,
+  tokens: (0, _utils.getTokensPropType)('Tabs'),
+  itemTokens: (0, _utils.getTokensPropType)('TabsItem'),
+  scrollButtonTokens: (0, _utils.getTokensPropType)('HorizontalScrollButton'),
+  variant: _utils.variantProp.propType
+};
+var _default = Tabs;
+exports.default = _default;

package/lib/Tabs/TabsItem.js

@@ -0,0 +1,237 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+
+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 _ThemeProvider = require("../ThemeProvider");
+
+var _utils = require("../utils");
+
+var _Spacer = _interopRequireDefault(require("../Spacer"));
+
+var _HorizontalScroll = require("../HorizontalScroll");
+
+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 {
+  itemPositionsPropType,
+  getItemPositionLayoutHandler
+} = _HorizontalScroll.horizontalScrollUtils;
+
+const selectHighlightBarStyles = ({
+  highlightColor,
+  highlightBarBorderRadius = 0,
+  highlightBarBorderWidth = 0,
+  highlightBarHeight = 0
+}) => ({
+  backgroundColor: highlightColor,
+  borderColor: highlightColor,
+  height: highlightBarHeight + highlightBarBorderWidth * 2,
+  borderRadius: highlightBarBorderRadius,
+  borderWidth: highlightBarBorderWidth,
+  bottom: -1 * (highlightBarHeight + highlightBarBorderWidth),
+  left: -1 * highlightBarBorderWidth,
+  right: -1 * highlightBarBorderWidth,
+  zIndex: 1 + highlightBarBorderWidth
+});
+
+const selectHighlightTriangleStyles = ({
+  highlightColor,
+  highlightTriangleSize
+}) => ({
+  container: {
+    bottom: 0 - highlightTriangleSize * 2
+  },
+  triangle: {
+    height: 0,
+    width: 0,
+    borderWidth: highlightTriangleSize,
+    borderTopColor: highlightColor,
+    borderBottomColor: 'transparent',
+    borderLeftColor: 'transparent',
+    borderRightColor: 'transparent'
+  }
+});
+
+const selectContainerStyles = ({
+  backgroundColor,
+  borderColor,
+  borderWidth = 0,
+  borderRadius,
+  paddingHorizontal = 0,
+  paddingVertical = 0
+}) => ({
+  backgroundColor,
+  borderColor,
+  borderWidth,
+  borderRadius,
+  paddingHorizontal: paddingHorizontal - borderWidth,
+  paddingVertical: paddingVertical - borderWidth
+});
+/**
+ * Item within a Tabs component representing one tab of content. May be rendered as a link
+ * or as a "menuitem" button depending on whether 'href' is passed.
+ *
+ * This is rendered automatically by `Tabs` and isn't intended be used directly.
+ */
+
+
+const TabsItem = ({
+  onPress,
+  href,
+  variant,
+  tokens,
+  selected,
+  itemPositions,
+  index,
+  children,
+  accessibilityRole = href ? 'link' : 'tab',
+  accessibilityState = _Platform.default.OS === 'web' && accessibilityRole === 'link' ? // Web links can't be aria-selected but can be aria-current
+  {
+    current: selected ? 'page' : false
+  } : {
+    selected
+  },
+  ...rest
+}) => {
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('TabsItem', tokens, variant);
+
+  const resolveTokens = pressableState => (0, _utils.resolvePressableTokens)(getTokens, pressableState, {
+    selected
+  });
+
+  const getPressableStyle = pressableState => {
+    const {
+      maxWidth
+    } = resolveTokens(pressableState);
+    return [{
+      maxWidth
+    }, _Platform.default.OS === 'web' && {
+      outline: 'none'
+    }];
+  };
+
+  const handleLayout = getItemPositionLayoutHandler(itemPositions.positions, index); // On press, update the selection, call any press handler, and open any href in platform-appropriate way
+
+  const openHref = href && _utils.linkProps.handleHref({
+    href
+  });
+
+  const handlePress = onPress || openHref ? () => {
+    if (onPress) onPress();
+    if (openHref) openHref();
+  } : undefined;
+  const a11y = {
+    accessibilityRole,
+    accessibilityState,
+    ..._utils.a11yProps.select(rest)
+  };
+  (0, _react.useEffect)(() => {
+    // If this is selected while off-screen, scroll it into view
+    if (selected) {
+      const position = itemPositions.positions[index];
+      const scrollEnd = itemPositions.scrollOffset + itemPositions.containerWidth;
+
+      if ( // is off the right edge, or
+      scrollEnd && (position === null || position === void 0 ? void 0 : position.end) > scrollEnd || // is off the left edge
+      typeof (position === null || position === void 0 ? void 0 : position.start) === 'number' && position.start < itemPositions.scrollOffset) {
+        itemPositions.scrollTo(position.start);
+      }
+    } // itemPositions is a ref object so this should only re-run when `selected` (or `index`) change
+
+  }, [selected, index, itemPositions]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    onPress: handlePress,
+    href: href,
+    style: getPressableStyle,
+    onLayout: handleLayout,
+    ...a11y,
+    children: pressableState => {
+      const {
+        space,
+        textAlign,
+        ...themeTokens
+      } = resolveTokens(pressableState);
+      const hasHighlightBar = Boolean(themeTokens.highlightBarHeight);
+      const highlightBarStyle = hasHighlightBar && selectHighlightBarStyles(themeTokens);
+      const hasHighlightTriangle = Boolean(themeTokens.highlightTriangleSize);
+      const highlightTriangleStyle = hasHighlightTriangle && selectHighlightTriangleStyles(themeTokens);
+      const containerStyles = selectContainerStyles(themeTokens);
+      const textStyles = (0, _ThemeProvider.applyTextStyles)({ ...(0, _utils.selectTokens)('Typography', themeTokens),
+        textAlign
+      });
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+        style: staticStyles.container,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: containerStyles,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: textStyles,
+            children: children
+          })
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
+          space: space
+        }), hasHighlightBar && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.absolute, highlightBarStyle]
+        }), hasHighlightTriangle && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          style: [staticStyles.absolute, highlightTriangleStyle.container],
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: highlightTriangleStyle.triangle
+          })
+        })]
+      });
+    }
+  });
+};
+
+TabsItem.propTypes = { ..._utils.a11yProps.propTypes,
+  tokens: (0, _utils.getTokensPropType)('TabsItem'),
+  variant: _utils.variantProp.propType,
+  onPress: _propTypes.default.func,
+  href: _propTypes.default.string,
+  index: _propTypes.default.number,
+  selected: _propTypes.default.bool,
+  itemPositions: itemPositionsPropType,
+  children: _propTypes.default.string
+};
+
+const staticStyles = _StyleSheet.default.create({
+  center: {
+    alignItems: 'center'
+  },
+  absolute: {
+    position: 'absolute',
+    alignItems: 'center',
+    left: 0,
+    right: 0
+  },
+  container: {
+    flexGrow: 1,
+    alignItems: 'center',
+    justifyContent: 'center'
+  }
+});
+
+var _default = TabsItem;
+exports.default = _default;

package/lib/Tabs/index.js

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

package/lib/Tags/Tags.js

@@ -0,0 +1,250 @@
+"use strict";
+
+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 _Text = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Text"));
+
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+
+var _ButtonBase = _interopRequireDefault(require("../Button/ButtonBase"));
+
+var _Icon = _interopRequireDefault(require("../Icon"));
+
+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 selectIconTextTokens = ({
+  icon,
+  iconPosition,
+  iconSpace,
+  iconSize,
+  iconColor,
+  iconBackground,
+  iconBorderRadius,
+  iconAlignSelf,
+  iconPadding,
+  iconTranslateX,
+  iconTranslateY
+}) => ({
+  icon,
+  iconPosition,
+  iconSpace,
+  iconWrapperStyle: {
+    backgroundColor: iconBackground,
+    borderRadius: iconBorderRadius,
+    alignSelf: iconAlignSelf,
+    padding: iconPadding,
+    ..._Platform.default.select({
+      // TODO: https://github.com/telus/universal-design-system/issues/487
+      web: {
+        transition: 'color 200ms, background 200ms'
+      }
+    })
+  },
+  iconTokens: {
+    size: iconSize,
+    color: iconColor,
+    translateX: iconTranslateX,
+    translateY: iconTranslateY
+  }
+});
+
+const Tags = ({
+  variant,
+  tokens,
+  items = [],
+  values,
+  initialValues,
+  maxValues,
+  onChange,
+  readOnly = false,
+  inactive = false,
+  accessibilityRole = _Platform.default.select({
+    web: 'group',
+    default: 'none'
+  }),
+  ...rest
+}) => {
+  const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Tags', tokens, variant, {
+    viewport
+  });
+  const stackTokens = (0, _propTypes2.selectTokens)('StackView', themeTokens);
+  const {
+    direction,
+    space
+  } = themeTokens;
+  const getItemTokens = (0, _ThemeProvider.useThemeTokensCallback)('TagsItem', tokens, variant);
+
+  const getButtonTokens = buttonState => (0, _propTypes2.selectTokens)('Button', getItemTokens(buttonState));
+
+  const {
+    currentValues,
+    toggleOneValue
+  } = (0, _input.useMultipleInputValues)({
+    initialValues,
+    values,
+    maxValues,
+    onChange,
+    readOnly
+  });
+
+  const a11y = _propTypes2.a11yProps.select({
+    accessibilityRole,
+    ...rest
+  });
+
+  const itemA11yRole = '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 = event => {
+        if (pressHandlers.onPress) pressHandlers.onPress();
+        toggleOneValue(id, event);
+      };
+
+      const itemA11y = {
+        accessibilityState: {
+          checked: isSelected
+        },
+        accessibilityRole: itemA11yRole,
+        accessibilityLabel,
+        ..._propTypes2.a11yProps.getPositionInSet(items.length, index)
+      };
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ButtonBase.default, { ...pressHandlers,
+        onPress: handlePress,
+        tokens: getButtonTokens,
+        selected: isSelected,
+        inactive: inactive,
+        ...itemA11y,
+        children: ({
+          textStyles,
+          ...buttonState
+        }) => {
+          // TODO: once Icon/IconButton designs are stable, see if this sort of styling around
+          // an icon should go in Icon itself, or possibly via an IconText token set. Related issues:
+          // - Icon: https://github.com/telus/universal-design-system/issues/327
+          // - IconButton: https://github.com/telus/universal-design-system/issues/281
+          // - Token sets: https://github.com/telus/universal-design-system/issues/782
+          const itemTokens = getItemTokens(buttonState);
+          const {
+            iconTokens,
+            iconPosition,
+            iconSpace,
+            iconWrapperStyle,
+            icon: IconComponent
+          } = selectIconTextTokens(itemTokens);
+          const iconContent = IconComponent ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: iconWrapperStyle,
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.default, {
+              icon: IconComponent,
+              tokens: iconTokens
+            })
+          }) : null;
+          const textContent = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: textStyles,
+            children: label
+          });
+          return (0, _StackView.getStackedContent)(iconPosition === 'left' ? [iconContent, textContent] : [textContent, iconContent], {
+            space: iconSpace,
+            direction: 'row'
+          });
+        }
+      }, id);
+    })
+  });
+};
+
+Tags.propTypes = { ..._propTypes2.a11yProps.propTypes,
+  ..._propTypes2.pressProps.propTypes,
+  tokens: (0, _propTypes2.getTokensPropType)('Tags'),
+  variant: _propTypes2.variantProp.propType,
+
+  /**
+   * If provided, sets a maximum number of items a user may select at once.
+   */
+  maxValues: _propTypes.default.number,
+
+  /**
+   * The options a user may select
+   */
+  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.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.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.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.default.func,
+
+  /**
+   * If the selected item(s) in the button group are to be controlled externally by
+   * a parent component, pass an array of strings as well as an `onChange` handler.
+   * 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.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.default.arrayOf(_propTypes.default.string)
+};
+var _default = Tags;
+exports.default = _default;

package/lib/Tags/index.js

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