@telus-uds/components-base 1.10.0 → 1.12.1

package/lib/Button/ButtonBase.js

@@ -17,11 +17,11 @@ var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/expo
 
 var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
 
-var _utils = require("../ThemeProvider/utils");
+var _ThemeProvider = require("../ThemeProvider");
 
 var _propTypes2 = _interopRequireDefault(require("./propTypes"));
 
-var _utils2 = require("../utils");
+var _utils = require("../utils");
 
 var _jsxRuntime = require("react/jsx-runtime");
 
@@ -31,7 +31,7 @@ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "functio
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
-const [selectProps, selectedSystemPropTypes] = (0, _utils2.selectSystemProps)([_utils2.a11yProps, _utils2.focusHandlerProps, _utils2.linkProps, _utils2.viewProps]);
+const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.focusHandlerProps, _utils.linkProps, _utils.viewProps]);
 
 const getOuterBorderOffset = _ref => {
   let {
@@ -55,7 +55,7 @@ const selectOuterContainerStyles = _ref2 => {
     alignSelf,
     backgroundColor: outerBackgroundColor,
     opacity,
-    ...(0, _utils.applyOuterBorder)({
+    ...(0, _ThemeProvider.applyOuterBorder)({
       outerBorderGap,
       outerBorderWidth,
       outerBorderColor,
@@ -137,7 +137,7 @@ const selectInnerContainerStyles = _ref4 => {
     paddingBottom: offsetBorder(paddingBottom),
     backgroundColor,
     minWidth,
-    ...(0, _utils.applyShadowToken)(shadow)
+    ...(0, _ThemeProvider.applyShadowToken)(shadow)
   };
 };
 
@@ -154,7 +154,7 @@ const selectBorderStyles = _ref5 => {
   };
 };
 
-const selectTextStyles = _ref6 => {
+const selectTextStyles = (_ref6, themeOptions) => {
   let {
     fontSize,
     color,
@@ -163,12 +163,13 @@ const selectTextStyles = _ref6 => {
     fontWeight,
     textAlign
   } = _ref6;
-  return (0, _utils.applyTextStyles)({
+  return (0, _ThemeProvider.applyTextStyles)({
     fontSize,
     color,
     lineHeight,
     fontName,
     fontWeight,
+    themeOptions,
     textAlign
   });
 };
@@ -183,7 +184,7 @@ const selectWebOnlyStyles = (inactive, themeTokens, _ref7) => {
       maxWidth: "calc(100% + ".concat(getOuterBorderOffset(themeTokens) * 2, "px)"),
       outline: 'none',
       // removes the default browser :focus outline
-      ...(0, _utils2.getCursorStyle)(inactive, accessibilityRole)
+      ...(0, _utils.getCursorStyle)(inactive, accessibilityRole)
     },
     default: {}
   });
@@ -206,14 +207,14 @@ const ButtonBase = /*#__PURE__*/(0, _react.forwardRef)((_ref8, ref) => {
   const {
     onPress,
     ...rest
-  } = _utils2.clickProps.toPressProps(rawRest);
+  } = _utils.clickProps.toPressProps(rawRest);
 
   const extraButtonState = {
     inactive,
     selected
   };
 
-  const resolveButtonTokens = pressableState => (0, _utils2.resolvePressableTokens)(tokens, pressableState, extraButtonState);
+  const resolveButtonTokens = pressableState => (0, _utils.resolvePressableTokens)(tokens, pressableState, extraButtonState);
 
   const systemProps = selectProps(rest);
 
@@ -222,10 +223,13 @@ const ButtonBase = /*#__PURE__*/(0, _react.forwardRef)((_ref8, ref) => {
     return [staticStyles.row, selectWebOnlyStyles(inactive, themeTokens, systemProps), selectOuterContainerStyles(themeTokens), selectOuterWidthStyles(themeTokens)];
   };
 
+  const {
+    themeOptions
+  } = (0, _ThemeProvider.useTheme)();
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
     ref: ref,
     href: href,
-    onPress: _utils2.linkProps.handleHref({
+    onPress: _utils.linkProps.handleHref({
       href,
       onPress
     }),
@@ -237,7 +241,7 @@ const ButtonBase = /*#__PURE__*/(0, _react.forwardRef)((_ref8, ref) => {
       const themeTokens = resolveButtonTokens(pressableState);
       const containerStyles = selectInnerContainerStyles(themeTokens);
       const borderStyles = selectBorderStyles(themeTokens);
-      const textStyles = [selectTextStyles(themeTokens), staticStyles.text]; // If the container has a width set, fill it instead of sizing from content.
+      const textStyles = [selectTextStyles(themeTokens, themeOptions), staticStyles.text]; // If the container has a width set, fill it instead of sizing from content.
       // If in future we support text alignments other than center, add here.
 
       const stretchStyles = themeTokens.width ? staticStyles.stretch : staticStyles.align;
@@ -251,7 +255,7 @@ const ButtonBase = /*#__PURE__*/(0, _react.forwardRef)((_ref8, ref) => {
             transition: 'background-color 200ms, border-color 200ms'
           }
         })],
-        children: (0, _utils2.wrapStringsInText)(typeof children === 'function' ? children({ ...(0, _utils2.resolvePressableState)(pressableState, extraButtonState),
+        children: (0, _utils.wrapStringsInText)(typeof children === 'function' ? children({ ...(0, _utils.resolvePressableState)(pressableState, extraButtonState),
           textStyles
         }) : children, {
           style: textStyles
@@ -295,6 +299,6 @@ const staticStyles = _StyleSheet.default.create({
   }
 });
 
-var _default = (0, _utils2.withLinkRouter)(ButtonBase);
+var _default = (0, _utils.withLinkRouter)(ButtonBase);
 
 exports.default = _default;

package/lib/Carousel/Carousel.js

@@ -31,11 +31,11 @@ var _CarouselContext = require("./CarouselContext");
 
 var _CarouselItem = _interopRequireDefault(require("./CarouselItem"));
 
-var _StepTracker = _interopRequireDefault(require("../StepTracker"));
+var _IconButton = _interopRequireDefault(require("../IconButton"));
 
-var _StackView = _interopRequireDefault(require("../StackView"));
+var _CarouselStepTracker = _interopRequireDefault(require("./CarouselStepTracker/CarouselStepTracker"));
 
-var _IconButton = _interopRequireDefault(require("../IconButton"));
+var _dictionary = _interopRequireDefault(require("./dictionary"));
 
 var _jsxRuntime = require("react/jsx-runtime");
 
@@ -52,19 +52,6 @@ const staticStyles = _StyleSheet.default.create({
   }
 });
 
-const staticTokens = {
-  stackView: {
-    justifyContent: 'center'
-  },
-  stepTracker: {
-    showStepLabel: false,
-    showStepTrackerLabel: true,
-    knobCompletedBackgroundColor: 'none',
-    connectorCompletedColor: 'none',
-    connectorColor: 'none'
-  }
-};
-
 const selectContainerStyles = width => ({
   backgroundColor: 'transparent',
   overflow: 'hidden',
@@ -103,14 +90,6 @@ const selectPreviousNextNavigationButtonStyles = (previousNextNavigationButtonWi
   return styles;
 };
 
-const defaultPanelNavigationDictionary = {
-  en: {
-    stepTrackerLabel: 'Showing %{stepNumber} of %{stepCount}'
-  },
-  fr: {
-    stepTrackerLabel: 'Étape %{stepNumber} sur %{stepCount}: %{stepLabel}'
-  }
-};
 const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
 /**
  * Carousel is a general-purpose content slider that can be used to render content in terms of slides.
@@ -172,6 +151,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
     tokens,
     variant,
     children,
+    itemLabel = 'item',
     previousNextNavigationPosition = 'inside',
     previousNextIconSize = 'default',
     minDistanceToCapture = 5,
@@ -180,26 +160,44 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
     onAnimationEnd,
     onIndexChanged,
     springConfig = undefined,
-    onRenderPanelNavigation,
-    panelNavigationTextDictionary = defaultPanelNavigationDictionary,
+    panelNavigation = /*#__PURE__*/(0, _jsxRuntime.jsx)(_CarouselStepTracker.default, {}),
+    tag = 'ul',
     accessibilityRole = 'adjustable',
     accessibilityLabel = 'carousel',
+    copy,
     ...rest
   } = _ref;
   const viewport = (0, _ViewportProvider.useViewport)();
+  const themeTokens = (0, _ThemeProvider.useThemeTokens)('Carousel', tokens, variant, {
+    viewport
+  });
   const {
     previousIcon,
     nextIcon,
     showPreviousNextNavigation,
     showPanelNavigation,
-    spaceBetweenSlideAndPreviousNextNavigation,
-    spaceBetweenSlideAndPanelNavigation
-  } = (0, _ThemeProvider.useThemeTokens)('Carousel', tokens, variant, {
-    viewport
-  });
+    spaceBetweenSlideAndPreviousNextNavigation
+  } = themeTokens;
 
   const [activeIndex, setActiveIndex] = _react.default.useState(0);
 
+  const [isAnimating, setIsAnimating] = _react.default.useState(false);
+
+  const handleAnimationStart = _react.default.useCallback(function () {
+    if (typeof onAnimationStart === 'function') onAnimationStart(...arguments);
+    setIsAnimating(true);
+  }, [onAnimationStart]);
+
+  const handleAnimationEnd = _react.default.useCallback(function () {
+    if (typeof onAnimationEnd === 'function') onAnimationEnd(...arguments);
+    setIsAnimating(false);
+  }, [onAnimationEnd]);
+
+  const getCopy = (0, _utils.useCopy)({
+    dictionary: _dictionary.default,
+    copy
+  });
+
   const childrenArray = _react.default.Children.toArray(children);
 
   const systemProps = selectProps({ ...rest,
@@ -231,9 +229,6 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
 
   const isFirstSlide = !activeIndex;
   const isLastSlide = activeIndex + 1 >= children.length;
-  const panelNavigationTokens = { ...staticTokens.stepTracker,
-    containerPaddingTop: spaceBetweenSlideAndPanelNavigation
-  };
 
   const onContainerLayout = _ref2 => {
     let {
@@ -276,20 +271,28 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
     });
   }, [activeIndex, containerLayout.width, pan, animatedX]);
 
-  const animate = _react.default.useCallback(toValue => {
+  const animate = _react.default.useCallback((toValue, toIndex) => {
+    const handleAnimationEndToIndex = function () {
+      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+        args[_key] = arguments[_key];
+      }
+
+      return handleAnimationEnd(toIndex, ...args);
+    };
+
     if (reduceMotionEnabled) {
       _Animated.default.timing(pan, {
         toValue,
         duration: 1,
         useNativeDriver: false
-      }).start();
+      }).start(handleAnimationEndToIndex);
     } else {
       _Animated.default.spring(pan, { ...springConfig,
         toValue,
         useNativeDriver: false
-      }).start();
+      }).start(handleAnimationEndToIndex);
     }
-  }, [pan, springConfig, reduceMotionEnabled]);
+  }, [pan, springConfig, reduceMotionEnabled, handleAnimationEnd]);
 
   const updateIndex = _react.default.useCallback(function () {
     let delta = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1;
@@ -308,25 +311,25 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
       calcDelta = -1 * activeIndex + delta - 1;
     }
 
+    const index = activeIndex + calcDelta;
+
     if (skipChanges) {
-      animate(toValue);
+      animate(toValue, index);
       return calcDelta;
     }
 
-    const index = activeIndex + calcDelta;
     setActiveIndex(index);
     toValue.x = containerLayout.width * -1 * calcDelta;
-    animate(toValue);
+    animate(toValue, index);
     if (onIndexChanged) onIndexChanged(calcDelta);
-    if (onAnimationEnd) onAnimationEnd(index);
     return calcDelta;
-  }, [containerLayout.width, activeIndex, animate, children.length, onIndexChanged, onAnimationEnd]);
+  }, [containerLayout.width, activeIndex, animate, children.length, onIndexChanged]);
 
   const fixOffsetAndGo = _react.default.useCallback(delta => {
     updateOffset();
-    if (onAnimationStart) onAnimationStart(activeIndex);
+    handleAnimationStart(activeIndex);
     updateIndex(delta);
-  }, [updateIndex, updateOffset, activeIndex, onAnimationStart]);
+  }, [updateIndex, updateOffset, activeIndex, handleAnimationStart]);
 
   const goToNeighboring = _react.default.useCallback(function () {
     let toPrev = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
@@ -349,7 +352,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
         return false;
       }
 
-      if (onAnimationStart) onAnimationStart(activeIndex);
+      handleAnimationStart(activeIndex);
       return Math.abs(gestureState.dx) > minDistanceToCapture;
     },
     onPanResponderGrant: () => updateOffset(),
@@ -365,13 +368,13 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
         animate({
           x: 0,
           y: 0
-        });
+        }, 0);
       } else {
         const delta = correction > 0 ? -1 : 1;
         updateIndex(delta);
       }
     }
