@carbon/ibm-products 1.57.0 → 1.59.0

package/es/components/Datagrid/Datagrid/addons/RowSize/RowSizeRadioGroup.js

@@ -8,9 +8,8 @@
  * restricted by GSA ADP Schedule Contract with IBM Corp.
  */
 
-import React, { useEffect } from 'react';
+import React from 'react';
 import PropTypes from 'prop-types';
-import { rem } from '@carbon/layout';
 import { RadioButtonGroup, RadioButton } from 'carbon-components-react';
 import isArray from 'lodash/isArray';
 import { pkg } from '../../../../../settings';
@@ -19,9 +18,7 @@ var RowSizeRadioGroup = function RowSizeRadioGroup(_ref) {
   var rowSizes = _ref.rowSizes,
     selectedOption = _ref.selectedOption,
     datagridName = _ref.datagridName,
-    buttonRef = _ref.buttonRef,
     onChange = _ref.onChange,
-    hideRadioGroup = _ref.hideRadioGroup,
     legendText = _ref.legendText,
     _ref$rowSizeLabels = _ref.rowSizeLabels,
     rowSizeLabels = _ref$rowSizeLabels === void 0 ? {
@@ -31,25 +28,9 @@ var RowSizeRadioGroup = function RowSizeRadioGroup(_ref) {
       sm: 'Small',
       xs: 'Extra small'
     } : _ref$rowSizeLabels;
-  var _getDropdownPosition = getDropdownPosition(buttonRef.current),
-    top = _getDropdownPosition.top,
-    right = _getDropdownPosition.right;
-  useEffect(function () {
-    window.addEventListener('click', hideRadioGroup);
-    return function () {
-      window.removeEventListener('click', hideRadioGroup);
-    };
-  }, [hideRadioGroup]);
   return /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__row-size-dropdown"),
-    style: {
-      top: rem(top),
-      right: rem(right)
-    },
-    role: "presentation",
-    onClick: function onClick(e) {
-      e.stopPropagation();
-    }
+    role: "presentation"
   }, /*#__PURE__*/React.createElement(RadioButtonGroup, {
     legendText: legendText,
     name: "row-height-group",
@@ -83,21 +64,6 @@ var getBackwardCompatibleRowSize = function getBackwardCompatibleRowSize(rowSize
 
   return rowSizeMap[rowSize] || rowSize;
 };
-var getDropdownPosition = function getDropdownPosition(buttonEle) {
-  var parent = buttonEle.parentElement;
-  if (parent instanceof HTMLElement) {
-    var top = buttonEle.offsetTop + buttonEle.offsetHeight;
-    var right = parent.offsetWidth - (buttonEle.offsetLeft + buttonEle.offsetWidth);
-    return {
-      top: top,
-      right: right
-    };
-  }
-  return {
-    top: 0,
-    right: 0
-  };
-};
 RowSizeRadioGroup.defaultProps = {
   rowSizes: [{
     value: 'xl' // 64
@@ -116,7 +82,6 @@ RowSizeRadioGroup.defaultProps = {
 RowSizeRadioGroup.propTypes = {
   buttonRef: PropTypes.any.isRequired,
   datagridName: PropTypes.string,
-  hideRadioGroup: PropTypes.func.isRequired,
   legendText: PropTypes.string,
   onChange: PropTypes.func.isRequired,
   rowSizeLabels: PropTypes.object,

package/es/components/InlineTip/InlineTip.js

@@ -10,7 +10,7 @@ var _excluded = ["children", "className", "closeIconDescription", "collapsible",
  */
 
 // Import portions of React that are needed.
-import React, { useEffect, useMemo, useState } from 'react';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
 
 // Other standard imports.
 import { Close16, Crossroads16, Idea20 } from '@carbon/icons-react';
@@ -20,6 +20,7 @@ import cx from 'classnames';
 import { getComponentText } from './utils';
 import { SteppedAnimatedMedia } from '../SteppedAnimatedMedia';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import uuidv4 from '../../global/js/utils/uuidv4';
 import { pkg /*, carbon */ } from '../../settings';
 
 // Carbon and package components we use.
@@ -79,6 +80,7 @@ export var InlineTip = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState2 = _slicedToArray(_useState, 2),
     isCollapsed = _useState2[0],
     setIsCollapsed = _useState2[1];
+  var labelId = useRef(uuidv4()).current;
   var previewText = useMemo(function () {
     return getComponentText(React.Children.toArray(children));
   }, [children]);
@@ -94,6 +96,7 @@ export var InlineTip = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setIsCollapsed(collapsible);
   }, [collapsible]);
   return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    "aria-labelledby": labelId,
     className: cx(blockClass,
     // Apply the block class to the main HTML element
     className,
@@ -115,6 +118,7 @@ export var InlineTip = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, /*#__PURE__*/React.createElement(Idea20, null)), /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__content")
   }, /*#__PURE__*/React.createElement("h6", {
+    id: labelId,
     className: "".concat(blockClass, "__title")
   }, title), /*#__PURE__*/React.createElement("section", {
     className: "".concat(blockClass, "__body")

package/es/components/InlineTip/InlineTipButton.js

@@ -42,7 +42,7 @@ var componentName = 'InlineTipButton';
 // };
 
 /**
- * TODO: A description of the component.
+ * TODO: A standard Carbon button, styled specifically for use inside InlineTip.
  */
 export var InlineTipButton = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var children = _ref.children,
@@ -65,13 +65,6 @@ export var InlineTipButton = /*#__PURE__*/React.forwardRef(function (_ref, ref)
   }), children);
 });
 
-// Return a placeholder if not released and not enabled by feature flag
-InlineTipButton = pkg.checkComponentEnabled(InlineTipButton, componentName);
-
-// The display name of the component, used by React. Note that displayName
-// is used in preference to relying on function.name.
-InlineTipButton.displayName = componentName;
-
 // The types and DocGen commentary for the component props,
 // in alphabetical order (for consistency).
 // See https://www.npmjs.com/package/prop-types#usage.

package/es/components/InlineTip/InlineTipLink.js

@@ -43,7 +43,7 @@ var componentName = 'InlineTipLink';
 // };
 
 /**
- * TODO: A description of the component.
+ * TODO: A standard Carbon link, styled specifically for use inside InlineTip.
  */
 export var InlineTipLink = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var children = _ref.children,
@@ -65,13 +65,6 @@ export var InlineTipLink = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }), children);
 });
 
