@telus-uds/components-base 2.4.0 → 3.0.0

package/lib/cjs/Select/Select.js

@@ -0,0 +1,339 @@
+"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 _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+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 _Picker = _interopRequireDefault(require("./Picker"));
+var _InputSupports = _interopRequireDefault(require("../InputSupports"));
+var _constants = require("./constants");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.inputSupportsProps, _utils.viewProps, _utils.htmlAttrs]);
+const selectInputStyles = (_ref, themeOptions, inactive) => {
+  let {
+    backgroundColor,
+    color,
+    borderWidth = 0,
+    borderColor,
+    borderRadius,
+    paddingTop,
+    paddingBottom,
+    paddingLeft = 0,
+    paddingRight,
+    fontName,
+    fontSize,
+    fontWeight,
+    lineHeight,
+    icon,
+    iconSize = 0,
+    validationIcon,
+    validationIconSize = 0,
+    height
+  } = _ref;
+  // Subtract border width from padding so overall input width/height doesn't
+  // jump around if the border width changes (avoiding NaN and negative padding)
+  const offsetBorder = value => typeof value === 'number' ? Math.max(0, value - borderWidth) : value;
+  const textStyles = (0, _ThemeProvider.applyTextStyles)({
+    fontName,
+    fontSize,
+    lineHeight,
+    fontWeight,
+    themeOptions
+  });
+  const webStyles = _Platform.default.select({
+    web: {
+      appearance: 'none',
+      WebkitAppearance: 'none',
+      // since iOS Safari needs a prefix
+      outline: 'none',
+      cursor: inactive ? 'not-allowed' : undefined,
+      opacity: inactive ? 1 : undefined // override Chrome's default fadeout of a disabled select
+    }
+  });
+  let paddingWithIcons = paddingRight;
+  if (_Platform.default.OS !== 'android') {
+    if (icon) {
+      paddingWithIcons += iconSize;
+    }
+    if (validationIcon) {
+      paddingWithIcons += validationIconSize;
+    }
+  }
+  return {
+    backgroundColor,
+    color,
+    borderWidth,
+    borderColor,
+    borderRadius,
+    paddingLeft: offsetBorder(paddingLeft),
+    paddingRight: offsetBorder(paddingWithIcons),
+    paddingTop: offsetBorder(paddingTop),
+    paddingBottom: offsetBorder(paddingBottom),
+    height,
+    ...textStyles,
+    ...webStyles
+  };
+};
+const selectOuterBorderStyles = _ref2 => {
+  let {
+    outerBackgroundColor,
+    outerBorderWidth,
+    outerBorderColor,
+    borderRadius
+  } = _ref2;
+  return {
+    background: outerBackgroundColor,
+    ...(0, _ThemeProvider.applyOuterBorder)({
+      outerBorderColor,
+      outerBorderWidth,
+      borderRadius
+    })
+  };
+};
+const selectIconTokens = _ref3 => {
+  let {
+    iconSize,
+    iconColor
+  } = _ref3;
+  return {
+    size: iconSize,
+    color: iconColor
+  };
+};
+const selectIconContainerStyles = _ref4 => {
+  let {
+    paddingRight,
+    paddingBottom
+  } = _ref4;
+  return {
+    paddingRight: paddingRight + 4,
+    marginRight: -4,
+    paddingBottom
+  };
+};
+const selectValidationIconTokens = _ref5 => {
+  let {
+    validationIconSize,
+    validationIconColor
+  } = _ref5;
+  return {
+    size: validationIconSize,
+    color: validationIconColor
+  };
+};
+const selectValidationIconContainerStyles = _ref6 => {
+  let {
+    icon,
+    iconSize = 0,
+    paddingRight = 0,
+    paddingBottom
+  } = _ref6;
+  return {
+    paddingRight: icon ? paddingRight + iconSize + 4 : paddingRight,
+    ...(_Platform.default.OS === 'android' ? {
+      paddingBottom: paddingBottom + _constants.ANDROID_VALIDATION_ICON_CONTAINER_OFFSET
+    } : {
+      paddingBottom
+    })
+  };
+};
+const selectCustomFeedbackStyles = _ref7 => {
+  let {
+    feedbackBackgroundColor
+  } = _ref7;
+  return {
+    backgroundColor: feedbackBackgroundColor
+  };
+};
+
+/**
+ * A basic form single-choice select component. Use in forms or individually to receive user's input.
+ *
+ * ## Usage criteria
+ * - Include a `placeholder` to provide instructions such as "Please select..." as an unselectable option (recommended)
+ * - Use when options are between 7-15 (recommended)
+ * - For options are 6 and under, use `Radio` groups or `ButtonGroup`.
+ * - For options 15 and above, look for alternatives (e.g grouping into categories, or input field with auto-complete etc.)
+ *
+ * ## Controlled component
+ * If it is required that the state of the `Select` be controlled by the application or other external methods,
+ * `value` and `onChange` props must be passed to the `Select`.
+ * If the `Select` value should not be changed by user input, a `readOnly` prop must be provided.
+ *
+ * ## Uncontrolled component
+ * If it is not necessary to control the `Select` state, you can create one without a value prop.
+ * In this case its value can be accessed within the `onChange` callback. Use the `initialValue` prop to set the
+ * default value for an uncontrolled `Select`.
+ *
+ * ## Getting feedback for entered values
+ * Use the `feedback` prop to give the user feedback regarding their selection.
+ * You can affirm that the user's selection was correct, or highlight errors that must be corrected, using the `validation` prop.
+ * Keep feedback text as brief as possible, should be limited to text and links.
+ *
+ * ## Using a tooltip
+ * When a more in-depth explanation is needed to fill out a `Select` properly, the tooltip prop may be used.
+ *
+ * ## Grouping options
+ * `Select` supports option groups. Use a `Select.Group` component to render an `<optgroup>` element with its items.
+ * NOTE: this does not work on native platforms - the grouped items will be shown at the same level as the non-grouped items.
+ *
+ */
+const Select = /*#__PURE__*/_react.default.forwardRef((_ref8, ref) => {
+  let {
+    value,
+    initialValue,
+    onChange,
+    children,
+    inactive,
+    readOnly,
+    placeholder,
+    validation,
+    tokens,
+    variant,
+    testID,
+    ...rest
+  } = _ref8;
+  const {
+    currentValue,
+    setValue
+  } = (0, _utils.useInputValue)({
+    value,
+    initialValue,
+    onChange,
+    readOnly
+  });
+  const [isFocused, setIsFocused] = _react.default.useState(false);
+  const handleFocus = () => setIsFocused(true);
+  const handleBlur = () => setIsFocused(false);
+  const [isHovered, setIsHovered] = _react.default.useState(false);
+  const handleMouseOver = () => setIsHovered(true);
+  const handleMouseOut = () => setIsHovered(false);
+  const [isOpen, setIsOpen] = _react.default.useState(false);
+  const {
+    supportsProps,
+    ...selectedProps
+  } = selectProps(rest);
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Select', tokens, variant, {
+    focus: isFocused,
+    hover: isHovered,
+    inactive,
+    active: isOpen,
+    validation
+  });
+  const {
+    icon: IconComponent,
+    validationIcon: ValidationIconComponent
+  } = themeTokens;
+  const {
+    themeOptions
+  } = (0, _ThemeProvider.useTheme)();
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_InputSupports.default, {
+    ...supportsProps,
+    ...selectedProps,
+    validation: validation,
+    feedbackTokens: selectCustomFeedbackStyles(themeTokens),
+    children: _ref9 => {
+      let {
+        inputId,
+        ...props
+      } = _ref9;
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
+        style: selectOuterBorderStyles(themeTokens),
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Picker.default, {
+          ref: ref,
+          style: selectInputStyles(themeTokens, themeOptions, inactive),
+          onFocus: handleFocus,
+          onBlur: handleBlur,
+          onMouseOver: handleMouseOver,
+          onMouseOut: handleMouseOut,
+          onOpen: () => setIsOpen(true),
+          onClose: () => setIsOpen(false),
+          onChange: e => setValue(e, null),
+          value: currentValue,
+          inactive: inactive,
+          placeholder: placeholder !== undefined ? {
+            label: placeholder,
+            value: ''
+          } : undefined,
+          ...props,
+          nativeID: inputId,
+          testID: testID,
+          children: children
+        }), ValidationIconComponent && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          pointerEvents: "none",
+          style: [staticStyles.iconContainer, selectValidationIconContainerStyles(themeTokens)],
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ValidationIconComponent, {
+            ...selectValidationIconTokens(themeTokens)
+          })
+        }), IconComponent && /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+          pointerEvents: "none",
+          style: [staticStyles.iconContainer, selectIconContainerStyles(themeTokens)],
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(IconComponent, {
+            ...selectIconTokens(themeTokens)
+          })
+        })]
+      });
+    }
+  });
+});
+Select.displayName = 'Select';
+Select.propTypes = {
+  ...selectedSystemPropTypes,
+  /**
+   * Initial value for the uncontrolled version.
+   */
+  initialValue: _propTypes.default.string,
+  /**
+   * Current value to be set as selected.
+   */
+  value: _propTypes.default.string,
+  /**
+   * Callback to be called when the value changes.
+   */
+  onChange: _propTypes.default.func,
+  /**
+   * An array of items or item groups to be used as options.
+   */
+  children: (0, _utils.componentPropType)(['Item', 'Group']),
+  /**
+   * Whether the select is disabled.
+   */
+  inactive: _propTypes.default.bool,
+  /**
+   * Whether the select is read-only.
+   */
+  readOnly: _propTypes.default.bool,
+  /**
+   * A placeholder to provide instructions (such as "Please select...")
+   * as an unselectable option
+   */
+  placeholder: _propTypes.default.string,
+  /**
+   * Select tokens.
+   */
+  tokens: (0, _utils.getTokensPropType)('Select'),
+  /**
+   * Select variant.
+   */
+  variant: _utils.variantProp.propType,
+  /**
+   * Dedicated ID for testing.
+   */
+  testID: _propTypes.default.string
+};
+var _default = exports.default = Select;
+const staticStyles = _StyleSheet.default.create({
+  iconContainer: {
+    position: 'absolute',
+    right: 0,
+    bottom: 0
+  }
+});

