@telus-uds/components-base 3.26.0 → 3.27.0

package/lib/cjs/Carousel/Carousel.js

@@ -79,7 +79,7 @@ const selectHeroContainerStyles = (width, hidden) => ({
   width,
   visibility: hidden ? 'hidden' : 'visible'
 });
-const getDynamicPositionProperty = areStylesAppliedOnPreviousButton => areStylesAppliedOnPreviousButton ? 'left' : 'right';
+const getDynamicPositionProperty = areStylesAppliedOnPreviousButton => areStylesAppliedOnPreviousButton ? _Constants.POSITION_PROPERTIES.LEFT : _Constants.POSITION_PROPERTIES.RIGHT;
 const selectControlButtonPositionStyles = _ref => {
   let {
     positionVariant,
@@ -89,23 +89,36 @@ const selectControlButtonPositionStyles = _ref => {
     enablePeeking,
     enableDisplayMultipleItemsPerSlide,
     isAutoPlayEnabled,
-    viewport
+    viewport,
+    maxWidth,
+    viewportWidth
   } = _ref;
   const styles = {};
-  if (positionVariant === 'edge') {
-    styles[positionProperty] = -1 * (buttonWidth / 2);
-  } else if (positionVariant === 'inside') {
-    styles[positionProperty] = _Constants.DEFAULT_POSITION_OFFSET;
-  } else if (positionVariant === 'outside') {
+  let positionOffset = 0;
+  if (positionVariant === _Constants.POSITION_VARIANTS.EDGE) {
+    positionOffset = -1 * (buttonWidth / 2);
+  } else if (positionVariant === _Constants.POSITION_VARIANTS.INSIDE) {
+    positionOffset = _Constants.DEFAULT_POSITION_OFFSET;
+  } else if (positionVariant === _Constants.POSITION_VARIANTS.OUTSIDE) {
     if (enablePeeking || enableDisplayMultipleItemsPerSlide || isAutoPlayEnabled && viewport === 'xs') {
-      styles[positionProperty] = 0;
+      positionOffset = 0;
     } else {
-      styles[positionProperty] = -1 * (spaceBetweenSlideAndButton + buttonWidth);
+      positionOffset = -1 * (spaceBetweenSlideAndButton + buttonWidth);
+    }
+  }
+  if (enablePeeking) {
+    if (positionProperty === _Constants.POSITION_PROPERTIES.RIGHT) {
+      const rightMargin = (viewportWidth - maxWidth) / 2;
+      positionOffset += rightMargin;
+    } else if (positionProperty === _Constants.POSITION_PROPERTIES.LEFT) {
+      const leftMargin = (viewportWidth - maxWidth) / 2;
+      positionOffset += leftMargin;
     }
   }
+  styles[positionProperty] = positionOffset;
   return styles;
 };
-const selectPreviousNextNavigationButtonStyles = (previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, areStylesAppliedOnPreviousButton, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport) => {
+const selectPreviousNextNavigationButtonStyles = (previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, areStylesAppliedOnPreviousButton, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport, maxWidth, viewportWidth) => {
   const styles = {
     zIndex: 1,
     position: 'absolute'
@@ -127,7 +140,9 @@ const selectPreviousNextNavigationButtonStyles = (previousNextNavigationButtonWi
       enablePeeking,
       enableDisplayMultipleItemsPerSlide,
       isAutoPlayEnabled,
-      viewport
+      viewport,
+      maxWidth,
+      viewportWidth
     })
   };
 };
@@ -193,7 +208,7 @@ const getMaximumItemsForSlide = (enableDisplayMultipleItemsPerSlide, viewport) =
   }
   return _Constants.ITEMS_PER_VIEWPORT_XS_SM;
 };