-// Return a placeholder if not released and not enabled by feature flag
-InlineTipLink = pkg.checkComponentEnabled(InlineTipLink, componentName);
-
-// The display name of the component, used by React. Note that displayName
-// is used in preference to relying on function.name.
-InlineTipLink.displayName = componentName;
-
 // The types and DocGen commentary for the component props,
 // in alphabetical order (for consistency).
 // See https://www.npmjs.com/package/prop-types#usage.

package/es/components/NonLinearReading/NonLinearReading.js

@@ -9,11 +9,12 @@ var _excluded = ["children", "className", "definition", "theme"];
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, { useState } from 'react';
+import React, { useRef, useState } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { ChevronDown16 } from '@carbon/icons-react';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import uuidv4 from '../../global/js/utils/uuidv4';
 import { pkg } from '../../settings';
 
 // The block part of our conventional BEM class names (blockClass__E--M).
@@ -41,6 +42,7 @@ export var NonLinearReading = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     _useState2 = _slicedToArray(_useState, 2),
     isOpen = _useState2[0],
     setOpen = _useState2[1];
+  var contentId = useRef(uuidv4()).current;
   var handleToggle = function handleToggle() {
     setOpen(function (prevState) {
       return !prevState;
@@ -52,12 +54,15 @@ export var NonLinearReading = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     role: "main"
   }, getDevtoolsProps(componentName)), ' ', /*#__PURE__*/React.createElement("button", {
     type: "button",
+    "aria-controls": contentId,
     "aria-expanded": isOpen,
     className: cx("".concat(blockClass, "__keyword"), [isOpen ? ["".concat(blockClass, "__keyword-open")] : ["".concat(blockClass, "__keyword-closed")]]),
     onClick: handleToggle
-  }, children, /*#__PURE__*/React.createElement(ChevronDown16, null)), ' ', isOpen && /*#__PURE__*/React.createElement("span", {
-    className: "".concat(blockClass, "__body")
-  }, definition), ' ');
+  }, children, /*#__PURE__*/React.createElement(ChevronDown16, null)), ' ', /*#__PURE__*/React.createElement("span", {
+    id: contentId,
+    className: "".concat(blockClass, "__body"),
+    hidden: !isOpen
+  }, isOpen && definition), ' ');
 });
 
 // Return a placeholder if not released and not enabled by feature flag

package/es/components/index.js

@@ -53,4 +53,5 @@ export { CoachmarkButton } from './CoachmarkButton';
 export { CoachmarkOverlayElements } from './CoachmarkOverlayElements';
 export { CoachmarkOverlayElement } from './CoachmarkOverlayElement';
 export { CoachmarkStack } from './CoachmarkStack';
-export { InlineTip } from './InlineTip';
+export { InlineTip } from './InlineTip';
+export { Checklist } from './Checklist';

