carbon-react 142.9.1 → 142.11.0

package/esm/__internal__/popover/popover.component.d.ts

@@ -4,15 +4,47 @@ declare type CustomRefObject<T> = {
     current?: T | null;
 };
 export interface PopoverProps {
+    /**
+     * Element to be positioned, has to be a single node and has to accept `ref` and `style` props.
+     */
     children: React.ReactElement;
+    /**
+     * Placement of children in relation to the reference element.
+     */
     placement?: Placement;
+    /**
+     * Disables interaction with background UI.
+     */
     disableBackgroundUI?: boolean;
+    /**
+     * Optional middleware array, for more information go to:
+     * [https://floating-ui.com/docs/middleware](https://floating-ui.com/docs/middleware)
+     */
     middleware?: Middleware[];
+    /**
+     * When true, children are not rendered in portal.
+     */
     disablePortal?: boolean;
+    /**
+     * Reference element, children will be positioned in relation to this element - should be a ref shaped object.
+     */
     reference: CustomRefObject<HTMLElement>;
+    /**
+     * Determines if the popover is currently open/visible or not. Defaults to true.
+     */
     isOpen?: boolean;
+    /**
+     * Whether to update the position of the floating element on every animation frame if required. This is optimized for performance but can still be costly. Use with caution!
+     * [https://floating-ui.com/docs/autoUpdate#animationframe](https://floating-ui.com/docs/autoUpdate#animationframe)
+     */
     animationFrame?: boolean;
+    /**
+     * Optional strategy to use for positioning the floating element. Defaults to "absolute".
+     */
     popoverStrategy?: "absolute" | "fixed";
+    /**
+     * Allows child ref to be set via a prop instead of dynamically finding it via children iteration.
+     */
     childRefOverride?: MutableRefObject<HTMLDivElement | null>;
 }
 declare const Popover: ({ children, placement, disablePortal, reference, middleware, disableBackgroundUI, isOpen, animationFrame, popoverStrategy, childRefOverride, }: PopoverProps) => React.JSX.Element;

package/esm/__internal__/popover/popover.component.js

