@carbon/ibm-products 2.32.0 → 2.34.0

package/es/components/OptionsTile/OptionsTile.d.ts

@@ -1,5 +1,79 @@
 /**
- * TODO: A description of the component.
+ * Copyright IBM Corp. 2021, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
  */
-export let OptionsTile: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+import React, { ReactNode } from 'react';
+interface OptionsTileProps {
+    /**
+     * Provide content to render as expandable OptionsTile. If no children
+     * are present, the OptionsTile will render as its variant.
+     */
+    children?: ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+    /**
+     * Whether the toggle is enabled or disabled. If nothing is passed,
+     * no toggle will be rendered.
+     */
+    enabled?: boolean;
+    /**
+     * Whether the OptionsTile is in invalid validation state.
+     */
+    invalid?: boolean;
+    /**
+     * Provide a text explaining why the OptionsTile is in invalid state.
+     */
+    invalidText?: string;
+    /**
+     * Whether the OptionsTile is in locked validation state.
+     */
+    locked?: boolean;
+    /**
+     * Provide a text explaining why the OptionsTile is in locked state.
+     */
+    lockedText?: string;
+    /**
+     * Provide a function which will be called each time the user
+     * toggles the open state of the OptionsTile.
+     */
+    onChange?: (value: boolean) => void;
+    /**
+     * Provide a function which will be called each time the user
+     * interacts with the toggle.
+     */
+    onToggle: (value: boolean) => void;
+    /**
+     * Whether the OptionsTile is in open state.
+     */
+    open?: boolean;
+    /**
+     * Define the size of the OptionsTile.
+     */
+    size: 'lg' | 'xl';
+    /**
+     * Optionally provide a text summarizing the current state of the content.
+     */
+    summary?: string;
+    /**
+     * Provide the title for this OptionsTile.
+     */
+    title: string;
+    /**
+     * Optionally provide an id which should be used for the title.
+     */
+    titleId?: string;
+    /**
+     * Whether the OptionsTile is in warning validation state.
+     */
+    warn?: boolean;
+    /**
+     * Provide a text explaining why the OptionsTile is in warning state.
+     */
+    warnText?: string;
+}
+export declare let OptionsTile: React.ForwardRefExoticComponent<OptionsTileProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/es/components/OptionsTile/OptionsTile.js

@@ -19,22 +19,12 @@ import { useControllableState } from '../../global/js/hooks/useControllableState
 
 var _Locked;
 var _excluded = ["children", "className", "enabled", "invalid", "invalidText", "locked", "lockedText", "onChange", "onToggle", "open", "size", "summary", "title", "titleId", "warn", "warnText"];
-
-// The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--options-tile");
 var componentName = 'OptionsTile';
-
-// NOTE: the component SCSS is not imported here: it is rolled up separately.
-
 // Default values for props
 var defaults = {
-  onChange: function onChange() {},
-  size: 'xl'
+  size: 'lg'
 };
-
-/**
- * TODO: A description of the component.
- */
 var OptionsTile = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
   var children = _ref.children,
     className = _ref.className,
@@ -43,8 +33,7 @@ var OptionsTile = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     invalidText = _ref.invalidText,
     locked = _ref.locked,
     lockedText = _ref.lockedText,
-    _ref$onChange = _ref.onChange,
-    _onChange = _ref$onChange === void 0 ? defaults.onChange : _ref$onChange,
+    _onChange = _ref.onChange,
     onToggle = _ref.onToggle,
     open = _ref.open,
     _ref$size = _ref.size,
@@ -64,11 +53,12 @@ var OptionsTile = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     closing = _useState4[0],
     setClosing = _useState4[1];
   var _useControllableState = useControllableState({
-      value: open,
       defaultValue: open || null,
+      name: 'OptionsTile',
       onChange: function onChange(value) {
-        return _onChange(value);
-      }
+        return _onChange === null || _onChange === void 0 ? void 0 : _onChange(value);
+      },
+      value: open
     }),
     _useControllableState2 = _slicedToArray(_useControllableState, 2),
     isOpen = _useControllableState2[0],
