carbon-react 125.9.3 → 125.11.0

package/esm/components/heading/heading.style.d.ts

@@ -12,7 +12,7 @@ declare type StyledHeadingTitleProps = {
     withMargin?: boolean;
 };
 declare const StyledHeadingTitle: import("styled-components").StyledComponent<{
-    ({ "data-component": dataComponent, variant, as, id, fontSize, fontWeight, textTransform, lineHeight, textDecoration, display, listStyleType, whiteSpace, wordWrap, textAlign, textOverflow, truncate, color, backgroundColor, bg, opacity, children, className, screenReaderOnly, isDisabled, ...rest }: import("../typography").TypographyProps): import("react").JSX.Element;
+    ({ "data-component": dataComponent, variant, as, id, fontSize, fontWeight, textTransform, lineHeight, textDecoration, display, listStyleType, whiteSpace, wordWrap, textAlign, textOverflow, truncate, color, backgroundColor, bg, opacity, children, className, screenReaderOnly, isDisabled, "aria-hidden": ariaHidden, ...rest }: import("../typography").TypographyProps): import("react").JSX.Element;
     displayName: string;
 }, any, StyledHeadingTitleProps, never>;
 declare const StyledHeadingPills: import("styled-components").StyledComponent<"span", any, {}, never>;

package/esm/components/pill/pill.component.d.ts

@@ -4,7 +4,9 @@ export interface PillProps extends StyledPillProps {
     /** The content to display inside of the pill.  */
     children: string;
     /** Change the color of a status pill. */
-    colorVariant?: "neutral" | "negative" | "positive" | "warning";
+    colorVariant?: "neutral" | "negative" | "positive" | "warning" | "information" | "neutralWhite";
+    /** Sets the colour styling when a status pill is rendered on a dark background. */
+    isDarkBackground?: boolean;
     /** Identifier used for testing purposes, applied to the root element of the component. */
     "data-element"?: string;
     /** Identifier used for testing purposes, applied to the root element of the component. */
@@ -22,5 +24,5 @@ export interface PillProps extends StyledPillProps {
     /** @private @ignore title attribute passed down to underlying element */
     title?: string;
 }
-export declare const Pill: ({ wrapText, borderColor, colorVariant, children, fill, maxWidth, onClick, onDelete, pillRole, size, ariaLabelOfRemoveButton, ...rest }: PillProps) => React.JSX.Element;
+export declare const Pill: ({ wrapText, borderColor, colorVariant, isDarkBackground, children, fill, maxWidth, onClick, onDelete, pillRole, size, ariaLabelOfRemoveButton, ...rest }: PillProps) => React.JSX.Element;
 export default Pill;

package/esm/components/pill/pill.component.js

@@ -5,10 +5,12 @@ import StyledPill from "./pill.style";
 import Icon from "../icon";
 import tagComponent from "../../__internal__/utils/helpers/tags/tags";
 import IconButton from "../icon-button";
+let neutralWhiteWarnTriggered = false;
 export const Pill = ({
   wrapText,
   borderColor,
   colorVariant = "neutral",
+  isDarkBackground = false,
   children,
   fill = false,
   maxWidth,
@@ -18,22 +20,30 @@ export const Pill = ({
   size = "M",
   ariaLabelOfRemoveButton = "remove pill",
   ...rest
-}) => /*#__PURE__*/React.createElement(StyledPill, _extends({
-  inFill: fill,
-  colorVariant: colorVariant,
-  isDeletable: !!onDelete,
-  pillRole: pillRole,
-  size: size,
-  borderColor: borderColor,
-  onClick: onClick
-}, tagComponent("pill", rest), {
-  maxWidth: maxWidth,
-  wrapText: wrapText
-}, rest), children, onDelete && /*#__PURE__*/React.createElement(IconButton, {
-  onClick: onDelete,
-  "data-element": "close",
-  "aria-label": ariaLabelOfRemoveButton
-}, /*#__PURE__*/React.createElement(Icon, {
-  type: "cross"
-})));
+}) => {
+  if (!neutralWhiteWarnTriggered && !isDarkBackground && colorVariant === "neutralWhite" && !fill) {
+    neutralWhiteWarnTriggered = true;
+    // eslint-disable-next-line no-console
+    console.warn("[WARNING] The `neutralWhite` variant should only be used on dark backgrounds with fill set to true. " + "Please set the `isDarkBackground` and `fill` props to true or use another color variant.");
+  }
+  return /*#__PURE__*/React.createElement(StyledPill, _extends({
+    inFill: fill,
+    colorVariant: colorVariant,
+    isDarkBackground: isDarkBackground,
+    isDeletable: !!onDelete,
+    pillRole: pillRole,
+    size: size,
+    borderColor: borderColor,
+    onClick: onClick
+  }, tagComponent("pill", rest), {
+    maxWidth: maxWidth,
+    wrapText: wrapText
+  }, rest), children, onDelete && /*#__PURE__*/React.createElement(IconButton, {
+    onClick: onDelete,
+    "data-element": "close",
+    "aria-label": ariaLabelOfRemoveButton
+  }, /*#__PURE__*/React.createElement(Icon, {
+    type: "cross"
+  })));
+};
 export default Pill;

package/esm/components/pill/pill.style.config.d.ts

@@ -9,10 +9,12 @@ interface StyledPillConfig {
         negative: StyledPillInnerConfigProps;
         warning: StyledPillInnerConfigProps;
         positive: StyledPillInnerConfigProps;
+        information: StyledPillInnerConfigProps;
+        neutralWhite: StyledPillInnerConfigProps;
     };
     tag: {
         primary: StyledPillInnerConfigProps;
     };
 }
