@carbon/ibm-products 2.32.0 → 2.34.0

package/lib/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/lib/components/OptionsTile/OptionsTile.js

@@ -47,22 +47,12 @@ var carbonMotion__namespace = /*#__PURE__*/_interopNamespace(carbonMotion);
 
 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(settings.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.
- */
 exports.OptionsTile = /*#__PURE__*/React__default["default"].forwardRef(function (_ref, ref) {
   var children = _ref.children,
     className = _ref.className,
@@ -71,8 +61,7 @@ exports.OptionsTile = /*#__PURE__*/React__default["default"].forwardRef(function
     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,
@@ -92,11 +81,12 @@ exports.OptionsTile = /*#__PURE__*/React__default["default"].forwardRef(function
     closing = _useState4[0],
     setClosing = _useState4[1];
   var _useControllableState = 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 = _rollupPluginBabelHelpers.slicedToArray(_useControllableState, 2),
     isOpen = _useControllableState2[0],
@@ -228,10 +218,7 @@ exports.OptionsTile = /*#__PURE__*/React__default["default"].forwardRef(function
     }, text)));
   }
   return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
-    className: cx__default["default"](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), _rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "--closing"), closing)),
+    className: cx__default["default"](blockClass, className, "".concat(blockClass, "--").concat(size), _rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "--closing"), closing)),
     ref: ref
   }, devtools.getDevtoolsProps(componentName)), enabled !== undefined && /*#__PURE__*/React__default["default"].createElement("div", {
     className: "".concat(blockClass, "__toggle-container")
@@ -322,6 +309,7 @@ exports.OptionsTile.propTypes = {
    * Provide a function which will be called each time the user
    * interacts with the toggle.
    */
+  /**@ts-ignore*/
   onToggle: index["default"].func,
   /**
    * Whether the OptionsTile is in open state.
@@ -330,6 +318,7 @@ exports.OptionsTile.propTypes = {
   /**
    * Define the size of the OptionsTile.
    */
+  /**@ts-ignore*/
   size: index["default"].oneOf(['lg', 'xl']),
   /**
    * Optionally provide a text summarizing the current state of the content.

package/lib/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/lib/components/RemoveModal/RemoveModal.js

@@ -33,6 +33,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.
  */
+
 exports.RemoveModal = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var body = _ref.body,
     className = _ref.className,

package/lib/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/lib/components/ScrollGradient/ScrollGradient.js

@@ -0,0 +1,163 @@
+/**
+ * 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var index = require('../../node_modules/prop-types/index.js');
+var cx = require('classnames');
+var devtools = require('../../global/js/utils/devtools.js');
+var settings = require('../../settings.js');
+var lodash = require('lodash');
+var constants = require('./constants.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+var _excluded = ["children", "className", "color", "onScroll", "scrollElementClassName", "getScrollElementRef", "hideStartGradient"];
+var blockClass = "".concat(settings.pkg.prefix, "--scroll-gradient");
+var componentName = 'ScrollGradient';
+
+// Default values for props
+var defaults = {
+  color: "var(--".concat(settings.carbon.prefix, "-layer-01)"),
+  hideStartGradient: false,
+  onScroll: function onScroll() {},
+  getScrollElementRef: function getScrollElementRef() {}
+};
+
+/**
+ * TODO: A description of the component.
+ */
+exports.ScrollGradient = /*#__PURE__*/React__default["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 = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
+  var _useState = React.useState(constants.ScrollStates.NONE),
+    _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
+    verticalPosition = _useState2[0],
+    setVerticalPosition = _useState2[1];
+  var _useState3 = React.useState(constants.ScrollStates.NONE),
+    _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
+    horizontalPosition = _useState4[0],
+    setHorizontalPosition = _useState4[1];
+  var scrollContainer = React.useRef();
+  var contentChildrenContainer = React.useRef();
+  var updateScrollState = lodash.throttle(function () {
+    var updatedVerticalVal = constants.getScrollState(scrollContainer.current, constants.ScrollDirection.Y);
+    var updatedHorizontalVal = constants.getScrollState(scrollContainer.current, constants.ScrollDirection.X);
+    setVerticalPosition(updatedVerticalVal);
+    setHorizontalPosition(updatedHorizontalVal);
+  }, 150);
+  var scrollHandler = React.useCallback(function (event) {
+    onScroll(event);
+    updateScrollState();
+  }, [onScroll, updateScrollState]);
+  var setRefs = function setRefs(element) {
+    scrollContainer.current = element;
+    getScrollElementRef(element);
+  };
+  React.useEffect(function () {
+    scrollHandler();
+  }, [scrollHandler]);
+  var _useIsOverflow = constants.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["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
+    className: cx__default["default"](blockClass, "".concat(blockClass, "--x-").concat(horizontalPosition.toLowerCase()), "".concat(blockClass, "--y-").concat(verticalPosition.toLowerCase()), _rollupPluginBabelHelpers.defineProperty(_rollupPluginBabelHelpers.defineProperty({}, "".concat(blockClass, "--x-scrollable"), xScrollable), "".concat(blockClass, "--y-scrollable"), yScrollable), className),
+    ref: ref,
+    role: "presentation"
+  }, devtools.getDevtoolsProps(componentName)), /*#__PURE__*/React__default["default"].createElement("div", {
+    onScroll: scrollHandler,
+    ref: setRefs,
+    className: cx__default["default"]("".concat(blockClass, "__content"), scrollElementClassName)
+  }, /*#__PURE__*/React__default["default"].createElement("div", {
+    ref: contentChildrenContainer,
+    className: "".concat(blockClass, "__content-children")
+  }, children)), !hideStartGradient && /*#__PURE__*/React__default["default"].createElement(React__default["default"].Fragment, null, /*#__PURE__*/React__default["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["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["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["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
+exports.ScrollGradient = settings.pkg.checkComponentEnabled(exports.ScrollGradient, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+exports.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.
+exports.ScrollGradient.propTypes = {
+  /**
+   * Provide the contents of the ScrollGradient.
+   */
+  children: index["default"].oneOfType([index["default"].arrayOf(index["default"].node), index["default"].node]),
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: index["default"].string,
+  /** @type {string} Fade out color. Any valid CSS color value works */
+  color: index["default"].string,
+  /** @type {(element: HTMLElement) => {}} Optional function to get reference to scrollable DOM element */
+  getScrollElementRef: index["default"].func,
+  /** @type {boolean} Set to true if you want to hide gradient on the start side (top or left) of scrollable element. */
+  hideStartGradient: index["default"].bool,
+  /** @type {Function} Optional scroll handler */
+  onScroll: index["default"].func,
+  /** @type {string} Optional classname for scroll element. */
+  scrollElementClassName: index["default"].string
+};

package/lib/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/lib/components/ScrollGradient/constants.js

@@ -0,0 +1,128 @@
+/**
+ * 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('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 = React.useState(),
+    _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
+    isHorizontallyScrollable = _useState2[0],
+    setIsHorizontallyScrollable = _useState2[1];
+  var _useState3 = React.useState(),
+    _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
+    isVerticallyScrollable = _useState4[0],
+    setIsVerticallyScrollable = _useState4[1];
+  var _useState5 = React.useState(),
+    _useState6 = _rollupPluginBabelHelpers.slicedToArray(_useState5, 2),
+    mutationObserver = _useState6[0],
+    setMutationObserver = _useState6[1];
+  var _useState7 = React.useState(),
+    _useState8 = _rollupPluginBabelHelpers.slicedToArray(_useState7, 2),
+    resizeObserver = _useState8[0],
+    setResizeObserver = _useState8[1];
+  var checkOverflow = React.useCallback(function () {
+    if (!ref.current) {
+      return;
+    }
+    setIsHorizontallyScrollable(ref.current.scrollWidth > ref.current.clientWidth);
+    setIsVerticallyScrollable(ref.current.scrollHeight > ref.current.clientHeight);
+  }, [ref]);
+  React.useEffect(function () {
+    if (!mutationObserver) {
+      return;
+    }
+    return function () {
+      if (mutationObserver) {
+        mutationObserver.disconnect();
+      }
+      if (resizeObserver) {
+        resizeObserver.disconnect();
+      }
+    };
+  });
+  React.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
+  };
+};
+
+exports.ScrollDirection = ScrollDirection;
+exports.ScrollStates = ScrollStates;
+exports.getScrollState = getScrollState;
+exports.useIsOverflow = useIsOverflow;

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

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