package/lib/cjs/Select/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MAX_FONT_SIZE_MULTIPLIER = exports.ANDROID_VALIDATION_ICON_CONTAINER_OFFSET = exports.ANDROID_HORIZONTAL_PADDING_OFFSET = exports.ANDROID_DEFAULT_PADDING = exports.ALLOW_FONT_SCALING = exports.ADJUSTS_FONT_SIZE_TO_FIT = void 0;
+// Because Android
+const ANDROID_VALIDATION_ICON_CONTAINER_OFFSET = exports.ANDROID_VALIDATION_ICON_CONTAINER_OFFSET = 5;
+const ANDROID_HORIZONTAL_PADDING_OFFSET = exports.ANDROID_HORIZONTAL_PADDING_OFFSET = 8;
+const ANDROID_DEFAULT_PADDING = exports.ANDROID_DEFAULT_PADDING = 0;
+const ALLOW_FONT_SCALING = exports.ALLOW_FONT_SCALING = true;
+const ADJUSTS_FONT_SIZE_TO_FIT = exports.ADJUSTS_FONT_SIZE_TO_FIT = true;
+const MAX_FONT_SIZE_MULTIPLIER = exports.MAX_FONT_SIZE_MULTIPLIER = 3;

package/lib/cjs/Select/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Select = _interopRequireDefault(require("./Select"));
+var _Group = _interopRequireDefault(require("./Group"));
+var _Item = _interopRequireDefault(require("./Item"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+_Select.default.Group = _Group.default;
+_Select.default.Item = _Item.default;
+var _default = exports.default = _Select.default;

package/lib/cjs/SideNav/Item.js

@@ -0,0 +1,150 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
+var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _utils = require("../utils");
+var _ThemeProvider = require("../ThemeProvider");
+var _ItemContent = _interopRequireDefault(require("./ItemContent"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.linkProps, _utils.viewProps]);
+function selectItemStyles(_ref) {
+  let {
+    backgroundColor,
+    borderColor,
+    borderWidth,
+    borderStyle,
+    paddingLeft,
+    paddingRight,
+    paddingTop,
+    paddingBottom,
+    justifyContent,
+    verticalAlign
+  } = _ref;
+  return {
+    backgroundColor,
+    borderTopColor: borderColor,
+    borderTopWidth: borderWidth,
+    borderTopStyle: borderStyle,
+    paddingLeft,
+    paddingRight,
+    paddingTop,
+    paddingBottom,
+    justifyContent,
+    ...(0, _ThemeProvider.verticalAlignRow)(verticalAlign)
+  };
+}
+
+/**
+ `SideNav.Item` is a navigational element that is used within `SideNav` or `SideNav.ItemsGroup`.
+
+ This component can only be accessed as a name-spaced component: `SideNav.Item`.
+ */
+const Item = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
+  let {
+    children,
+    itemId,
+    groupId,
+    onPress,
+    isActive = false,
+    isExpanded = false,
+    tokens,
+    variant,
+    href,
+    accessibilityRole = 'link',
+    testID,
+    ...props
+  } = _ref2;
+  const handlePress = () => onPress(itemId, groupId);
+  const {
+    hrefAttrs,
+    rest
+  } = _utils.hrefAttrsProp.bundle(props);
+  const selectedProps = selectProps({
+    accessibilityRole,
+    href,
+    onPress: handlePress,
+    hrefAttrs,
+    ...rest
+  });
+  const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('SideNavItem', tokens, variant);
+  const getAppearanceState = _ref3 => {
+    let {
+      hovered,
+      focused
+    } = _ref3;
+    return {
+      hover: hovered,
+      active: isActive,
+      expanded: isExpanded,
+      focus: focused
+    };
+  };
+  const getPressableStyle = pressableState => ({
+    ...selectItemStyles(getTokens(getAppearanceState(pressableState))),
+    ...(_Platform.default.OS === 'web' ? {
+      outline: 'none'
+    } : {})
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+    ref: ref,
+    style: getPressableStyle,
+    accessibilityState: {
+      selected: isActive
+    },
+    ...selectedProps,
+    children: pressableState => {
+      const themeTokens = getTokens(getAppearanceState(pressableState));
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ItemContent.default, {
+        tokens: themeTokens,
+        children: children
+      });
+    }
+  });
+});
+Item.displayName = 'Item';
+Item.propTypes = {
+  ...selectedSystemPropTypes,
+  /**
+   * Text content of the `Item`.
+   */
+  children: _propTypes.default.node.isRequired,
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function - used to keep track of active item.
+   */
+  itemId: _propTypes.default.string,
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function - used to keep track of expanded items groups.
+   */
+  groupId: _propTypes.default.string,
+  onPress: _propTypes.default.func,
+  href: _propTypes.default.string,
+  /**
+   * On Web if href is passed, React Native Web maps this object's props to
+   * `rel`, `target` and `download` attrs.
+   */
+  hrefAttrs: _propTypes.default.shape(_utils.hrefAttrsProp.types),
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function.
+   */
+  isActive: _propTypes.default.bool,
+  /**
+   * @ignore
+   * Set internally in `SideNav.ItemsGroup` render function. Used to mark expanded `ItemsGroup` parent.
+   */
+  isExpanded: _propTypes.default.bool,
+  accessibilityRole: _propTypes.default.string,
+  testID: _propTypes.default.number,
+  tokens: (0, _utils.getTokensPropType)('SideNavItem'),
+  variant: _utils.variantProp.propType
+};
+var _default = exports.default = Item;