-  }), [containerLayout.width, updateIndex, updateOffset, animate, isSwipeAllowed, activeIndex, minDistanceForAction, onAnimationStart, minDistanceToCapture, pan.x]);
+  }), [containerLayout.width, updateIndex, updateOffset, animate, isSwipeAllowed, activeIndex, minDistanceForAction, handleAnimationStart, minDistanceToCapture, pan.x]);
 
   _react.default.useEffect(() => {
     pan.x.addListener(_ref4 => {
@@ -416,11 +419,20 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
     size: previousNextIconSize,
     raised: true
   };
+
+  const getCopyWithPlaceholders = _react.default.useCallback(copyKey => {
+    const copyText = getCopy(copyKey).replace(/%\{itemLabel\}/g, itemLabel).replace(/%\{stepNumber\}/g, activeIndex + 1).replace(/%\{stepCount\}/g, childrenArray.length); // First word might be a lowercase placeholder: capitalize the first letter
+
+    return "".concat(copyText[0].toUpperCase()).concat(copyText.slice(1));
+  }, [activeIndex, childrenArray.length, itemLabel, getCopy]);
+
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_CarouselContext.CarouselProvider, {
     activeIndex: activeIndex,
     totalItems: childrenArray.length,
     width: containerLayout.width,
     goTo: goTo,
+    getCopyWithPlaceholders: getCopyWithPlaceholders,
+    themeTokens: themeTokens,
     children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
       style: staticStyles.root,
       onLayout: onContainerLayout,
@@ -434,7 +446,7 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
           icon: previousIcon,
           onPress: goToPrev,
           variant: previousNextIconButtonVariants,
-          accessibilityLabel: "previous-button"
+          accessibilityLabel: getCopyWithPlaceholders('iconButtonLabel').replace('%{targetStep}', activeIndex)
         })
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
         style: selectContainerStyles(containerLayout.width),
@@ -447,9 +459,13 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
             }]
           }]),
           ...panResponder.panHandlers,
