@telus-uds/components-base 1.50.0 → 1.51.1

package/lib/Modal/Modal.js

@@ -200,9 +200,25 @@ const Modal = /*#__PURE__*/(0, _react.forwardRef)((_ref5, ref) => {
 Modal.displayName = 'Modal';
 Modal.propTypes = { ...selectedSystemPropTypes,
   children: _propTypes.default.oneOfType([_propTypes.default.node, _propTypes.default.arrayOf(_propTypes.default.node)]),
+
+  /**
+   * To define the locale of the copy
+   */
   copy: _utils.copyPropTypes,
+
+  /**
+   * Setting this to `true` will open the `Modal`
+   */
   isOpen: _propTypes.default.bool,
+
+  /**
+   * This function is triggered when the `Modal` is closed
+   */
   onClose: _propTypes.default.func,
+
+  /**
+   * `max-width` is applied to the `Modal` container
+   */
   maxWidth: _propTypes.default.bool,
   tokens: (0, _utils.getTokensPropType)('Modal'),
   variant: _utils.variantProp.propType,

package/lib/MultiSelectFilter/ModalOverlay.js

@@ -40,7 +40,6 @@ const staticStyles = _StyleSheet.default.create({
     flex: 1,
     // Grow to maxWidth when possible, shrink when not possible
     position: 'absolute',
-    height: 330,
     zIndex: 10000 // Position on top of all the other overlays, including backdrops and modals
 
   },
@@ -86,6 +85,11 @@ const ModalOverlay = /*#__PURE__*/(0, _react.forwardRef)((_ref3, ref) => {
   let {
     children,
     isReady = false,
+    maxHeight,
+    maxHeightSize,
+    maxWidthSize,
+    minHeight,
+    minWidth,
     overlaidPosition,
     onLayout,
     variant,
@@ -98,9 +102,18 @@ const ModalOverlay = /*#__PURE__*/(0, _react.forwardRef)((_ref3, ref) => {
     viewport,
     maxWidth: false
   });
+  const containerWidthHeight = {
+    minWidth,
+    minHeight,
+    ...(tokens.maxWidth && maxWidthSize && {
+      maxWidth: maxWidthSize
+    }),
+    ...(maxHeight && maxHeightSize && {
+      maxHeight: maxHeightSize
+    })
+  };
   const {
-    closeIcon: CloseIconComponent,
-    maxWidth
+    closeIcon: CloseIconComponent
   } = themeTokens;
   const getCopy = (0, _utils.useCopy)({
     dictionary: _dictionary.default,
@@ -111,9 +124,7 @@ const ModalOverlay = /*#__PURE__*/(0, _react.forwardRef)((_ref3, ref) => {
     children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
       ref: ref,
       onLayout: onLayout,
-      style: [overlaidPosition, {
-        minWidth: maxWidth
-      }, staticStyles.positioner, !isReady && staticStyles.hidden],
+      style: [overlaidPosition, containerWidthHeight, staticStyles.positioner, !isReady && staticStyles.hidden],
       children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Card.default, {
         tokens: selectPaddingContainerStyles(themeTokens),
         children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
@@ -122,8 +133,7 @@ const ModalOverlay = /*#__PURE__*/(0, _react.forwardRef)((_ref3, ref) => {
             onPress: onClose,
             icon: CloseIconComponent,
             accessibilityRole: "button",
-            accessibilityLabel: closeLabel,
-            tokens: (0, _utils.selectTokens)('IconButton', themeTokens, 'close')
+            accessibilityLabel: closeLabel
           })
         }), children]
       })
@@ -139,6 +149,12 @@ ModalOverlay.propTypes = {
     left: _propTypes.default.number,
     width: _propTypes.default.number
   }),
+  minWidth: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number]),
+  minHeight: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number]),
+  maxHeightSize: _propTypes.default.number,
+  maxWidthSize: _propTypes.default.number,
+  maxHeight: _propTypes.default.bool,
+  maxWidth: _propTypes.default.bool,
   onLayout: _propTypes.default.func,
   variant: _utils.variantProp.propType,
   tokens: (0, _utils.getTokensPropType)('Modal'),

package/lib/MultiSelectFilter/MultiSelectFilter.js

@@ -15,6 +15,8 @@ var _utils = require("../utils");
 
 var _dictionary = _interopRequireDefault(require("./dictionary"));
 
+var _ViewportProvider = require("../ViewportProvider");
+
 var _Box = _interopRequireDefault(require("../Box"));
 
 var _Button = require("../Button");
@@ -35,6 +37,8 @@ var _Link = require("../Link");
 
 var _ModalOverlay = _interopRequireDefault(require("./ModalOverlay"));
 
+var _Modal = _interopRequireDefault(require("../Modal"));
+
 var _jsxRuntime = require("react/jsx-runtime");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -81,6 +85,7 @@ const MultiSelectFilter = _ref3 => {
     tokens,
     items = [],
     values,
+    maxHeight = false,
     initialValues,
     maxValues,
     onChange,
@@ -90,6 +95,7 @@ const MultiSelectFilter = _ref3 => {
     rowLimit = 12,
     ...rest
   } = _ref3;
+  const viewport = (0, _ViewportProvider.useViewport)();
   const {
     currentValues,
     setValues
@@ -100,6 +106,9 @@ const MultiSelectFilter = _ref3 => {
     onChange,
     readOnly
   });
+  const [isOpen, setIsOpen] = (0, _react.useState)(false);
+  const [checkedIds, setCheckedIds] = (0, _react.useState)(currentValues ?? []);
+  const [maxWidth, setMaxWidth] = (0, _react.useState)(false);
   const themeTokens = (0, _ThemeProvider.useThemeTokens)('ButtonDropdown', tokens, variant);
   const getItemTokens = (0, _ThemeProvider.useThemeTokensCallback)('ButtonDropdown', tokens, variant);
 
@@ -109,10 +118,34 @@ const MultiSelectFilter = _ref3 => {
     dictionary: _dictionary.default,
     copy
   });
-  const [isOpen, setIsOpen] = (0, _react.useState)(false);
-  const [checkedIds, setCheckedIds] = (0, _react.useState)(currentValues ?? []);
-  const colSize = items.length > rowLimit ? 2 : 1;
+  const colSizeNotMobile = items.length > rowLimit ? 2 : 1;
+  const colSize = viewport !== 'xs' ? colSizeNotMobile : 1;
+  const itemsLengthNotMobile = items.length > 24 ? items.length / 2 : rowLimit;
   const isSelected = currentValues.length > 0;
+  const rowLength = viewport !== 'xs' ? itemsLengthNotMobile : items.length;
+  (0, _react.useEffect)(() => {
+    if (colSize === 1) return setMaxWidth(false);
+    return colSize === 2 && setMaxWidth(true);
+  }, [colSize]);
+  const {
+    headerFontColor,
+    headerFontSize,
+    buttonDirection,
+    headerFontWeight,
+    headerLineHeight,
+    subHeaderFontWeight,
+    subHeaderFontSize,
+    maxHeightSize,
+    maxWidthSize,
+    subHeaderLineHeight,
+    minHeight,
+    minWidth
+  } = (0, _ThemeProvider.useThemeTokens)('MultiSelectFilter', tokens, { ...variant,
+    maxHeight,
+    maxWidth
+  }, {
+    viewport
+  });
   const uniqueFields = ['id', 'label'];
 
   if (!(0, _utils.containUniqueFields)(items, uniqueFields)) {
@@ -136,6 +169,11 @@ const MultiSelectFilter = _ref3 => {
     setIsOpen(false);
   };
 
+  const onClear = () => {
+    setCheckedIds(() => []);
+    onApply([]);
+  };
+
   const {
     align,
     offsets
@@ -143,9 +181,7 @@ const MultiSelectFilter = _ref3 => {
     xs: {
       align: {
         top: 'top',
-        left: 'left',
-        bottom: 'bottom',
-        right: 'right'
+        left: 'left'
       }
     },
     sm: {
@@ -158,6 +194,16 @@ const MultiSelectFilter = _ref3 => {
       }
     }
   });
+  const headerStyles = (0, _ThemeProvider.applyTextStyles)({
+    fontSize: headerFontSize,
+    fontWeight: headerFontWeight,
+    fontColor: headerFontColor
+  });
+  const subeHeaderStyles = (0, _ThemeProvider.applyTextStyles)({
+    fontSize: subHeaderFontSize,
+    fontWeight: subHeaderFontWeight,
+    fontColor: selectSubTitleTokens(themeTokens)
+  });
   const {
     overlaidPosition,
     onTargetLayout,
@@ -178,20 +224,96 @@ const MultiSelectFilter = _ref3 => {
       onChange: handleChange,
       tokens: getButtonTokens,
       inactive: inactive
-    }, id), isOpen && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_ModalOverlay.default, {
+    }, id), isOpen && viewport === 'xs' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Modal.default, {
+      isOpen: isOpen,
+      onClose: () => setIsOpen(false),
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
+          tokens: { ...headerStyles,
+            lineHeight: headerLineHeight
+          },
+          children: getCopy('filterByLabel').replace(/%\{filterCategory\}/g, label.toLowerCase())
+        })
+      }), subtitle && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
+          space: 5
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
+            tokens: { ...subeHeaderStyles,
+              lineHeight: subHeaderLineHeight
+            },
+            children: subtitle
+          })
+        })]
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
+        space: 4
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
+        scroll: true,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
+          distribute: "between",
+          children: [...Array(colSize).keys()].map(i => /*#__PURE__*/(0, _jsxRuntime.jsxs)(Col, {
+            xs: 12 / colSize,
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.CheckboxGroup, {
+              items: items.slice(i * rowLength, (i + 1) * rowLength),
+              checkedIds: checkedIds,
+              onChange: e => setCheckedIds(e, i)
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
+              size: 4
+            })]
+          }, i))
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Divider.default, {
+        variant: selectDividerToknes({ ...themeTokens,
+          width: 'full'
+        }),
+        space: 4
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
+        horizontalAlign: buttonDirection === 'column' ? 'center' : 'start',
+        children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.default, {
+          direction: buttonDirection,
+          space: 3,
+          tokens: {
+            alignItems: 'center',
+            ...(viewport === 'xs' && {
+              flexGrow: 1
+            })
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Button.Button, {
+            onPress: () => onApply(checkedIds),
+            variant: {
+              size: 'small',
+              priority: 'high',
+              ...(viewport === 'xs' && {
+                width: 'full'
+              })
+            },
+            children: getCopy('applyButtonLabel')
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Link.TextButton, {
+              onPress: () => onClear(),
+              children: getCopy('clearButtonLabel')
+            })
+          })]
+        })
+      })]
+    }), isOpen && viewport !== 'xs' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_ModalOverlay.default, {
       overlaidPosition: overlaidPosition,
-      variant: {
-        width: colSize > 1 ? 'size576' : 's'
-      },
       onClose: () => setIsOpen(false),
-      tokens: tokens,
+      maxHeight: maxHeight,
+      maxHeightSize: maxHeightSize,
+      maxWidthSize: maxWidthSize,
+      minHeight: minHeight,
+      minWidth: minWidth,
+      tokens: { ...tokens,
+        maxWidth
+      },
       copy: copy,
       isReady: isReady,
       onLayout: onTargetLayout,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
-          variant: {
-            size: 'h4'
+          tokens: { ...headerStyles,
+            lineHeight: headerLineHeight
           },
           children: getCopy('filterByLabel').replace(/%\{filterCategory\}/g, label.toLowerCase())
         })