package/es/global/js/package-settings.js

@@ -75,6 +75,7 @@ var defaults = {
     InlineTip: false,
     Guidebanner: false,
     NonLinearReading: false,
+    Checklist: false,
     Coachmark: false,
     CoachmarkBeacon: false,
     CoachmarkButton: false,

package/es/global/js/utils/test-helper.js

@@ -109,7 +109,7 @@ var makeMatcherArray = function makeMatcherArray(args) {
  * A helper function to enable a test to expect a single call to
  * console.warn, for example when intentionally using a deprecated prop
  * or supplying invalid parameters for the purposes of the test.
- * @param {string|regex|Function|[]} message the expected parameters for the call to
+ * @param {string | regex | Function | []} message the expected parameters for the call to
  * console.warn, which must be called exactly once. A single string or regex or an
  * expect matcher can be used to match a single-argument call to console.warn (most common),
  * while an array of strings and/or regex and/or expect matchers can be used to match a
@@ -220,7 +220,7 @@ export var expectLogging = function expectLogging(_ref2, test) {
  * A helper function to enable a test to expect a single call to
  * console.error, for example when intentionally omitting a required prop
  * or supplying an invalid prop type or value for the purposes of the test.
- * @param {string|regex|Function|[]} message the expected parameters for the call to
+ * @param {string | regex | Function | []} message the expected parameters for the call to
  * console.error, which must be called exactly once. A single string or regex or an
  * expect matcher can be used to match a single-argument call to console.error (most common),
  * while an array of strings and/or regex and/or expect matchers can be used to match a

package/lib/components/Checklist/Checklist.js

@@ -0,0 +1,267 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Checklist = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+var _settings = require("../../settings");
+var _carbonComponentsReact = require("carbon-components-react");
+var _iconsReact = require("@carbon/icons-react");
+var _ChecklistIcon = require("./ChecklistIcon");
+var _ChecklistChart = require("./ChecklistChart");
+var _excluded = ["chartValue", "chartLabel", "checklistAriaLabel", "checklistToggleAriaLabel", "className", "onClickViewAll", "onToggle", "open", "showToggle", "taskLists", "theme", "title", "viewAllLabel"];
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--checklist");
+var componentName = 'Checklist';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values can be included here and then assigned to the prop params,
+// e.g. prop = defaults.prop,
+// This gathers default values together neatly and ensures non-primitive
+// values are initialized early to avoid react making unnecessary re-renders.
+// Note that default values are not required for props that are 'required',
+// nor for props where the component can apply undefined values reasonably.
+// Default values should be provided when the component needs to make a choice
+// or assumption when a prop is not supplied.
+
+// Default values for props
+var defaults = {
+  checklistAriaLabel: 'Checklist',
+  checklistToggleAriaLabel: 'Checklist toggle',
+  onClickViewAll: function onClickViewAll() {},
+  onToggle: function onToggle() {},
+  open: true,
+  showToggle: true,
+  taskLists: [],
+  theme: 'light'
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var Checklist = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var chartValue = _ref.chartValue,
+    chartLabel = _ref.chartLabel,
+    _ref$checklistAriaLab = _ref.checklistAriaLabel,
+    checklistAriaLabel = _ref$checklistAriaLab === void 0 ? defaults.checklistAriaLabel : _ref$checklistAriaLab,
+    _ref$checklistToggleA = _ref.checklistToggleAriaLabel,
+    checklistToggleAriaLabel = _ref$checklistToggleA === void 0 ? defaults.checklistToggleAriaLabel : _ref$checklistToggleA,
+    className = _ref.className,
+    _ref$onClickViewAll = _ref.onClickViewAll,
+    onClickViewAll = _ref$onClickViewAll === void 0 ? defaults.onClickViewAll : _ref$onClickViewAll,
+    _ref$onToggle = _ref.onToggle,
+    onToggle = _ref$onToggle === void 0 ? defaults.onToggle : _ref$onToggle,
+    _ref$open = _ref.open,
+    open = _ref$open === void 0 ? defaults.open : _ref$open,
+    _ref$showToggle = _ref.showToggle,
+    showToggle = _ref$showToggle === void 0 ? defaults.showToggle : _ref$showToggle,
+    _ref$taskLists = _ref.taskLists,
+    taskLists = _ref$taskLists === void 0 ? defaults.taskLists : _ref$taskLists,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    title = _ref.title,
+    viewAllLabel = _ref.viewAllLabel,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var _useState = (0, _react.useState)(open),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    isOpen = _useState2[0],
+    setIsOpen = _useState2[1];
+  var listContainerId = (0, _react.useRef)((0, _uuidv.default)()).current;
+  var chartLabelId = (0, _react.useRef)((0, _uuidv.default)()).current;
+
+  // Don't use this test: {chartValue && chartLabel && (render...)}.
+  // If `chartValue` is 0 (zero) - a valid value - then it will render 0 and skip the remaining statement.
+  // Use this test instead: {chartLabelAndValue && (render...)}.
+  // The ChecklistChart component will validate `chartValue`.
+  var chartLabelAndValue = typeof chartValue === 'number' && chartLabel;
+  var handleClickToggle = function handleClickToggle() {
+    setIsOpen(function (prevOpen) {
+      return !prevOpen;
+    });
+  };
+  var handleClickViewAll = function handleClickViewAll() {
+    onClickViewAll();
+  };
+
+  // If state changes, then trigger callback.
+  (0, _react.useEffect)(function () {
+    onToggle(isOpen);
+  }, [isOpen, onToggle]);
+
+  // If the "open" prop is changed after initialization,
+  // then update internal state.
+  (0, _react.useEffect)(function () {
+    setIsOpen(open);
+  }, [open]);
+  return /*#__PURE__*/_react.default.createElement("aside", (0, _extends2.default)({}, rest, {
+    "aria-label": checklistAriaLabel,
+    className: (0, _classnames.default)(blockClass,
+    // Apply the block class to the main HTML element
+    className, // Apply any supplied class names to the main HTML element.
+    // example: `${blockClass}__template-string-class-${kind}-n-${size}`,
+    (0, _defineProperty2.default)({}, "".concat(blockClass, "__closed"), !isOpen)),
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName)), (title || chartLabelAndValue) && /*#__PURE__*/_react.default.createElement("header", {
+    className: "".concat(blockClass, "__header")
+  }, chartLabelAndValue && /*#__PURE__*/_react.default.createElement(_ChecklistChart.ChecklistChart, {
+    "aria-labelledby": chartLabelId,
+    theme: theme,
+    value: chartValue
+  }), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__titles")
+  }, title && /*#__PURE__*/_react.default.createElement("h2", {
+    className: "".concat(blockClass, "__title")
+  }, title), chartLabelAndValue && /*#__PURE__*/_react.default.createElement("h3", {
+    id: chartLabelId,
+    className: "".concat(blockClass, "__chart-label")
+  }, chartLabel)), showToggle && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    "aria-controls": listContainerId,
+    "aria-expanded": isOpen,
+    "aria-label": checklistToggleAriaLabel,
+    className: "".concat(blockClass, "__toggle"),
+    kind: "ghost",
+    onClick: handleClickToggle,
+    size: "small"
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.ChevronUp16, {
+    className: (0, _classnames.default)("".concat(blockClass, "__chevron"))
+  }))), /*#__PURE__*/_react.default.createElement("div", {
+    id: listContainerId,
+    className: "".concat(blockClass, "__content-outer")
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__content-inner")
+  }, /*#__PURE__*/_react.default.createElement("section", {
+    className: (0, _classnames.default)("".concat(blockClass, "__body"))
+  }, taskLists.map(function (list, index) {
+    return /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__list-group"),
+      key: "".concat(list.title, "-").concat(index)
+    }, list.title && /*#__PURE__*/_react.default.createElement("h3", {
+      title: list.title,
+      className: "".concat(blockClass, "__list-title")
+    }, list.title), /*#__PURE__*/_react.default.createElement("ol", {
+      className: "".concat(blockClass, "__list")
+    }, list.tasks.map(function (item, index) {
+      return /*#__PURE__*/_react.default.createElement("li", {
+        className: "".concat(blockClass, "__list-item"),
+        key: "".concat(item.label, "-").concat(index)
+      }, /*#__PURE__*/_react.default.createElement(_ChecklistIcon.ChecklistIcon, {
+        kind: item.kind
+      }), typeof item.onClick === 'function' ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+        className: (0, _classnames.default)("".concat(blockClass, "__button"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__button--error"), item.kind === 'error')),
+        onClick: function onClick() {
+          item.onClick(item);
+        },
+        size: "small"
+      }, /*#__PURE__*/_react.default.createElement("div", {
+        title: item.label
+      }, item.label)) : /*#__PURE__*/_react.default.createElement("span", {
+        className: (0, _classnames.default)("".concat(blockClass, "__label"), "".concat(blockClass, "__label--").concat(item.kind)),
+        title: item.label
+      }, item.label));
+    })));
+  })), viewAllLabel && /*#__PURE__*/_react.default.createElement("footer", {
+    className: "".concat(blockClass, "__footer")
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    className: (0, _classnames.default)("".concat(blockClass, "__button"), "".concat(blockClass, "__view-all")),
+    onClick: handleClickViewAll,
+    size: "small"
+  }, /*#__PURE__*/_react.default.createElement("div", null, viewAllLabel))))));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.Checklist = Checklist;
+exports.Checklist = Checklist = _settings.pkg.checkComponentEnabled(Checklist, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+Checklist.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+Checklist.propTypes = {
+  /**
+   * Define both `chartLabel` and `chartValue` to show the chart and its label together.
+   */
+  chartLabel: _propTypes.default.string,
+  /**
+   * A number between 0 and 1.
+   *
+   * Define both `chartLabel` and `chartValue` to show the chart and its label together.
+   */
+  chartValue: _propTypes.default.number,
+  /**
+   * Aria-label for the Checklist component.
+   */
+  checklistAriaLabel: _propTypes.default.string,
+  /**
+   * Aria-label for the Checklist's toggle component.
+   */
+  checklistToggleAriaLabel: _propTypes.default.string,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+  /**
+   * Callback for the "View all" button. See also `viewAllLabel`.
+   */
+  onClickViewAll: _propTypes.default.func,
+  /**
+   * Optional callback for when the list is opened/closed.
+   */
+  onToggle: _propTypes.default.func,
+  /**
+   * Specifies whether the component is opened or closed.
+   * This can be set during initialization, or changed after being rendered.
+   */
+  open: _propTypes.default.bool,
+  /**
+   * Whether or not to show the open/close toggle.
+   */
+  showToggle: _propTypes.default.bool,
+  /**
+   * The task list can be broken down into sub-lists.
+   *
+   * Each sub-list can include an optional `title`.
+   *
+   * Each task must specify the appropriate icon (`kind`) and `label`.
+   *
+   * If any task has an `onClick` callback function defined,
+   * then the `label` will be rendered as a button,
+   * else the `label` will be rendered as plain text.
+   */
+  taskLists: _propTypes.default.arrayOf(_propTypes.default.shape({
+    title: _propTypes.default.string,
+    tasks: _propTypes.default.arrayOf(_propTypes.default.shape({
+      kind: _propTypes.default.oneOf(['unchecked', 'indeterminate', 'checked', 'disabled', 'error']).isRequired,
+      label: _propTypes.default.string.isRequired,
+      onClick: _propTypes.default.func
+    })).isRequired
+  })).isRequired,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']),
+  /**
+   * The title of the component.
+   */
+  title: _propTypes.default.string,
+  /**
+   * If defined, will show and enable the "View all (#)" button at the bottom of the list.
+   */
+  viewAllLabel: _propTypes.default.string
+};

package/lib/components/Checklist/ChecklistChart.js

@@ -0,0 +1,88 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChecklistChart = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireDefault(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _clamp = _interopRequireDefault(require("lodash/clamp"));
+var _excluded = ["className", "value", "theme"];
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--checklist__chart");
+var componentName = 'ChecklistChart';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values can be included here and then assigned to the prop params,
+// e.g. prop = defaults.prop,
+// This gathers default values together neatly and ensures non-primitive
+// values are initialized early to avoid react making unnecessary re-renders.
+// Note that default values are not required for props that are 'required',
+// nor for props where the component can apply undefined values reasonably.
+// Default values should be provided when the component needs to make a choice
+// or assumption when a prop is not supplied.
+
+// Default values for props
+var defaults = {
+  theme: 'light'
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var ChecklistChart = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+    value = _ref.value,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var numDegrees = (0, _clamp.default)(value * 360, 0, 360);
+  var circleColor = theme === 'light' ? '#c6c6c6' : '#525252'; // $gray-30, $gray-70
+  var progressColor = theme === 'light' ? '#6929c4' : '#A56EFF'; // $purple-70, $purple-50
+
+  return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, className),
+    style: {
+      backgroundImage: "conic-gradient(".concat(progressColor, " ").concat(numDegrees, "deg, ").concat(circleColor, " ").concat(numDegrees, "deg 360deg)"),
+      borderRadius: '50%'
+    },
+    ref: ref,
+    role: "img"
+  }, (0, _devtools.getDevtoolsProps)(componentName)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+// ChecklistChart = pkg.checkComponentEnabled(ChecklistChart, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+// ChecklistChart.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+exports.ChecklistChart = ChecklistChart;
+ChecklistChart.propTypes = {
+  /**
+   * Optional class name for this component.
+   */
+  className: _propTypes.default.string,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']),
+  /**
+   * Number between 0 and 1.
+   */
+  value: _propTypes.default.number.isRequired
+};