-declare const _default: () => StyledPillConfig;
+declare const _default: (isDarkBackground: boolean) => StyledPillConfig;
 export default _default;

package/esm/components/pill/pill.style.config.js

@@ -1,15 +1,15 @@
-export default (() => {
+export default (isDarkBackground => {
   return {
     status: {
       neutral: {
-        varietyColor: "var(--colorsSemanticNeutral500)",
-        buttonFocus: "var(--colorsSemanticNeutral600)",
-        content: "var(--colorsSemanticNeutralYang100)"
+        varietyColor: isDarkBackground ? "var(--colorsSemanticNeutral400)" : "var(--colorsSemanticNeutral500)",
+        buttonFocus: isDarkBackground ? "var(--colorsSemanticNeutral500)" : "var(--colorsSemanticNeutral600)",
+        content: isDarkBackground ? "var(--colorsSemanticNeutralYin090)" : "var(--colorsSemanticNeutralYang100)"
       },
       negative: {
-        varietyColor: "var(--colorsSemanticNegative500)",
-        buttonFocus: "var(--colorsSemanticNegative600)",
-        content: "var(--colorsSemanticNegativeYang100)"
+        varietyColor: isDarkBackground ? "var(--colorsSemanticNegative450)" : "var(--colorsSemanticNegative500)",
+        buttonFocus: isDarkBackground ? "var(--colorsSemanticNegative500)" : "var(--colorsSemanticNegative600)",
+        content: isDarkBackground ? "var(--colorsSemanticNegativeYin090)" : "var(--colorsSemanticNegativeYang100)"
       },
       warning: {
         varietyColor: "var(--colorsSemanticCaution400)",
@@ -17,9 +17,19 @@ export default (() => {
         content: "var(--colorsSemanticCautionYin090)"
       },
       positive: {
-        varietyColor: "var(--colorsSemanticPositive500)",
-        buttonFocus: "var(--colorsSemanticPositive600)",
-        content: "var(--colorsSemanticPositiveYang100)"
+        varietyColor: isDarkBackground ? "var(--colorsSemanticPositive400)" : "var(--colorsSemanticPositive500)",
+        buttonFocus: isDarkBackground ? "var(--colorsSemanticPositive500)" : "var(--colorsSemanticPositive600)",
+        content: isDarkBackground ? "var(--colorsSemanticPositiveYin090)" : "var(--colorsSemanticPositiveYang100)"
+      },
+      information: {
+        varietyColor: isDarkBackground ? "var(--colorsSemanticInfo400)" : "var(--colorsSemanticInfo500)",
+        buttonFocus: isDarkBackground ? "var(--colorsSemanticInfo500)" : "var(--colorsSemanticInfo600)",
+        content: isDarkBackground ? "var(--colorsSemanticInfoYin090)" : "var(--colorsSemanticInfoYang100)"
+      },
+      neutralWhite: {
+        varietyColor: "var(--colorsSemanticNeutralYang100)",
+        buttonFocus: "var(--colorsSemanticNeutralYin030)",
+        content: "var(--colorsSemanticNeutral500)"
       }
     },
     tag: {

package/esm/components/pill/pill.style.d.ts

@@ -15,7 +15,8 @@ export interface StyledPillProps extends MarginProps {
 interface AllStyledPillProps extends StyledPillProps {
     inFill?: boolean;
     isDeletable: boolean;
-    colorVariant: "neutral" | "negative" | "positive" | "warning";
+    isDarkBackground: boolean;
+    colorVariant: "neutral" | "negative" | "positive" | "warning" | "information" | "neutralWhite";
     pillRole: "tag" | "status";
 }
 declare const StyledPill: import("styled-components").StyledComponent<"span", any, AllStyledPillProps, never>;

package/esm/components/pill/pill.style.js

@@ -21,6 +21,7 @@ const StyledPill = styled.span`
   wrapText,
   borderColor,
   colorVariant,
+  isDarkBackground,
   isDeletable,
   inFill,
   maxWidth,
@@ -41,7 +42,7 @@ const StyledPill = styled.span`
       const {
         status,
         tag
-      } = styleConfig();
+      } = styleConfig(isDarkBackground);
       const {
         varietyColor,
         buttonFocus,
@@ -83,7 +84,7 @@ const StyledPill = styled.span`
       `}
 
       ${!inFill && css`
-        color: var(--colorsUtilityYin090);
+        color: ${!isDarkBackground ? "var(--colorsUtilityYin090)" : "var(--colorsUtilityYang100)"};
       `}
 
       ${size === "S" && css`
@@ -204,7 +205,7 @@ const StyledPill = styled.span`
 
           ${!inFill && css`
             ${StyledIcon} {
-              color: var(--colorsUtilityYin090);
+              color: ${!isDarkBackground ? "var(--colorsUtilityYin090)" : "var(--colorsUtilityYang100)"};
             }
           `}
         }

package/esm/components/step-flow/index.d.ts

@@ -0,0 +1,2 @@
+export { default as StepFlow } from "./step-flow.component";
+export type { StepFlowProps } from "./step-flow.component";

package/esm/components/step-flow/index.js

@@ -0,0 +1 @@
+export { default as StepFlow } from "./step-flow.component";

package/esm/components/step-flow/step-flow.component.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import { MarginProps } from "styled-system";
+import { TagProps } from "../../__internal__/utils/helpers/tags/tags";
+export declare type Steps = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+export interface StepFlowProps extends MarginProps, TagProps {
+    /** A category for the user journey.  */
+    category?: string;
+    /** The title of the current step.  */
+    title: string;
+    /** Set the variant of the internal 'Typography' component which contains the title.
+     * However, despite the chosen variant the styling will always be overridden.
+     */
+    titleVariant?: "h1" | "h2";
+    /** The total steps in the user journey.  */
+    totalSteps: Steps;
+    /**
+     * The current step of the user journey. If the set `currentStep` is higher than
+     * `totalSteps`the value of `currentStep` will be that of `totalSteps` instead.
+     */
+    currentStep: Steps;
+    /** Determines if the progress indicator is shown. */
+    showProgressIndicator?: boolean;
+    /** Determines if the close icon button is shown */
+    showCloseIcon?: boolean;
+    /** function runs when user click dismiss button */
+    onDismiss?: (e: React.KeyboardEvent<HTMLButtonElement> | React.MouseEvent<HTMLButtonElement>) => void;
+}
+export declare type StepFlowHandle = {
+    /** Programmatically focus on root container of Dialog. */
+    focus: () => void;
+} | null;
+export declare const StepFlow: React.ForwardRefExoticComponent<StepFlowProps & React.RefAttributes<StepFlowHandle>>;
+export default StepFlow;

package/esm/components/step-flow/step-flow.component.js

@@ -0,0 +1,277 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+import React, { useImperativeHandle, useRef, forwardRef } from "react";
+import PropTypes from "prop-types";
+import Icon from "../icon";
+import IconButton from "../icon-button";
+import { StyledStepFlow, StyledStepContent, StyledStepContentText, StyledStepLabelAndProgress, StyledProgressIndicatorBar, StyledProgressIndicator, StyledTitleFocusWrapper } from "./step-flow.style";
+import tagComponent from "../../__internal__/utils/helpers/tags/tags";
+import Typography from "../typography";
+import useLocale from "../../hooks/__internal__/useLocale";
+const StepFlow = /*#__PURE__*/forwardRef(({
+  category,
+  title,
+  titleVariant,
+  totalSteps,
+  currentStep,
+  showProgressIndicator = false,
+  showCloseIcon = false,
+  onDismiss,
+  ...rest
+}, ref) => {
+  const totalStepsArray = Array.from({
+    length: totalSteps
+  }, (_, index) => index + 1);
+  const validatedCurrentStep = currentStep > totalSteps ? totalSteps : currentStep;
+  let currentStepWarnTriggered = false;
+  let noRefWarnTriggered = false;
+
+  /* eslint-disable no-console */
+  if (!currentStepWarnTriggered && currentStep > totalSteps) {
+    currentStepWarnTriggered = true;
+    console.warn("[WARNING] The `currentStep` prop should not be higher than the `totalSteps`prop in `StepFlow`." + " Please ensure `currentStep`s value does not exceed that of `totalSteps`, in the meantime" + " we have set `currentStep` value to that of `totalSteps`, and all indicators have been marked as completed.");
+  }
+  if (!noRefWarnTriggered && !ref) {
+    noRefWarnTriggered = true;
+    console.warn("[WARNING] A `ref` should be provided to ensure focus is programmatically focused back to a title div," + " this ensures screen reader users are informed regarding any changes and can navigate back down the page.");
+  }
+  const progressIndicators = totalStepsArray.map(step => {
+    const generateDataState = () => {
+      if (step === validatedCurrentStep) {
+        return "in-progress";
+      }
+      if (step < validatedCurrentStep) {
+        return "is-completed";
+      }
+      return "not-completed";
+    };
+    return /*#__PURE__*/React.createElement(StyledProgressIndicator, {
+      key: step,
+      "aria-hidden": "true",
+      "data-element": "progress-indicator",
+      isCompleted: step < validatedCurrentStep,
+      isInProgress: step === validatedCurrentStep,
+      "data-state": generateDataState()
+    }, "\xA0");
+  });
+  const locale = useLocale();
+  const closeIcon = /*#__PURE__*/React.createElement(IconButton, {
+    "data-element": "close",
+    "aria-label": locale.stepFlow.closeIconAriaLabel?.(),
+    onClick: onDismiss
+  }, /*#__PURE__*/React.createElement(Icon, {
+    type: "close"
+  }));
+  const titleRef = useRef(null);
+  useImperativeHandle(ref, () => ({
+    focus() {
+      titleRef.current?.focus();
+    }
+  }), []);
+  const stepFlowTitle = /*#__PURE__*/React.createElement(StyledTitleFocusWrapper, {
+    "data-element": "title-text-wrapper",
+    tabIndex: -1,
+    ref: titleRef
+  }, /*#__PURE__*/React.createElement(Typography, {
+    variant: titleVariant || "h1",
+    "data-element": "title-text"
+  }, /*#__PURE__*/React.createElement(Typography, {
+    fontWeight: "900",
+    fontSize: "var(--fontSizes600)",
+    lineHeight: "var(--sizing375)",
+    variant: "span",
+    "aria-hidden": "true",
+    "data-element": "visible-title-text"
+  }, title), /*#__PURE__*/React.createElement(Typography, {
+    variant: "span",
+    "data-element": "visually-hidden-title-text",
+    screenReaderOnly: true
+  }, locale.stepFlow.screenReaderOnlyTitle(title, validatedCurrentStep, totalSteps, category))));
+  const stepFlowLabel = /*#__PURE__*/React.createElement(Typography, {
+    variant: "span",
+    fontWeight: "400",
+    fontSize: "var(--fontSizes200)",
+    lineHeight: "var(--sizing300)",
+    "data-element": "step-label",
+    "aria-hidden": "true"
+  }, locale.stepFlow.stepLabel(validatedCurrentStep, totalSteps));
+  return /*#__PURE__*/React.createElement(StyledStepFlow, _extends({}, rest, tagComponent("step-flow", rest)), /*#__PURE__*/React.createElement(StyledStepContent, null, category ? /*#__PURE__*/React.createElement(StyledStepContentText, null, /*#__PURE__*/React.createElement(Typography, {
+    fontWeight: "500",
+    fontSize: "var(--fontSizes100)",
+    lineHeight: "var(--sizing250)",
+    variant: "span",
+    "data-element": "category-text",
+    "aria-hidden": "true"
+  }, category), stepFlowTitle) : stepFlowTitle, showCloseIcon ? closeIcon : null), showProgressIndicator ? /*#__PURE__*/React.createElement(StyledStepLabelAndProgress, null, stepFlowLabel, /*#__PURE__*/React.createElement(StyledProgressIndicatorBar, {
+    "data-element": "progress-indicator-bar"
+  }, progressIndicators)) : stepFlowLabel);
+});
+StepFlow.propTypes = {
+  "category": PropTypes.string,
+  "children": PropTypes.node,
+  "currentStep": PropTypes.oneOf([1, 2, 3, 4, 5, 6, 7, 8]).isRequired,
+  "data-component": PropTypes.string,
+  "data-element": PropTypes.string,
+  "data-role": PropTypes.string,
+  "m": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "margin": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginBottom": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginLeft": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginRight": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginTop": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginX": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "marginY": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "mb": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "ml": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "mr": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "mt": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "mx": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "my": PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf([null]), PropTypes.number, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string])), PropTypes.number, PropTypes.object, PropTypes.shape({
+    "__@toStringTag": PropTypes.string.isRequired,
+    "description": PropTypes.string,
+    "toString": PropTypes.func.isRequired,
+    "valueOf": PropTypes.func.isRequired
+  }), PropTypes.string]),
+  "onDismiss": PropTypes.func,
+  "showCloseIcon": PropTypes.bool,
+  "showProgressIndicator": PropTypes.bool,
+  "title": PropTypes.string.isRequired,
+  "titleVariant": PropTypes.oneOf(["h1", "h2"]),
+  "totalSteps": PropTypes.oneOf([1, 2, 3, 4, 5, 6, 7, 8]).isRequired
+};
+export { StepFlow };
+export default StepFlow;

package/esm/components/step-flow/step-flow.style.d.ts

@@ -0,0 +1,12 @@
+declare const StyledStepFlow: import("styled-components").StyledComponent<"div", any, {}, never>;
+declare const StyledStepContent: import("styled-components").StyledComponent<"div", any, {}, never>;
+declare const StyledStepContentText: import("styled-components").StyledComponent<"div", any, {}, never>;
+declare const StyledTitleFocusWrapper: import("styled-components").StyledComponent<"div", any, {}, never>;
+declare const StyledStepLabelAndProgress: import("styled-components").StyledComponent<"div", any, {}, never>;
+declare const StyledProgressIndicatorBar: import("styled-components").StyledComponent<"div", any, {}, never>;
+interface StyledProgressIndicatorProps {
+    isCompleted: boolean;
+    isInProgress: boolean;
+}
+declare const StyledProgressIndicator: import("styled-components").StyledComponent<"span", any, StyledProgressIndicatorProps, never>;
+export { StyledStepFlow, StyledStepContent, StyledStepContentText, StyledTitleFocusWrapper, StyledStepLabelAndProgress, StyledProgressIndicatorBar, StyledProgressIndicator, };

package/esm/components/step-flow/step-flow.style.js

@@ -0,0 +1,42 @@
+import styled from "styled-components";
+import { margin } from "styled-system";
+const StyledStepFlow = styled.div`
+  ${margin}
+`;
+const StyledStepContent = styled.div`
+  display: flex;
+  justify-content: space-between;
+  margin-bottom: var(--sizing200);
+`;
+const StyledStepContentText = styled.div`
+  display: flex;
+  flex-direction: column;
+`;
+const StyledTitleFocusWrapper = styled.div``;
+const StyledStepLabelAndProgress = styled.div`
+  margin-top: var(--sizing125);
+`;
+const StyledProgressIndicatorBar = styled.div`
+  display: flex;
+  margin-top: var(--sizing100);
+`;
+function calculateProgressIndicatorColor({
+  isCompleted,
+  isInProgress
+}) {
+  if (isInProgress) {
+    return "var(--colorsUtilityYin090)";
+  }
+  if (isCompleted) {
+    return "var(--colorsSemanticPositive500)";
+  }
+  return "var(--colorsActionDisabled600)";
+}
+const StyledProgressIndicator = styled.span`
+  background-color: ${calculateProgressIndicatorColor};
+  width: 100%;
+  height: 8px;
+  border-radius: 8px;
+  margin-right: 12px;
+`;
+export { StyledStepFlow, StyledStepContent, StyledStepContentText, StyledTitleFocusWrapper, StyledStepLabelAndProgress, StyledProgressIndicatorBar, StyledProgressIndicator };

package/esm/components/typography/index.d.ts

@@ -1,4 +1,4 @@
 export { default } from "./typography.component";
 export { List, ListItem } from "./list.component";
-export type { TypographyProps } from "./typography.component";
+export type { TypographyProps, VariantTypes } from "./typography.component";
 export type { ListProps, ListItemProps } from "./list.component";

package/esm/components/typography/typography.component.d.ts

@@ -55,9 +55,11 @@ export interface TypographyProps extends SpaceProps, TagProps {
      * Override the default color of the rendered element to match disabled styling
      * */
     isDisabled?: boolean;
+    /** @private @ignore Set whether the component should be recognised by assistive technologies */
+    "aria-hidden"?: "true" | "false";
 }
 export declare const Typography: {
-    ({ "data-component": dataComponent, variant, as, id, fontSize, fontWeight, textTransform, lineHeight, textDecoration, display, listStyleType, whiteSpace, wordWrap, textAlign, textOverflow, truncate, color, backgroundColor, bg, opacity, children, className, screenReaderOnly, isDisabled, ...rest }: TypographyProps): React.JSX.Element;
+    ({ "data-component": dataComponent, variant, as, id, fontSize, fontWeight, textTransform, lineHeight, textDecoration, display, listStyleType, whiteSpace, wordWrap, textAlign, textOverflow, truncate, color, backgroundColor, bg, opacity, children, className, screenReaderOnly, isDisabled, "aria-hidden": ariaHidden, ...rest }: TypographyProps): React.JSX.Element;
     displayName: string;
 };
 export default Typography;

package/esm/components/typography/typography.component.js

@@ -30,6 +30,7 @@ export const Typography = ({
   className,
   screenReaderOnly,
   isDisabled,
+  "aria-hidden": ariaHidden,
   ...rest
 }) => {
   return /*#__PURE__*/React.createElement(StyledTypography, _extends({
@@ -54,7 +55,8 @@ export const Typography = ({
     opacity: opacity,
     className: className,
     screenReaderOnly: screenReaderOnly,
-    isDisabled: isDisabled
+    isDisabled: isDisabled,
+    "aria-hidden": ariaHidden
   }, tagComponent(dataComponent, rest), filterStyledSystemMarginProps(rest), filterStyledSystemPaddingProps(rest)), children);
 };
 Typography.displayName = "Typography";

package/esm/locales/__internal__/pl-pl.js

@@ -177,6 +177,11 @@ const plPL = {
   splitButton: {
     ariaLabel: () => "Pokaż więcej"
   },
+  stepFlow: {
+    stepLabel: (currentStep, totalSteps) => `Krok ${currentStep} z ${totalSteps}`,
+    screenReaderOnlyTitle: (title, currentStep, totalSteps, category) => `${category ? `${category}.` : ""}. ${title}. Krok ${currentStep} of ${totalSteps}.`,
+    closeIconAriaLabel: () => "Zamknij"
+  },
   switch: {
     on: () => "WŁ",
     off: () => "WYŁ"

package/esm/locales/en-gb.js

@@ -142,6 +142,11 @@ const enGB = {
   splitButton: {
     ariaLabel: () => "Show more"
   },
+  stepFlow: {
+    stepLabel: (currentStep, totalSteps) => `Step ${currentStep} of ${totalSteps}`,
+    screenReaderOnlyTitle: (title, currentStep, totalSteps, category) => `${category ? `${category}.` : ""} ${title}. Step ${currentStep} of ${totalSteps}.`,
+    closeIconAriaLabel: () => "Close"
+  },
   switch: {
     on: () => "ON",
     off: () => "OFF"

package/esm/locales/locale.d.ts

@@ -121,6 +121,11 @@ interface Locale {
         on: () => string;
         off: () => string;
     };
+    stepFlow: {
+        stepLabel: (currentStep: number, totalSteps: number) => string;
+        screenReaderOnlyTitle: (title: string, currentStep: number, totalSteps: number, category?: string) => string;
+        closeIconAriaLabel?: () => string;
+    };
     textEditor: {
         tooltipMessages: {
             bold: () => string;