@@ -200,10 +322,9 @@ const MultiSelectFilter = _ref3 => {
           space: 5
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Typography.default, {
-            variant: {
-              size: 'h5'
+            tokens: { ...subeHeaderStyles,
+              lineHeight: subHeaderLineHeight
             },
-            tokens: selectSubTitleTokens(themeTokens),
             children: subtitle
           })
         })]
@@ -216,7 +337,7 @@ const MultiSelectFilter = _ref3 => {
           children: [...Array(colSize).keys()].map(i => /*#__PURE__*/(0, _jsxRuntime.jsxs)(Col, {
             xs: 12 / colSize,
             children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Checkbox.CheckboxGroup, {
-              items: items.slice(i * rowLimit, (i + 1) * rowLimit),
+              items: items.slice(i * rowLength, (i + 1) * rowLength),
               checkedIds: checkedIds,
               onChange: e => setCheckedIds(e, i)
             }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Spacer.default, {
@@ -230,22 +351,29 @@ const MultiSelectFilter = _ref3 => {
         }),
         space: 4
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(Row, {
+        horizontalAlign: buttonDirection === 'column' ? 'center' : 'start',
         children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.default, {
-          direction: "row",
+          direction: buttonDirection,
           space: 3,
           tokens: {
-            alignItems: 'center'
+            alignItems: 'center',
+            ...(viewport === 'xs' && {
+              flexGrow: 1
+            })
           },
           children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Button.Button, {
             onPress: () => onApply(checkedIds),
             variant: {
               size: 'small',
-              priority: 'high'
+              priority: 'high',
+              ...(viewport === 'xs' && {
+                width: 'full'
+              })
             },
             children: getCopy('applyButtonLabel')
           }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Box.default, {
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Link.TextButton, {
-              onPress: () => setCheckedIds([]),
+              onPress: () => onClear(),
               children: getCopy('clearButtonLabel')
             })
           })]
@@ -319,6 +447,11 @@ MultiSelectFilter.propTypes = {
    */
   maxValues: _propTypes.default.number,
 
+  /**
+   * If provided sets maxHeight to be active
+   */
+  maxHeight: _propTypes.default.bool,
+
   /**
    * 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`.

package/lib/Pagination/PageButton.js

@@ -80,8 +80,20 @@ const PageButton = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
 });
 PageButton.displayName = 'PageButton';
 PageButton.propTypes = { ..._utils.linkProps.types,
+
+  /**
+   * To set custom label for the button
+   */
   label: _propTypes.default.string,
+
+  /**
+   * To set `PageButton` to active state
+   */
   isActive: _propTypes.default.bool,
+
+  /**
+   * To change the language for labels
+   */
   copy: _utils.copyPropTypes,
   variant: _utils.variantProp.propType,
   tokens: (0, _utils.getTokensPropType)('PaginationPageButton')

package/lib/Pagination/Pagination.js

@@ -210,10 +210,22 @@ Pagination.PageButton = _PageButton.default;
 Pagination.propTypes = { ...selectedSystemPropTypes,
   ..._utils.withLinkRouter.propTypes,
   children: (0, _utils.componentPropType)('PageButton'),
+
+  /**
+   * To change the language for labels
+   */
   copy: _utils.copyPropTypes,
   variant: _utils.variantProp.propType,
   tokens: (0, _utils.getTokensPropType)('Pagination'),
+
+  /**
+   * When passed as `{{ compact: true }}`, `Pagination` does not render labels along side buttons
+   */
   sideButtonVariant: _utils.variantProp.propType,
+
+  /**
+   * Custom tokens for `PaginationSideButton`
+   */
   sideButtonTokens: (0, _utils.getTokensPropType)('PaginationSideButton')
 };
 

package/lib/QuickLinks/QuickLinks.js

@@ -81,8 +81,20 @@ const QuickLinks = /*#__PURE__*/(0, _react.forwardRef)((_ref, ref) => {
 QuickLinks.displayName = 'QuickLinks';
 QuickLinks.propTypes = {
   tokens: (0, _utils.getTokensPropType)('QuickLinks'),
+
+  /**
+   * Custom tokens override for `Card`
+   */
   cardTokens: (0, _utils.getTokensPropType)('Card'),
+
+  /**
+   * Custom tokens override for `QuickLinksList`
+   */
   listTokens: (0, _utils.getTokensPropType)('QuickLinksList'),
+
+  /**
+   * The HTML tag to render the list as
+   */
   tag: _propTypes.default.string,
   variant: _utils.variantProp.propType,
   children: _propTypes.default.node

package/lib/QuickLinksFeature/QuickLinksFeatureItem.js

@@ -56,6 +56,7 @@ const selectContainerStyle = _ref => {
   } = _ref;
   return {
     textAlign,
+    outline: 'red',
     width: contentMaxDimension,
     overflow: 'hidden'
   };
@@ -67,6 +68,15 @@ const selectImageContainerStyle = contentMaxDimension => ({
   justifyContent: 'center',
   alignItems: 'center'
 });
+
+const selectLinkToken = _ref2 => {
+  let {
+    outerBorderColor
+  } = _ref2;
+  return {
+    outerBorderColor
+  };
+};
 /**
  * Component export along with QuickLinksFeature to be used as children
  *
@@ -74,7 +84,7 @@ const selectImageContainerStyle = contentMaxDimension => ({
  */
 
 
-const QuickLinksFeatureItem = /*#__PURE__*/(0, _react.forwardRef)((_ref2, ref) => {
+const QuickLinksFeatureItem = /*#__PURE__*/(0, _react.forwardRef)((_ref3, ref) => {
   let {
     tokens,
     variant,
@@ -82,52 +92,63 @@ const QuickLinksFeatureItem = /*#__PURE__*/(0, _react.forwardRef)((_ref2, ref) =
     imageAccessibilityLabel,
     imageSource,
     ...rest
-  } = _ref2;
+  } = _ref3;
   const viewport = (0, _ViewportProvider.useViewport)();
   const getTokens = (0, _ThemeProvider.useThemeTokensCallback)('QuickLinksFeatureItem', tokens, variant);
-  const [hover, setHover] = (0, _react.useState)(false);
-  const {
-    contentDirection,
-    contentSpace,
-    contentAlignItems,
-    contentMaxDimension,
-    imageDimension,
-    textAlign
-  } = getTokens({
-    viewport,
-    hover
-  });
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Link.Link, {
     ref: ref,
-    tokens: state => {
-      setHover(state.hover);
-      return getTokens(state);
-    },
     ...selectProps(rest),
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-      style: selectContainerStyle({
+    tokens: state => selectLinkToken(getTokens(state)),
+    children: _ref4 => {
+      let {
+        hovered: hover,
+        pressed,
+        focused: focus
+      } = _ref4;
+      const {
+        contentDirection,
+        contentSpace,
+        contentAlignItems,
         contentMaxDimension,
-        textAlign
-      }),
-      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.StackWrap, {
-        direction: contentDirection,
-        space: contentSpace,
-        tokens: {
-          alignItems: contentAlignItems
-        },
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-          style: selectImageContainerStyle(contentMaxDimension),
-          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Image.default, {
-            accessibilityIgnoresInvertColors: true,
-            imageAccessibilityLabel: imageAccessibilityLabel,
-            source: imageSource,
-            style: selectImageStyle(imageDimension)
-          })
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
-          children: children
-        })]
-      })
-    })
+        imageDimension,
+        textLine,
+        gap,
+        ...themeTokens
+      } = getTokens({
+        viewport,
+        hover,
+        pressed,
+        focus
+      });
+      const textStyle = { ...(0, _ThemeProvider.applyTextStyles)(themeTokens),
+        textDecorationLine: textLine
+      };
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+        style: selectContainerStyle({ ...themeTokens,
+          contentMaxDimension
+        }),
+        children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.StackWrap, {
+          direction: contentDirection,
+          space: contentSpace,
+          gap: gap,
+          tokens: {
+            alignItems: contentAlignItems
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
+            style: selectImageContainerStyle(contentMaxDimension),
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Image.default, {
+              accessibilityIgnoresInvertColors: true,
+              imageAccessibilityLabel: imageAccessibilityLabel,
+              source: imageSource,
+              style: selectImageStyle(imageDimension)
+            })
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+            style: textStyle,
+            children: children
+          })]
+        })
+      });
+    }
   });
 });
 QuickLinksFeatureItem.displayName = 'QuickLinksFeatureItem';