+          ...(0, _utils.getA11yPropsFromHtmlTag)(tag),
           children: childrenArray.map((element, index) => {
+            const hidden = !isAnimating && index !== activeIndex;
+
             const clonedElement = /*#__PURE__*/_react.default.cloneElement(element, {
-              elementIndex: index
+              elementIndex: index,
+              hidden
             });
 
             return /*#__PURE__*/(0, _jsxRuntime.jsx)(_react.default.Fragment, {
@@ -465,22 +481,10 @@ const Carousel = /*#__PURE__*/_react.default.forwardRef((_ref, ref) => {
           icon: nextIcon,
           onPress: goToNext,
           variant: previousNextIconButtonVariants,
-          accessibilityLabel: "next-button"
+          accessibilityLabel: getCopyWithPlaceholders('iconButtonLabel').replace('%{targetStep}', activeIndex + 2)
         })
       })]
-    }), showPanelNavigation ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackView.default, {
-      direction: "row",
-      tokens: staticTokens.stackView,
-      children: onRenderPanelNavigation ? onRenderPanelNavigation({
-        activeIndex,
-        totalItems: childrenArray.length
-      }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_StepTracker.default, {
-        current: activeIndex,
-        steps: childrenArray.map((_, index) => String(index)),
-        dictionary: panelNavigationTextDictionary,
-        tokens: panelNavigationTokens
-      })
-    }) : null]
+    }), showPanelNavigation ? panelNavigation : null]
   });
 });
 
