carbon-react 142.10.0 → 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "142.10.0",
+  "version": "142.11.0",
   "description": "A library of reusable React components for easily building user interfaces.",
   "files": [
     "lib",