@carbon/ibm-products 2.36.0 → 2.37.0

package/lib/components/ConditionBuilder/ConditionConnector/ConditionConnector.d.ts

@@ -0,0 +1,15 @@
+export default ConditionConnector;
+declare function ConditionConnector({ operator, className, onChange, ...rest }: {
+    [x: string]: any;
+    operator: any;
+    className: any;
+    onChange: any;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace ConditionConnector {
+    namespace propTypes {
+        let className: PropTypes.Requireable<string>;
+        let onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        let operator: PropTypes.Requireable<string>;
+    }
+}
+import PropTypes from 'prop-types';

package/lib/components/ConditionBuilder/ConditionConnector/ConditionConnector.js

@@ -0,0 +1,93 @@
+/**
+ * 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 ConditionBuilderItem = require('../ConditionBuilderItem/ConditionBuilderItem.js');
+var ConditionBuilderItemOption = require('../ConditionBuilderItem/ConditionBuilderItemOption/ConditionBuilderItemOption.js');
+var DataConfigs = require('../ConditionBuilderContext/DataConfigs.js');
+var settings = require('../../../settings.js');
+var index = require('../../../node_modules/prop-types/index.js');
+var util = require('../utils/util.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+var _excluded = ["operator", "className", "onChange"];
+var blockClass = "".concat(settings.pkg.prefix, "--condition-builder");
+function ConditionConnector(_ref) {
+  var operator = _ref.operator,
+    className = _ref.className,
+    onChange = _ref.onChange,
+    rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
+  var handleConnectorHover = React.useCallback(function (parentGroup, isHover) {
+    if (isHover) {
+      parentGroup.classList.add('hoveredConnector');
+    } else {
+      parentGroup.classList.remove('hoveredConnector');
+    }
+  }, []);
+  var activeConnectorHandler = function activeConnectorHandler(e) {
+    var parentGroup = e.currentTarget.closest('.eachGroup');
+    handleConnectorHover(parentGroup, true);
+  };
+  var inActiveConnectorHandler = function inActiveConnectorHandler(e) {
+    var parentGroup = e.currentTarget.closest('.eachGroup');
+    handleConnectorHover(parentGroup, false);
+  };
+  var onChangeHandler = function onChangeHandler(op, e) {
+    onChange(op);
+    util.focusThisField(e);
+  };
+  return (
+    /*#__PURE__*/
+    // <div className={className} {...rest}>
+    React__default["default"].createElement(ConditionBuilderItem.ConditionBuilderItem, _rollupPluginBabelHelpers["extends"]({
+      label: operator,
+      title: DataConfigs.translateWithId('connector'),
+      "data-name": "connectorField",
+      onMouseEnter: activeConnectorHandler,
+      onMouseLeave: inActiveConnectorHandler,
+      onFocus: activeConnectorHandler,
+      onBlur: inActiveConnectorHandler
+    }, rest, {
+      popOverClassName: className,
+      className: "".concat(blockClass, "__connector-button ")
+    }), /*#__PURE__*/React__default["default"].createElement(ConditionBuilderItemOption.ConditionBuilderItemOption, {
+      config: {
+        options: DataConfigs.connectorConfig
+      },
+      conditionState: {
+        value: operator,
+        label: DataConfigs.translateWithId('connector')
+      },
+      onChange: onChangeHandler
+    }))
+    // </div>
+  );
+}
+ConditionConnector.propTypes = {
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: index["default"].string,
+  /**
+   * callback to update the current condition of the state tree
+   */
+  onChange: index["default"].func,
+  /**
+   * string that defines the connector operator (and/or)
+   */
+  operator: index["default"].string
+};
+
+exports["default"] = ConditionConnector;

package/lib/components/ConditionBuilder/ConditionGroupBuilder/ConditionGroupBuilder.d.ts

