carbon-react 108.0.0 → 109.0.2

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

@@ -0,0 +1,46 @@
+import React from "react";
+import { MarginProps } from "styled-system";
+import { StyledIconProps } from "./icon.style";
+import { IconType } from "./icon-type";
+import { TooltipPositions } from "../tooltip/tooltip.config";
+export declare type LegacyIconTypes = "help" | "maintenance" | "new" | "success" | "messages";
+export interface IconProps extends Omit<StyledIconProps, "type">, MarginProps {
+    /** Set whether icon should be recognised by assistive technologies */
+    "aria-hidden"?: boolean;
+    /** Aria label for accessibility purposes */
+    ariaLabel?: string;
+    /** Id passed to the icon. */
+    id?: string;
+    /** The ARIA role to be applied to the Icon */
+    role?: string;
+    /** The message to be displayed within the tooltip */
+    tooltipMessage?: React.ReactNode;
+    /** The position to display the tooltip */
+    tooltipPosition?: TooltipPositions;
+    /** Control whether the tooltip is visible */
+    tooltipVisible?: boolean;
+    /** Override background color of the Tooltip, provide any color from palette or any valid css color value. */
+    tooltipBgColor?: string;
+    /** Override font color of the Tooltip, provide any color from palette or any valid css color value. */
+    tooltipFontColor?: string;
+    /** Overrides the default flip behaviour of the Tooltip */
+    tooltipFlipOverrides?: TooltipPositions[];
+    /** Id passed to the tooltip container, used for accessibility purposes */
+    tooltipId?: string;
+    /**
+     * Icon type
+     *
+     * The full list of types can be seen [here](https://carbon.sage.com/?path=/docs/icon--list-of-icons#list-of-icons).
+     */
+    type: IconType | LegacyIconTypes;
+    /** @ignore @private */
+    focusable?: boolean;
+    /** @ignore @private */
+    isPartOfInput?: boolean;
+    /** @ignore @private */
+    inputSize?: "small" | "medium" | "large";
+    /** @ignore @private */
+    tabIndex?: number;
+}
+declare const Icon: React.ForwardRefExoticComponent<IconProps & React.RefAttributes<HTMLSpanElement>>;
+export default Icon;

package/esm/components/icon/icon.component.js

@@ -1,25 +1,27 @@
-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); }
-
 import React, { useContext } from "react";
 import PropTypes from "prop-types";
-import styledSystemPropTypes from "@styled-system/prop-types";
-import tagComponent from "../../__internal__/utils/helpers/tags/tags";
-import StyledIcon from "./icon.style";
+import invariant from "invariant";
 import Tooltip from "../tooltip";
 import { filterStyledSystemMarginProps } from "../../style/utils";
-import { ICON_TOOLTIP_POSITIONS } from "./icon-config";
 import { TooltipContext } from "../../__internal__/tooltip-provider";
