@telus-uds/components-base 3.29.1 → 3.31.0

package/lib/esm/Scroll/index.js

@@ -0,0 +1,4 @@
+import Scroll from './Scroll';
+export default Scroll;
+export { default as ScrollItem } from './ScrollItem';
+export { ScrollProvider, useScroll } from './ScrollContext';

package/lib/esm/TextInput/TextInputBase.js

@@ -272,7 +272,8 @@ const TextInputBase = /*#__PURE__*/React.forwardRef((_ref8, ref) => {
   }, [element, pattern]);
   const handleChangeText = event => {
     const text = event.nativeEvent?.text ?? event.target?.value;
-    let filteredText = isNumeric ? text?.replace(/[^\d]/g, '') || undefined : text;
+    // Do NOT use `|| undefined`: empty string is falsy and would break the controlled contract
+    let filteredText = isNumeric ? text?.replace(/[^\d]/g, '') ?? '' : text;
     if (type === 'card' && filteredText) {
       const formattedValue = filteredText.replace(/[^a-zA-Z0-9]/g, '');
       const regex = new RegExp(`([a-zA-Z0-9]{4})(?=[a-zA-Z0-9])`, 'g');

package/lib/esm/index.js

@@ -45,6 +45,7 @@ export { default as QuickLinksFeature } from './QuickLinksFeature';
 export { default as Radio, RadioGroup } from './Radio';
 export { default as RadioCard, RadioCardGroup } from './RadioCard';
 export { default as Responsive } from './Responsive';
+export { default as Scroll, ScrollItem } from './Scroll';
 export { default as Search } from './Search';
 export { default as Select } from './Select';
 export { default as Shortcuts, ShortcutsItem } from './Shortcuts';

package/lib/esm/utils/animation/index.js

@@ -1,2 +1,2 @@
-/* eslint-disable import/prefer-default-export */
+export { default as useAnimatedValue } from './useAnimatedValue';
 export { default as useVerticalExpandAnimation } from './useVerticalExpandAnimation';

package/lib/esm/utils/animation/useAnimatedValue.js

@@ -0,0 +1,39 @@
+import React from 'react';
+import Animated from "react-native-web/dist/exports/Animated";
+import Easing from "react-native-web/dist/exports/Easing";
+const ANIMATION_DURATION = 200;
+
+/**
+ * Smoothly animates a numeric value to a new target using a quadratic ease-in-out
+ * curve. Returns the current interpolated value as a plain number so
+ * consumers can use it in non-Animated style props.
+ *
+ * @param {number} targetValue - The value to animate towards.
+ * @param {number} [duration=ANIMATION_DURATION] - Animation duration in ms.
+ */
+const useAnimatedValue = function (targetValue) {
+  let duration = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ANIMATION_DURATION;
+  const [currentValue, setCurrentValue] = React.useState(targetValue);
+  const animatedValue = React.useRef(new Animated.Value(targetValue)).current;
+  React.useEffect(() => {
+    const id = animatedValue.addListener(_ref => {
+      let {
+        value
+      } = _ref;
+      return setCurrentValue(value);
+    });
+    return () => animatedValue.removeListener(id);
+  }, [animatedValue]);
+  React.useEffect(() => {
+    const animation = Animated.timing(animatedValue, {
+      toValue: targetValue,
+      duration,
+      easing: Easing.inOut(Easing.quad),
+      useNativeDriver: false
+    });
+    animation.start();
+    return () => animation.stop();
+  }, [targetValue, animatedValue, duration]);
+  return currentValue;
+};
+export default useAnimatedValue;

package/lib/esm/utils/children.js

@@ -47,7 +47,8 @@ export const unpackFragment = child => {
 };
 const isStringOrNumber = child => typeof child === 'string' || typeof child === 'number';
 // Wrap an A11yText with neighouring text strings so it doesn't split them into multiple <Text>s
-const isWrapable = child => isStringOrNumber(child) || child.type === A11yText || child.type?.name === 'FootnoteLink';
+// Check displayName first as it is explicitly set and reliable regardless of export style (named vs default)
+const isWrapable = child => isStringOrNumber(child) || child.type === A11yText || child.type?.__UDS_COMPONENT_NAME__ === 'FootnoteLink';
 const combineKeys = childrenArray => childrenArray.reduce((newKey, child) => `${newKey}${child.key || ''}`, '');
 
 // Group wrappable children for one `<Text>` parent, merging adjacent text nodes

package/lib/esm/utils/useOverlaidPosition.js

@@ -54,46 +54,45 @@ function getOverlaidPosition(_ref2) {
     offsets = {},
     align
   } = _ref2;
-  // Web-only: this will be difficult to mimic on native because there's no global scroll position.
-  // TODO: wire something in e.g. a scroll ref accessible from a provider included in Allium provider
-  // that can be passed to the appropriate ScrollView?
-  const {
-    scrollX = 0,
-    scrollY = 0
-  } = typeof window === 'object' ? window : {};
-
   // Will have top, bottom, left and/or right offsets depending on `align`
   const positioning = {};
   const verticalOffset = offsets.vertical ?? 0;
   const horizontalOffset = offsets.horizontal ?? 0;
   if (align.top) positioning.top = getPosition({
     edge: getEdgeType(align, 'top'),
-    fromEdge: sourceLayout.y + scrollY + verticalOffset,
+    fromEdge: sourceLayout.y + verticalOffset,
     sourceSize: sourceLayout.height
   });
   if (align.middle) positioning.top = getPosition({
     edge: getEdgeType(align, 'middle'),
-    fromEdge: sourceLayout.y + scrollY + verticalOffset - targetDimensions.height / 2,
-    sourceSize: sourceLayout.height
-  });
-  if (align.bottom) positioning.bottom = getPosition({
-    edge: getEdgeType(align, 'bottom'),
-    fromEdge: windowDimensions.height - (sourceLayout.y + scrollY + sourceLayout.height - verticalOffset),
+    fromEdge: sourceLayout.y + verticalOffset - targetDimensions.height / 2,
     sourceSize: sourceLayout.height
   });
+  if (align.bottom) {
+    if (Platform.OS !== 'web') {
+      // On native, position:absolute is parent-relative, so use negative top offset instead of window-based bottom math.
+      positioning.top = sourceLayout.y - targetDimensions.height - verticalOffset;
+    } else {
+      positioning.bottom = getPosition({
+        edge: getEdgeType(align, 'bottom'),
+        fromEdge: windowDimensions.height - (sourceLayout.y + sourceLayout.height - verticalOffset),
+        sourceSize: sourceLayout.height
+      });
+    }
+  }
   if (align.left) positioning.left = getPosition({
     edge: getEdgeType(align, 'left'),
-    fromEdge: sourceLayout.x + scrollX + horizontalOffset,
+    fromEdge: sourceLayout.x + horizontalOffset,
     sourceSize: sourceLayout.width
   });
   if (align.center) positioning.left = getPosition({
     edge: getEdgeType(align, 'center'),
-    fromEdge: sourceLayout.x + scrollX + horizontalOffset - targetDimensions.width / 2,
+    fromEdge: sourceLayout.x + horizontalOffset - targetDimensions.width / 2,
     sourceSize: sourceLayout.width
   });
   if (align.right) positioning.right = getPosition({
     edge: getEdgeType(align, 'right'),
-    fromEdge: windowDimensions.width - (sourceLayout.x + scrollX + sourceLayout.width - horizontalOffset),
+    fromEdge: windowDimensions.width - (sourceLayout.x + sourceLayout.width - horizontalOffset),
     sourceSize: sourceLayout.width
   });
   if (!(align.left && align.right)) {
@@ -134,6 +133,32 @@ const useOverlaidPosition = _ref3 => {
   const targetRef = useRef(null);
   const [targetDimensions, setTargetDimensions] = useState(null);
   const [windowDimensions, setWindowDimensions] = useState(null);
+  const hasRemeasuredRef = useRef(false);
+  const applySourceLayout = useCallback((dims, x, y, width, height) => {
+    setWindowDimensions(dims);
+    setSourceLayout({
+      x,
+      y,
+      width,
+      height
+    });
+  }, []);
+  const measureSourceOnWeb = useCallback(windowDims => {
+    const el = sourceRef.current;
+    if (!el) return;
+    const domNode = el._nativeTag ?? el;
+    const dims = windowDims ?? Dimensions.get('window');
+    const rect = typeof domNode.getBoundingClientRect === 'function' ? domNode.getBoundingClientRect() : null;
+    if (rect) {
+      const x = rect.left + (typeof window.scrollX === 'number' ? window.scrollX : 0);
+      const y = rect.top + (typeof window.scrollY === 'number' ? window.scrollY : 0);
+      applySourceLayout(dims, x, y, rect.width, rect.height);
+    } else {
+      el.measureInWindow((mx, my, width, height) => {
+        applySourceLayout(dims, mx, my, width, height);
+      });
+    }
+  }, [applySourceLayout]);
   const onTargetLayout = useCallback(_ref4 => {
     let {
       nativeEvent: {
@@ -164,16 +189,19 @@ const useOverlaidPosition = _ref3 => {
       let {
         window
       } = _ref5;
-      const measurementFunction = Platform.OS === 'web' ? 'measureInWindow' : 'measure';
-      sourceRef.current?.[measurementFunction]((x, y, width, height) => {
-        setWindowDimensions(window);
-        setSourceLayout({
-          x,
-          y,
-          width,
-          height
+      if (Platform.OS === 'web') {
+        measureSourceOnWeb(window);
+      } else {
+        sourceRef.current?.measure((x, y, width, height) => {
+          setWindowDimensions(window);
+          setSourceLayout({
+            x,
+            y,
+            width,
+            height
+          });
         });
-      });
+      }
     };
     let subscription;
     const unsubscribe = () => {
@@ -186,6 +214,7 @@ const useOverlaidPosition = _ref3 => {
       }
       setSourceLayout(null);
       setTargetDimensions(null);
+      hasRemeasuredRef.current = false;
     };
     if (readyToShow) {
       subscription = Dimensions.addEventListener('change', handleDimensionsChange);
@@ -196,36 +225,48 @@ const useOverlaidPosition = _ref3 => {
       unsubscribe();
     }
     return unsubscribe;
-  }, [readyToShow]);
+  }, [readyToShow, measureSourceOnWeb]);
+
+  // Re-measure source when targetDimensions first becomes available.
+  // Without this, there is a race condition: getBoundingClientRect() resolves faster than
+  // measureInWindow used to, so sourceLayout may be set before the dropdown has rendered
+  // and reported its dimensions via onTargetLayout. When targetDimensions finally arrives,
+  // sourceLayout is stale (no scroll has occurred to trigger handleScroll).
+  // Setting hasRemeasuredRef.current=true here also prevents the blink: isReady (on web)
+  // won't become true until this effect completes, guaranteeing the dropdown is always shown
+  // at its final correct position without an intermediate incorrect-position frame.
+  useEffect(() => {
+    if (!isShown || !sourceRef.current || !targetDimensions || Platform.OS !== 'web') return;
+    measureSourceOnWeb();
+    hasRemeasuredRef.current = true;
+  }, [targetDimensions, isShown, measureSourceOnWeb]);
   useEffect(() => {
     if (Platform.OS !== 'web') {
       return undefined;
     }
-    const handleScroll = debounce(() => {
-      sourceRef.current?.measureInWindow((x, y, width, height) => {
-        setWindowDimensions(window);
-        setSourceLayout({
-          x,
-          y,
-          width,
-          height
-        });
-      });
-    }, DEBOUNCE_DELAY);
+    const handleScroll = debounce(measureSourceOnWeb, DEBOUNCE_DELAY);
     window.addEventListener('scroll', handleScroll);
     return () => {
       window.removeEventListener('scroll', handleScroll);
       handleScroll.cancel();
     };
-  }, [sourceRef]);
-  const isReady = Boolean(isShown && sourceLayout && windowDimensions && targetDimensions);
+  }, [measureSourceOnWeb]);
+
+  // On web, require hasRemeasuredRef to be true before declaring isReady. This ensures
+  // the dropdown is never shown with an intermediate stale position (the blink).
+  // On native, hasRemeasuredRef stays false (the web-only effect never runs), so we skip
+  // that check to preserve the original native behaviour.
+  const isReady = Boolean(isShown && sourceLayout && windowDimensions && targetDimensions && (Platform.OS !== 'web' || hasRemeasuredRef.current));
   const overlaidPosition = isReady ? getOverlaidPosition({
     sourceLayout,
     targetDimensions,
     windowDimensions,
     offsets,
     align
-  }) : {};
+  }) : {
+    top: 0,
+    left: 0
+  };
   return {
     overlaidPosition,
     sourceRef,

package/lib/package.json

@@ -12,7 +12,7 @@
     "@gorhom/portal": "^1.0.14",
     "@react-native-picker/picker": "^2.9.0",
     "@telus-uds/system-constants": "^3.0.0",
-    "@telus-uds/system-theme-tokens": "^4.20.0",
+    "@telus-uds/system-theme-tokens": "^4.21.0",
     "airbnb-prop-types": "^2.16.0",
     "css-mediaquery": "^0.1.2",
     "expo-document-picker": "^13.0.1",
@@ -84,6 +84,6 @@
   "standard-engine": {
     "skip": true
   },
-  "version": "3.29.1",
+  "version": "3.31.0",
   "types": "types/index.d.ts"
 }

package/package.json

@@ -12,7 +12,7 @@
     "@gorhom/portal": "^1.0.14",
     "@react-native-picker/picker": "^2.9.0",
     "@telus-uds/system-constants": "^3.0.0",
-    "@telus-uds/system-theme-tokens": "^4.20.0",
+    "@telus-uds/system-theme-tokens": "^4.21.0",
     "airbnb-prop-types": "^2.16.0",
     "css-mediaquery": "^0.1.2",
     "expo-document-picker": "^13.0.1",
@@ -84,6 +84,6 @@
   "standard-engine": {
     "skip": true
   },
-  "version": "3.29.1",
+  "version": "3.31.0",
   "types": "types/index.d.ts"
 }

package/src/Autocomplete/Autocomplete.jsx

@@ -131,6 +131,7 @@ const Autocomplete = React.forwardRef(
       value,
       helpText = '',
       loadingLabel,
+      dropdownPosition = 'bottom',
       tokens,
       ...rest
     },
@@ -182,7 +183,11 @@ const Autocomplete = React.forwardRef(
       isShown: isExpanded || hintExpansionEnabled,
       offsets: {
         vertical: Platform.OS !== 'web' && (hint || inputLabel) ? 28 : 4
-      }
+      },
+      align:
+        dropdownPosition === 'top'
+          ? { center: 'center', bottom: 'top' }
+          : { center: 'center', top: 'bottom' }
     })
     const targetRef = React.useRef(null)
     // We limit the number of suggestions displayed to avoid huge lists