@@ -0,0 +1,24 @@
+export default ConditionGroupBuilder;
+/**
+ *
+ *  state - this is the current group that is being rendered . This can be a inner group or outer group
+ * All the inner components of group are called from here.
+ * @returns
+ */
+declare function ConditionGroupBuilder({ state, aria, onRemove, onChange, conditionBuilderRef, }: {
+    state: any;
+    aria: any;
+    onRemove: any;
+    onChange: any;
+    conditionBuilderRef: any;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace ConditionGroupBuilder {
+    namespace propTypes {
+        let aria: PropTypes.Requireable<object>;
+        let conditionBuilderRef: PropTypes.Requireable<object>;
+        let onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        let onRemove: PropTypes.Requireable<(...args: any[]) => any>;
+        let state: PropTypes.Requireable<object>;
+    }
+}
+import PropTypes from 'prop-types';

package/lib/components/ConditionBuilder/ConditionGroupBuilder/ConditionGroupBuilder.js

@@ -0,0 +1,153 @@
+/**
+ * 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 ConditionBlock = require('../ConditionBlock/ConditionBlock.js');
+var index = require('../../../node_modules/prop-types/index.js');
+var DataConfigs = require('../ConditionBuilderContext/DataConfigs.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+/**
+ *
+ *  state - this is the current group that is being rendered . This can be a inner group or outer group
+ * All the inner components of group are called from here.
+ * @returns
+ */
+var ConditionGroupBuilder = function ConditionGroupBuilder(_ref) {
+  var _state$conditions;
+  var state = _ref.state,
+    aria = _ref.aria,
+    onRemove = _ref.onRemove,
+    onChange = _ref.onChange,
+    conditionBuilderRef = _ref.conditionBuilderRef;
+  var onRemoveHandler = function onRemoveHandler(conditionIndex, e) {
+    if (state.conditions.length > 1) {
+      onChange(_rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, state), {}, {
+        conditions: state.conditions.filter(function (condition, cIndex) {
+          return conditionIndex !== cIndex;
+        })
+      }));
+      handleFocusOnClose(e);
+    } else {
+      onRemove();
+    }
+  };
+  var onChangeHandler = function onChangeHandler(updatedConditions, conditionIndex) {
+    onChange(_rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, state), {}, {
+      conditions: state.conditions.map(function (condition, cIndex) {
+        return conditionIndex === cIndex ? updatedConditions : condition;
+      })
+    }));
+  };
+  var addConditionHandler = function addConditionHandler(conditionIndex) {
+    onChange(_rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, state), {}, {
+      conditions: [].concat(_rollupPluginBabelHelpers.toConsumableArray(state.conditions.slice(0, conditionIndex + 1)), [{
+        property: undefined,
+        operator: '',
+        value: '',
+        popoverToOpen: 'propertyField'
+      }], _rollupPluginBabelHelpers.toConsumableArray(state.conditions.slice(conditionIndex + 1)))
+    }));
+  };
+  var handleFocusOnClose = function handleFocusOnClose(e) {
+    var _e$currentTarget;
+    var previousClose = (_e$currentTarget = e.currentTarget) === null || _e$currentTarget === void 0 || (_e$currentTarget = _e$currentTarget.closest('[role="row"]')) === null || _e$currentTarget === void 0 || (_e$currentTarget = _e$currentTarget.previousSibling) === null || _e$currentTarget === void 0 ? void 0 : _e$currentTarget.querySelector('[data-name="closeCondition"]');
+    if (previousClose) {
+      previousClose.focus();
+    }
+  };
+  return /*#__PURE__*/React__default["default"].createElement("div", {
+    className: " ".concat(DataConfigs.blockClass, "__condition-builder__group eachGroup")
+  }, /*#__PURE__*/React__default["default"].createElement("div", {
+    className: "".concat(DataConfigs.blockClass, "__condition-wrapper"),
+    role: "grid",
+    "aria-label": DataConfigs.translateWithId('condition_builder_group')
+  }, state === null || state === void 0 || (_state$conditions = state.conditions) === null || _state$conditions === void 0 ? void 0 : _state$conditions.map(function (eachCondition, conditionIndex) {
+    return /*#__PURE__*/React__default["default"].createElement("div", {
+      key: conditionIndex
+    }, eachCondition.conditions && /*#__PURE__*/React__default["default"].createElement(ConditionGroupBuilder, {
+      aria: {
+        level: aria.level + 1,
+        posinset: conditionIndex + 1,
+        setsize: state.conditions.length
+      },
+      state: eachCondition,
+      onChange: function onChange(updatedConditions) {
+        onChangeHandler(updatedConditions, conditionIndex);
+      },
+      onRemove: function onRemove(e) {
+        onRemoveHandler(conditionIndex, e);
+      },
+      conditionBuilderRef: conditionBuilderRef,
+      key: conditionIndex
+    }), !eachCondition.conditions && /*#__PURE__*/React__default["default"].createElement(ConditionBlock["default"], {
+      key: conditionIndex,
+      conjunction: conditionIndex > 0 ? state.groupOperator : undefined,
+      aria: {
+        level: aria.level + 1,
+        posinset: conditionIndex + 1,
+        setsize: state.conditions.length
+      },
+      isStatement: conditionIndex == 0,
+      state: eachCondition,
+      group: state,
+      conditionIndex: conditionIndex,
+      className: "".concat(DataConfigs.blockClass, "__gap ").concat(DataConfigs.blockClass, "__gap-bottom"),
+      onChange: function onChange(updatedConditions) {
+        onChangeHandler(updatedConditions, conditionIndex);
+      },
+      addConditionHandler: addConditionHandler,
+      onRemove: function onRemove(e) {
+        onRemoveHandler(conditionIndex, e);
+      },
+      onConnectorOperatorChange: function onConnectorOperatorChange(op) {
+        onChange(_rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, state), {}, {
+          groupOperator: op
+        }));
+      },
+      onStatementChange: function onStatementChange(updatedStatement) {
+        onChange(_rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, state), {}, {
+          statement: updatedStatement
+        }));
+      }
+    }));
+  })));
+};
+var ConditionGroupBuilder$1 = ConditionGroupBuilder;
+ConditionGroupBuilder.propTypes = {
+  /**
+   * object contains the aria attributes
+   */
+  aria: index["default"].object,
+  /**
+   * ref of condition builder
+   */
+  conditionBuilderRef: index["default"].object,
+  /**
+  
+   * callback to update the current condition of the state tree
+   */
+  onChange: index["default"].func,
+  /**
+   * call back to remove the particular group from the state tree
+   */
+  onRemove: index["default"].func,
+  /**
+   * state defines the current group
+   */
+  state: index["default"].object
+};
+
+exports["default"] = ConditionGroupBuilder$1;