-const selectRootContainerStyles = (enableHero, viewport) => {
+const selectRootContainerStyles = (enableHero, viewport, enablePeeking) => {
   if (enableHero && viewport === 'xl' && _Platform.default.OS === 'web') {
     return {
       alignItems: 'center'
@@ -204,15 +219,25 @@ const selectRootContainerStyles = (enableHero, viewport) => {
       paddingHorizontal: 16
     };
   }
+  if (enablePeeking) {
+    return {
+      width: '100%'
+    };
+  }
   return {};
 };
-const selectMainContainerStyles = (enableHero, viewport, maxWidth) => {
-  if (enableHero && viewport === 'xl' && _Platform.default.OS === 'web') {
+const selectMainContainerStyles = (enableHero, viewport, maxWidth, enablePeeking) => {
+  if (enableHero && viewport === 'xl' && _Platform.default.OS === 'web' && !enablePeeking) {
     return {
       width: '100%',
       maxWidth: maxWidth || 1200
     };
   }
+  if (enablePeeking) {
+    return {
+      width: '100%'
+    };
+  }
   if (maxWidth !== null && maxWidth !== undefined) {
     return {
       maxWidth,
@@ -222,14 +247,20 @@ const selectMainContainerStyles = (enableHero, viewport, maxWidth) => {
   }
   return {};
 };
-const selectNavigationStyles = (tabs, enableHero, viewport) => {
+const selectNavigationStyles = (tabs, enableHero, viewport, enablePeeking, maxWidth) => {
   let marginHorizontal = 0;
   if (enableHero && tabs) {
     marginHorizontal = viewport === 'xl' ? _Constants.LARGE_VIEWPORT_MARGIN : _Constants.DEFAULT_VIEWPORT_MARGIN;
   }
-  return {
+  const styles = {
     marginHorizontal
   };
+  if (enablePeeking && maxWidth) {
+    styles.maxWidth = maxWidth;
+    styles.alignSelf = 'center';
+    styles.width = '100%';
+  }
+  return styles;
 };
 
 /**
@@ -238,23 +269,18 @@ const selectNavigationStyles = (tabs, enableHero, viewport) => {
  * @param {number} containerWidth - The width of the carousel container.
  * @param {boolean} enablePeeking - Flag indicating whether peeking is enabled.
  * @param {Object} viewport - The viewport configuration object used to determine peeking properties.
- * @param {React.MutableRefObject<number>} activeIndexRef - A ref object holding the current active index of the carousel.
+ * @param {number} maxWidth - The maximum width constraint for the carousel content.
  * @returns {number} The calculated final width of the carousel container.
  */
-const calculateFinalWidth = (containerWidth, enablePeeking, viewport, activeIndexRef) => {
+const calculateFinalWidth = (containerWidth, enablePeeking, viewport, maxWidth) => {
   let finalWidth = containerWidth;
   if (enablePeeking) {
     const {
       peekingGap,
-      peekingMiddleSpace,
-      peekingMarginLeft
+      peekingMiddleSpace
     } = getPeekingProps(viewport);
-    const slideWide = containerWidth - (peekingMiddleSpace * _Constants.PEEKING_MULTIPLIER + peekingGap * _Constants.PEEKING_MULTIPLIER);
-    if (activeIndexRef.current === 0) {
-      finalWidth = slideWide + peekingMarginLeft - peekingMiddleSpace;
-    } else {
-      finalWidth = slideWide + peekingGap;
-    }
+    const baseWidth = maxWidth || containerWidth;
+    finalWidth = baseWidth - peekingMiddleSpace * _Constants.PEEKING_MULTIPLIER + peekingGap;
   }
   return finalWidth;
 };
@@ -377,7 +403,10 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
   } = (0, _ThemeProvider.useTheme)();
   const contentMaxWidthValue = (0, _utils.useResponsiveProp)(contentMaxWidth);
   const responsiveWidth = (0, _utils.useResponsiveProp)(themeOptions?.contentMaxWidth);
-  const maxWidth = (0, _utils.resolveContentMaxWidth)(contentMaxWidthValue, responsiveWidth);
+  let maxWidth = null;
+  if (enablePeeking || contentMaxWidth !== undefined) {
+    maxWidth = contentMaxWidthValue === undefined ? responsiveWidth : (0, _utils.resolveContentMaxWidth)(contentMaxWidthValue, responsiveWidth);
+  }
   const totalItems = getTotalItems(enableDisplayMultipleItemsPerSlide, childrenArray, viewport);
   const autoPlayFeatureEnabled = autoPlay && slideDuration > 0 && transitionDuration > 0 && totalItems > 1;
   // if `Carousel` only has one `Carousel.Item`, convert this to a single-item array
@@ -440,8 +469,16 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
   const [isCarouselPlaying, setisCarouselPlaying] = _react.default.useState(autoPlayFeatureEnabled);
   const isSwiping = _react.default.useRef(false);
   const autoPlayRef = _react.default.useRef(null);
+  const [rootContainerLayout, setRootContainerLayout] = _react.default.useState({
+    x: 0,
+    y: 0,
+    width: 0,
+    height: 0
+  });
+  const rootContainerLayoutRef = _react.default.useRef(rootContainerLayout);
   const isFirstSlide = !activeIndex;
   const isLastSlide = activeIndex + 1 >= totalItems;
+  const currentViewportWidth = rootContainerLayout.width;
   const handleAnimationStart = _react.default.useCallback(function () {
     if (typeof onAnimationStart === 'function') onAnimationStart(...arguments);
     setIsAnimating(true);
@@ -459,15 +496,15 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
     if (enablePeeking) {
       const {
         peekingGap,
-        peekingMiddleSpace,
-        peekingMarginLeft
+        peekingMiddleSpace
       } = getPeekingProps(viewport);
       let finalWidth;
-      const slideWide = containerLayoutRef.current.width - (peekingMiddleSpace * _Constants.PEEKING_MULTIPLIER + peekingGap * _Constants.PEEKING_MULTIPLIER);
+      const baseWidth = maxWidth || containerLayoutRef.current.width;
+      const slideWide = baseWidth - peekingMiddleSpace * _Constants.PEEKING_MULTIPLIER;
       if (activeIndexRef.current === 0) {
         finalWidth = 0;
       } else {
-        finalWidth = slideWide + peekingMarginLeft - peekingMiddleSpace + (slideWide + peekingGap) * (activeIndexRef.current - _Constants.ACTIVE_INDEX_OFFSET_MULTIPLIER);
+        finalWidth = (slideWide + peekingGap) * activeIndexRef.current;
       }
       animatedX.current = finalWidth * _Constants.NEGATIVE_MULTIPLIER;
     } else {
@@ -494,7 +531,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
         y: 0
       });
     }
-  }, [pan, animatedX, heroPan, heroAnimatedX, enableHero, viewport, enablePeeking]);
+  }, [pan, animatedX, heroPan, heroAnimatedX, enableHero, viewport, enablePeeking, maxWidth]);
   const animate = _react.default.useCallback(function (panToAnimate, toValue, toIndex) {
     let isSwipeRelease = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
     const applicableTransitionDuration = isLastSlide && toIndex === 0 ? loopDuration : transitionDuration;
@@ -586,7 +623,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
     }
     stopAutoplay();
     setActiveIndex(index);
-    const finalWidth = calculateFinalWidth(containerLayoutRef.current.width, enablePeeking, viewport, activeIndexRef);
+    const finalWidth = calculateFinalWidth(containerLayoutRef.current.width, enablePeeking, viewport, maxWidth);
     toValue.x = finalWidth * -1 * calcDelta;
     const heroToValue = {
       x: 0,
@@ -613,7 +650,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
     }
     if (onIndexChanged) onIndexChanged(calcDelta, index);
     return calcDelta;
-  }, [handleAnimationStart, triggerRefocus, slideDuration, updateOffset, animate, totalItems, onIndexChanged, isCarouselPlaying, stopAutoplay, isAutoPlayEnabled, viewport, enablePeeking, pan, heroPan, enableHero]);
+  }, [handleAnimationStart, triggerRefocus, slideDuration, updateOffset, animate, totalItems, onIndexChanged, isCarouselPlaying, stopAutoplay, isAutoPlayEnabled, viewport, enablePeeking, pan, heroPan, enableHero, maxWidth]);
   const startAutoplay = _react.default.useCallback(() => {
     stopAutoplay();
     if (isAutoPlayEnabled) {
@@ -648,6 +685,9 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
   _react.default.useEffect(() => {
     heroContainerLayoutRef.current = heroContainerLayout;
   }, [heroContainerLayout]);
+  _react.default.useEffect(() => {
+    rootContainerLayoutRef.current = rootContainerLayout;
+  }, [rootContainerLayout]);
   _react.default.useEffect(() => {
     pan.x.addListener(_ref5 => {
       let {
@@ -756,6 +796,25 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
     } = _ref11;
     return setPreviousNextNavigationButtonWidth(width);
   };
+  const onRootContainerLayout = _ref12 => {
+    let {
+      nativeEvent: {
+        layout: {
+          x,
+          y,
+          width,
+          height
+        }
+      }
+    } = _ref12;
+    return setRootContainerLayout(prevState => ({
+      ...prevState,
+      x,
+      y,
+      width,
+      height
+    }));
+  };
   const isSwipeAllowed = _react.default.useCallback(() => {
     if (totalItems === 1) {
       return false;
@@ -921,9 +980,10 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
     }
   }, [isTransitioningRef]);
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
-    style: selectRootContainerStyles(enableHero, viewport),
+    style: selectRootContainerStyles(enableHero, viewport, enablePeeking),
+    onLayout: onRootContainerLayout,
     children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-      style: selectMainContainerStyles(enableHero, viewport, maxWidth),
+      style: selectMainContainerStyles(enableHero, viewport, maxWidth, enablePeeking),
       children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_CarouselContext.CarouselProvider, {
         activeIndex: activeIndex,
         goTo: goTo,
@@ -935,6 +995,8 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
         refocus: refocus,
         width: containerLayout.width,
         maximumItemsForSlide: getMaximumItemsForSlide(enableDisplayMultipleItemsPerSlide, viewport),
+        maxWidth: maxWidth,
+        viewportWidth: currentViewportWidth,
         children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
           style: [staticStyles.root, {
             ...(_Platform.default.OS === 'web' ? {
@@ -957,7 +1019,9 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
               enablePeeking,
               enableDisplayMultipleItemsPerSlide,
               isAutoPlayEnabled,
-              viewport
+              viewport,
+              maxWidth,
+              viewportWidth: currentViewportWidth
             })],
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton.default, {
               icon: isCarouselPlaying ? pauseIcon : playIcon,
@@ -966,7 +1030,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
               onPress: onAnimationControlButtonPress
             })
           }) : null, showPreviousNextNavigation && totalItems > 1 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-            style: selectPreviousNextNavigationButtonStyles(previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, true, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport),
+            style: selectPreviousNextNavigationButtonStyles(previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, true, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport, maxWidth, currentViewportWidth),
             testID: "previous-button-container",
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton.default, {
               onLayout: onPreviousNextNavigationButtonLayout,
@@ -1004,16 +1068,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
               children: childrenArray.map((element, index) => {
                 let hidden = !isAnimating && index !== activeIndex;
                 if (enablePeeking && !isAnimating) {
-                  if (enableDisplayMultipleItemsPerSlide) {
-                    const maxItemsForSlide = getMaximumItemsForSlide(enableDisplayMultipleItemsPerSlide, viewport);
-                    if (index >= activeIndex * maxItemsForSlide - 1 && index < activeIndex * maxItemsForSlide + maxItemsForSlide + 1) {
-                      hidden = false;
-                    } else {
-                      hidden = true;
-                    }
-                  } else if (index >= activeIndex - 1 && index <= activeIndex + 1) {
-                    hidden = false;
-                  }
+                  hidden = false;
                 } else if (!enablePeeking && enableDisplayMultipleItemsPerSlide && !isAnimating) {
                   const maxItemsForSlide = getMaximumItemsForSlide(enableDisplayMultipleItemsPerSlide, viewport);
                   if (index >= activeIndex * maxItemsForSlide && index < activeIndex * maxItemsForSlide + maxItemsForSlide) {
@@ -1035,7 +1090,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
               })
             })
           }), showPreviousNextNavigation && totalItems > 1 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-            style: selectPreviousNextNavigationButtonStyles(previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, false, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport),
+            style: selectPreviousNextNavigationButtonStyles(previousNextNavigationButtonWidth, previousNextNavigationPosition, spaceBetweenSlideAndPreviousNextNavigation, isFirstSlide, isLastSlide, false, enablePeeking, enableDisplayMultipleItemsPerSlide, isAutoPlayEnabled, viewport, maxWidth, currentViewportWidth),
             testID: "next-button-container",
             children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconButton.default, {
               onLayout: onPreviousNextNavigationButtonLayout,
@@ -1047,7 +1102,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref3, ref) => {
             })
           }) : null]
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-          style: selectNavigationStyles(tabs, enableHero, viewport),
+          style: selectNavigationStyles(tabs, enableHero, viewport, enablePeeking, maxWidth),
           children: showPanelNavigation ? activePanelNavigation : null
         })]
       })

