carbon-react 101.0.4 → 101.3.1

package/lib/__internal__/tooltip-provider/index.d.ts

@@ -11,6 +11,9 @@ export interface TooltipProviderProps {
   children: React.ReactNode;
   /** Aria label for rendered help component */
   helpAriaLabel?: string;
+  focusable?: boolean;
+  tooltipVisible?: boolean;
+  disabled?: boolean;
 }
 
 declare const ToolbarContext: React.Context<ToolbarContextProps>;

package/lib/__internal__/tooltip-provider/index.js

@@ -18,11 +18,17 @@ exports.TooltipContext = TooltipContext;
 const TooltipProvider = ({
   children,
   tooltipPosition,
-  helpAriaLabel
+  helpAriaLabel,
+  focusable = true,
+  tooltipVisible,
+  disabled = false
 }) => /*#__PURE__*/_react.default.createElement(TooltipContext.Provider, {
   value: {
     tooltipPosition,
-    helpAriaLabel
+    helpAriaLabel,
+    focusable,
+    tooltipVisible,
+    disabled
   }
 }, children);
 
@@ -30,5 +36,8 @@ exports.TooltipProvider = TooltipProvider;
 TooltipProvider.propTypes = {
   children: _propTypes.default.node.isRequired,
   tooltipPosition: _propTypes.default.oneOf(["top", "bottom", "left", "right"]),
-  helpAriaLabel: _propTypes.default.string
+  helpAriaLabel: _propTypes.default.string,
+  focusable: _propTypes.default.bool,
+  tooltipVisible: _propTypes.default.bool,
+  disabled: _propTypes.default.bool
 };

package/lib/components/flat-table/flat-table.component.js