package/lib/cjs/SideNav/ItemContent.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.selectAccentStyles = selectAccentStyles;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
+var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
+var _Typography = _interopRequireDefault(require("../Typography"));
+var _utils = require("../utils");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function selectAccentStyles(tokens) {
+  return {
+    left: tokens.accentOffset,
+    top: tokens.accentPadding,
+    bottom: tokens.accentPadding,
+    backgroundColor: tokens.accentBackgroundColor,
+    width: tokens.accentWidth,
+    position: 'absolute'
+  };
+}
+
+/**
+ * Content inside an item or control in a SideNav, themed by the SideNavItem theme
+ */
+const ItemContent = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
+  let {
+    children,
+    tokens
+  } = _ref;
+  const typographyTokens = (0, _utils.selectTokens)('Typography', tokens);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
+      tokens: typographyTokens,
+      ref: ref,
+      children: children
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+      style: [staticStyles.absolute, selectAccentStyles(tokens)]
+    })]
+  });
+});
+ItemContent.displayName = 'ItemContent';
+ItemContent.propTypes = {
+  tokens: (0, _utils.getTokensPropType)('SideNavItem'),
+  children: _propTypes.default.node
+};
+const staticStyles = _StyleSheet.default.create({
+  absolute: {
+    position: 'absolute'
+  }
+});
+var _default = exports.default = ItemContent;