package/lib/components/ConditionBuilder/utils/util.d.ts

@@ -0,0 +1,4 @@
+export function focusThisField(e: any): void;
+export function focusThisItem(currentElement: any): void;
+export function traverseClockVise(eachElem: any, index: any, allElements: any, rotate: any, trapFocus: any): void;
+export function traverseReverse(eachElem: any, index: any, allElements: any, rotate: any, trapFocus: any): void;

package/lib/components/ConditionBuilder/utils/util.js

@@ -0,0 +1,20 @@
+/**
+ * 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 focusThisField = function focusThisField(e) {
+  setTimeout(function () {
+    var _e$target$closest, _e$target$closest2;
+    (_e$target$closest = e.target.closest('[role="gridcell"]')) === null || _e$target$closest === void 0 || (_e$target$closest = _e$target$closest.querySelector('button')) === null || _e$target$closest === void 0 || _e$target$closest.click();
+    (_e$target$closest2 = e.target.closest('[role="gridcell"]')) === null || _e$target$closest2 === void 0 || (_e$target$closest2 = _e$target$closest2.querySelector('button')) === null || _e$target$closest2 === void 0 || _e$target$closest2.focus();
+  }, 0);
+};
+
+exports.focusThisField = focusThisField;

package/lib/components/CreateTearsheet/CreateTearsheet.d.ts

@@ -1,4 +1,106 @@
-export const StepsContext: React.Context<null>;
-export const StepNumberContext: React.Context<number>;
-export let CreateTearsheet: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+/**
+ * Copyright IBM Corp. 2021, 2022
+ *
+ * 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 React, { ReactNode, PropsWithChildren, Dispatch, SetStateAction } from 'react';
+export interface StepsContextType {
+    currentStep: number;
+    setIsDisabled: Dispatch<SetStateAction<boolean>>;
+    setOnPrevious: (fn: any) => void;
+    setOnNext: (fn: any) => void;
+    setOnMount: (fn: any) => void;
+    setStepData: Dispatch<SetStateAction<Step[]>>;
+    stepData: Step[];
+}
+export declare const StepsContext: React.Context<StepsContextType | null>;
+export declare const StepNumberContext: React.Context<number>;
+interface CreateTearsheetProps extends PropsWithChildren {
+    /**
+     * The back button text
+     */
+    backButtonText: string;
+    /**
+     * The cancel button text
+     */
+    cancelButtonText: string;
+    /**
+     * The main content of the tearsheet
+     */
+    /**
+     * An optional class or classes to be added to the outermost element.
+     */
+    className?: string;
+    /**
+     * A description of the flow, displayed in the header area of the tearsheet.
+     */
+    description?: ReactNode;
+    /**
+     * Specifies elements to focus on first on render.
+     */
+    firstFocusElement?: string;
+    /**
+     * Used to set the size of the influencer
+     */
+    influencerWidth?: 'narrow' | 'wide';
+    /**
+     * This can be used to open the component to a step other than the first step.
+     * For example, a create flow was previously in progress, data was saved, and
+     * is now being completed.
+     */
+    initialStep?: number;
+    /**
+     * A label for the tearsheet, displayed in the header area of the tearsheet
+     * to maintain context for the tearsheet (e.g. as the title changes from page
+     * to page of a multi-page task).
+     */
+    label?: ReactNode;
+    /**
+     * The next button text
+     */
+    nextButtonText: string;
+    /**
+     * An optional handler that is called when the user closes the tearsheet (by
+     * clicking the close button, if enabled, or clicking outside, if enabled).
+     * Returning `false` here prevents the modal from closing.
+     */
+    onClose?: () => void;
+    /**
+     * Specify a handler for submitting the multi step tearsheet (final step).
+     * This function can _optionally_ return a promise that is either resolved or rejected and the CreateTearsheet will handle the submitting state of the create button.
+     */
+    onRequestSubmit: () => void;
+    /**
+     * Specifies whether the tearsheet is currently open.
+     */
+    open?: boolean;
+    /**
+     *  **Experimental:** Provide a `Slug` component to be rendered inside the `Tearsheet` component
+     */
+    slug?: ReactNode;
+    /**
+     * The submit button text
+     */
+    submitButtonText: string;
+    /**
+     * The main title of the tearsheet, displayed in the header area.
+     */
+    title?: ReactNode;
+    /**
+     * The position of the top of tearsheet in the viewport. The 'normal'
+     * position (the default) is a short distance down from the top of the
+     * viewport, leaving room at the top for a global header bar to show through
+     * from below. The 'lower' position provides a little extra room at the top
+     * to allow an action bar navigation or breadcrumbs to also show through.
+     */
+    verticalPosition?: 'normal' | 'lower';
+}
+interface Step {
+    introStep?: boolean;
+    secondaryLabel?: string;
+    shouldIncludeStep?: boolean;
+    title?: string;
+}
+export declare let CreateTearsheet: React.ForwardRefExoticComponent<CreateTearsheetProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/lib/components/CreateTearsheet/CreateTearsheet.js