package/lib/cjs/Carousel/CarouselContext.js

@@ -22,7 +22,9 @@ const CarouselProvider = _ref => {
     themeTokens,
     totalItems,
     width,
-    maximumItemsForSlide
+    maximumItemsForSlide,
+    maxWidth,
+    viewportWidth
   } = _ref;
   const value = _react.default.useMemo(() => ({
     activeIndex,
@@ -33,8 +35,10 @@ const CarouselProvider = _ref => {
     themeTokens,
     totalItems,
     width,
-    maximumItemsForSlide
-  }), [activeIndex, goTo, getCopyWithPlaceholders, itemLabel, refocus, totalItems, themeTokens, width, maximumItemsForSlide]);
+    maximumItemsForSlide,
+    maxWidth,
+    viewportWidth
+  }), [activeIndex, goTo, getCopyWithPlaceholders, itemLabel, refocus, totalItems, themeTokens, width, maximumItemsForSlide, maxWidth, viewportWidth]);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(CarouselContext.Provider, {
     value: value,
     children: children
@@ -58,5 +62,7 @@ CarouselProvider.propTypes = {
   themeTokens: (0, _utils.getTokensPropType)('Carousel'),
   totalItems: _propTypes.default.number.isRequired,
   width: _propTypes.default.number.isRequired,
-  maximumItemsForSlide: _propTypes.default.number
+  maximumItemsForSlide: _propTypes.default.number,
+  maxWidth: _propTypes.default.number,
+  viewportWidth: _propTypes.default.number
 };

package/lib/cjs/Carousel/CarouselItem/CarouselItem.js

@@ -19,26 +19,26 @@ const selectContainerStyle = _ref => {
     width,
     elementIndex,
     enablePeeking,
-    peekingMarginLeft,
     peekingGap,
     hidden,
     enableDisplayMultipleItemsPerSlide,
     viewport,
-    peekingMiddleSpace
+    peekingMiddleSpace,
+    maxWidth,
+    viewportWidth
   } = _ref;
   let adjustedWidth = width;
   let marginLeft = 0;
   if (enablePeeking) {
     const isFirst = elementIndex === 0;
-    adjustedWidth = width - (peekingMiddleSpace * 2 + peekingGap * 2);
+    const baseWidth = maxWidth || width;
+    adjustedWidth = baseWidth - peekingMiddleSpace * 2;
     if (isFirst) {
-      marginLeft = peekingMarginLeft;
+      marginLeft = peekingMiddleSpace + (viewportWidth - maxWidth) / 2;
     } else {
       marginLeft = peekingGap;
     }
   }
-
-  // Adjust width and margins for multiple items per slide.
   if (enableDisplayMultipleItemsPerSlide) {
     switch (viewport) {
       case 'xs':
@@ -96,7 +96,9 @@ const CarouselItem = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
     width,
     activeIndex,
     goTo,
-    maximumItemsForSlide
+    maximumItemsForSlide,
+    maxWidth,
+    viewportWidth
   } = (0, _CarouselContext.useCarousel)();
   const selectedProps = selectProps({
     ...rest,
@@ -139,6 +141,8 @@ const CarouselItem = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
       enablePeeking,
       enableDisplayMultipleItemsPerSlide,
       viewport,
+      maxWidth,
+      viewportWidth,
       ...peekingProps
     }),
     ...selectedProps,

package/lib/cjs/Carousel/Constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TRANSITION_MODES = exports.SWIPE_RELEASE_STYLES = exports.PEEKING_MULTIPLIER = exports.NEGATIVE_MULTIPLIER = exports.LARGE_VIEWPORT_MARGIN = exports.ITEMS_PER_VIEWPORT_XS_SM = exports.ITEMS_PER_VIEWPORT_MD = exports.ITEMS_PER_VIEWPORT_LG_XL = exports.INSTANT_ANIMATION_DURATION = exports.HERO_POSITION_OFFSET = exports.GAP_BETWEEN_ITEMS = exports.DEFAULT_VIEWPORT_MARGIN = exports.DEFAULT_SWIPE_RELEASE_DURATION = exports.DEFAULT_POSITION_OFFSET = exports.ACTIVE_INDEX_OFFSET_MULTIPLIER = void 0;
+exports.TRANSITION_MODES = exports.SWIPE_RELEASE_STYLES = exports.POSITION_VARIANTS = exports.POSITION_PROPERTIES = exports.PEEKING_MULTIPLIER = exports.NEGATIVE_MULTIPLIER = exports.LARGE_VIEWPORT_MARGIN = exports.ITEMS_PER_VIEWPORT_XS_SM = exports.ITEMS_PER_VIEWPORT_MD = exports.ITEMS_PER_VIEWPORT_LG_XL = exports.INSTANT_ANIMATION_DURATION = exports.HERO_POSITION_OFFSET = exports.GAP_BETWEEN_ITEMS = exports.DEFAULT_VIEWPORT_MARGIN = exports.DEFAULT_SWIPE_RELEASE_DURATION = exports.DEFAULT_POSITION_OFFSET = exports.ACTIVE_INDEX_OFFSET_MULTIPLIER = void 0;
 const ITEMS_PER_VIEWPORT_XS_SM = exports.ITEMS_PER_VIEWPORT_XS_SM = 1;
 const ITEMS_PER_VIEWPORT_MD = exports.ITEMS_PER_VIEWPORT_MD = 2;
 const ITEMS_PER_VIEWPORT_LG_XL = exports.ITEMS_PER_VIEWPORT_LG_XL = 3;
@@ -25,4 +25,13 @@ const SWIPE_RELEASE_STYLES = exports.SWIPE_RELEASE_STYLES = {
   EASE_OUT: 'ease-out'
 };
 const INSTANT_ANIMATION_DURATION = exports.INSTANT_ANIMATION_DURATION = 1;
-const DEFAULT_SWIPE_RELEASE_DURATION = exports.DEFAULT_SWIPE_RELEASE_DURATION = 500;
+const DEFAULT_SWIPE_RELEASE_DURATION = exports.DEFAULT_SWIPE_RELEASE_DURATION = 500;
+const POSITION_VARIANTS = exports.POSITION_VARIANTS = {
+  EDGE: 'edge',
+  INSIDE: 'inside',
+  OUTSIDE: 'outside'
+};
+const POSITION_PROPERTIES = exports.POSITION_PROPERTIES = {
+  LEFT: 'left',
+  RIGHT: 'right'
+};

package/lib/cjs/Checkbox/Checkbox.js

@@ -121,6 +121,32 @@ const selectFeedbackTokens = _ref5 => {
     feedbackMarginTop
   };
 };
+const selectPressableStyles = _ref6 => {
+  let {
+    padding,
+    paddingLeft,
+    paddingRight,
+    paddingTop,
+    paddingBottom
+  } = _ref6;
+  return {
+    padding,
+    paddingLeft,
+    paddingRight,
+    paddingTop,
+    paddingBottom
+  };
+};
+const selectContainerStyles = _ref7 => {
+  let {
+    iconContainerHeight,
+    iconContainerWidth
+  } = _ref7;
+  return {
+    height: iconContainerHeight,
+    width: iconContainerWidth
+  };
+};
 
 /**
  * Basic Checkbox component.
@@ -157,7 +183,7 @@ const selectFeedbackTokens = _ref5 => {
  * or the internal state in case of uncontrolled checkbox.
  *
  */
-const Checkbox = /*#__PURE__*/_react.default.forwardRef((_ref6, ref) => {
+const Checkbox = /*#__PURE__*/_react.default.forwardRef((_ref8, ref) => {
   let {
     checked,
     defaultChecked,
@@ -172,8 +198,9 @@ const Checkbox = /*#__PURE__*/_react.default.forwardRef((_ref6, ref) => {
     tokens,
     value,
     variant,
+    testID,
     ...rest
-  } = _ref6;
+  } = _ref8;
   const {
     currentValue: isChecked,
     setValue: setIsChecked,
@@ -230,17 +257,18 @@ const Checkbox = /*#__PURE__*/_react.default.forwardRef((_ref6, ref) => {
       direction: feedbackPosition === 'top' ? 'column-reverse' : 'column',
       space: 0,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
+        testID: testID && `${testID}-pressable`,
         disabled: inactive,
         onKeyDown: handleKeyDown,
         onPress: handleChange,
         ...selectedProps,
-        style: staticStyles.removeOutline,
-        children: _ref7 => {
+        style: [staticStyles.removeOutline, selectPressableStyles(defaultTokens)],
+        children: _ref9 => {
           let {
             focused: focus,
             hovered: hover,
             pressed
-          } = _ref7;
+          } = _ref9;
           const {
             icon: IconComponent,
             ...stateTokens
@@ -251,15 +279,12 @@ const Checkbox = /*#__PURE__*/_react.default.forwardRef((_ref6, ref) => {
           });
           const iconTokens = selectIconTokens(stateTokens);
           const labelStyles = selectLabelStyles(stateTokens, themeOptions);
-          const alignWithLabel = label ? [staticStyles.alignWithLabel, {
-            height: labelStyles.lineHeight
-          }] : null;
           return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_StackView.default, {
             space: 0,
             children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
               style: staticStyles.container,
               children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-                style: alignWithLabel,
+                style: [staticStyles.iconContainer, selectContainerStyles(stateTokens)],
                 children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
                   style: [staticStyles.defaultInputStyles, selectInputStyles(stateTokens, isChecked)],
                   testID: "Checkbox-Input",
@@ -358,7 +383,11 @@ Checkbox.propTypes = {
   /**
    * An optional Checkbox description.
    */
-  description: _propTypes.default.string
+  description: _propTypes.default.string,
+  /**
+   * A identifier for testing purposes.
+   */
+  testID: _propTypes.default.string
 };
 var _default = exports.default = Checkbox;
 const staticStyles = _StyleSheet.default.create({
@@ -373,9 +402,10 @@ const staticStyles = _StyleSheet.default.create({
     alignItems: 'center',
     justifyContent: 'center'
   },
-  alignWithLabel: {
-    alignSelf: 'flex-start',
-    justifyContent: 'center'
+  iconContainer: {
+    display: 'flex',
+    justifyContent: 'center',
+    alignItems: 'center'
   },
   removeOutline: {
     outlineStyle: 'none'

package/lib/cjs/List/List.js

@@ -13,10 +13,15 @@ var _utils = require("../utils");
 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.viewProps]);
+const LIST_ITEM_TYPE = 'ListItem';
+const LINKS_ITEM_TYPE = 'LinksItem';
 const isListItem = element => {
-  const elementName = element?.type?.displayName || element?.type?.name;
-  // Match our own ListItem, and also, custom list items
-  return Boolean(elementName.match(/Item/));
+  if (!element?.type) return false;
+  if (element.type.__UDS_COMPONENT_TYPE__ === LIST_ITEM_TYPE) {
+    return true;
+  }
+  const elementName = element.type.displayName || element.type.name || '';
+  return elementName === LIST_ITEM_TYPE || elementName.includes(LIST_ITEM_TYPE) || elementName.includes(LINKS_ITEM_TYPE);
 };
 
 /**
@@ -29,6 +34,7 @@ const List = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
     showDivider,
     tokens,
     variant,
+    iconVerticalAlign,
     accessibilityRole = _Platform.default.select({
       web: 'list',
       default: undefined
@@ -38,13 +44,17 @@ const List = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
   const items = _react.default.Children.map(children, (child, index) => {
     // Pass ListItem-specific props to children (by name so teams can add their own ListItems)
     if (isListItem(child)) {
-      return /*#__PURE__*/_react.default.cloneElement(child, {
-        showDivider,
-        isLastItem: index + 1 === _react.default.Children.count(children),
+      const childProps = {
         tokens,
         variant,
-        ...child.props
-      });
+        ...child.props,
+        showDivider,
+        isLastItem: index + 1 === _react.default.Children.count(children)
+      };
+      if (!child.props.iconVerticalAlign && iconVerticalAlign) {
+        childProps.iconVerticalAlign = iconVerticalAlign;
+      }
+      return /*#__PURE__*/_react.default.cloneElement(child, childProps);
     }
     return child;
   });
@@ -78,6 +88,11 @@ List.propTypes = {
   /**
    * In case it is not the last item allow display divider
    */
-  showDivider: _propTypes.default.bool
+  showDivider: _propTypes.default.bool,
+  /**
+   * The vertical alignment of the icon in ListItems.
+   * This prop is passed down to ListItem components and can be overridden in individual List.Item components.
+   */
+  iconVerticalAlign: _propTypes.default.oneOf(['top', 'center', 'bottom'])
 };
 var _default = exports.default = List;

package/lib/cjs/List/ListItem.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
 var _ListItemBase = _interopRequireDefault(require("./ListItemBase"));
 var _ThemeProvider = require("../ThemeProvider");
 var _utils = require("../utils");
@@ -18,6 +19,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
     variant,
     children,
     title,
+    iconVerticalAlign = 'top',
     ...listItemProps
   } = _ref;
   const themeTokens = (0, _ThemeProvider.useThemeTokens)('List', tokens, variant);
@@ -26,12 +28,27 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
     ref: ref,
     ...listItemProps,
     title: title,
+    iconVerticalAlign: iconVerticalAlign,
     children: children
   });
 });
 ListItem.displayName = 'ListItem';
 ListItem.propTypes = {
+  /** Theme tokens for styling */
+  tokens: (0, _utils.getTokensPropType)('List'),
+  /** Variant configuration for the component */
   variant: _utils.variantProp.propType,
-  ..._ListItemBase.default.propTypes
+  /** Content to be rendered within the list item */
+  children: _propTypes.default.oneOfType([_propTypes.default.node, _propTypes.default.func]).isRequired,
+  /** Title of the list item */
+  title: _propTypes.default.node,
+  /** Controls the vertical alignment of the icon */
+  iconVerticalAlign: _propTypes.default.oneOf(['top', 'center', 'bottom']),
+  /** Icon to be displayed */
+  icon: _propTypes.default.elementType,
+  /** Color of the icon */
+  iconColor: _propTypes.default.string,
+  /** Size of the icon */
+  iconSize: _propTypes.default.number
 };
 var _default = exports.default = ListItem;