package/lib/cjs/SideNav/ItemsGroup.js

@@ -0,0 +1,125 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _ItemContent = _interopRequireDefault(require("./ItemContent"));
+var _ExpandCollapse = _interopRequireDefault(require("../ExpandCollapse"));
+var _utils = require("../utils");
+var _ThemeProvider = require("../ThemeProvider");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ Expandable content areas for use within `SideNav`.
+
+ This component can only be accessed as a name-spaced component: `SideNav.ItemsGroup`.
+
+ `SideNav.ItemsGroup` contains a label and a list of items. Items can link to in-page elements or route to other pages.
+
+ ## Usage Criteria
+ - Use `SideNav.ItemsGroup` with large pages that have multiple sections
+ */const ItemsGroup = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
+  let {
+    children,
+    label,
+    openGroups,
+    groupId,
+    isActive = false,
+    variant,
+    tokens,
+    itemTokens,
+    onToggle
+  } = _ref;
+  // A SideNav control uses the same style and theme as SideNavItem, with a 'parent' variant,
+  // plus control-specific tokens from the SideNavItemsGroup theme (e.g. open/close icon, etc).
+  const getAppearance = appearance => ({
+    ...variant,
+    ...appearance,
+    active: isActive
+  });
+  const getItemAppearance = appearance => ({
+    ...getAppearance(appearance),
+    type: 'parent'
+  });
+  const getGroupTokens = (0, _ThemeProvider.useThemeTokensCallback)('SideNavItemsGroup', tokens, variant);
+  const getPanelTokens = appearance => {
+    const {
+      panelBorderColor,
+      ...itemsGroupTokens
+    } = getGroupTokens(getAppearance(appearance));
+    const groupTokens = {
+      ...itemsGroupTokens,
+      borderWidth: 0,
+      marginBottom: 0
+    };
+    return (0, _utils.selectTokens)('ExpandCollapsePanel', groupTokens);
+  };
+  const getItemTokens = (0, _ThemeProvider.useThemeTokensCallback)('SideNavItem', itemTokens, variant);
+  const getControlTokens = appearance => (0, _utils.selectTokens)('ExpandCollapseControl', {
+    ...getItemTokens(getItemAppearance(appearance)),
+    // main style from SideNavItem
+    ...getGroupTokens(getAppearance(appearance)) // control-specific tokens like icon etc
+  });
+  const controlContent = controlState => {
+    const currentItemTokens = getItemTokens(getItemAppearance(controlState));
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ItemContent.default, {
+      tokens: currentItemTokens,
+      children: label
+    });
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ExpandCollapse.default.Panel, {
+    ref: ref,
+    openIds: openGroups,
+    panelId: groupId,
+    onToggle: onToggle,
+    tokens: getPanelTokens,
+    controlTokens: getControlTokens,
+    control: controlContent,
+    accessibilityState: {
+      active: isActive
+    } // ExpandCollapse.Panel handles expanded state
+    ,
+    children: children
+  });
+});
+ItemsGroup.displayName = 'ItemsGroup';
+ItemsGroup.propTypes = {
+  /**
+   * Specifies the links contained within. It may only contain `SideNav.Item`.
+   */
+  children: (0, _utils.componentPropType)('Item'),
+  /**
+   * Text content of the group's parent `SideNav.Item`.
+   */
+  label: _propTypes.default.string.isRequired,
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function - used to keep track of expanded items groups.
+   */
+  groupId: _propTypes.default.string,
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function. Called when the group is expanded/collapsed.
+   */
+  onToggle: _propTypes.default.func,
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function. Contains `groupId`s of currently open groups.
+   */
+  openGroups: _propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number])),
+  /**
+   * @ignore
+   * Set internally in `SideNav` render function. Used to mark group containing the currently active `SideNav.Item`.
+   */
+  isActive: _propTypes.default.bool,
+  variant: _utils.variantProp.propType,
+  tokens: (0, _utils.getTokensPropType)('SideNavItemsGroup'),
+  /**
+   * Custom tokens for `SideNav.Item`
+   */
+  itemTokens: (0, _utils.getTokensPropType)('SideNavItem')
+};
+var _default = exports.default = ItemsGroup;