@@ -14,7 +14,6 @@ var React = require('react');
 var index = require('../../node_modules/prop-types/index.js');
 var cx = require('classnames');
 var react = require('@carbon/react');
-var wrapFocus = require('../../global/js/utils/wrapFocus.js');
 var TearsheetShell = require('../Tearsheet/TearsheetShell.js');
 var settings = require('../../settings.js');
 var devtools = require('../../global/js/utils/devtools.js');
@@ -39,17 +38,12 @@ var blockClass = "".concat(settings.pkg.prefix, "--tearsheet-create");
 // This is a general context for the steps container
 // containing information about the state of the container
 // and providing some callback methods for steps to use
+
 var StepsContext = /*#__PURE__*/React.createContext(null);
 
 // This is a context supplied separately to each step in the container
 // to let it know what number it is in the sequence of steps
 var StepNumberContext = /*#__PURE__*/React.createContext(-1);
-
-// Default values for props
-var defaults = {
-  verticalPosition: 'normal',
-  influencerWidth: 'narrow'
-};
 exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var backButtonText = _ref.backButtonText,
     cancelButtonText = _ref.cancelButtonText,
@@ -57,7 +51,7 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     className = _ref.className,
     description = _ref.description,
     _ref$influencerWidth = _ref.influencerWidth,