@@ -200,10 +190,7 @@ var OptionsTile = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     }, text)));
   }
   return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
-    className: cx(blockClass,
-    // Apply the block class to the main HTML element
-    className, // Apply any supplied class names to the main HTML element.
-    "".concat(blockClass, "--").concat(size), _defineProperty({}, "".concat(blockClass, "--closing"), closing)),
+    className: cx(blockClass, className, "".concat(blockClass, "--").concat(size), _defineProperty({}, "".concat(blockClass, "--closing"), closing)),
     ref: ref
   }, getDevtoolsProps(componentName)), enabled !== undefined && /*#__PURE__*/React__default.createElement("div", {
     className: "".concat(blockClass, "__toggle-container")
@@ -294,6 +281,7 @@ OptionsTile.propTypes = {
    * Provide a function which will be called each time the user
    * interacts with the toggle.
    */
+  /**@ts-ignore*/
   onToggle: PropTypes.func,
   /**
    * Whether the OptionsTile is in open state.
@@ -302,6 +290,7 @@ OptionsTile.propTypes = {
   /**
    * Define the size of the OptionsTile.
    */
+  /**@ts-ignore*/
   size: PropTypes.oneOf(['lg', 'xl']),
   /**
    * Optionally provide a text summarizing the current state of the content.

package/es/components/RemoveModal/RemoveModal.d.ts

@@ -1,7 +1,81 @@
-/**
-The `RemoveModal` covers what is known as high impact and medium impact deleting.
-Enabling `textConfirmation` enables what would be considered the high impact state of the modal.
-For additional information on differentiating between delete / remove and low / medium / high impact please refer to the usage guidelines.
- */
-export let RemoveModal: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+/// <reference path="../../../src/custom-typings/index.d.ts" />
+import React, { ReactNode } from 'react';
+import { ComposedModal } from '@carbon/react';
+interface RemoveModalProps extends React.ComponentProps<typeof ComposedModal> {
+    /**
+     * The content to be displayed in the body of the modal
+     */
+    body: string;
+    /**
+     * Optional classname
+     */
+    className?: string;
+    /**
+     * Provide a description for "close" icon that can be read by screen readers
+     */
+    iconDescription: string;
+    /**
+     * Message showed when user input fails validation
+     */
+    inputInvalidText?: string;
+    /**
+     * Label for text box
+     */
+    inputLabelText?: ReactNode;
+    /**
+     * Placeholder for text box
+     */
+    inputPlaceholderText?: string;
+    /**
+     * Specify the modal label texts
+     */
+    label?: string;
+    /**
+     * Callback function that runs when user closes the modal
+     */
+    onClose?: () => void;
+    /**
+     * Callback function that runs when user submits the modal
+     */
+    onRequestSubmit?: () => void;
+    /**
+     * Specify whether the Modal is currently open
+     */
+    open: boolean;
+    /**
+     * The DOM node the tearsheet should be rendered within. Defaults to document.body.
+     */
+    portalTarget?: ReactNode;
+    /**
+     * Prevent closing on click outside of modal
+     */
+    preventCloseOnClickOutside?: boolean;
+    /**
+     * Specify whether the primary button should be disabled. This value will override textConfirmation
+     */
+    primaryButtonDisabled?: boolean;
+    /**
+     * Specify the text for the primary button
+     */
+    primaryButtonText?: string;
+    /**
+     * The name of the resource being acted upon
+     */
+    resourceName: string;
+    /**
+     * Specify the text for the secondary button
+     */
+    secondaryButtonText?: string;
+    /**
+     * Specify whether or not to show the text confirmation input
+     */
+    textConfirmation?: boolean;
+    /**
+     * The text displayed at the top of the modal
+     */
+    title: string;
+}
+export declare let RemoveModal: React.ForwardRefExoticComponent<RemoveModalProps & {
+    children?: React.ReactNode;
+} & React.RefAttributes<unknown>>;
+export {};

package/es/components/RemoveModal/RemoveModal.js

@@ -24,6 +24,7 @@ The `RemoveModal` covers what is known as high impact and medium impact deleting
 Enabling `textConfirmation` enables what would be considered the high impact state of the modal.
 For additional information on differentiating between delete / remove and low / medium / high impact please refer to the usage guidelines.
  */
+
 var RemoveModal = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var body = _ref.body,
     className = _ref.className,

package/es/components/ScrollGradient/ScrollGradient.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TODO: A description of the component.
+ */
+export let ScrollGradient: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
+import React from 'react';

package/es/components/ScrollGradient/ScrollGradient.js

@@ -0,0 +1,156 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * 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 { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, extends as _extends, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import React__default, { useState, useRef, useCallback, useEffect } from 'react';
+import PropTypes from '../../node_modules/prop-types/index.js';
+import cx from 'classnames';
+import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
+import { pkg, carbon } from '../../settings.js';
+import { throttle } from 'lodash';
+import { ScrollStates, getScrollState, ScrollDirection, useIsOverflow } from './constants.js';
+
+var _excluded = ["children", "className", "color", "onScroll", "scrollElementClassName", "getScrollElementRef", "hideStartGradient"];
+var blockClass = "".concat(pkg.prefix, "--scroll-gradient");
+var componentName = 'ScrollGradient';
+
+// Default values for props
+var defaults = {
+  color: "var(--".concat(carbon.prefix, "-layer-01)"),
+  hideStartGradient: false,
+  onScroll: function onScroll() {},
+  getScrollElementRef: function getScrollElementRef() {}
+};
+
+/**
+ * TODO: A description of the component.
+ */
+var ScrollGradient = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
+  var children = _ref.children,
+    className = _ref.className,
+    _ref$color = _ref.color,
+    color = _ref$color === void 0 ? defaults.color : _ref$color,
+    _ref$onScroll = _ref.onScroll,
+    onScroll = _ref$onScroll === void 0 ? defaults.onScroll : _ref$onScroll,
+    scrollElementClassName = _ref.scrollElementClassName,
+    _ref$getScrollElement = _ref.getScrollElementRef,
+    getScrollElementRef = _ref$getScrollElement === void 0 ? defaults.getScrollElementRef : _ref$getScrollElement,
+    _ref$hideStartGradien = _ref.hideStartGradient,
+    hideStartGradient = _ref$hideStartGradien === void 0 ? defaults.hideStartGradient : _ref$hideStartGradien,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useState = useState(ScrollStates.NONE),
+    _useState2 = _slicedToArray(_useState, 2),
+    verticalPosition = _useState2[0],
+    setVerticalPosition = _useState2[1];
+  var _useState3 = useState(ScrollStates.NONE),
+    _useState4 = _slicedToArray(_useState3, 2),
+    horizontalPosition = _useState4[0],
+    setHorizontalPosition = _useState4[1];
+  var scrollContainer = useRef();
+  var contentChildrenContainer = useRef();
+  var updateScrollState = throttle(function () {
+    var updatedVerticalVal = getScrollState(scrollContainer.current, ScrollDirection.Y);
+    var updatedHorizontalVal = getScrollState(scrollContainer.current, ScrollDirection.X);
+    setVerticalPosition(updatedVerticalVal);
+    setHorizontalPosition(updatedHorizontalVal);
+  }, 150);
+  var scrollHandler = useCallback(function (event) {
+    onScroll(event);
+    updateScrollState();
+  }, [onScroll, updateScrollState]);
+  var setRefs = function setRefs(element) {
+    scrollContainer.current = element;
+    getScrollElementRef(element);
+  };
+  useEffect(function () {
+    scrollHandler();
+  }, [scrollHandler]);
+  var _useIsOverflow = useIsOverflow(scrollContainer),
+    xScrollable = _useIsOverflow.xScrollable,
+    yScrollable = _useIsOverflow.yScrollable;
+  var gradientRight = yScrollable && scrollContainer.current && contentChildrenContainer.current ? scrollContainer.current.offsetWidth - contentChildrenContainer.current.offsetWidth : 0;
+  var gradientBottom = xScrollable && scrollContainer.current && contentChildrenContainer.current ? scrollContainer.current.offsetHeight - contentChildrenContainer.current.offsetHeight : 0;
+  return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
+    className: cx(blockClass, "".concat(blockClass, "--x-").concat(horizontalPosition.toLowerCase()), "".concat(blockClass, "--y-").concat(verticalPosition.toLowerCase()), _defineProperty(_defineProperty({}, "".concat(blockClass, "--x-scrollable"), xScrollable), "".concat(blockClass, "--y-scrollable"), yScrollable), className),
+    ref: ref,
+    role: "presentation"
+  }, getDevtoolsProps(componentName)), /*#__PURE__*/React__default.createElement("div", {
+    onScroll: scrollHandler,
+    ref: setRefs,
+    className: cx("".concat(blockClass, "__content"), scrollElementClassName)
+  }, /*#__PURE__*/React__default.createElement("div", {
+    ref: contentChildrenContainer,
+    className: "".concat(blockClass, "__content-children")
+  }, children)), !hideStartGradient && /*#__PURE__*/React__default.createElement(React__default.Fragment, null, /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(blockClass, "__start-vertical"),
+    style: {
+      right: gradientRight,
+      backgroundImage: "linear-gradient(0deg, transparent, ".concat(color, " 90%)")
+    },
+    role: "presentation",
+    "aria-hidden": true
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(blockClass, "__start-horizontal"),
+    style: {
+      backgroundImage: "linear-gradient(-90deg, transparent, ".concat(color, " 90%)"),
+      bottom: gradientBottom
+    },
+    role: "presentation",
+    "aria-hidden": true
+  })), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(blockClass, "__end-vertical"),
+    style: {
+      right: gradientRight,
+      bottom: gradientBottom,
+      backgroundImage: "linear-gradient(0deg, ".concat(color, " 10%, transparent)")
+    },
+    role: "presentation",
+    "aria-hidden": true
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(blockClass, "__end-horizontal"),
+    style: {
+      right: gradientRight,
+      bottom: gradientBottom,
+      backgroundImage: "linear-gradient(-90deg, ".concat(color, " 10%, transparent)")
+    },
+    role: "presentation",
+    "aria-hidden": true
+  }));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+ScrollGradient = pkg.checkComponentEnabled(ScrollGradient, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+ScrollGradient.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.
+ScrollGradient.propTypes = {
+  /**
+   * Provide the contents of the ScrollGradient.
+   */
+  children: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.node), PropTypes.node]),
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: PropTypes.string,
+  /** @type {string} Fade out color. Any valid CSS color value works */
+  color: PropTypes.string,
+  /** @type {(element: HTMLElement) => {}} Optional function to get reference to scrollable DOM element */
+  getScrollElementRef: PropTypes.func,
+  /** @type {boolean} Set to true if you want to hide gradient on the start side (top or left) of scrollable element. */
+  hideStartGradient: PropTypes.bool,
+  /** @type {Function} Optional scroll handler */
+  onScroll: PropTypes.func,
+  /** @type {string} Optional classname for scroll element. */
+  scrollElementClassName: PropTypes.string
+};
+
+export { ScrollGradient };