-const marginPropTypes = filterStyledSystemMarginProps(styledSystemPropTypes.space);
+import tagComponent from "../../__internal__/utils/helpers/tags/tags";
+import StyledIcon from "./icon.style";
+import { ICON_TOOLTIP_POSITIONS } from "./icon-config";
 const Icon = /*#__PURE__*/React.forwardRef(({
   "aria-hidden": ariaHidden,
+  ariaLabel,
   bg,
   bgShape,
-  bgSize,
+  bgSize = "small",
   className,
   color,
   disabled,
-  fontSize,
-  type,
+  focusable = true,
+  fontSize = "small",
+  id,
+  inputSize,
+  isPartOfInput,
+  tabIndex,
   tooltipMessage,
   tooltipPosition,
   tooltipVisible,
@@ -27,15 +29,16 @@ const Icon = /*#__PURE__*/React.forwardRef(({
   tooltipFontColor,
   tooltipFlipOverrides,
   tooltipId,
-  tabIndex,
-  id,
-  isPartOfInput,
-  inputSize,
+  type,
   role,
-  ariaLabel,
-  focusable = true,
   ...rest
 }, ref) => {
+  const flipBehaviourCheck = Array.isArray(tooltipFlipOverrides) && tooltipFlipOverrides.every(override => ICON_TOOLTIP_POSITIONS.includes(override));
+
+  if (tooltipFlipOverrides) {
+    invariant(flipBehaviourCheck, `The tooltipFlipOverrides prop supplied to \`Icon\` must be an array containing some or all of ["top", "bottom", "left", "right"].`);
+  }
+
   const isInteractive = !!tooltipMessage && !disabled;
   const {
     tooltipPosition: tooltipPositionFromContext,
@@ -71,31 +74,29 @@ const Icon = /*#__PURE__*/React.forwardRef(({
   };
 
   const isFocusable = focusableFromContext !== undefined ? focusableFromContext : focusable;
-  const hasTooltip = !disabled && !disabledFromContext && tooltipMessage && isFocusable;
-  const styleProps = {
+  const hasTooltip = !disabled && !disabledFromContext && !!tooltipMessage && isFocusable;
+  const styledIconProps = {
+    "aria-hidden": ariaHidden,
+    "aria-label": ariaLabel,
     bg,
     bgSize,
     bgShape,
+    className: className || undefined,
     color,
+    "data-element": iconType(),
     disabled: disabledFromContext || disabled,
     fontSize,
+    hasTooltip,
+    id,
     isInteractive,
-    type: iconType(),
+    key: "icon",
+    ref,
+    role,
     tabIndex: hasTooltip && tabIndex === undefined ? 0 : tabIndex,
+    type: iconType(),
+    ...tagComponent("icon", rest),
     ...filterStyledSystemMarginProps(rest)
   };
-  const icon = /*#__PURE__*/React.createElement(StyledIcon, _extends({
-    "aria-hidden": ariaHidden,
-    ref: ref,
-    key: "icon",
-    id: id,
-    className: className || null,
-    "data-element": iconType()
-  }, tagComponent("icon", rest), styleProps, {
-    hasTooltip: hasTooltip,
-    "aria-label": ariaLabel,
-    role: role
-  }));
 
   if (tooltipMessage) {
     const showTooltip = tooltipVisibleFromContext !== undefined ? tooltipVisibleFromContext : tooltipVisible;
@@ -112,103 +113,189 @@ const Icon = /*#__PURE__*/React.forwardRef(({
       fontColor: tooltipFontColor,
       flipOverrides: tooltipFlipOverrides,
       target: target
-    }, icon);
+    }, /*#__PURE__*/React.createElement(StyledIcon, styledIconProps));
   }
 
-  return icon;
+  return /*#__PURE__*/React.createElement(StyledIcon, styledIconProps);
 });
-Icon.propTypes = { ...marginPropTypes,
-
-  /**
-   * @private
-   * @ignore
-   * Add classes to this component
-   * */
-  className: PropTypes.string,
-
-  /**
-   * Icon type.
-   *
-   * The full list of types can be seen [here](https://github.com/Sage/carbon/blob/master/src/components/icon/icon-config.js).
-   * */
-  type: PropTypes.string.isRequired,
-
-  /** Background size */
-  bgSize: PropTypes.oneOf(["extra-small", "small", "medium", "large", "extra-large"]),
-
-  /** Background shape */
-  bgShape: PropTypes.oneOf(["circle", "rounded-rect", "square"]),
-
-  /** Icon font size */
-  fontSize: PropTypes.oneOf(["small", "medium", "large", "extra-large"]),
-
-  /** Icon colour, provide design token, any color from palette or any valid css color value. */
-  color: PropTypes.string,
-
-  /** Background colour, provide design token, any color from palette, or any valid css color value. */
-  bg: PropTypes.string,
-
-  /** Sets the icon in the disabled state */
-  disabled: PropTypes.bool,
-
-  /** Aria label for accessibility purposes */
-  ariaLabel: PropTypes.string,
-
-  /** Set whether icon should be recognised by assistive technologies */
+Icon.propTypes = {
   "aria-hidden": PropTypes.bool,
-
-  /** The message to be displayed within the tooltip */
-  tooltipMessage: PropTypes.node,
-
-  /** The position to display the tooltip */
-  tooltipPosition: PropTypes.oneOf(["top", "bottom", "left", "right"]),
-
-  /** Control whether the tooltip is visible */
-  tooltipVisible: PropTypes.bool,
-
-  /** Override background color of the Tooltip, provide design token, any color from palette or any valid css color value. */
-  tooltipBgColor: PropTypes.string,
-
-  /** Override font color of the Tooltip, provide design token, any color from palette or any valid css color value. */
-  tooltipFontColor: PropTypes.string,
-
-  /** Id passed to the tooltip container, used for accessibility purposes. */
-  tooltipId: PropTypes.string,
-
-  /** Overrides the default flip behaviour of the Tooltip, must be an array containing some or all of ["top", "bottom", "left", "right"].
-   *
-   *  See the Popper [documentation](https://popper.js.org/docs/v2/modifiers/flip/#fallbackplacements) for more information
-   * */
-  tooltipFlipOverrides: (props, propName) => {
-    const prop = props[propName];
-    const isValid = prop && Array.isArray(prop) && prop.every(placement => ICON_TOOLTIP_POSITIONS.includes(placement));
-
-    if (!prop || isValid) {
-      return null;
-    }
-
-    return new Error( // eslint-disable-next-line max-len
-    `The \`${propName}\` prop supplied to \`Icon\` must be an array containing some or all of ["top", "bottom", "left", "right"].`);
-  },
-
-  /** @ignore @private */
-  isPartOfInput: PropTypes.bool,
-
-  /** @ignore @private */
-  inputSize: PropTypes.oneOf(["small", "medium", "large"]),
-
-  /** @ignore @private */
-  tabIndex: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
-
-  /** @ignore @private */
-  focusable: PropTypes.bool,
-
-  /** Id passed to the icon. */
-  id: PropTypes.string
-};
-Icon.defaultProps = {
-  bgSize: "small",
-  fontSize: "small",
-  disabled: false
+  "ariaLabel": PropTypes.string,
+  "bg": PropTypes.string,
+  "bgShape": PropTypes.oneOf(["circle", "rounded-rect", "square"]),
+  "bgSize": PropTypes.oneOf(["extra-large", "extra-small", "large", "medium", "small"]),
+  "className": PropTypes.string,
+  "color": PropTypes.string,
+  "disabled": PropTypes.bool,
+  "focusable": PropTypes.bool,
+  "fontSize": PropTypes.oneOf(["extra-large", "large", "medium", "small"]),
+  "id": PropTypes.string,
+  "inputSize": PropTypes.oneOf(["large", "medium", "small"]),
+  "isPartOfInput": PropTypes.bool,
+  "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]),
+  "role": PropTypes.string,
+  "tabIndex": PropTypes.number,
+  "tooltipBgColor": PropTypes.string,
+  "tooltipFlipOverrides": PropTypes.arrayOf(PropTypes.oneOf(["bottom", "left", "right", "top"])),
+  "tooltipFontColor": PropTypes.string,
+  "tooltipId": PropTypes.string,
+  "tooltipMessage": PropTypes.node,
+  "tooltipPosition": PropTypes.oneOf(["bottom", "left", "right", "top"]),
+  "tooltipVisible": PropTypes.bool,
+  "type": PropTypes.oneOf(["add", "admin", "alert", "analysis", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_up", "arrow", "attach", "bank", "basket_with_squares", "basket", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "gift", "go", "graph", "grid", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "maintenance", "marker", "message", "messages", "minus_large", "minus", "mobile", "money_bag", "new", "none", "old_warning", "pause_circle", "pause", "pdf", "people_switch", "people", "person_info", "person_tick", "person", "phone", "piggy_bank", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "success", "sync", "tag", "talk", "three_boxes", "tick_circle", "tick", "true_tick", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]).isRequired
 };
+Icon.displayName = "Icon";
 export default Icon;

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

@@ -1,2 +1,38 @@
+import { ThemeObject } from "../../style/themes/base";
+import { IconType } from "./icon-type";
+export declare type BackgroundShape = "circle" | "rounded-rect" | "square";
+export declare type BgSize = "extra-small" | "small" | "medium" | "large" | "extra-large";
+export declare type FontSize = "small" | "medium" | "large" | "extra-large";
+export interface StyledIconProps {
+    /** Background colour, provide any color from palette or any valid css color value. */
+    bg?: string;
+    /** Background shape */
+    bgShape?: BackgroundShape;
+    /** Background size */
+    bgSize?: BgSize;
+    /**
+     * @private
+     * @ignore
+     * Add classes to this component
+     */
+    className?: string;
+    /** Icon colour, provide any color from palette or any valid css color value. */
+    color?: string;
+    /** Sets the icon in the disabled state */
+    disabled?: boolean;
+    /** Icon font size */
+    fontSize?: FontSize;
+    /**
+     * Icon type
+     *
+     * The full list of types can be seen [here](https://github.com/Sage/carbon/blob/master/src/components/icon/icon-config.js).
+     */
+    type: IconType;
+}
+export interface StyledIconInternalProps {
+    isInteractive?: boolean;
+    hasTooltip?: boolean;
+    theme?: ThemeObject;
+}
+declare const StyledIcon: import("styled-components").StyledComponent<"span", any, StyledIconProps & StyledIconInternalProps, never>;
 export default StyledIcon;
-declare const StyledIcon: import("styled-components").StyledComponent<"span", any, {}, never>;

package/esm/components/icon/icon.style.js

@@ -1,38 +1,19 @@
 import styled, { css } from "styled-components";
-import PropTypes from "prop-types";
 import { shade } from "polished";
 import { margin } from "styled-system";
 import iconUnicodes from "./icon-unicodes";
 import baseTheme from "../../style/themes/base";
-import iconSizeConfig, { ICON_SHAPES } from "./icon-config";
+import iconConfig from "./icon-config";
 import browserTypeCheck, { isSafari } from "../../__internal__/utils/helpers/browser-type-check";
 import styledColor from "../../style/utils/color";
 import getColorValue from "../../style/utils/get-color-value";
 
 function adjustIconBgSize(fontSize, bgSize) {
-  var _replacements$fontSiz;
-
-  const replacements = {
-    medium: {
-      small: "medium"
-    },
-    large: {
-      small: "large",
-      medium: "large"
-    },
-    "extra-large": {
-      small: "extra-large",
-      medium: "extra-large",
-      large: "extra-large"
-    }
-  };
-  const replacement = replacements === null || replacements === void 0 ? void 0 : (_replacements$fontSiz = replacements[fontSize]) === null || _replacements$fontSiz === void 0 ? void 0 : _replacements$fontSiz[bgSize];
-
-  if (replacement) {
-    return iconSizeConfig.backgroundSize[replacement];
+  if (fontSize && fontSize !== "small") {
+    return iconConfig.backgroundSize[fontSize];
   }
 
-  return iconSizeConfig.backgroundSize[bgSize];
+  return bgSize ? iconConfig.backgroundSize[bgSize] : undefined;
 }
 
 const StyledIcon = styled.span`
@@ -99,7 +80,7 @@ const StyledIcon = styled.span`
       justify-content: center;
       height: ${adjustIconBgSize(fontSize, bgSize)};
       width: ${adjustIconBgSize(fontSize, bgSize)};
-      border-radius: ${iconSizeConfig.backgroundShape[bgShape]};
+      ${bgShape ? `border-radius: ${iconConfig.backgroundShape[bgShape]}` : ""};
 
       ${isInteractive && css`
         &:hover {
@@ -114,12 +95,15 @@ const StyledIcon = styled.span`
 
         font-family: CarbonIcons;
         content: "${iconUnicodes[type]}";
-        font-size: ${iconSizeConfig.iconSize[fontSize]};
         font-style: normal;
         font-weight: normal;
-        line-height: ${iconSizeConfig.iconSize[fontSize]};
         vertical-align: middle;
 
+        ${fontSize && css`
+          font-size: ${iconConfig.iconSize[fontSize]};
+          line-height: ${iconConfig.iconSize[fontSize]};
+        `}
+
         ${type === "services" && browserTypeCheck(window) && css`
           margin-top: ${fontSize === "small" ? "-7px" : "-8px"};
         `}
@@ -141,15 +125,6 @@ const StyledIcon = styled.span`
     `;
 }}
 `;
-StyledIcon.propTypes = {
-  theme: PropTypes.object,
-  type: PropTypes.string,
-  isInteractive: PropTypes.bool,
-  disabled: PropTypes.bool,
-  bgSize: PropTypes.oneOf(["extra-small", "small", "medium", "large", "extra-large"]),
-  bgShape: PropTypes.oneOf(ICON_SHAPES),
-  fontSize: PropTypes.oneOf(["small", "medium", "large", "extra-large"])
-};
 StyledIcon.defaultProps = {
   theme: baseTheme
 };

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

@@ -1,2 +1,3 @@
-export { default } from "./icon";
-export * from "./icon";
+export { default } from "./icon.component";
+export type { IconProps } from "./icon.component";
+export type { IconType } from "./icon-type";

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

@@ -1,6 +1,6 @@
 import * as React from "react";
 import { MarginProps } from "styled-system";
-import { IconProps } from "../icon/icon";
+import { IconProps } from "../icon/icon-type";
 
 export interface IconButtonProps extends MarginProps {
   /** Optional: alternative rendered content, displayed within <SelectList> of <Select> (eg: an icon, an image, etc) */

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

@@ -1,5 +1,5 @@
 import React from "react";
-import { IconType } from "components/icon/icon";
+import { IconType } from "components/icon/icon-type";
 export interface LinkProps extends React.AriaAttributes {
     /** The disabled state of the link. */
     disabled?: boolean;
@@ -34,5 +34,5 @@ export interface LinkProps extends React.AriaAttributes {
     /** allows to set rel property in <a> tag */
     rel?: string;
 }
-export declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLLinkElement | HTMLButtonElement>>;
+export declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLButtonElement | HTMLLinkElement>>;
 export default Link;

package/esm/components/link/link.component.js

@@ -153,7 +153,7 @@ Link.propTypes = {
   "className": PropTypes.string,
   "disabled": PropTypes.bool,
   "href": PropTypes.string,
-  "icon": PropTypes.oneOf(["add", "alert", "analysis", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_up", "attach", "bank", "basket_with_squares", "basket", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "copy", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "gift", "graph", "grid", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "ledger_arrow_left", "ledger_arrow_right", "ledger", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "messages", "minus_large", "minus", "mobile", "money_bag", "pause_circle", "pause", "pdf", "people_switch", "people", "person_info", "person_tick", "person", "phone", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "three_boxes", "tick_circle", "tick", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
+  "icon": PropTypes.oneOf(["add", "admin", "alert", "analysis", "arrow_down", "arrow_left_boxed", "arrow_left_right_small", "arrow_left_small", "arrow_left", "arrow_right_small", "arrow_right", "arrow_up", "arrow", "attach", "bank", "basket_with_squares", "basket", "bin", "block_arrow_right", "blocked_square", "blocked", "bold", "boxed_shapes", "bulk_destroy", "bullet_list_dotted", "bullet_list_numbers", "bullet_list", "business", "calendar_today", "calendar", "call", "camera", "card_view", "caret_down", "caret_large_down", "caret_large_left", "caret_large_right", "caret_large_up", "caret_left", "caret_right", "caret_up", "cart", "chart_bar", "chart_line", "chart_pie", "chat_notes", "chat", "chevron_down_thick", "chevron_down", "chevron_left_thick", "chevron_left", "chevron_right_thick", "chevron_right", "chevron_up_thick", "chevron_up", "circle_with_dots", "circles_connection", "clock", "close", "coins", "collaborate", "computer_clock", "connect", "contacts", "copy", "create", "credit_card_slash", "credit_card", "cross_circle", "cross", "csv", "delete", "delivery", "disconnect", "disputed", "document_right_align", "document_tick", "document_vertical_lines", "download", "draft", "drag_vertical", "drag", "dropdown", "duplicate", "edit", "edited", "ellipsis_horizontal", "ellipsis_vertical", "email_switch", "email", "entry", "envelope_dollar", "envelope_euro", "error_square", "error", "euro", "expand", "factory", "favourite_lined", "favourite", "fax", "feedback", "file_excel", "file_generic", "file_image", "file_pdf", "file_word", "files_leaning", "filter_new", "filter", "fit_height", "fit_width", "flag", "folder", "gift", "go", "graph", "grid", "help", "hide", "home", "image", "in_progress", "in_transit", "individual", "info", "italic", "key", "ledger_arrow_left", "ledger_arrow_right", "ledger", "lightbulb_off", "lightbulb_on", "link", "list_view", "location", "locked", "logout", "lookup", "marker", "message", "minus_large", "minus", "mobile", "money_bag", "none", "old_warning", "pause_circle", "pause", "pdf", "people_switch", "people", "person_info", "person_tick", "person", "phone", "piggy_bank", "play_circle", "play", "plus_large", "plus", "pound", "print", "progress", "progressed", "question_hollow", "question_mark", "question", "refresh_clock", "refresh", "remove", "sage_coin", "save", "scan", "search", "services", "settings_old", "settings", "share", "shop", "sort_down", "sort_up", "spanner", "split_container", "split", "square_dot", "squares_nine", "stacked_boxes", "stacked_squares", "submitted", "sync", "tag", "talk", "three_boxes", "tick_circle", "tick", "true_tick", "undo", "unlocked", "upload", "uploaded", "video", "view", "warning"]),
   "iconAlign": PropTypes.oneOf(["left", "right"]),
   "isSkipLink": PropTypes.bool,
   "onClick": PropTypes.func,

package/esm/components/menu/menu-item/menu-item.d.ts

@@ -1,4 +1,4 @@
-import { IconType } from "components/icon/icon";
+import { IconType } from "components/icon/icon-type";
 import * as React from "react";
 import { FlexboxProps, LayoutProps } from "styled-system";