-    influencerWidth = _ref$influencerWidth === void 0 ? defaults.influencerWidth : _ref$influencerWidth,
+    influencerWidth = _ref$influencerWidth === void 0 ? 'narrow' : _ref$influencerWidth,
     initialStep = _ref.initialStep,
     label = _ref.label,
     nextButtonText = _ref.nextButtonText,
@@ -69,7 +63,7 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     submitButtonText = _ref.submitButtonText,
     title = _ref.title,
     _ref$verticalPosition = _ref.verticalPosition,
-    verticalPosition = _ref$verticalPosition === void 0 ? defaults.verticalPosition : _ref$verticalPosition,
+    verticalPosition = _ref$verticalPosition === void 0 ? 'normal' : _ref$verticalPosition,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
   var _useState = React.useState([]),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
@@ -115,7 +109,7 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState22 = _rollupPluginBabelHelpers.slicedToArray(_useState21, 2),
     firstIncludedStep = _useState22[0],
     setFirstIncludedStep = _useState22[1];
-  var _useState23 = React.useState(null),
+  var _useState23 = React.useState(),
     _useState24 = _rollupPluginBabelHelpers.slicedToArray(_useState23, 2),
     lastIncludedStep = _useState24[0],
     setLastIncludedStep = _useState24[1];
@@ -123,7 +117,7 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     currentStep: currentStep,
     open: open
   });