@@ -493,6 +497,14 @@ Carousel.propTypes = { ...selectedSystemPropTypes,
    */
   children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired,
 
+  /**
+   * Lowercase language-appropriate user-facing description of what each Carousel slide represents.
+   * This is used when generating item labels. For example, if a carousel contains offers,
+   * pass itemLabel="summer offer" (or copy="fr" and an appropriate French translation) to genereate
+   * accessible labels such as "Summer offer 1 of 3" and "Show summer offer 2 of 3".
+   */
+  itemLabel: _propTypes.default.string,
+
   /**
    * `inside` renders the previous and next buttons inside the slide
    * `outside` renders the previous and next buttons outside the slide
@@ -540,20 +552,20 @@ Carousel.propTypes = { ...selectedSystemPropTypes,
   onIndexChanged: _propTypes.default.func,
 
   /**
-   * Use this to render a custom panel navigation element instead of dots navigation
-   * This function is also provided with an object with the following properties
-   * activeIndex: index of current slide
-   * totalItems: total number of slides
+   * Use this to render a custom panel navigation element instead of the default StepTracker's based navigation
+   * You can make use of `useCarousel` within your custom panel navigation component to hook into various Carousel states such as:
+   * - activeIndex: index of current slide
+   * - totalItems: total number of slides
    * Use it as follows:
    * ```js
    *    <Carousel
-   *      onRenderPanelNavigation={({ totalItems, activeIndex }) => <Text>Showing {activeIndex + 1}</Text>}
+   *      panelNavigation={<CustomPanelNavigation />}
    *    >
    *      <Carousel.Item>First Slide</Carousel.Item>
    *    </Carousel>
    * ```
    */
-  onRenderPanelNavigation: _propTypes.default.func,
+  panelNavigation: _propTypes.default.element,
 
   /**
    * When slide animation start
@@ -611,7 +623,16 @@ Carousel.propTypes = { ...selectedSystemPropTypes,
   /**
    * Provide custom accessibilityLabel for Carousel container
    */
-  accessibilityLabel: _propTypes.default.string
+  accessibilityLabel: _propTypes.default.string,
+
+  /**
+   * HTML tag to use for the Carousel item's immediate parent. Defaults to `'ul'` so that
+   * assistive technology tools know to intepret the carousel as a list.
+   *
+   * Note that if the immediate Carousel children do not all render as `'li'` elements,
+   * this should be changed (e.g. pass tag="div") because only 'li' is a valid child of 'ul'.
+   */
+  tag: _propTypes.default.oneOf(_utils.layoutTags)
 };
 Carousel.Item = _CarouselItem.default;
 Carousel.displayName = 'Carousel';

