@carbon/react 1.50.0-rc.0 → 1.50.0

package/es/components/Accordion/AccordionItem.js

@@ -9,7 +9,7 @@ import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js
 import { ChevronRight } from '@carbon/icons-react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
-import React__default, { useState, useContext, useRef } from 'react';
+import React__default, { useState, useContext } from 'react';
 import '../Text/index.js';
 import { useId } from '../../internal/useId.js';
 import deprecate from '../../prop-types/deprecate.js';
@@ -51,7 +51,15 @@ function AccordionItem(_ref) {
   });
   const Toggle = renderToggle || renderExpando; // remove renderExpando in next major release
 
-  const content = useRef(null);
+  const content = React__default.useCallback(node => {
+    if (!node) {
+      return;
+    }
+    if (isOpen) {
+      // accordion closes
+      node.style.maxBlockSize = '';
+    }
+  }, [isOpen]);
   if (open !== prevIsOpen) {
     setIsOpen(open);
     setPrevIsOpen(open);
@@ -60,19 +68,6 @@ function AccordionItem(_ref) {
   // When the AccordionItem heading is clicked, toggle the open state of the
   // panel
   function onClick(event) {
-    // type guard for ref
-    if (!content.current) {
-      return;
-    }
-    if (isOpen) {
-      // accordion closes
-      content.current.style.maxBlockSize = '';
-    } else {
-      // accordion opens
-      content.current.style.maxBlockSize =
-      // Scroll height plus top/bottom padding
-      content.current.scrollHeight + 32 + 'px';
-    }
     const nextValue = !isOpen;
     setIsOpen(nextValue);
     if (onHeadingClick) {

package/es/components/ChatButton/ChatButton.Skeleton.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import PropTypes from 'prop-types';
+import React__default from 'react';
+import cx from 'classnames';
+import { usePrefix } from '../../internal/usePrefix.js';
+
+const ChatButtonSkeleton = _ref => {
+  let {
+    className,
+    size,
+    ...rest
+  } = _ref;
+  const prefix = usePrefix();
+  const skeletonClasses = cx(className, `${prefix}--skeleton`, `${prefix}--btn`, `${prefix}--chat-btn`, {
+    [`${prefix}--layout--size-${size}`]: size
+  });
+  return /*#__PURE__*/React__default.createElement("div", _extends({
+    className: skeletonClasses
+  }, rest));
+};
+ChatButtonSkeleton.propTypes = {
+  /**
+   * Specify an optional className to add.
+   */
+  className: PropTypes.string,
+  /**
+   * Specify the size of the `ChatButtonSkeleton`, from the following list of sizes:
+   */
+  size: PropTypes.oneOf(['sm', 'md', 'lg'])
+};
+var ChatButtonSkeleton$1 = ChatButtonSkeleton;
+
+export { ChatButtonSkeleton$1 as default };

package/es/components/ChatButton/ChatButton.js

@@ -0,0 +1,81 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import PropTypes from 'prop-types';
+import React__default from 'react';
+import cx from 'classnames';
+import Button from '../Button/Button.js';
+import '../Button/Button.Skeleton.js';
+import { usePrefix } from '../../internal/usePrefix.js';
+
+const ChatButton = /*#__PURE__*/React__default.forwardRef(function ChatButton(_ref, ref) {
+  let {
+    className,
+    children,
+    disabled,
+    isQuickAction,
+    isSelected,
+    kind,
+    size,
+    ...other
+  } = _ref;
+  const prefix = usePrefix();
+  const classNames = cx(className, {
+    [`${prefix}--chat-btn`]: true,
+    [`${prefix}--chat-btn--quick-action`]: isQuickAction,
+    [`${prefix}--chat-btn--quick-action--selected`]: isSelected
+  });
+  const allowedSizes = ['sm', 'md', 'lg'];
+  if (isQuickAction) {
+    kind = 'ghost';
+    size = 'sm';
+  } else {
+    // Do not allow size larger than `lg`
+    size = allowedSizes.includes(size) ? size : 'lg';
+  }
+  return /*#__PURE__*/React__default.createElement(Button, _extends({
+    disabled: disabled,
+    className: classNames,
+    kind: kind,
+    ref: ref,
+    size: size
+  }, other), children);
+});
+ChatButton.propTypes = {
+  /**
+   * Provide the contents of your Select
+   */
+  children: PropTypes.node,
+  /**
+   * Specify an optional className to be applied to the node containing the label and the select box
+   */
+  className: PropTypes.string,
+  /**
+   * Specify whether the `ChatButton` should be disabled
+   */
+  disabled: PropTypes.bool,
+  /**
+   * Specify whether the `ChatButton` should be rendered as a quick action button
+   */
+  isQuickAction: PropTypes.bool,
+  /**
+   * Specify whether the quick action `ChatButton` should be rendered as selected. This disables the input
+   */
+  isSelected: PropTypes.bool,
+  /**
+   * Specify the kind of `ChatButton` you want to create
+   */
+  kind: PropTypes.oneOf(['primary', 'secondary', 'danger', 'ghost', 'tertiary']),
+  /**
+   * Specify the size of the `ChatButton`, from the following list of sizes:
+   */
+  size: PropTypes.oneOf(['sm', 'md', 'lg'])
+};
+var ChatButton$1 = ChatButton;
+
+export { ChatButton$1 as default };

package/es/components/DataTable/DataTable.d.ts

@@ -53,6 +53,7 @@ export interface DataTableRow<ColTypes extends any[]> {
 export interface DataTableHeader {
     key: string;
     header: React.ReactNode;
+    slug: React.ReactElement;
 }
 export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
     headers: Array<DataTableHeader>;
@@ -152,6 +153,12 @@ export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
         stickyHeader?: boolean;
         useStaticWidth?: boolean;
     };
+    getCellProps: (getCellPropsArgs: {
+        cell: DataTableCell<ColTypes>;
+    }) => {
+        [key: string]: unknown;
+        hasSlugHeader?: boolean;
+    };
     onInputChange: (e: React.ChangeEvent<HTMLInputElement>, defaultValue?: string) => void;
     sortBy: (headerKey: string) => void;
     selectAll: () => void;
@@ -334,6 +341,7 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         sortDirection: DataTableSortState;
         isSortable: boolean | undefined;
         isSortHeader: boolean;
+        slug: React.ReactElement<any, string | React.JSXElementConstructor<any>>;
         onClick: (event: any) => void;
     };
     /**
@@ -468,6 +476,19 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         stickyHeader: boolean | undefined;
         useStaticWidth: boolean | undefined;
     };
+    /**
+     * Get the props associated with the given table cell.
+     *
+     * @param {object} config
+     * @param {object} config.cell the cell we want the props for
+     * @returns {object}
+     */
+    getCellProps: ({ cell, ...rest }: {
+        [x: string]: any;
+        cell: any;
+    }) => {
+        hasSlugHeader: any;
+    };
     /**
      * Helper utility to get all the currently selected rows
      * @returns {Array<string>} the array of rowIds that are currently selected

package/es/components/DataTable/DataTable.js

@@ -103,6 +103,7 @@ class DataTable extends React__default.Component {
         sortDirection,
         isSortable,
         isSortHeader: sortHeaderKey === header.key,
+        slug: header.slug,
         onClick: event => {
           const nextSortState = getNextSortState(this.props, this.state, {
             key: header.key
@@ -339,6 +340,23 @@ class DataTable extends React__default.Component {
         useStaticWidth
       };
     });
+    /**
+     * Get the props associated with the given table cell.
+     *
+     * @param {object} config
+     * @param {object} config.cell the cell we want the props for
+     * @returns {object}
+     */
+    _defineProperty(this, "getCellProps", _ref4 => {
+      let {
+        cell,
+        ...rest
+      } = _ref4;
+      return {
+        ...rest,
+        hasSlugHeader: cell.hasSlugHeader
+      };
+    });
     /**
      * Helper utility to get all the currently selected rows
      * @returns {Array<string>} the array of rowIds that are currently selected
@@ -612,6 +630,7 @@ class DataTable extends React__default.Component {
       getBatchActionProps: this.getBatchActionProps,
       getTableProps: this.getTableProps,
       getTableContainerProps: this.getTableContainerProps,
+      getCellProps: this.getCellProps,
       // Custom event handlers
       onInputChange: this.handleOnInputValueChange,
       // Expose internal state change actions

package/es/components/DataTable/TableCell.d.ts

@@ -4,7 +4,32 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { TdHTMLAttributes } from 'react';
-export type TableCellProps = TdHTMLAttributes<HTMLTableCellElement>;
-declare const TableCell: React.FC<TableCellProps>;
+import React from 'react';
+import { ReactAttr } from '../../types/common';
+interface TableCellProps extends ReactAttr<HTMLTableCellElement> {
+    /**
+     * Pass in children that will be embedded in the table header label
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * The width of the expanded row's internal cell
+     */
+    colSpan?: number;
+    /**
+     * Specify if the table cell is in an AI column
+     */
+    hasSlugHeader?: boolean;
+    /**
+     * The id of the matching th node in the table head. Addresses a11y concerns outlined here: https://www.ibm.com/able/guidelines/ci162/info_and_relationships.html and https://www.w3.org/TR/WCAG20-TECHS/H43
+     */
+    headers?: string;
+}
+declare const TableCell: {
+    ({ children, className, hasSlugHeader, colSpan, ...rest }: TableCellProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
 export default TableCell;

package/es/components/DataTable/TableCell.js

@@ -5,11 +5,28 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import wrapComponent from '../../tools/wrapComponent.js';
+import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import React__default from 'react';
+import cx from 'classnames';
+import { usePrefix } from '../../internal/usePrefix.js';
 
-const TableCell = wrapComponent({
-  name: 'TableCell',
-  type: 'td'
-});
+const TableCell = _ref => {
+  let {
+    children,
+    className,
+    hasSlugHeader,
+    colSpan,
+    ...rest
+  } = _ref;
+  const prefix = usePrefix();
+  const tableCellClassNames = cx(className, {
+    [`${prefix}--table-cell--column-slug`]: hasSlugHeader
+  });
+  return /*#__PURE__*/React__default.createElement("td", _extends({
+    className: tableCellClassNames ? tableCellClassNames : undefined,
+    colSpan: colSpan
+  }, rest), children);
+};
+TableCell.displayName = 'TableCell';
 
 export { TableCell as default };

package/es/components/DataTable/TableExpandRow.js

@@ -48,7 +48,7 @@ const TableExpandRow = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     [`${prefix}--parent-row`]: true,
     [`${prefix}--expandable-row`]: isExpanded,
     [`${prefix}--data-table--selected`]: isSelected,
-    [`${prefix}--parent-row--slug`]: rowHasSlug
+    [`${prefix}--data-table--slug-row`]: rowHasSlug
   }, rowClassName);
   const previousValue = isExpanded ? 'collapsed' : undefined;
   return /*#__PURE__*/React__default.createElement("tr", _extends({}, rest, {

package/es/components/DataTable/TableHeader.js

@@ -124,13 +124,13 @@ const TableHeader = /*#__PURE__*/React__default.forwardRef(function TableHeader(
     className: `${prefix}--table-sort__flex`
   }, /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--table-header-label`
-  }, children), normalizedSlug, /*#__PURE__*/React__default.createElement(ArrowUp, {
+  }, children), /*#__PURE__*/React__default.createElement(ArrowUp, {
     size: 20,
     className: `${prefix}--table-sort__icon`
   }), /*#__PURE__*/React__default.createElement(ArrowsVertical, {
     size: 20,
     className: `${prefix}--table-sort__icon-unsorted`
-  }))));
+  }), normalizedSlug)));
 });
 TableHeader.propTypes = {
   /**

package/es/components/DataTable/TableRow.js

@@ -13,10 +13,21 @@ import { usePrefix } from '../../internal/usePrefix.js';
 
 const TableRow = props => {
   const prefix = usePrefix();
+  let rowHasSlug;
+  if (props?.children) {
+    React__default.Children.toArray(props.children).map(child => {
+      if (child.type?.displayName === 'TableSlugRow') {
+        if (child.props.slug) {
+          rowHasSlug = true;
+        }
+      }
+    });
+  }
   // Remove unnecessary props if provided to this component, these are
   // only useful in `TableExpandRow`
   const className = cx(props.className, {
-    [`${prefix}--data-table--selected`]: props.isSelected
+    [`${prefix}--data-table--selected`]: props.isSelected,
+    [`${prefix}--data-table--slug-row`]: rowHasSlug
   });
   const cleanProps = {
     ...omit(props, ['ariaLabel', 'aria-label', 'aria-controls', 'onExpand', 'isExpanded', 'isSelected']),

package/es/components/DataTable/tools/normalize.js

@@ -48,7 +48,8 @@ const normalize = function (rows, headers) {
     }
     headers.forEach((_ref, i) => {
       let {
-        key
+        key,
+        slug
       } = _ref;
       const id = getCellId(row.id, key);
       // Initialize the cell info and state values, namely for editing
@@ -59,6 +60,7 @@ const normalize = function (rows, headers) {
         isEditing: false,
         isValid: true,
         errors: null,
+        hasSlugHeader: !!slug,
         info: {
           header: key
         }

package/es/index.d.ts

@@ -115,6 +115,7 @@ export { PageSelector as unstable_PageSelector, Pagination as unstable_Paginatio
 export * from './components/Popover';
 export * from './components/ProgressBar';
 export { Slug as unstable__Slug, SlugContent as unstable__SlugContent, SlugActions as unstable__SlugActions, } from './components/Slug';
+export { ChatButton as unstable__ChatButton, ChatButtonSkeleton as unstable__ChatButtonSkeleton, } from './components/ChatButton';
 export * from './components/Stack';
 export * from './components/Tooltip';
 export { Text as unstable_Text, TextDirection as unstable_TextDirection, } from './components/Text';

package/es/index.js

@@ -189,6 +189,8 @@ export { default as unstable__FluidTimePickerSkeleton } from './components/Fluid
 export { default as unstable__FluidTimePickerSelect } from './components/FluidTimePickerSelect/FluidTimePickerSelect.js';
 export { LayoutDirection as unstable_LayoutDirection } from './components/LayoutDirection/LayoutDirection.js';
 export { useLayoutDirection as unstable_useLayoutDirection } from './components/LayoutDirection/useLayoutDirection.js';
+export { default as unstable__ChatButton } from './components/ChatButton/ChatButton.js';
+export { default as unstable__ChatButtonSkeleton } from './components/ChatButton/ChatButton.Skeleton.js';
 export { Text as unstable_Text } from './components/Text/Text.js';
 export { TextDirection as unstable_TextDirection } from './components/Text/TextDirection.js';
 export { default as DataTable } from './components/DataTable/DataTable.js';

package/lib/components/Accordion/AccordionItem.js

@@ -61,7 +61,15 @@ function AccordionItem(_ref) {
   });
   const Toggle = renderToggle || renderExpando; // remove renderExpando in next major release
 
-  const content = React.useRef(null);
+  const content = React__default["default"].useCallback(node => {
+    if (!node) {
+      return;
+    }
+    if (isOpen) {
+      // accordion closes
+      node.style.maxBlockSize = '';
+    }
+  }, [isOpen]);
   if (open !== prevIsOpen) {
     setIsOpen(open);
     setPrevIsOpen(open);
@@ -70,19 +78,6 @@ function AccordionItem(_ref) {
   // When the AccordionItem heading is clicked, toggle the open state of the
   // panel
   function onClick(event) {
-    // type guard for ref
-    if (!content.current) {
-      return;
-    }
-    if (isOpen) {
-      // accordion closes
-      content.current.style.maxBlockSize = '';
-    } else {
-      // accordion opens
-      content.current.style.maxBlockSize =
-      // Scroll height plus top/bottom padding
-      content.current.scrollHeight + 32 + 'px';
-    }
     const nextValue = !isOpen;
     setIsOpen(nextValue);
     if (onHeadingClick) {

package/lib/components/ChatButton/ChatButton.Skeleton.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var PropTypes = require('prop-types');
+var React = require('react');
+var cx = require('classnames');
+var usePrefix = require('../../internal/usePrefix.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+const ChatButtonSkeleton = _ref => {
+  let {
+    className,
+    size,
+    ...rest
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const skeletonClasses = cx__default["default"](className, `${prefix}--skeleton`, `${prefix}--btn`, `${prefix}--chat-btn`, {
+    [`${prefix}--layout--size-${size}`]: size
+  });
+  return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({
+    className: skeletonClasses
+  }, rest));
+};
+ChatButtonSkeleton.propTypes = {
+  /**
+   * Specify an optional className to add.
+   */
+  className: PropTypes__default["default"].string,
+  /**
+   * Specify the size of the `ChatButtonSkeleton`, from the following list of sizes:
+   */
+  size: PropTypes__default["default"].oneOf(['sm', 'md', 'lg'])
+};
+var ChatButtonSkeleton$1 = ChatButtonSkeleton;
+
+exports["default"] = ChatButtonSkeleton$1;

package/lib/components/ChatButton/ChatButton.js

@@ -0,0 +1,91 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var PropTypes = require('prop-types');
+var React = require('react');
+var cx = require('classnames');
+var Button = require('../Button/Button.js');
+require('../Button/Button.Skeleton.js');
+var usePrefix = require('../../internal/usePrefix.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+const ChatButton = /*#__PURE__*/React__default["default"].forwardRef(function ChatButton(_ref, ref) {
+  let {
+    className,
+    children,
+    disabled,
+    isQuickAction,
+    isSelected,
+    kind,
+    size,
+    ...other
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const classNames = cx__default["default"](className, {
+    [`${prefix}--chat-btn`]: true,
+    [`${prefix}--chat-btn--quick-action`]: isQuickAction,
+    [`${prefix}--chat-btn--quick-action--selected`]: isSelected
+  });
+  const allowedSizes = ['sm', 'md', 'lg'];
+  if (isQuickAction) {
+    kind = 'ghost';
+    size = 'sm';
+  } else {
+    // Do not allow size larger than `lg`
+    size = allowedSizes.includes(size) ? size : 'lg';
+  }
+  return /*#__PURE__*/React__default["default"].createElement(Button["default"], _rollupPluginBabelHelpers["extends"]({
+    disabled: disabled,
+    className: classNames,
+    kind: kind,
+    ref: ref,
+    size: size
+  }, other), children);
+});
+ChatButton.propTypes = {
+  /**
+   * Provide the contents of your Select
+   */
+  children: PropTypes__default["default"].node,
+  /**
+   * Specify an optional className to be applied to the node containing the label and the select box
+   */
+  className: PropTypes__default["default"].string,
+  /**
+   * Specify whether the `ChatButton` should be disabled
+   */
+  disabled: PropTypes__default["default"].bool,
+  /**
+   * Specify whether the `ChatButton` should be rendered as a quick action button
+   */
+  isQuickAction: PropTypes__default["default"].bool,
+  /**
+   * Specify whether the quick action `ChatButton` should be rendered as selected. This disables the input
+   */
+  isSelected: PropTypes__default["default"].bool,
+  /**
+   * Specify the kind of `ChatButton` you want to create
+   */
+  kind: PropTypes__default["default"].oneOf(['primary', 'secondary', 'danger', 'ghost', 'tertiary']),
+  /**
+   * Specify the size of the `ChatButton`, from the following list of sizes:
+   */
+  size: PropTypes__default["default"].oneOf(['sm', 'md', 'lg'])
+};
+var ChatButton$1 = ChatButton;
+
+exports["default"] = ChatButton$1;

package/lib/components/DataTable/DataTable.d.ts

@@ -53,6 +53,7 @@ export interface DataTableRow<ColTypes extends any[]> {
 export interface DataTableHeader {
     key: string;
     header: React.ReactNode;
+    slug: React.ReactElement;
 }
 export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
     headers: Array<DataTableHeader>;
@@ -152,6 +153,12 @@ export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
         stickyHeader?: boolean;
         useStaticWidth?: boolean;
     };
+    getCellProps: (getCellPropsArgs: {
+        cell: DataTableCell<ColTypes>;
+    }) => {
+        [key: string]: unknown;
+        hasSlugHeader?: boolean;
+    };
     onInputChange: (e: React.ChangeEvent<HTMLInputElement>, defaultValue?: string) => void;
     sortBy: (headerKey: string) => void;
     selectAll: () => void;
@@ -334,6 +341,7 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         sortDirection: DataTableSortState;
         isSortable: boolean | undefined;
         isSortHeader: boolean;
+        slug: React.ReactElement<any, string | React.JSXElementConstructor<any>>;
         onClick: (event: any) => void;
     };
     /**
@@ -468,6 +476,19 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         stickyHeader: boolean | undefined;
         useStaticWidth: boolean | undefined;
     };
+    /**
+     * Get the props associated with the given table cell.
+     *
+     * @param {object} config
+     * @param {object} config.cell the cell we want the props for
+     * @returns {object}
+     */
+    getCellProps: ({ cell, ...rest }: {
+        [x: string]: any;
+        cell: any;
+    }) => {
+        hasSlugHeader: any;
+    };
     /**
      * Helper utility to get all the currently selected rows
      * @returns {Array<string>} the array of rowIds that are currently selected