@@ -556,7 +561,11 @@ Autocomplete.propTypes = {
   /**
    * Input value for controlled usage
    */
-  value: PropTypes.string
+  value: PropTypes.string,
+  /**
+   * Controls whether the dropdown renders above or below the input. Defaults to 'bottom'.
+   */
+  dropdownPosition: PropTypes.oneOf(['top', 'bottom'])
 }
 
 export default Autocomplete

package/src/Autocomplete/constants.js

@@ -1,5 +1,5 @@
 export const DEFAULT_MIN_TO_SUGGESTION = 1
 export const DEFAULT_MAX_SUGGESTIONS = 5
-export const DEFAULT_MAX_DROPDOWN_HEIGHT = 336 // Approximately 7 items (48px each)
+export const DEFAULT_MAX_DROPDOWN_HEIGHT = 500
 export const INPUT_LEFT_PADDING = 16
 export const MIN_LISTBOX_WIDTH = 288

package/src/Carousel/Carousel.jsx

@@ -1403,9 +1403,14 @@ Carousel.propTypes = {
    */
   thumbnails: PropTypes.arrayOf(
     PropTypes.shape({
+      /** Accessibility label for the thumbnail image, used by assistive technologies. */
       accessibilityLabel: PropTypes.string,
+      /** Alternative text for the thumbnail image, displayed when the image cannot be rendered. */
       alt: PropTypes.string,
-      src: PropTypes.string
+      /** When true, renders a play icon overlay on the thumbnail to indicate that the slide contains a video. */
+      isVideo: PropTypes.bool,
+      /** URL or path of the thumbnail image. When used with `isVideo`, this should be the video's poster/preview image. */
+      src: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
     })
   ),
   /**

package/src/Carousel/CarouselThumbnail.jsx

@@ -1,9 +1,10 @@
 import React from 'react'
 import PropTypes from 'prop-types'
-import { Pressable, Image } from 'react-native'
+import { StyleSheet, Pressable, Image, View } from 'react-native'
 import { useCarousel } from './CarouselContext'
 import { useThemeTokensCallback } from '../ThemeProvider'
 import { useViewport } from '../ViewportProvider'
+import Icon from '../Icon'
 
 const selectPressableTokens = ({ borderColor, borderRadius, borderWidth, margin, padding }) => ({
   borderColor,
@@ -13,83 +14,171 @@ const selectPressableTokens = ({ borderColor, borderRadius, borderWidth, margin,
   padding
 })
 
+// Play icon overlay appearance is consistent across all brands and is not theme-configurable.
+// The circle occupies 55% of the thumbnail size, and the icon occupies 55% of the circle diameter.
+const PLAY_ICON_RATIO = 0.55
+const PLAY_ICON_BORDER_RADIUS_DIVISOR = 2
+
+const selectImageStyles = (size) => ({
+  width: size,
+  height: size
+})
+
+const selectSelectedStyles = ({ selectedBorderColor, selectedBorderWidth, padding, margin }) => ({
+  borderColor: selectedBorderColor,
+  borderWidth: selectedBorderWidth,
+  padding: padding - selectedBorderWidth,
+  marginBottom: margin + selectedBorderWidth
+})
+
+const selectNonSelectedStyles = ({ borderWidth, padding, margin, selectedBorderWidth }) => ({
+  padding: padding - borderWidth,
+  marginBottom: margin + selectedBorderWidth
+})
+
+const selectPlayIconCircleStyles = (thumbnailSize) => {
+  const diameter = thumbnailSize * PLAY_ICON_RATIO
+  return {
+    width: diameter,
+    height: diameter,
+    borderRadius: diameter / PLAY_ICON_BORDER_RADIUS_DIVISOR
+  }
+}
+
+const selectPlayIconTokens = (thumbnailSize) => ({
+  size: thumbnailSize * PLAY_ICON_RATIO * PLAY_ICON_RATIO
+})
+
 /**
  * `Carousel.Thumbnail` is used to wrap the content of an individual slide and is suppsoed to be the
  * only top-level component passed to the `Carousel`
  */
-const CarouselThumbnail = React.forwardRef(({ accessibilityLabel, alt, index, src }, ref) => {
-  const { activeIndex, itemLabel, totalItems, getCopyWithPlaceholders, goTo } = useCarousel()
-  const getThumbnailTokens = useThemeTokensCallback('CarouselThumbnail')
-  const viewport = useViewport()
-  const thumbnailTitle =
-    alt ??
-    getCopyWithPlaceholders('stepTrackerLabel')
-      .replace(/%\{itemLabel\}/g, itemLabel)
-      .replace(/%\{stepNumber\}/g, index)
-      .replace(/%\{stepCount\}/g, totalItems)
-  const handlePress = () => goTo(index)
-  const handleKeyDown = (event) => {
-    // Allow using the spacebar for navigation
-    if (event?.key === ' ') goTo(index)
-  }
-  const { borderWidth, padding, selectedBorderColor, selectedBorderWidth, size, margin } =
-    getThumbnailTokens({ viewport })
-  const styles = {
-    image: {
-      height: size,
-      width: size
-    },
-    selected: {
-      borderColor: selectedBorderColor,
-      borderWidth: selectedBorderWidth,
-      padding: padding - selectedBorderWidth,
-      marginBottom: margin + selectedBorderWidth
-    },
-    nonSelected: {
-      padding: padding - borderWidth,
-      marginBottom: margin + selectedBorderWidth
+const CarouselThumbnail = React.forwardRef(
+  ({ accessibilityLabel, alt, index, isVideo, src }, ref) => {
+    const { activeIndex, itemLabel, totalItems, getCopyWithPlaceholders, goTo } = useCarousel()
+    const getThumbnailTokens = useThemeTokensCallback('CarouselThumbnail')
+    const viewport = useViewport()
+    const thumbnailTitle =
+      alt ??
+      getCopyWithPlaceholders('stepTrackerLabel')
+        .replace(/%\{itemLabel\}/g, itemLabel)
+        .replace(/%\{stepNumber\}/g, index)
+        .replace(/%\{stepCount\}/g, totalItems)
+    const handlePress = () => goTo(index)
+    const handleKeyDown = (event) => {
+      // Allow using the spacebar for navigation
+      if (event?.key === ' ') goTo(index)
     }
-  }
+    const {
+      borderWidth,
+      padding,
+      selectedBorderColor,
+      selectedBorderWidth,
+      size,
+      margin,
+      playIcon
+    } = getThumbnailTokens({ viewport })
 
-  return (
-    <Pressable
-      key={src}
-      onKeyDown={handleKeyDown}
-      onPress={handlePress}
-      style={({ hovered, pressed, focused }) => {
-        const pressableStyles = selectPressableTokens(
-          getThumbnailTokens({
-            hover: hovered,
-            pressed,
-            focus: focused
-          })
-        )
+    return (
+      <Pressable
+        key={src}
+        onKeyDown={handleKeyDown}
+        onPress={handlePress}
+        style={({ hovered, pressed, focused }) => {
+          const pressableStyles = selectPressableTokens(
+            getThumbnailTokens({
+              hover: hovered,
+              pressed,
+              focus: focused
+            })
+          )
 
-        return [
-          pressableStyles,
-          index === activeIndex ? [styles.selected, { outline: 'none' }] : styles.nonSelected
-        ]
-      }}
-      ref={ref}
-    >
-      <Image
-        accessibilityIgnoresInvertColors
-        accessibilityLabel={accessibilityLabel ?? alt}
-        source={src}
-        style={styles.image}
-        title={thumbnailTitle}
-      />
-    </Pressable>
-  )
-})
+          return [
+            pressableStyles,
+            index === activeIndex
+              ? [
+                  selectSelectedStyles({
+                    selectedBorderColor,
+                    selectedBorderWidth,
+                    padding,
+                    margin
+                  }),
+                  staticStyles.selectedPressableOutline
+                ]
+              : selectNonSelectedStyles({ borderWidth, padding, margin, selectedBorderWidth })
+          ]
+        }}
+        ref={ref}
+      >
+        <View style={[staticStyles.imageContainer, selectImageStyles(size)]}>
+          <Image
+            accessibilityIgnoresInvertColors
+            accessibilityLabel={accessibilityLabel ?? alt}
+            source={src}
+            style={selectImageStyles(size)}
+            title={thumbnailTitle}
+          />
+          {isVideo && playIcon && (
+            <View
+              style={staticStyles.playIconOverlayContainer}
+              testID={`play-icon-overlay-${index}`}
+            >
+              <View
+                style={[selectPlayIconCircleStyles(size), staticStyles.playIconCircleBackground]}
+              >
+                <Icon
+                  icon={playIcon}
+                  tokens={{
+                    ...selectPlayIconTokens(size),
+                    color: staticStyles.playIconSymbol.color
+                  }}
+                />
+              </View>
+            </View>
+          )}
+        </View>
+      </Pressable>
+    )
+  }
+)
 
 CarouselThumbnail.displayName = 'CarouselThumbnail'
 
 CarouselThumbnail.propTypes = {
+  /** Accessibility label for screen readers, overrides the alt text */
   accessibilityLabel: PropTypes.string,
+  /** Alt text for the thumbnail image */
   alt: PropTypes.string,
+  /** Zero-based index of this thumbnail within the carousel */
   index: PropTypes.number,
-  src: PropTypes.string
+  /**
+   * When true, renders a play icon overlay on the thumbnail to indicate that the slide contains a video.
+   */
+  isVideo: PropTypes.bool,
+  /** Image source URI (web) or local asset require() (native) */
+  src: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
 }
 
+const staticStyles = StyleSheet.create({
+  imageContainer: {
+    position: 'relative'
+  },
+  playIconOverlayContainer: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    right: 0,
+    bottom: 0,
+    justifyContent: 'center',
+    alignItems: 'center'
+  },
+  selectedPressableOutline: { outlineStyle: 'none' },
+  playIconCircleBackground: {
+    backgroundColor: 'rgba(0, 0, 0, 0.6)',
+    justifyContent: 'center',
+    alignItems: 'center'
+  },
+  playIconSymbol: { color: 'rgb(255, 255, 255)' }
+})
+
 export default CarouselThumbnail

package/src/Carousel/CarouselThumbnailNavigation.jsx

@@ -27,11 +27,12 @@ const CarouselThumbnailNavigation = React.forwardRef(({ thumbnails = [] }, ref)
   return (
     <View style={containerStyles}>
       <StackWrap direction="row" tokens={stackWrapTokens} space={2} ref={ref}>
-        {thumbnails.map(({ accessibilityLabel, alt, src }, index) => (
+        {thumbnails.map(({ accessibilityLabel, alt, isVideo, src }, index) => (
           <CarouselThumbnail
             accessibilityLabel={accessibilityLabel}
             alt={alt}
             index={index}
+            isVideo={isVideo}
             key={src}
             src={src}
           />
@@ -47,9 +48,14 @@ CarouselThumbnailNavigation.propTypes = {
    */
   thumbnails: PropTypes.arrayOf(
     PropTypes.shape({
+      /** Accessibility label for the thumbnail image, used by assistive technologies. */
       accessibilityLabel: PropTypes.string,
+      /** Alternative text for the thumbnail image, displayed when the image cannot be rendered. */
       alt: PropTypes.string,
-      src: PropTypes.string
+      /** When true, renders a play icon overlay on the thumbnail to indicate that the slide contains a video. */
+      isVideo: PropTypes.bool,
+      /** URL or path of the thumbnail image. When used with `isVideo`, this should be the video's poster/preview image. */
+      src: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
     })
   ).isRequired
 }