@@ -39,6 +39,7 @@ const FlatTable = ({
   hasMaxHeight = false,
   ariaDescribedby,
   minHeight,
+  overflowX,
   ...rest
 }) => {
   const addDefaultHeight = !height && (hasStickyHead || hasStickyFooter);
@@ -57,16 +58,18 @@ const FlatTable = ({
   }) => /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTableWrapper, _extends({
     isInSidebar: isInSidebar,
     hasStickyHead: hasStickyHead,
-    colorTheme: colorTheme
-  }, rest, {
+    colorTheme: colorTheme,
     minHeight: minHeight,
     overflowY: !isInSidebar && (hasStickyHead || hasStickyFooter) ? "auto" : undefined,
     height: addDefaultHeight && !hasMaxHeight ? "99%" : height,
     maxHeight: hasMaxHeight ? "100%" : undefined,
     display: "flex",
     flexDirection: "column",
-    justifyContent: hasStickyFooter || height ? "space-between" : undefined
-  }), /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTable, _extends({
+    justifyContent: hasStickyFooter || height ? "space-between" : undefined,
+    tabIndex: "0",
+    role: "region",
+    overflowX: overflowX
+  }, rest), /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTable, _extends({
     "data-component": "flat-table"
   }, tableStylingProps), caption ? /*#__PURE__*/_react.default.createElement("caption", null, caption) : null, /*#__PURE__*/_react.default.createElement(FlatTableThemeContext.Provider, {
     value: {
@@ -114,7 +117,10 @@ FlatTable.propTypes = { ...marginPropTypes,
   size: _propTypes.default.oneOf(["compact", "small", "medium", "large", "extraLarge"]),
 
   /** Applies max-height of 100% to FlatTable if true */
-  hasMaxHeight: _propTypes.default.bool
+  hasMaxHeight: _propTypes.default.bool,
+
+  /** Set the overflow X of the table wrapper. Any valid CSS string */
+  overflowX: _propTypes.default.string
 };
 FlatTable.defaultProps = {
   colorTheme: "dark",

package/lib/components/flat-table/flat-table.style.js

@@ -107,6 +107,18 @@ const StyledFlatTableWrapper = (0, _styledComponents.default)(_box.default)`
 }) => (0, _styledComponents.css)`
       box-sizing: border-box;
 
+      :focus {
+        outline: 2px solid ${theme.colors.focus};
+
+        :not(:focus-visible) {
+          outline: none;
+        }
+
+        :focus-visible {
+          outline: 2px solid ${theme.colors.focus};
+        }
+      }
+
       ${isInSidebar ? "min-width: fit-content" : `box-shadow: inset 0px 0px 0px 1px ${theme.table.secondary}`};
     `}
 

package/lib/components/icon/icon.component.js

@@ -57,6 +57,12 @@ const Icon = /*#__PURE__*/_react.default.forwardRef(({
   ...rest
 }, ref) => {
   const isInteractive = !!tooltipMessage && !disabled;
+  const {
+    tooltipPosition: tooltipPositionFromContext,
+    focusable: focusableFromContext,
+    tooltipVisible: tooltipVisibleFromContext,
+    disabled: disabledFromContext
+  } = (0, _react.useContext)(_tooltipProvider.TooltipContext);
   /** Return Icon type with overrides */
 
   const iconType = () => {
@@ -83,13 +89,14 @@ const Icon = /*#__PURE__*/_react.default.forwardRef(({
     }
   };
 
-  const hasTooltip = !disabled && tooltipMessage && focusable;
+  const isFocusable = focusableFromContext !== undefined ? focusableFromContext : focusable;
+  const hasTooltip = !disabled && !disabledFromContext && tooltipMessage && isFocusable;
   const styleProps = {
     bg,
     bgSize,
     bgShape,
     color,
-    disabled,
+    disabled: disabledFromContext || disabled,
     fontSize,
     isInteractive,
     type: iconType(),
@@ -108,12 +115,9 @@ const Icon = /*#__PURE__*/_react.default.forwardRef(({
     role: hasTooltip && role === undefined ? "tooltip" : role
   }));
 
-  const {
-    tooltipPosition: tooltipPositionFromContext
-  } = (0, _react.useContext)(_tooltipProvider.TooltipContext);
-
   if (tooltipMessage) {
-    const visible = disabled ? false : tooltipVisible;
+    const showTooltip = tooltipVisibleFromContext !== undefined ? tooltipVisibleFromContext : tooltipVisible;
+    const visible = disabled ? false : showTooltip;
     return /*#__PURE__*/_react.default.createElement(_tooltip.default, {
       message: tooltipMessage,
       position: tooltipPositionFromContext || tooltipPosition,

package/lib/components/icon-button/icon-button.component.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
@@ -19,8 +19,14 @@ var _icon = _interopRequireDefault(require("../icon"));
 
 var _utils = require("../../style/utils");
 
+var _tooltipProvider = require("../../__internal__/tooltip-provider");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
+
+function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
+
 function _extends() { _extends = Object.assign || 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); }
 
 const marginPropTypes = (0, _utils.filterStyledSystemMarginProps)(_propTypes2.default.space);
@@ -29,9 +35,16 @@ const IconButton = /*#__PURE__*/_react.default.forwardRef(({
   "aria-label": ariaLabel,
   onAction,
   children,
+  disabled,
   ...rest
 }, ref) => {
   const marginProps = (0, _utils.filterStyledSystemMarginProps)(rest);
+  const hasIconWithTooltip = !!_react.default.Children.toArray(children).find(child => {
+    var _child$props;
+
+    return child === null || child === void 0 ? void 0 : (_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.tooltipMessage;
+  });
+  const [tooltipVisible, setTooltipVisible] = (0, _react.useState)(undefined);
 
   const onKeyDown = e => {
     if (_events.default.isEnterKey(e) || _events.default.isSpaceKey(e)) {
@@ -46,12 +59,27 @@ const IconButton = /*#__PURE__*/_react.default.forwardRef(({
     onAction(e);
   };
 
+  const handleTooltipVisibility = (ev, callbackName) => {
+    setTooltipVisible(["onFocus", "onMouseEnter"].includes(callbackName));
+    if (rest[callbackName]) rest[callbackName](ev);
+  };
+
   return /*#__PURE__*/_react.default.createElement(_iconButton.default, _extends({}, rest, {
     "aria-label": ariaLabel,
     onKeyDown: onKeyDown,
     onClick: handleOnAction,
-    ref: ref
-  }, marginProps), children);
+    ref: ref,
+    disabled: disabled
+  }, !disabled && hasIconWithTooltip && {
+    onFocus: ev => handleTooltipVisibility(ev, "onFocus"),
+    onBlur: ev => handleTooltipVisibility(ev, "onBlur"),
+    onMouseEnter: ev => handleTooltipVisibility(ev, "onMouseEnter"),
+    onMouseLeave: ev => handleTooltipVisibility(ev, "onMouseLeave")
+  }, marginProps), /*#__PURE__*/_react.default.createElement(_tooltipProvider.TooltipProvider, {
+    disabled: disabled,
+    tooltipVisible: tooltipVisible,
+    focusable: false
+  }, children));
 });
 
 IconButton.propTypes = { ...marginPropTypes,
@@ -65,7 +93,10 @@ IconButton.propTypes = { ...marginPropTypes,
   onAction: _propTypes.default.func.isRequired,
 
   /** Prop to specify the aria-label of the icon-button component */
-  "aria-label": _propTypes.default.string
+  "aria-label": _propTypes.default.string,
+
+  /** Set the button to disabled */
+  disabled: _propTypes.default.bool
 };
 var _default = IconButton;
 exports.default = _default;

package/lib/components/icon-button/icon-button.d.ts

@@ -7,6 +7,8 @@ export interface IconButtonProps extends MarginProps {
   children: React.ReactElement<IconProps>;
   /** Callback */
   onAction: React.MouseEventHandler<HTMLButtonElement>;
+  /** Set the button to disabled */
+  disabled?: boolean;
 }
 
 declare function IconButton(

package/lib/components/select/multi-select/multi-select.component.js

@@ -344,7 +344,7 @@ const MultiSelect = /*#__PURE__*/_react.default.forwardRef(({
     } = optionData;
 
     if (selectionType === "navigationKey") {
-      setHighlightedValue("");
+      setHighlightedValue(newValue);
       return;
     }
 
@@ -353,26 +353,23 @@ const MultiSelect = /*#__PURE__*/_react.default.forwardRef(({
     }
 
     setTextValue("");
+    const isAlreadySelected = selectedValue.findIndex(val => (0, _isExpectedValue.default)(val, newValue)) !== -1;
+
+    if (!isAlreadySelected && isControlled.current && onChange) {
+      onChange(createCustomEvent([...selectedValue, newValue]));
+    }
+
     setSelectedValue(previousValue => {
       textboxRef.focus();
       isMouseDownReported.current = false;
-      const isAlreadySelected = previousValue.findIndex(val => (0, _isExpectedValue.default)(val, newValue)) !== -1;
 
       if (isAlreadySelected) {
         return previousValue;
       }
 
-      const valueList = [...previousValue, newValue];
-
-      if (isControlled.current && onChange) {
-        onChange(createCustomEvent(valueList));
-        return previousValue;
-      }
-
-      return valueList;
+      return [...previousValue, newValue];
     });
-  }, // eslint-disable-next-line react-hooks/exhaustive-deps
-  [createCustomEvent, onChange, textboxRef]);
+  }, [createCustomEvent, onChange, textboxRef, selectedValue]);
 
   function onSelectListClose() {
     setOpenState(false);

package/lib/components/tabs/__internal__/tab-title/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./tab-title";

package/lib/components/tabs/__internal__/tab-title/tab-title.component.js

@@ -52,6 +52,7 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
   isInSidebar,
   href,
   onKeyDown,
+  align,
   ...tabTitleProps
 }, ref) => {
   const keys = (0, _react.useRef)([]);
@@ -74,6 +75,8 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
   };
 
   const handleClick = ev => {
+    var _ref$current;
+
     ev.preventDefault();
     const customEvent = { ...ev,
       target: { ...ev.target,
@@ -86,8 +89,10 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     if (href) {
       onClick(customEvent);
       return window.open(href, "_blank");
-    }
+    } // safari does not focus buttons by default
 
+
+    (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.focus();
     return onClick(customEvent);
   };
 
@@ -131,18 +136,17 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     error: error,
     warning: warning,
     info: info,
-    size: size,
     noRightBorder: noRightBorder,
     alternateStyling: alternateStyling || isInSidebar,
     borders: borders,
     isInSidebar: isInSidebar
-  }, tabTitleProps, (0, _tags.default)("tab-header", tabTitleProps), {
-    onKeyDown: handleKeyDown
-  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledTitleContent, _extends({}, isHref && {
+  }, tabTitleProps, isHref && {
     href,
     target: "_blank",
     as: "a"
-  }, {
+  }, (0, _tags.default)("tab-header", tabTitleProps), {
+    onKeyDown: handleKeyDown
+  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledTitleContent, {
     error: error,
     warning: warning,
     info: info,
@@ -155,23 +159,29 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     hasSiblings: !!siblings,
     isTabSelected: isTabSelected,
     hasCustomLayout: !!customLayout,
-    alternateStyling: hasAlternateStyling
-  }), renderContent(), isHref && /*#__PURE__*/_react.default.createElement(_icon.default, {
+    alternateStyling: hasAlternateStyling,
+    align: align,
+    hasHref: !!href
+  }, renderContent(), isHref && /*#__PURE__*/_react.default.createElement(_icon.default, {
     type: "link"
-  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledLayoutWrapper, {
+  }), hasFailedValidation && /*#__PURE__*/_react.default.createElement(_tabTitle.StyledLayoutWrapper, {
+    position: position,
     hasCustomSibling: !!customLayout
   }, error && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    error: errorMessage
+    error: errorMessage,
+    tabIndex: null
   }), !error && warning && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    warning: warningMessage
+    warning: warningMessage,
+    tabIndex: null
   }), !warning && !error && info && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    info: infoMessage
+    info: infoMessage,
+    tabIndex: null
   }))), !(hasFailedValidation || hasAlternateStyling) && isTabSelected && /*#__PURE__*/_react.default.createElement(_tabTitle.StyledSelectedIndicator, {
     "data-element": "tab-selected-indicator",
     position: position,
@@ -204,7 +214,8 @@ TabTitle.propTypes = {
   noRightBorder: _propTypes.default.bool,
   customLayout: _propTypes.default.node,
   isInSidebar: _propTypes.default.bool,
-  href: _propTypes.default.string
+  href: _propTypes.default.string,
+  align: _propTypes.default.oneOf(["left", "right"])
 };
 var _default = TabTitle;
 exports.default = _default;

package/lib/components/tabs/__internal__/tab-title/tab-title.d.ts

@@ -0,0 +1,39 @@
+import * as React from "react";
+
+export interface TabTitleProps {
+  title: string;
+  id?: string;
+  dataTabId?: string;
+  className?: string;
+  children?: React.ReactNode;
+  isTabSelected?: boolean;
+  position?: "top" | "left";
+  errorMessage?: string;
+  warningMessage?: string;
+  infoMessage?: string;
+  errors?: boolean;
+  warning?: boolean;
+  info?: boolean;
+  borders?: boolean;
+  noLeftBorder?: boolean;
+  noRightBorder?: boolean;
+  alternateStyling?: boolean;
+  isInSidebar?: boolean;
+  siblings?: React.ReactNode[];
+  titlePosition?: "before" | "after";
+  href?: string;
+  tabIndex?: string;
+  size?: "default" | "large";
+  align?: "left" | "right";
+  customLayout?: React.ReactNode;
+  onClick?: (
+    ev: React.MouseEvent<HTMLButtonElement | HTMLAnchorElement>
+  ) => void;
+  onKeyDown?: (
+    ev: React.KeyboardEvent<HTMLButtonElement | HTMLAnchorElement>
+  ) => void;
+}
+
+declare function TabTitle(props: TabTitleProps): JSX.Element;
+
+export default TabTitle;

package/lib/components/tabs/__internal__/tab-title/tab-title.style.js

@@ -21,8 +21,9 @@ function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return
 
 function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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 StyledTitleContent = _styledComponents.default.div`
+const StyledTitleContent = _styledComponents.default.span`
   outline: none;
+  display: inline-block;
 
   ${({
   theme,
@@ -32,17 +33,22 @@ const StyledTitleContent = _styledComponents.default.div`
   noLeftBorder,
   noRightBorder,
   isTabSelected,
-  hasSiblings,
-  href,
+  hasHref,
   error,
-  warning,
-  info,
-  alternateStyling
+  alternateStyling,
+  align
 }) => (0, _styledComponents.css)`
     line-height: 20px;
     margin: 0;
+    text-align: ${align};
+
+    ${position === "left" && (0, _styledComponents.css)`
+      display: flex;
+      width: 100%;
+      justify-content: ${align === "right" ? "flex-end" : "flex-start"};
+    `}
 
-    ${href && (0, _styledComponents.css)`
+    ${hasHref && (0, _styledComponents.css)`
       color: ${theme.text.color};
       display: block;
       text-decoration: none;
@@ -81,10 +87,8 @@ const StyledTitleContent = _styledComponents.default.div`
 
     ${size === "large" && position === "top" && (0, _styledComponents.css)`
       padding: 10px 24px;
+      ${borders && `padding-bottom: 9px;`}
       font-size: 16px;
-      ${isTabSelected && !hasSiblings && !(error || warning || info) && (0, _styledComponents.css)`
-        padding-bottom: 6px;
-      `}
     `}
 
     ${size === "large" && position === "left" && (0, _styledComponents.css)`
@@ -95,11 +99,12 @@ const StyledTitleContent = _styledComponents.default.div`
 
     ${size === "default" && (0, _styledComponents.css)`
       padding: 10px 16px;
-      ${isTabSelected && !(error || warning || info) && position === "top" && (0, _styledComponents.css)`
-        padding-bottom: 8px;
-      `}
 
-      ${position === "left" && !isTabSelected && !alternateStyling && error && `margin-right: -2px;`}
+      ${borders && `padding-bottom: 9px;`}
+
+      ${position === "left" && !isTabSelected && !alternateStyling && error && `
+        margin-right: -2px;
+      `}
     `}
   `}
 
@@ -131,7 +136,7 @@ const StyledTitleContent = _styledComponents.default.div`
         padding-right: ${size === "large" ? "26px;" : "18px;"};
       `}
       
-    &:hover {
+      &:hover {
         outline: 1px solid;
         outline-offset: -1px;
 
@@ -174,10 +179,10 @@ const StyledTitleContent = _styledComponents.default.div`
 
       ${position === "left" && (0, _styledComponents.css)`
         border-right-color: transparent;
-        padding-right: ${size === "large" ? "26px;" : "18px;"};
+        padding-right: ${size === "large" ? "26px" : "18px"};
       `}
     
-    &:hover {
+      &:hover {
         outline: 2px solid ${theme.colors.error};
         outline-offset: -2px;
         ${position === "top" && (0, _styledComponents.css)`
@@ -190,7 +195,7 @@ const StyledTitleContent = _styledComponents.default.div`
 
         ${position === "left" && (0, _styledComponents.css)`
           border-right-color: transparent;
-          padding-right: ${size === "large" ? "26px;" : "18px;"};
+          padding-right: ${size === "large" ? "26px" : "18px"};
         `}
       }
     `}
@@ -206,23 +211,11 @@ const StyledTitleContent = _styledComponents.default.div`
   position
 }) => hasSiblings && !hasCustomLayout && position === "top" && (0, _styledComponents.css)`
       height: 20px;
+      padding-top: 10px;
+      padding-bottom: 10px;
 
-      ${size === "default" && (0, _styledComponents.css)`
-        padding-top: 10px;
-        padding-bottom: 10px;
-
-        ${!(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
-          padding-bottom: 8px;
-        `}
-      `}
-
-      ${size === "large" && (0, _styledComponents.css)`
-        padding-top: 10px;
-        padding-bottom: 10px;
-
-        ${!(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
-          padding-bottom: 6px;
-        `}
+      ${size === "large" && !(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
+        padding-bottom: 6px;
       `}
     `}
 
@@ -238,13 +231,13 @@ const StyledTitleContent = _styledComponents.default.div`
       display: flex;
 
       ${position === "left" && (0, _styledComponents.css)`
-        padding: ${size === "large" ? "2px;" : "0px;"}
-          ${isTabSelected && (0, _styledComponents.css)`
-            padding-right: 0px;
-          `}
-          ${(error || warning || info) && (0, _styledComponents.css)`
-            padding-right: ${size === "large" ? "26px" : "18px"};
-          `};
+        padding: ${size === "large" ? "2px" : "0px"};
+        ${isTabSelected && (0, _styledComponents.css)`
+          padding-right: 0px;
+        `}
+        ${(error || warning || info) && (0, _styledComponents.css)`
+          padding-right: ${size === "large" ? "26px" : "18px"};
+        `}
       `}
 
       ${position === "top" && (0, _styledComponents.css)`
@@ -253,49 +246,63 @@ const StyledTitleContent = _styledComponents.default.div`
             padding-bottom: 0px;
           `}
           ${(error || warning || info) && (0, _styledComponents.css)`
-        padding-bottom: ${size === "large" ? "4px;" : "2px;"}
-        padding-right: ${size === "large" ? "18px;" : "14px;"}
-
-        &:hover {
           padding-bottom: ${size === "large" ? "4px;" : "2px;"}
-        }
-      `};
+          padding-right: ${size === "large" ? "18px;" : "14px;"}
+
+          &:hover {
+            padding-bottom: ${size === "large" ? "4px;" : "2px;"}
+          }
+        `};
       `}
     `}
 `;
 exports.StyledTitleContent = StyledTitleContent;
-const StyledTabTitle = _styledComponents.default.li`
+const StyledTabTitle = _styledComponents.default.button`
   background-color: transparent;
   display: inline-block;
   font-weight: bold;
-  height: 100%;
   position: relative;
+  border: none;
+  cursor: pointer;
+  font-size: 14px;
+  padding: 0px;
+  text-decoration: none;
+  outline-offset: 0px;
+  margin: 0;
+
+  a:visited {
+    color: inherit;
+  }
 
   ${({
   position,
   borders,
   noRightBorder,
   noLeftBorder
-}) => `
-      ${position === "top" && (0, _styledComponents.css)`
-          ${borders && !(noRightBorder || noLeftBorder) && (0, _styledComponents.css)`
-            &:not(:first-of-type) {
-              margin-left: -1px;
-            }
-          `}
-        `}
-      ${position === "left" && (0, _styledComponents.css)`
-          ${borders && (0, _styledComponents.css)`
-            &:not(:first-of-type) {
-              margin-top: -1px;
-            }
-          `}
-        `}
-    `}
+}) => (0, _styledComponents.css)`
+    ${position === "top" && (0, _styledComponents.css)`
+      height: 40px;
 
-  &:first-child {
-    margin-left: 0;
-  }
+      ${borders && !(noRightBorder || noLeftBorder) && (0, _styledComponents.css)`
+        &:nth-of-type(n + 1) {
+          margin-left: -1px;
+        }
+        &:first-child {
+          margin-left: 0;
+        }
+      `}
+    `}
+    ${position === "left" && (0, _styledComponents.css)`
+      ${borders && (0, _styledComponents.css)`
+        &:nth-of-type(n + 1) {
+          margin-top: -1px;
+        }
+        &:first-child {
+          margin-top: 0;
+        }
+      `}
+    `}
+  `}
 
   ${({
   isTabSelected,
@@ -319,27 +326,12 @@ const StyledTabTitle = _styledComponents.default.li`
   error,
   warning,
   info,
-  size,
-  isInSidebar,
-  position
+  isInSidebar
 }) => isTabSelected && (0, _styledComponents.css)`
     ${!isInSidebar && "z-index: 1;"}
     color: ${theme.text.color};
     background-color: ${theme.colors.white};
 
-    ${alternateStyling && (0, _styledComponents.css)`
-        border-bottom: 2px solid ${theme.tab.background};
-      `}
-
-    ${!alternateStyling && (0, _styledComponents.css)`
-        padding-bottom: 2px;
-      `}
-
-    ${size === "large" && (0, _styledComponents.css)`
-        ${position === "top" && `
-          padding-bottom: ${alternateStyling ? "3px" : "4px"};
-          `}
-      `}
     ${(error || warning || info) && (0, _styledComponents.css)`
         padding-bottom: 0px;
       `}
@@ -364,7 +356,6 @@ const StyledTabTitle = _styledComponents.default.li`
   
   ${({
   position,
-  size,
   borders,
   theme,
   alternateStyling,
@@ -387,7 +378,7 @@ const StyledTabTitle = _styledComponents.default.li`
         }
       `}
 
-      display: block;
+      display: flex;
       height: auto;
       margin-left: 0px;
 
@@ -422,12 +413,6 @@ const StyledTabTitle = _styledComponents.default.li`
     
           background-color: ${theme.colors.white};
 
-          ${size === "large" && (0, _styledComponents.css)`
-            & ${StyledTitleContent} {
-              padding-right: 22px;
-            }
-          `}
-
           &:hover {
             ${alternateStyling && ` border-right-color: ${theme.tab.background};`}
             background-color: ${theme.colors.white};
@@ -473,7 +458,8 @@ const StyledLayoutWrapper = _styledComponents.default.div`
   ${({
   hasCustomLayout,
   titlePosition,
-  hasCustomSibling
+  hasCustomSibling,
+  position
 }) => !hasCustomLayout && (0, _styledComponents.css)`
       display: inline-flex;
 
@@ -500,7 +486,7 @@ const StyledLayoutWrapper = _styledComponents.default.div`
         ${_icon.default} {
           height: 16px;
           left: -2px;
-          top: 3px;
+          top: ${position === "left" ? "1px" : "3px"};
         }
       }
     `}

package/lib/components/tabs/__internal__/tabs-header/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./tab-header";

package/lib/components/tabs/__internal__/tabs-header/tab-header.d.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+
+export interface TabHeaderProps {
+  role?: string;
+  position?: "top" | "left";
+  extendedLine?: boolean;
+  noRightBorder?: boolean;
+  alternateStyling?: boolean;
+  isInSidebar?: boolean;
+  children: React.ReactNode;
+  align?: "left" | "right";
+}
+
+declare function TabHeader(props: TabHeaderProps): JSX.Element;
+
+export default TabHeader;

package/lib/components/tabs/__internal__/tabs-header/tabs-header.style.js

@@ -50,7 +50,7 @@ const StyledTabsHeaderWrapper = _styledComponents.default.div`
     `}
 `;
 exports.StyledTabsHeaderWrapper = StyledTabsHeaderWrapper;
-const StyledTabsHeaderList = _styledComponents.default.ul`
+const StyledTabsHeaderList = _styledComponents.default.div`
   display: flex;
   box-shadow: inset 0px ${computeLineWidth} 0px 0px
     ${({

package/lib/components/tabs/tabs.component.js

@@ -249,6 +249,7 @@ const Tabs = ({
         noRightBorder: ["no right side", "no sides"].includes(borders),
         customLayout: customLayout,
         isInSidebar: isInSidebar,
+        align: align,
         onFocus: () => {
           if (!hasTabStop(tabId)) {
             setTabStopId(tabId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "101.0.4",
+  "version": "101.3.1",
   "description": "A library of reusable React components for easily building user interfaces.",
   "engineStrict": true,
   "engines": {