package/lib/Carousel/CarouselContext.js

@@ -10,6 +10,8 @@ var _react = _interopRequireDefault(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
+var _utils = require("../utils");
+
 var _jsxRuntime = require("react/jsx-runtime");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -22,15 +24,19 @@ const CarouselProvider = _ref => {
     activeIndex,
     totalItems,
     width,
-    goTo
+    goTo,
+    getCopyWithPlaceholders,
+    themeTokens
   } = _ref;
 
   const value = _react.default.useMemo(() => ({
     activeIndex,
     totalItems,
     width,
-    goTo
-  }), [activeIndex, totalItems, width, goTo]);
+    goTo,
+    getCopyWithPlaceholders,
+    themeTokens
+  }), [activeIndex, totalItems, width, goTo, getCopyWithPlaceholders, themeTokens]);
 
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(CarouselContext.Provider, {
     value: value,
@@ -55,5 +61,7 @@ CarouselProvider.propTypes = {
   activeIndex: _propTypes.default.number.isRequired,
   totalItems: _propTypes.default.number.isRequired,
   width: _propTypes.default.number.isRequired,
-  goTo: _propTypes.default.func.isRequired
+  goTo: _propTypes.default.func.isRequired,
+  getCopyWithPlaceholders: _propTypes.default.func.isRequired,
+  themeTokens: (0, _utils.getTokensPropType)('Carousel')
 };

package/lib/Carousel/CarouselItem/CarouselItem.js

@@ -31,23 +31,29 @@ const CarouselItem = _ref => {
   let {
     children,
     elementIndex,
+    tag = 'li',
+    hidden,
     ...rest
   } = _ref;
   const {
     width,
-    activeIndex,
-    totalItems
+    activeIndex
   } = (0, _CarouselContext.useCarousel)();
   const selectedProps = selectProps({ ...rest,
-    // `group` role crashes the app on Android so setting it to `none` for Android
-    accessibilityRole: _Platform.default.OS === 'android' ? 'none' : 'group',
-    accessibilityLabel: "Showing ".concat(elementIndex + 1, " of ").concat(totalItems)
+    ...(0, _utils.getA11yPropsFromHtmlTag)(tag, rest.accessibilityRole)
   });
   const focusabilityProps = activeIndex === elementIndex ? {} : _utils.a11yProps.nonFocusableProps;
+  const style = {
+    width
+  };
+
+  if (hidden && _Platform.default.OS === 'web') {
+    // On web, visibility: hidden makes all children non-focusable. It doesn't exist on native.
+    style.visibility = 'hidden';
+  }
+
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
-    style: {
-      width
-    },
+    style: style,
     ...selectedProps,
     ...focusabilityProps,
     children: children
@@ -70,7 +76,16 @@ CarouselItem.propTypes = { ...selectedSystemPropTypes,
   /**
    * Content of the slide
    */
-  children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired
+  children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired,
+
+  /**
+   * Sets the HTML tag of the outer container. By default `'li'` so that assistive technology sees
+   * the Carousel as a list of items.
+   *
+   * Carousel's innermost container defaults to `'ul'` which can be overridden. If the tag of either
+   * `Carousel` or `Carousel.Item` is overriden, the other should be too, to avoid producing invalid HTML.
+   */
+  tag: _propTypes.default.oneOf(_utils.layoutTags)
 };
 CarouselItem.displayName = 'Carousel.Item';
 var _default = CarouselItem;

package/lib/Carousel/CarouselStepTracker/CarouselStepTracker.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _CarouselContext = require("../CarouselContext");
+
+var _StepTracker = _interopRequireDefault(require("../../StepTracker"));
+
+var _StackView = _interopRequireDefault(require("../../StackView"));
+
+var _jsxRuntime = require("react/jsx-runtime");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const CarouselStepTracker = () => {
+  const {
+    activeIndex,
+    totalItems,
+    getCopyWithPlaceholders,
+    themeTokens
+  } = (0, _CarouselContext.useCarousel)();
+  const stackViewTokens = {
+    justifyContent: 'center'
+  };
+  const stepTrackerTokens = {
+    showStepLabel: false,
+    showStepTrackerLabel: true,
+    knobCompletedBackgroundColor: 'none',
+    connectorCompletedColor: 'none',
+    connectorColor: 'none',
+    containerPaddingTop: themeTokens.spaceBetweenSlideAndPanelNavigation
+  };
+  const steps = Array.from(Array(totalItems)).map((_, index) => String(index));
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_StackView.default, {
+    direction: "row",
+    tokens: stackViewTokens,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_StepTracker.default, {
+      current: activeIndex,
+      steps: steps,
+      copy: {
+        // Give StepTracker copy from Carousel's language and dictionary
+        stepLabel: getCopyWithPlaceholders('stepLabel'),
+        stepTrackerLabel: getCopyWithPlaceholders('stepTrackerLabel')
+      },
+      tokens: stepTrackerTokens
+    })
+  });
+};
+
+var _default = CarouselStepTracker;
+exports.default = _default;

package/lib/Carousel/CarouselStepTracker/index.js

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

package/lib/Carousel/dictionary.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+// 'stepLabel' and 'stepTrackerLabel' are passed down to StepTracker
+var _default = {
+  en: {
+    carouselLabel: '%{stepCount} items',
+    iconButtonLabel: 'Show %{itemLabel} %{targetStep} of %{stepCount}',
+    stepLabel: '%{itemLabel} %{stepNumber}',
+    stepTrackerLabel: '%{itemLabel} %{stepNumber} of %{stepCount}'
+  },
+  fr: {
+    // TODO: French translations here
+    carouselLabel: '(fr) %{stepCount} items',
+    iconButtonLabel: '(fr) Show %{itemLabel} %{targetStep} of %{stepCount}',
+    stepLabel: '(fr) %{itemLabel} %{stepNumber}',
+    stepTrackerLabel: '(fr) %{itemLabel} %{stepNumber} of %{stepCount}'
+  }
+};
+exports.default = _default;