package/es/components/ScrollGradient/constants.d.ts

@@ -0,0 +1,15 @@
+export namespace ScrollDirection {
+    let X: string;
+    let Y: string;
+}
+export namespace ScrollStates {
+    let NONE: string;
+    let INITIAL: string;
+    let STARTED: string;
+    let END: string;
+}
+export function getScrollState(element: any, scrollDirection: any): string;
+export function useIsOverflow(ref: any): {
+    xScrollable: undefined;
+    yScrollable: undefined;
+};

package/es/components/ScrollGradient/constants.js

@@ -0,0 +1,121 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * 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 { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { useState, useCallback, useEffect, useLayoutEffect } from 'react';
+
+var ScrollDirection = {
+  X: 'X',
+  Y: 'Y'
+};
+var ScrollStates = {
+  // No scrolling required because content fits within container.
+  NONE: 'NONE',
+  // Scroll position is a the start of the scrollable content.
+  INITIAL: 'INITIAL',
+  // Scroll position is neither at start or end of scrollable content.
+  STARTED: 'STARTED',
+  // Scroll position is a the end of the scrollable content.
+  END: 'END'
+};
+
+// FUNCTIONS
+
+var getScrollState = function getScrollState(element, scrollDirection) {
+  // console.log('getScrollState - element: ', element);
+  // console.log('getScrollState - scrollDirection: ', scrollDirection);
+  // console.log('-------------------------------------------------');
+  switch (scrollDirection) {
+    case ScrollDirection.X:
+      {
+        if (element.scrollWidth === element.clientWidth) {
+          return ScrollStates.NONE;
+        }
+        if (element.scrollLeft === 0) {
+          return ScrollStates.INITIAL;
+        }
+        if (element.scrollLeft + element.clientWidth === element.scrollWidth) {
+          return ScrollStates.END;
+        }
+        return ScrollStates.STARTED;
+      }
+    case ScrollDirection.Y:
+    default:
+      {
+        if (element.scrollHeight === element.clientHeight) {
+          return ScrollStates.NONE;
+        }
+        if (element.scrollTop === 0) {
+          return ScrollStates.INITIAL;
+        }
+        if (element.scrollTop + element.clientHeight === element.scrollHeight) {
+          return ScrollStates.END;
+        }
+        return ScrollStates.STARTED;
+      }
+  }
+};
+var useIsOverflow = function useIsOverflow(ref) {
+  var _useState = useState(),
+    _useState2 = _slicedToArray(_useState, 2),
+    isHorizontallyScrollable = _useState2[0],
+    setIsHorizontallyScrollable = _useState2[1];
+  var _useState3 = useState(),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isVerticallyScrollable = _useState4[0],
+    setIsVerticallyScrollable = _useState4[1];
+  var _useState5 = useState(),
+    _useState6 = _slicedToArray(_useState5, 2),
+    mutationObserver = _useState6[0],
+    setMutationObserver = _useState6[1];
+  var _useState7 = useState(),
+    _useState8 = _slicedToArray(_useState7, 2),
+    resizeObserver = _useState8[0],
+    setResizeObserver = _useState8[1];
+  var checkOverflow = useCallback(function () {
+    if (!ref.current) {
+      return;
+    }
+    setIsHorizontallyScrollable(ref.current.scrollWidth > ref.current.clientWidth);
+    setIsVerticallyScrollable(ref.current.scrollHeight > ref.current.clientHeight);
+  }, [ref]);
+  useEffect(function () {
+    if (!mutationObserver) {
+      return;
+    }
+    return function () {
+      if (mutationObserver) {
+        mutationObserver.disconnect();
+      }
+      if (resizeObserver) {
+        resizeObserver.disconnect();
+      }
+    };
+  });
+  useLayoutEffect(function () {
+    var current = ref.current;
+    if (current) {
+      if ('ResizeObserver' in window && !resizeObserver) {
+        setResizeObserver(new ResizeObserver(checkOverflow).observe(current));
+      }
+      if ('MutationObserver' in window && !mutationObserver) {
+        setMutationObserver(new MutationObserver(checkOverflow).observe(current, {
+          attributes: false,
+          childList: true,
+          subtree: false
+        }));
+      }
+      checkOverflow();
+    }
+  }, [ref, checkOverflow, mutationObserver, resizeObserver]);
+  return {
+    xScrollable: isHorizontallyScrollable,
+    yScrollable: isVerticallyScrollable
+  };
+};
+
+export { ScrollDirection, ScrollStates, getScrollState, useIsOverflow };

package/es/components/ScrollGradient/index.d.ts

@@ -0,0 +1 @@
+export { ScrollGradient } from "./ScrollGradient";