package/lib/Responsive/Responsive.js

@@ -50,7 +50,14 @@ const Responsive = _ref => {
 };
 
 Responsive.propTypes = {
+  /**
+   * To hide children of `Responsive` if the current viewport is smaller than `min`
+   */
   min: _propTypes.default.oneOf(['xs', 'sm', 'md', 'lg', 'xl']),
+
+  /**
+   * To hide children of `Responsive` if the current viewport is larger than `max`
+   */
   max: _propTypes.default.oneOf(['sm', 'md', 'lg', 'xl']),
   children: _propTypes.default.node.isRequired
 };

package/lib/Select/Group.js

@@ -30,5 +30,9 @@ var _default = Group;
 exports.default = _default;
 Group.propTypes = {
   children: (0, _utils.componentPropType)('Item'),
+
+  /**
+   * The label for the group.
+   */
   label: _propTypes.default.string.isRequired
 };

package/lib/Select/Group.native.js

@@ -22,5 +22,9 @@ var _default = Group;
 exports.default = _default;
 Group.propTypes = {
   children: (0, _utils.componentPropType)('Item'),
+
+  /**
+   * The label for the group.
+   */
   label: _propTypes.default.string.isRequired
 };

package/lib/Select/Item.js

@@ -28,5 +28,9 @@ var _default = Item;
 exports.default = _default;
 Item.propTypes = {
   children: _propTypes.default.string.isRequired,
+
+  /**
+   * The value of the option
+   */
   value: _propTypes.default.string.isRequired
 };

package/lib/SideNav/ItemsGroup.js

@@ -141,6 +141,10 @@ ItemsGroup.propTypes = {
   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 = ItemsGroup;

package/lib/SideNav/SideNav.js

@@ -147,7 +147,15 @@ SideNav.propTypes = { ...selectedSystemPropTypes,
   accordion: _propTypes.default.bool,
   variant: _utils.variantProp.propType,
   tokens: (0, _utils.getTokensPropType)('SideNav'),
+
+  /**
+   * Custom tokens for `SideNav.Item`
+   */
   itemTokens: (0, _utils.getTokensPropType)('SideNavItem'),
+
+  /**
+   * Custom tokens for `SideNavItemsGroup`
+   */
   groupTokens: (0, _utils.getTokensPropType)('SideNavItemsGroup')
 };
 SideNav.Item = _Item.default;