@@ -67,7 +67,9 @@ const Popover = ({
   if (disableBackgroundUI) {
     content = /*#__PURE__*/React.createElement(StyledPopoverContent, {
       isOpen: isOpen
-    }, /*#__PURE__*/React.createElement(StyledBackdrop, null, content));
+    }, /*#__PURE__*/React.createElement(StyledBackdrop, {
+      "data-role": "popup-backdrop"
+    }, content));
   }
   if (disablePortal) {
     return content;

package/esm/__internal__/radio-button-mapper/radio-button-mapper.component.js

@@ -23,7 +23,6 @@ const RadioButtonMapper = ({
   const [checkedValue, setCheckedValue] = useState(false);
   const onChangeProp = useCallback(event => {
     onChange?.(event);
-    /* istanbul ignore else */
     if (!isControlled) {
       setCheckedValue(event.target.value);
     }

package/esm/components/flat-table/flat-table-row/flat-table-row.style.js

@@ -171,7 +171,12 @@ const StyledFlatTableRow = styled.tr`
       ${StyledFlatTableHeader} {
         border-bottom: 1px solid ${borderColor(colorTheme)};
 
-        ${!isInSidebar && `
+        ${horizontalBorderSize !== "small" && css`
+          border-bottom: ${horizontalBorderSizes[horizontalBorderSize]} solid
+            var(--colorsUtilityMajor100);
+        `}
+
+        ${!isInSidebar && !colorTheme?.includes("transparent") && `
           :first-child {
             border-left: 1px solid ${borderColor(colorTheme)};
           }

package/esm/components/flat-table/flat-table.component.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { MarginProps } from "styled-system";
+import * as DesignTokens from "@sage/design-tokens/js/base/common";
 export interface FlatTableProps extends MarginProps {
     /** The HTML id of the element that contains a description of this table. */
     ariaDescribedby?: string;
@@ -25,13 +26,17 @@ export interface FlatTableProps extends MarginProps {
     size?: "compact" | "small" | "medium" | "large" | "extraLarge";
     /** Applies max-height of 100% to FlatTable if true */
     hasMaxHeight?: boolean;
+    /** Toggles the visibility of the table's outer left and right borders. When false, the left border of the first column and the right border of the last column are hidden.  */
+    hasOuterVerticalBorders?: boolean;
+    /** Sets the border radius of the first and last cells in the last row. */
+    bottomBorderRadius?: Extract<keyof typeof DesignTokens, `borderRadius${number}`>;
     /** Set the overflow X of the table wrapper. Any valid CSS string */
     overflowX?: string;
     /** Width of the table. Any valid CSS string */
     width?: string;
 }
 export declare const FlatTable: {
-    ({ caption, children, hasStickyHead, colorTheme, footer, hasStickyFooter, height, isZebra, size, hasMaxHeight, ariaDescribedby, minHeight, overflowX, width, ...rest }: FlatTableProps): React.JSX.Element;
+    ({ caption, children, hasStickyHead, colorTheme, footer, hasStickyFooter, height, isZebra, size, hasMaxHeight, hasOuterVerticalBorders, bottomBorderRadius, ariaDescribedby, minHeight, overflowX, width, ...rest }: FlatTableProps): React.JSX.Element;
     displayName: string;
 };
 export default FlatTable;

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

@@ -17,6 +17,8 @@ export const FlatTable = ({
   isZebra,
   size = "medium",
   hasMaxHeight = false,
+  hasOuterVerticalBorders = true,
+  bottomBorderRadius = "borderRadius100",
   ariaDescribedby,
   minHeight,
   overflowX,
@@ -134,6 +136,7 @@ export const FlatTable = ({
   return /*#__PURE__*/React.createElement(StyledFlatTableWrapper, _extends({
     ref: wrapperRef,
     "data-component": "flat-table-wrapper",
+    "data-role": "flat-table-wrapper",
     isInSidebar: isInSidebar,
     hasStickyHead: hasStickyHead,
     colorTheme: colorTheme,
@@ -141,6 +144,8 @@ export const FlatTable = ({
     overflowY: hasStickyHead || hasStickyFooter ? "auto" : undefined,
     height: addDefaultHeight && !hasMaxHeight ? "99%" : height,
     maxHeight: hasMaxHeight ? "100%" : undefined,
+    hasOuterVerticalBorders: hasOuterVerticalBorders,
+    bottomBorderRadius: bottomBorderRadius,
     display: "flex",
     flexDirection: "column",
     justifyContent: hasStickyFooter || height ? "space-between" : undefined,

package/esm/components/flat-table/flat-table.style.d.ts

@@ -4,12 +4,13 @@ declare const StyledTableContainer: import("styled-components").StyledComponent<
 declare const StyledFlatTable: import("styled-components").StyledComponent<"table", any, Pick<FlatTableProps, "caption" | "isZebra"> & {
     size: NonNullable<FlatTableProps["size"]>;
 }, never>;
-interface StyledFlatTableWrapperProps extends Pick<FlatTableProps, "hasStickyFooter" | "colorTheme" | "hasStickyHead" | "footer">, Partial<DrawerSidebarContextProps> {
+interface StyledFlatTableWrapperProps extends Pick<FlatTableProps, "hasStickyFooter" | "colorTheme" | "hasStickyHead" | "footer" | "hasOuterVerticalBorders">, Partial<DrawerSidebarContextProps> {
     hasHorizontalScrollbar: boolean;
     hasVerticalScrollbar: boolean;
     lastColRowSpanIndex: number;
     firstColRowSpanIndex: number;
     isFocused: boolean;
+    bottomBorderRadius: NonNullable<FlatTableProps["bottomBorderRadius"]>;
 }
 declare const StyledFlatTableWrapper: import("styled-components").StyledComponent<"div", any, import("../box").BoxProps & StyledFlatTableWrapperProps, never>;
 declare const StyledFlatTableFooter: import("styled-components").StyledComponent<"div", any, Pick<FlatTableProps, "hasStickyFooter">, never>;

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

@@ -100,12 +100,27 @@ const StyledFlatTable = styled.table`
 const StyledFlatTableWrapper = styled(StyledBox)`
   border-top-left-radius: var(--borderRadius100);
   border-top-right-radius: var(--borderRadius100);
+
+  ${({
+  hasOuterVerticalBorders
+}) => !hasOuterVerticalBorders && css`
+      ${StyledFlatTableRow} {
+        & > ${StyledFlatTableCell}:first-child {
+          border-left-color: var(--colorsUtilityMajorTransparent);
+        }
+        & > ${StyledFlatTableCell}:last-child {
+          border-right-color: var(--colorsUtilityMajorTransparent);
+        }
+      }
+    `}
+
   ${({
   hasStickyFooter,
-  hasHorizontalScrollbar
+  hasHorizontalScrollbar,
+  bottomBorderRadius
 }) => !hasStickyFooter && !hasHorizontalScrollbar && css`
-      border-bottom-left-radius: var(--borderRadius100);
-      border-bottom-right-radius: var(--borderRadius100);
+      border-bottom-left-radius: var(--${bottomBorderRadius});
+      border-bottom-right-radius: var(--${bottomBorderRadius});
     `}
 
   ${({
@@ -152,7 +167,6 @@ css`
           ${StyledFlatTableHeader},
           ${StyledFlatTableHead} ${StyledFlatTableCheckbox} {
             background-color: var(--colorsUtilityMajor025);
-            border-right: 1px solid var(--colorsUtilityMajor025);
             border-bottom-color: var(--colorsUtilityMajor100);
           }
           ${StyledFlatTableHead} ${StyledFlatTableRowHeader} {
@@ -167,7 +181,6 @@ css`
           ${StyledFlatTableHeader},
           ${StyledFlatTableHead} ${StyledFlatTableCheckbox} {
             background-color: var(--colorsUtilityYang100);
-            border-right: 1px solid var(--colorsUtilityYang100);
             border-bottom-color: var(--colorsUtilityMajor100);
           }
           ${StyledFlatTableHead} ${StyledFlatTableRowHeader} {
@@ -294,7 +307,8 @@ css`
   firstColRowSpanIndex,
   lastColRowSpanIndex,
   hasHorizontalScrollbar,
-  hasVerticalScrollbar
+  hasVerticalScrollbar,
+  bottomBorderRadius
 }) => !footer && css`
       tbody {
         ${firstColRowSpanIndex >= 0 && css`
@@ -319,13 +333,13 @@ css`
           ${!hasHorizontalScrollbar && firstColRowSpanIndex === -1 && css`
             th:first-child,
             td:first-child {
-              border-bottom-left-radius: var(--borderRadius100);
+              border-bottom-left-radius: var(--${bottomBorderRadius});
             }
           `}
           ${!hasVerticalScrollbar && !hasHorizontalScrollbar && lastColRowSpanIndex === -1 && css`
             th:last-child,
             td:last-child {
-              border-bottom-right-radius: var(--borderRadius100);
+              border-bottom-right-radius: var(--${bottomBorderRadius});
             }
           `}
         }

package/esm/components/link-preview/link-preview.style.js

@@ -1,6 +1,5 @@
 import styled, { css } from "styled-components";
-import { StyledPreview } from "../preview/preview.style";
-import { StyledPreviewPlaceholder } from "../preview/__internal__/preview-placeholder.style";
+import { StyledPreview, StyledPreviewPlaceholder } from "../preview/preview.style";
 import addFocusStyling from "../../style/utils/add-focus-styling";
 import baseTheme from "../../style/themes/base";
 const oldFocusStyling = `

package/esm/components/pages/pages.component.js

@@ -31,6 +31,7 @@ const Pages = ({
       transitionName,
       timeout: TRANSITION_TIME,
       "data-element": "visible-page",
+      "data-role": "visible-page",
       className: visiblePage.props.className
     };
     return /*#__PURE__*/React.cloneElement(visiblePage, additionalProps);

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

@@ -1,11 +1,21 @@
 import React from "react";
 import { MarginProps } from "styled-system";
-import { PreviewPlaceholderProps } from "./__internal__/preview-placeholder.component";
-export interface PreviewProps extends Partial<Omit<PreviewPlaceholderProps, "index">>, MarginProps {
+export declare type Shapes = "text" | "rectangle" | "rectangle-round" | "circle";
+export interface PreviewProps extends MarginProps {
     /** Children content to render in the component. */
     children?: React.ReactNode;
-    /** Provides more control over when in a loading state. */
+    /** Sets loading state. */
     loading?: boolean;
+    /** Sets the height of the Preview. */
+    height?: string;
+    /** Sets the width of the Preview. */
+    width?: string;
+    /** The number of placeholder shapes to render. */
+    lines?: number;
+    /** Sets the preview's shape. */
+    shape?: Shapes;
+    /** Removes Preview's animation, is true when prefer reduce-motion is on. */
+    disableAnimation?: boolean;
 }
-export declare const Preview: ({ children, loading, lines, ...props }: PreviewProps) => React.JSX.Element;
+export declare const Preview: ({ children, loading, lines, height, width, shape, disableAnimation, ...props }: PreviewProps) => React.JSX.Element;
 export default Preview;

package/esm/components/preview/preview.component.js

@@ -1,25 +1,37 @@
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 import React from "react";
 import PropTypes from "prop-types";
-import PreviewPlaceholder from "./__internal__/preview-placeholder.component";
-import { StyledPreview } from "./preview.style";
+import { StyledPreview, StyledPreviewPlaceholder } from "./preview.style";
 import { filterStyledSystemMarginProps } from "../../style/utils";
+import useMediaQuery from "../../hooks/useMediaQuery";
 export const Preview = ({
   children,
   loading,
   lines = 1,
+  height,
+  width,
+  shape = "text",
+  disableAnimation,
   ...props
 }) => {
   const marginProps = filterStyledSystemMarginProps(props);
-  const hasPlaceholder = loading === undefined ? !children : loading;
+  const hasPlaceholder = loading ?? !children;
+  const isLastLine = index => {
+    return lines > 1 && lines === index + 1;
+  };
+  const reduceMotion = !useMediaQuery("screen and (prefers-reduced-motion: no-preference)");
   if (hasPlaceholder) {
     const placeholders = [];
-    for (let i = 1; i <= lines; i++) {
-      placeholders.push( /*#__PURE__*/React.createElement(PreviewPlaceholder, _extends({
+    for (let i = 0; i < lines; i++) {
+      placeholders.push( /*#__PURE__*/React.createElement(StyledPreviewPlaceholder, _extends({
+        "data-component": "preview",
         "data-role": "preview-placeholder",
         key: i,
-        index: i,
-        lines: lines
+        height: height,
+        width: width,
+        isLastLine: isLastLine(i),
+        shape: shape,
+        disableAnimation: disableAnimation || reduceMotion
       }, props)));
     }
     return /*#__PURE__*/React.createElement(StyledPreview, marginProps, placeholders);

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

@@ -1,2 +1,11 @@
+import { Shapes } from "./preview.component";
 declare const StyledPreview: import("styled-components").StyledComponent<"div", any, {}, never>;
-export { StyledPreview };
+interface StyledPreviewPlaceholderProps {
+    height?: string;
+    width?: string;
+    shape: Shapes;
+    disableAnimation?: boolean;
+    isLastLine: boolean;
+}
+declare const StyledPreviewPlaceholder: import("styled-components").StyledComponent<"span", any, StyledPreviewPlaceholderProps, never>;
+export { StyledPreview, StyledPreviewPlaceholder };

package/esm/components/preview/preview.style.js

@@ -1,12 +1,86 @@
-import styled from "styled-components";
+import styled, { css, keyframes } from "styled-components";
 import { margin } from "styled-system";
 import baseTheme from "../../style/themes/base";
 const StyledPreview = styled.div`
   ${margin}
 `;
+const shimmer = keyframes`
+  0% { 
+    opacity: 0.1 
+  }
+  70% { 
+    opacity: 1
+  }
+  100% { 
+    opacity: 0.1 
+  }
+`;
+function getBorderRadius(shape) {
+  switch (shape) {
+    case "rectangle-round":
+      return "var(--borderRadius400)";
+    case "circle":
+      return "var(--borderRadiusCircle)";
+    default:
+      return "var(--borderRadius100)";
+  }
+}
+function getHeight(shape) {
+  if (shape.includes("rectangle")) {
+    return "var(--sizing400)";
+  }
+  switch (shape) {
+    case "circle":
+      return "var(--sizing700)";
+    default:
+      return "var(--sizing175)";
+  }
+}
+function getWidth(shape) {
+  if (shape.includes("rectangle")) {
+    return "var(--sizing1500)";
+  }
+  return "100%";
+}
+const StyledPreviewPlaceholder = styled.span`
+  ${({
+  shape,
+  disableAnimation,
+  isLastLine,
+  height,
+  width
+}) => {
+  return css`
+      display: block;
+      background: linear-gradient(
+        135deg,
+        var(--colorsUtilityMajor100),
+        var(--colorsUtilityMajor040)
+      );
+      border-radius: ${getBorderRadius(shape)};
+      height: ${height || getHeight(shape)};
+      width: ${width || getWidth(shape)};
+      animation: ${shimmer} 2s ease infinite;
+
+      ${isLastLine && shape === "text" && css`
+        width: calc(${width || getWidth(shape)}*0.8);
+      `}
+
+      ${shape === "circle" && css`
+        width: ${height || getHeight(shape)};
+      `}
+
+      ${disableAnimation && css`
+        animation: none;
+      `}
+
+      & + & {
+        margin-top: 6px;
+      }
+    `;
+}}
+`;
 StyledPreview.defaultProps = {
   theme: baseTheme
 };
-
-// eslint-disable-next-line import/prefer-default-export
-export { StyledPreview };
+export { StyledPreview, StyledPreviewPlaceholder };

package/esm/components/search/search.component.js

@@ -3,7 +3,6 @@ import React, { useState, useRef, useImperativeHandle } from "react";
 import PropTypes from "prop-types";
 import invariant from "invariant";
 import { filterStyledSystemMarginProps } from "../../style/utils";
-import tagComponent from "../../__internal__/utils/helpers/tags/tags";
 import StyledSearch from "./search.style";
 import StyledSearchButton from "./search-button.style";
 import Icon from "../icon";
@@ -141,7 +140,9 @@ const Search = /*#__PURE__*/React.forwardRef(({
     showSearchButton: !!searchButton,
     variant: variant,
     mb: 0
-  }, filterStyledSystemMarginProps(rest), tagComponent("search", rest), {
+  }, filterStyledSystemMarginProps(rest), {
+    "data-component": "search",
+    "data-role": "search",
     id: id,
     name: name
   }, rest), /*#__PURE__*/React.createElement(Textbox, {

package/lib/__internal__/popover/popover.component.d.ts

@@ -4,15 +4,47 @@ declare type CustomRefObject<T> = {
     current?: T | null;
 };
 export interface PopoverProps {
+    /**
+     * Element to be positioned, has to be a single node and has to accept `ref` and `style` props.
+     */
     children: React.ReactElement;
+    /**
+     * Placement of children in relation to the reference element.
+     */
     placement?: Placement;
+    /**
+     * Disables interaction with background UI.
+     */
     disableBackgroundUI?: boolean;
+    /**
+     * Optional middleware array, for more information go to:
+     * [https://floating-ui.com/docs/middleware](https://floating-ui.com/docs/middleware)
+     */
     middleware?: Middleware[];
+    /**
+     * When true, children are not rendered in portal.
+     */
     disablePortal?: boolean;
+    /**
+     * Reference element, children will be positioned in relation to this element - should be a ref shaped object.
+     */
     reference: CustomRefObject<HTMLElement>;
+    /**
+     * Determines if the popover is currently open/visible or not. Defaults to true.
+     */
     isOpen?: boolean;
+    /**
+     * Whether to update the position of the floating element on every animation frame if required. This is optimized for performance but can still be costly. Use with caution!
+     * [https://floating-ui.com/docs/autoUpdate#animationframe](https://floating-ui.com/docs/autoUpdate#animationframe)
+     */
     animationFrame?: boolean;
+    /**
+     * Optional strategy to use for positioning the floating element. Defaults to "absolute".
+     */
     popoverStrategy?: "absolute" | "fixed";
+    /**
+     * Allows child ref to be set via a prop instead of dynamically finding it via children iteration.
+     */
     childRefOverride?: MutableRefObject<HTMLDivElement | null>;
 }
 declare const Popover: ({ children, placement, disablePortal, reference, middleware, disableBackgroundUI, isOpen, animationFrame, popoverStrategy, childRefOverride, }: PopoverProps) => React.JSX.Element;

package/lib/__internal__/popover/popover.component.js

@@ -76,7 +76,9 @@ const Popover = ({
   if (disableBackgroundUI) {
     content = /*#__PURE__*/_react.default.createElement(_popover.StyledPopoverContent, {
       isOpen: isOpen
-    }, /*#__PURE__*/_react.default.createElement(_popover.StyledBackdrop, null, content));
+    }, /*#__PURE__*/_react.default.createElement(_popover.StyledBackdrop, {
+      "data-role": "popup-backdrop"
+    }, content));
   }
   if (disablePortal) {
     return content;

package/lib/__internal__/radio-button-mapper/radio-button-mapper.component.js

@@ -32,7 +32,6 @@ const RadioButtonMapper = ({
   const [checkedValue, setCheckedValue] = (0, _react.useState)(false);
   const onChangeProp = (0, _react.useCallback)(event => {
     onChange?.(event);
-    /* istanbul ignore else */
     if (!isControlled) {
       setCheckedValue(event.target.value);
     }

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

@@ -180,7 +180,12 @@ const StyledFlatTableRow = _styledComponents.default.tr`
       ${_flatTableHeader.default} {
         border-bottom: 1px solid ${borderColor(colorTheme)};
 
-        ${!isInSidebar && `
+        ${horizontalBorderSize !== "small" && (0, _styledComponents.css)`
+          border-bottom: ${horizontalBorderSizes[horizontalBorderSize]} solid
+            var(--colorsUtilityMajor100);
+        `}
+
+        ${!isInSidebar && !colorTheme?.includes("transparent") && `
           :first-child {
             border-left: 1px solid ${borderColor(colorTheme)};
           }

package/lib/components/flat-table/flat-table.component.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { MarginProps } from "styled-system";
+import * as DesignTokens from "@sage/design-tokens/js/base/common";
 export interface FlatTableProps extends MarginProps {
     /** The HTML id of the element that contains a description of this table. */
     ariaDescribedby?: string;
@@ -25,13 +26,17 @@ export interface FlatTableProps extends MarginProps {
     size?: "compact" | "small" | "medium" | "large" | "extraLarge";
     /** Applies max-height of 100% to FlatTable if true */
     hasMaxHeight?: boolean;
+    /** Toggles the visibility of the table's outer left and right borders. When false, the left border of the first column and the right border of the last column are hidden.  */
+    hasOuterVerticalBorders?: boolean;
+    /** Sets the border radius of the first and last cells in the last row. */
+    bottomBorderRadius?: Extract<keyof typeof DesignTokens, `borderRadius${number}`>;
     /** Set the overflow X of the table wrapper. Any valid CSS string */
     overflowX?: string;
     /** Width of the table. Any valid CSS string */
     width?: string;
 }
 export declare const FlatTable: {
-    ({ caption, children, hasStickyHead, colorTheme, footer, hasStickyFooter, height, isZebra, size, hasMaxHeight, ariaDescribedby, minHeight, overflowX, width, ...rest }: FlatTableProps): React.JSX.Element;
+    ({ caption, children, hasStickyHead, colorTheme, footer, hasStickyFooter, height, isZebra, size, hasMaxHeight, hasOuterVerticalBorders, bottomBorderRadius, ariaDescribedby, minHeight, overflowX, width, ...rest }: FlatTableProps): React.JSX.Element;
     displayName: string;
 };
 export default FlatTable;

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

@@ -26,6 +26,8 @@ const FlatTable = ({
   isZebra,
   size = "medium",
   hasMaxHeight = false,
+  hasOuterVerticalBorders = true,
+  bottomBorderRadius = "borderRadius100",
   ariaDescribedby,
   minHeight,
   overflowX,
@@ -143,6 +145,7 @@ const FlatTable = ({
   return /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTableWrapper, _extends({
     ref: wrapperRef,
     "data-component": "flat-table-wrapper",
+    "data-role": "flat-table-wrapper",
     isInSidebar: isInSidebar,
     hasStickyHead: hasStickyHead,
     colorTheme: colorTheme,
@@ -150,6 +153,8 @@ const FlatTable = ({
     overflowY: hasStickyHead || hasStickyFooter ? "auto" : undefined,
     height: addDefaultHeight && !hasMaxHeight ? "99%" : height,
     maxHeight: hasMaxHeight ? "100%" : undefined,
+    hasOuterVerticalBorders: hasOuterVerticalBorders,
+    bottomBorderRadius: bottomBorderRadius,
     display: "flex",
     flexDirection: "column",
     justifyContent: hasStickyFooter || height ? "space-between" : undefined,

package/lib/components/flat-table/flat-table.style.d.ts

@@ -4,12 +4,13 @@ declare const StyledTableContainer: import("styled-components").StyledComponent<
 declare const StyledFlatTable: import("styled-components").StyledComponent<"table", any, Pick<FlatTableProps, "caption" | "isZebra"> & {
     size: NonNullable<FlatTableProps["size"]>;
 }, never>;
-interface StyledFlatTableWrapperProps extends Pick<FlatTableProps, "hasStickyFooter" | "colorTheme" | "hasStickyHead" | "footer">, Partial<DrawerSidebarContextProps> {
+interface StyledFlatTableWrapperProps extends Pick<FlatTableProps, "hasStickyFooter" | "colorTheme" | "hasStickyHead" | "footer" | "hasOuterVerticalBorders">, Partial<DrawerSidebarContextProps> {
     hasHorizontalScrollbar: boolean;
     hasVerticalScrollbar: boolean;
     lastColRowSpanIndex: number;
     firstColRowSpanIndex: number;
     isFocused: boolean;
+    bottomBorderRadius: NonNullable<FlatTableProps["bottomBorderRadius"]>;
 }
 declare const StyledFlatTableWrapper: import("styled-components").StyledComponent<"div", any, import("../box").BoxProps & StyledFlatTableWrapperProps, never>;
 declare const StyledFlatTableFooter: import("styled-components").StyledComponent<"div", any, Pick<FlatTableProps, "hasStickyFooter">, never>;

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

@@ -109,12 +109,27 @@ const StyledFlatTable = exports.StyledFlatTable = _styledComponents.default.tabl
 const StyledFlatTableWrapper = exports.StyledFlatTableWrapper = (0, _styledComponents.default)(_box.default)`
   border-top-left-radius: var(--borderRadius100);
   border-top-right-radius: var(--borderRadius100);
+
+  ${({
+  hasOuterVerticalBorders
+}) => !hasOuterVerticalBorders && (0, _styledComponents.css)`
+      ${_flatTableRow.default} {
+        & > ${_flatTableCell.StyledFlatTableCell}:first-child {
+          border-left-color: var(--colorsUtilityMajorTransparent);
+        }
+        & > ${_flatTableCell.StyledFlatTableCell}:last-child {
+          border-right-color: var(--colorsUtilityMajorTransparent);
+        }
+      }
+    `}
+
   ${({
   hasStickyFooter,
-  hasHorizontalScrollbar
+  hasHorizontalScrollbar,
+  bottomBorderRadius
 }) => !hasStickyFooter && !hasHorizontalScrollbar && (0, _styledComponents.css)`
-      border-bottom-left-radius: var(--borderRadius100);
-      border-bottom-right-radius: var(--borderRadius100);
+      border-bottom-left-radius: var(--${bottomBorderRadius});
+      border-bottom-right-radius: var(--${bottomBorderRadius});
     `}
 
   ${({
@@ -161,7 +176,6 @@ const StyledFlatTableWrapper = exports.StyledFlatTableWrapper = (0, _styledCompo
           ${_flatTableHeader.default},
           ${_flatTableHead.default} ${_flatTableCheckbox.default} {
             background-color: var(--colorsUtilityMajor025);
-            border-right: 1px solid var(--colorsUtilityMajor025);
             border-bottom-color: var(--colorsUtilityMajor100);
           }
           ${_flatTableHead.default} ${_flatTableRowHeader.StyledFlatTableRowHeader} {
@@ -176,7 +190,6 @@ const StyledFlatTableWrapper = exports.StyledFlatTableWrapper = (0, _styledCompo
           ${_flatTableHeader.default},
           ${_flatTableHead.default} ${_flatTableCheckbox.default} {
             background-color: var(--colorsUtilityYang100);
-            border-right: 1px solid var(--colorsUtilityYang100);
             border-bottom-color: var(--colorsUtilityMajor100);
           }
           ${_flatTableHead.default} ${_flatTableRowHeader.StyledFlatTableRowHeader} {
@@ -303,7 +316,8 @@ const StyledFlatTableWrapper = exports.StyledFlatTableWrapper = (0, _styledCompo
   firstColRowSpanIndex,
   lastColRowSpanIndex,
   hasHorizontalScrollbar,
-  hasVerticalScrollbar
+  hasVerticalScrollbar,
+  bottomBorderRadius
 }) => !footer && (0, _styledComponents.css)`
       tbody {
         ${firstColRowSpanIndex >= 0 && (0, _styledComponents.css)`
@@ -328,13 +342,13 @@ const StyledFlatTableWrapper = exports.StyledFlatTableWrapper = (0, _styledCompo
           ${!hasHorizontalScrollbar && firstColRowSpanIndex === -1 && (0, _styledComponents.css)`
             th:first-child,
             td:first-child {
-              border-bottom-left-radius: var(--borderRadius100);
+              border-bottom-left-radius: var(--${bottomBorderRadius});
             }
           `}
           ${!hasVerticalScrollbar && !hasHorizontalScrollbar && lastColRowSpanIndex === -1 && (0, _styledComponents.css)`
             th:last-child,
             td:last-child {
-              border-bottom-right-radius: var(--borderRadius100);
+              border-bottom-right-radius: var(--${bottomBorderRadius});
             }
           `}
         }

package/lib/components/link-preview/link-preview.style.js

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.StyledUrl = exports.StyledTitle = exports.StyledPreviewWrapper = exports.StyledLinkPreview = exports.StyledDescription = exports.StyledCloseIconWrapper = void 0;
 var _styledComponents = _interopRequireWildcard(require("styled-components"));
 var _preview = require("../preview/preview.style");
-var _previewPlaceholder = require("../preview/__internal__/preview-placeholder.style");
 var _addFocusStyling = _interopRequireDefault(require("../../style/utils/add-focus-styling"));
 var _base = _interopRequireDefault(require("../../style/themes/base"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
@@ -64,11 +63,11 @@ const StyledPreviewWrapper = exports.StyledPreviewWrapper = _styledComponents.de
       }
     `}
 
-  ${_previewPlaceholder.StyledPreviewPlaceholder}:first-of-type {
+  ${_preview.StyledPreviewPlaceholder}:first-of-type {
     margin-top: 8px;
   }
 
-  ${_previewPlaceholder.StyledPreviewPlaceholder}:not(:first-of-type) {
+  ${_preview.StyledPreviewPlaceholder}:not(:first-of-type) {
     margin-top: 16px;
   }
 `;

package/lib/components/pages/pages.component.js

@@ -46,6 +46,7 @@ const Pages = ({
       transitionName,
       timeout: TRANSITION_TIME,
       "data-element": "visible-page",
+      "data-role": "visible-page",
       className: visiblePage.props.className
     };
     return /*#__PURE__*/_react.default.cloneElement(visiblePage, additionalProps);

package/lib/components/preview/preview.component.d.ts

@@ -1,11 +1,21 @@
 import React from "react";
 import { MarginProps } from "styled-system";
-import { PreviewPlaceholderProps } from "./__internal__/preview-placeholder.component";
-export interface PreviewProps extends Partial<Omit<PreviewPlaceholderProps, "index">>, MarginProps {
+export declare type Shapes = "text" | "rectangle" | "rectangle-round" | "circle";
+export interface PreviewProps extends MarginProps {
     /** Children content to render in the component. */
     children?: React.ReactNode;
-    /** Provides more control over when in a loading state. */
+    /** Sets loading state. */
     loading?: boolean;
+    /** Sets the height of the Preview. */
+    height?: string;
+    /** Sets the width of the Preview. */
+    width?: string;
+    /** The number of placeholder shapes to render. */
+    lines?: number;
+    /** Sets the preview's shape. */
+    shape?: Shapes;
+    /** Removes Preview's animation, is true when prefer reduce-motion is on. */
+    disableAnimation?: boolean;
 }
-export declare const Preview: ({ children, loading, lines, ...props }: PreviewProps) => React.JSX.Element;
+export declare const Preview: ({ children, loading, lines, height, width, shape, disableAnimation, ...props }: PreviewProps) => React.JSX.Element;
 export default Preview;

package/lib/components/preview/preview.component.js

@@ -6,27 +6,39 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = exports.Preview = void 0;
 var _react = _interopRequireDefault(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
-var _previewPlaceholder = _interopRequireDefault(require("./__internal__/preview-placeholder.component"));
 var _preview = require("./preview.style");
 var _utils = require("../../style/utils");
+var _useMediaQuery = _interopRequireDefault(require("../../hooks/useMediaQuery"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 const Preview = ({
   children,
   loading,
   lines = 1,
+  height,
+  width,
+  shape = "text",
+  disableAnimation,
   ...props
 }) => {
   const marginProps = (0, _utils.filterStyledSystemMarginProps)(props);
-  const hasPlaceholder = loading === undefined ? !children : loading;
+  const hasPlaceholder = loading ?? !children;
+  const isLastLine = index => {
+    return lines > 1 && lines === index + 1;
+  };
+  const reduceMotion = !(0, _useMediaQuery.default)("screen and (prefers-reduced-motion: no-preference)");
   if (hasPlaceholder) {
     const placeholders = [];
-    for (let i = 1; i <= lines; i++) {
-      placeholders.push( /*#__PURE__*/_react.default.createElement(_previewPlaceholder.default, _extends({
+    for (let i = 0; i < lines; i++) {
+      placeholders.push( /*#__PURE__*/_react.default.createElement(_preview.StyledPreviewPlaceholder, _extends({
+        "data-component": "preview",
         "data-role": "preview-placeholder",
         key: i,
-        index: i,
-        lines: lines
+        height: height,
+        width: width,
+        isLastLine: isLastLine(i),
+        shape: shape,
+        disableAnimation: disableAnimation || reduceMotion
       }, props)));
     }
     return /*#__PURE__*/_react.default.createElement(_preview.StyledPreview, marginProps, placeholders);

package/lib/components/preview/preview.style.d.ts

@@ -1,2 +1,11 @@
+import { Shapes } from "./preview.component";
 declare const StyledPreview: import("styled-components").StyledComponent<"div", any, {}, never>;
-export { StyledPreview };
+interface StyledPreviewPlaceholderProps {
+    height?: string;
+    width?: string;
+    shape: Shapes;
+    disableAnimation?: boolean;
+    isLastLine: boolean;
+}
+declare const StyledPreviewPlaceholder: import("styled-components").StyledComponent<"span", any, StyledPreviewPlaceholderProps, never>;
+export { StyledPreview, StyledPreviewPlaceholder };

package/lib/components/preview/preview.style.js

@@ -3,16 +3,92 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.StyledPreview = void 0;
-var _styledComponents = _interopRequireDefault(require("styled-components"));
+exports.StyledPreviewPlaceholder = exports.StyledPreview = void 0;
+var _styledComponents = _interopRequireWildcard(require("styled-components"));
 var _styledSystem = require("styled-system");
 var _base = _interopRequireDefault(require("../../style/themes/base"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 const StyledPreview = exports.StyledPreview = _styledComponents.default.div`
   ${_styledSystem.margin}
 `;
+const shimmer = (0, _styledComponents.keyframes)`
+  0% { 
+    opacity: 0.1 
+  }
+  70% { 
+    opacity: 1
+  }
+  100% { 
+    opacity: 0.1 
+  }
+`;
+function getBorderRadius(shape) {
+  switch (shape) {
+    case "rectangle-round":
+      return "var(--borderRadius400)";
+    case "circle":
+      return "var(--borderRadiusCircle)";
+    default:
+      return "var(--borderRadius100)";
+  }
+}
+function getHeight(shape) {
+  if (shape.includes("rectangle")) {
+    return "var(--sizing400)";
+  }
+  switch (shape) {
+    case "circle":
+      return "var(--sizing700)";
+    default:
+      return "var(--sizing175)";
+  }
+}
+function getWidth(shape) {
+  if (shape.includes("rectangle")) {
+    return "var(--sizing1500)";
+  }
+  return "100%";
+}
+const StyledPreviewPlaceholder = exports.StyledPreviewPlaceholder = _styledComponents.default.span`
+  ${({
+  shape,
+  disableAnimation,
+  isLastLine,
+  height,
+  width
+}) => {
+  return (0, _styledComponents.css)`
+      display: block;
+      background: linear-gradient(
+        135deg,
+        var(--colorsUtilityMajor100),
+        var(--colorsUtilityMajor040)
+      );
+      border-radius: ${getBorderRadius(shape)};
+      height: ${height || getHeight(shape)};
+      width: ${width || getWidth(shape)};
+      animation: ${shimmer} 2s ease infinite;
+
+      ${isLastLine && shape === "text" && (0, _styledComponents.css)`
+        width: calc(${width || getWidth(shape)}*0.8);
+      `}
+
+      ${shape === "circle" && (0, _styledComponents.css)`
+        width: ${height || getHeight(shape)};
+      `}
+
+      ${disableAnimation && (0, _styledComponents.css)`
+        animation: none;
+      `}
+
+      & + & {
+        margin-top: 6px;
+      }
+    `;
+}}
+`;
 StyledPreview.defaultProps = {
   theme: _base.default
-};
-
-// eslint-disable-next-line import/prefer-default-export
+};

package/lib/components/search/search.component.js

@@ -8,7 +8,6 @@ var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _invariant = _interopRequireDefault(require("invariant"));
 var _utils = require("../../style/utils");
-var _tags = _interopRequireDefault(require("../../__internal__/utils/helpers/tags/tags"));
 var _search = _interopRequireDefault(require("./search.style"));
 var _searchButton = _interopRequireDefault(require("./search-button.style"));
 var _icon = _interopRequireDefault(require("../icon"));
@@ -150,7 +149,9 @@ const Search = exports.Search = /*#__PURE__*/_react.default.forwardRef(({
     showSearchButton: !!searchButton,
     variant: variant,
     mb: 0
-  }, (0, _utils.filterStyledSystemMarginProps)(rest), (0, _tags.default)("search", rest), {
+  }, (0, _utils.filterStyledSystemMarginProps)(rest), {
+    "data-component": "search",
+    "data-role": "search",
     id: id,
     name: name
   }, rest), /*#__PURE__*/_react.default.createElement(_textbox.default, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "142.9.1",
+  "version": "142.11.0",
   "description": "A library of reusable React components for easily building user interfaces.",
   "files": [
     "lib",
@@ -56,7 +56,7 @@
     "styled-components": "^4.4.1"
   },
   "devDependencies": {
-    "@axe-core/playwright": "~4.9.0",
+    "@axe-core/playwright": "~4.10.0",
     "@babel/cli": "^7.23.4",
     "@babel/core": "^7.23.3",
     "@babel/eslint-parser": "^7.23.3",
@@ -69,8 +69,8 @@
     "@babel/types": "^7.23.4",
     "@commitlint/cli": "^17.6.3",
     "@commitlint/config-conventional": "^17.6.3",
-    "@playwright/experimental-ct-react17": "~1.43.0",
-    "@playwright/test": "~1.43.0",
+    "@playwright/experimental-ct-react17": "~1.47.0",
+    "@playwright/test": "~1.47.0",
     "@sage/design-tokens": "~4.29.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^6.0.3",

package/esm/components/preview/__internal__/preview-placeholder.component.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-import { StyledPreviewPlaceholderProps } from "./preview-placeholder.style";
-export interface PreviewPlaceholderProps extends StyledPreviewPlaceholderProps {
-    index: number;
-    /** The number of lines to render. */
-    lines: number;
-    loading?: boolean;
-}
-declare const PreviewPlaceholder: ({ height, index, lines, width, ...props }: PreviewPlaceholderProps) => React.JSX.Element;
-export default PreviewPlaceholder;

package/esm/components/preview/__internal__/preview-placeholder.component.js

@@ -1,19 +0,0 @@
-function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
-import React from "react";
-import PropTypes from "prop-types";
-import tagComponent from "../../../__internal__/utils/helpers/tags/tags";
-import { StyledPreviewPlaceholder } from "./preview-placeholder.style";
-const PreviewPlaceholder = ({
-  height,
-  index,
-  lines,
-  width,
-  ...props
-}) => {
-  const isLastLine = lines > 1 && lines === index;
-  return /*#__PURE__*/React.createElement(StyledPreviewPlaceholder, _extends({
-    height: height,
-    width: !width && isLastLine ? "80%" : width
-  }, tagComponent("preview", props)));
-};
-export default PreviewPlaceholder;

package/esm/components/preview/__internal__/preview-placeholder.style.d.ts

@@ -1,7 +0,0 @@
-export interface StyledPreviewPlaceholderProps {
-    /** A custom height to be applied to the component. */
-    height?: string;
-    /** A custom width */
-    width?: string;
-}
-export declare const StyledPreviewPlaceholder: import("styled-components").StyledComponent<"span", any, StyledPreviewPlaceholderProps, never>;

package/esm/components/preview/__internal__/preview-placeholder.style.js

@@ -1,23 +0,0 @@
-import styled, { keyframes } from "styled-components";
-const shimmer = keyframes`
-  0% { opacity:0.1 }
-  70% { opacity:0.6 }
-  100% { opacity:0.1 }
-`;
-export const StyledPreviewPlaceholder = styled.span`
-  animation: ${shimmer} 2s ease infinite;
-  background: var(--colorsUtilityMajor150);
-  display: block;
-  height: ${({
-  height
-}) => height || "15px"};
-  opacity: 0.6;
-  width: ${({
-  width
-}) => width || "100%"};
-  border-radius: var(--borderRadius050);
-
-  & + & {
-    margin-top: 3px;
-  }
-`;

package/lib/components/preview/__internal__/preview-placeholder.component.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-import { StyledPreviewPlaceholderProps } from "./preview-placeholder.style";
-export interface PreviewPlaceholderProps extends StyledPreviewPlaceholderProps {
-    index: number;
-    /** The number of lines to render. */
-    lines: number;
-    loading?: boolean;
-}
-declare const PreviewPlaceholder: ({ height, index, lines, width, ...props }: PreviewPlaceholderProps) => React.JSX.Element;
-export default PreviewPlaceholder;

package/lib/components/preview/__internal__/preview-placeholder.component.js

@@ -1,26 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _react = _interopRequireDefault(require("react"));
-var _propTypes = _interopRequireDefault(require("prop-types"));
-var _tags = _interopRequireDefault(require("../../../__internal__/utils/helpers/tags/tags"));
-var _previewPlaceholder = require("./preview-placeholder.style");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
-const PreviewPlaceholder = ({
-  height,
-  index,
-  lines,
-  width,
-  ...props
-}) => {
-  const isLastLine = lines > 1 && lines === index;
-  return /*#__PURE__*/_react.default.createElement(_previewPlaceholder.StyledPreviewPlaceholder, _extends({
-    height: height,
-    width: !width && isLastLine ? "80%" : width
-  }, (0, _tags.default)("preview", props)));
-};
-var _default = exports.default = PreviewPlaceholder;

package/lib/components/preview/__internal__/preview-placeholder.style.d.ts

@@ -1,7 +0,0 @@
-export interface StyledPreviewPlaceholderProps {
-    /** A custom height to be applied to the component. */
-    height?: string;
-    /** A custom width */
-    width?: string;
-}
-export declare const StyledPreviewPlaceholder: import("styled-components").StyledComponent<"span", any, StyledPreviewPlaceholderProps, never>;

package/lib/components/preview/__internal__/preview-placeholder.style.js

@@ -1,31 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.StyledPreviewPlaceholder = void 0;
-var _styledComponents = _interopRequireWildcard(require("styled-components"));
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-const shimmer = (0, _styledComponents.keyframes)`
-  0% { opacity:0.1 }
-  70% { opacity:0.6 }
-  100% { opacity:0.1 }
-`;
-const StyledPreviewPlaceholder = exports.StyledPreviewPlaceholder = _styledComponents.default.span`
-  animation: ${shimmer} 2s ease infinite;
-  background: var(--colorsUtilityMajor150);
-  display: block;
-  height: ${({
-  height
-}) => height || "15px"};
-  opacity: 0.6;
-  width: ${({
-  width
-}) => width || "100%"};
-  border-radius: var(--borderRadius050);
-
-  & + & {
-    margin-top: 3px;
-  }
-`;