-  var contentRef = React.useRef();
+  var contentRef = React.useRef(null);
   React.useEffect(function () {
     var firstItem = stepData.findIndex(function (item) {
       return item === null || item === void 0 ? void 0 : item.shouldIncludeStep;
@@ -153,9 +147,11 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   useResetCreateComponent.useResetCreateComponent({
     firstIncludedStep: firstIncludedStep,
     previousState: previousState,
+    /**@ts-ignore */
     open: open,
     setCurrentStep: setCurrentStep,
     stepData: stepData,
+    /**@ts-ignore */
     initialStep: initialStep,
     totalSteps: stepData === null || stepData === void 0 ? void 0 : stepData.length,
     componentName: componentName
@@ -170,6 +166,7 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setCurrentStep: setCurrentStep,
     setIsSubmitting: setIsSubmitting,
     setShouldViewAll: setShouldViewAll,
+    /**@ts-ignore */
     setLoadingPrevious: setLoadingPrevious,
     loadingPrevious: loadingPrevious,
     onClose: onClose,
@@ -185,43 +182,26 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     componentBlockClass: blockClass,
     setCreateComponentActions: setCreateTearsheetActions
   });
-
-  // adds focus trap functionality
-  /* istanbul ignore next */
-  var handleBlur = function handleBlur(_ref2) {
-    var oldActiveNode = _ref2.target,
-      currentActiveNode = _ref2.relatedTarget;
-    var visibleStepInnerContent = document.querySelector(".".concat(settings.pkg.prefix, "--tearsheet__body"));
-    if (open && visibleStepInnerContent) {
-      wrapFocus["default"]({
-        bodyNode: visibleStepInnerContent,
-        currentActiveNode: currentActiveNode,
-        oldActiveNode: oldActiveNode
-      });
-    }
-  };
-  return /*#__PURE__*/React__default["default"].createElement(TearsheetShell.TearsheetShell, _rollupPluginBabelHelpers["extends"]({}, rest, devtools.getDevtoolsProps(componentName), {
+  return /*#__PURE__*/React__default["default"].createElement(TearsheetShell.TearsheetShell, _rollupPluginBabelHelpers["extends"]({}, devtools.getDevtoolsProps(componentName), rest, {
+    ref: ref,
     actions: createTearsheetActions,
     className: cx__default["default"](blockClass, className),
     description: description,
-    hasCloseIcon: false,
     influencer: /*#__PURE__*/React__default["default"].createElement(CreateInfluencer.CreateInfluencer, {
       currentStep: currentStep,
       stepData: stepData
     }),
-    influencerPosition: "left",
     influencerWidth: influencerWidth,
     label: label,
     onClose: onClose,
     open: open,
-    size: "wide",
+    size: 'wide',
     slug: slug,
     title: title,
     verticalPosition: verticalPosition,
-    ref: ref
+    closeIconDescription: ''
   }), /*#__PURE__*/React__default["default"].createElement("div", {
     className: "".concat(blockClass, "__content"),
-    onBlur: handleBlur,
     ref: contentRef
   }, /*#__PURE__*/React__default["default"].createElement(react.Form, {
     "aria-label": title

package/lib/components/Datagrid/useParentDimensions.js

@@ -48,7 +48,7 @@ var useParentDimensions = function useParentDimensions(hooks) {
       setTableHeight(newHeight);
     };
     Object.assign(instance, {
-      tableHeight: tableHeight,
+      tableHeight: tableHeight || instance.tableHeight,
       rootRef: rootRef,
       headRef: headRef,
       innerListRef: innerListRef,

package/lib/components/EditUpdateCards/EditUpdateCards.d.ts

@@ -1,7 +1,109 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * 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 React, { ReactNode } from 'react';
+import { CarbonIconType } from '@carbon/icons-react/lib/CarbonIcon';
+type ActionIcon = {
+    id: string;
+    icon: CarbonIconType;
+    onKeyDown?(): void;
+    onClick?(): void;
+    iconDescription: string;
+    href?: string;
+};
+interface EditUpdateCardsProps {
+    /**
+     * Icons that are displayed on card. Refer to design documentation for implementation guidelines
+     */
+    actionIcons?: Array<ActionIcon>;
+    /**
+     * Determines if the action icons are on the top or bottom of the card
+     */
+    actionsPlacement?: 'top' | 'bottom';
+    /**
+     * Optional label for the top of the card.
+     */
+    className?: string;
+    /**
+     * Optional header description
+     */
+    description?: string;
+    /**
+     * Edit mode children
+     */
+    editChildren?: ReactNode;
+    /**
+     * Edit mode
+     */
+    editMode?: boolean;
+    /**
+     * Optional label for the top of the card
+     */
+    label?: string;
+    /**
+     * Function that's called from the primary button or action icon
+     */
+    onPrimaryButtonClick?(): void;
+    /**
+     * Function that's called from the secondary button or action icon
+     */
+    onSecondaryButtonClick?(): void;
+    /**
+     * Preview mode children
+     */
+    previewChildren?: ReactNode;
+    /**
+     * Optional prop to allow overriding the icon rendering. Can be a React component class
+     */
+    primaryButtonIcon?: CarbonIconType;
+    /**
+     * Establishes the kind of button displayed for the primary button
+     */
+    primaryButtonKind?: 'primary' | 'ghost';
+    /**
+     * Determines if the primary button is on the top or bottom of the card
+     */
+    primaryButtonPlacement?: 'top' | 'bottom';
+    /**
+     * The text that's displayed in the primary button
+     */
+    primaryButtonText?: string;
+    /**
+     * Optionally specify an href for your Button to become an <a> element
+     */
+    secondaryButtonHref?: string;
+    /**
+     * Optional prop to allow overriding the icon rendering. Can be a React component class
+     */
+    secondaryButtonIcon?: CarbonIconType;
+    /**
+     * Establishes the kind of button displayed for the secondary button
+     */
+    secondaryButtonKind?: 'secondary' | 'ghost';
+    /**
+     * Determines if the secondary button is on the top or bottom of the card
+     */
+    secondaryButtonPlacement?: 'top' | 'bottom';
+    /**
+     * The text that's displayed in the secondary button
+     */
+    secondaryButtonText?: string;
+    /**
+     * Title that's displayed at the top of the card
+     */
+    title?: string;
+    /**
+     * Determines title size
+     */
+    titleSize?: 'default' | 'large';
+}
 /**
  Editable cards allow a user to view, modify, and save the content contained within the card.
  These cards are generally used in instances where a user needs to make changes to a resource instances
  (ex. configuration details), account plan, etc. Editable cards allow a user to edit something within context.
  */
-export let EditUpdateCards: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let EditUpdateCards: React.ForwardRefExoticComponent<EditUpdateCardsProps & React.RefAttributes<HTMLDivElement>>;
+export {};