carbon-react 106.7.0 → 107.0.0

package/lib/components/multi-step-wizard/multi-step-wizard.js

@@ -1,397 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
-var _step = _interopRequireDefault(require("./step"));
-
-var _multiStepWizard = require("./multi-step-wizard.style");
-
-var _logger = _interopRequireDefault(require("../../__internal__/utils/logger"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
-
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
-
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
-
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-
-function _possibleConstructorReturn(self, call) { if (call && (typeof call === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
-
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
-
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
-
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
-
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-
-/**
- * A MultiStepWizard widget.
- *
- * == How to use a MultiStepWizard in a component:
- *
- * In your file:
- *
- *   import MultiStepWizard from 'carbon-react/lib/components/multi-step-wizard';
- *
- * To render the Wizard:
- *
- *  <MultiStepWizard steps={ [<Step1 />, <Step2 />, ...] } />
- *
- * The component rendering the wizard must pass down a prop of 'steps' where you need to provide an array of custom
- * step components. Note that Step components must be objects and you can pass props to Step components, e.g.
- * <MultiStepWizard steps={ [<Textbox onChange={ this.updateTextboxValue } />, <div className='some-style' />] } />
- *
- * You also need to provide a 'onSubmit' handler to handle a submit event.
- *
- * The wizard also takes a 'currentStep' prop with an integer to specify a step you want to start with.
- * e.g. currentStep={ 2 }. The wizard starts with the first step by default.
- *
- * The wizard disables inactive steps by default. If you wish to enable inactive steps, pass a 'enableInactiveSteps'
- * prop and set it to true.
- *
- * The wizard generates Next and Back buttons by default. If you wish to use custom buttons to replace the default ones
- * in a step component, you can pass a 'defaultButton' prop in the corresponding step component and set it to false.
- * Also, if you want to add additional buttons beside the default Next and Back buttons, you can pass a 'extraButtons'
- * prop in the corresponding step component with your extra buttons.
- * Individual Steps can be optionally disabled by a passing a prop of `enabled={ false }`.
- * e.g. <MultiStepWizard steps={ [<Step1 defaultButton={ false } />, <Step2 />] } />
- *      <MultiStepWizard steps={ [<Step1 />, <Step2 extraButtons={ [<Button>Cancel</Button>] }) />] } />
- *      <MultiStepWizard steps={ [<Step1 />, <Step2 enabled={ false } />] } />
- *
- * The wizard provides the ability to hook into the handle next/back/submit methods.
- * (1) By passing a 'beforeSubmitValidation' prop in the wizard, you can add custom logic before a submit event, and
- *     the submit event can be completed only when the 'beforeSubmitValidation' prop returns 'true'.
- * (2) By passing 'onNext' prop in the corresponding step component,
- *     you can add custom logic when moving a step forward, and
- *     the 'onNext' prop overrides the step's default behaviour of moving next.
- * (3) By passing 'onBack' prop in the corresponding step component,
- *     you can add custom logic when moving a step backward, and
- *     the 'onBack' prop overrides the step's default behaviour of moving back.
- * e.g. <MultiStepWizard steps={ [
- *        <Step1 onNext={ this.customMethodOnNext }/>,
- *        <Step2 onBack={ this.customMethodOnBack }) />
- *      ] } />
- *      <MultiStepWizard beforeSubmitValidation={ this.customValidation } onSubmit={ this.customMethodOnSubmit } />
- *
- * If you want to complete the wizard without going through steps, you can pass a 'completed' prop and set it to true.
- *
- * @class MultiStepWizard
- * @constructor
- */
-let deprecatedWarnTriggered = false;
-
-let MultiStepWizard = /*#__PURE__*/function (_React$Component) {
-  _inherits(MultiStepWizard, _React$Component);
-
-  var _super = _createSuper(MultiStepWizard);
-
-  function MultiStepWizard(props) {
-    var _this;
-
-    _classCallCheck(this, MultiStepWizard);
-
-    _this = _super.call(this, props);
-
-    _defineProperty(_assertThisInitialized(_this), "validateStepProps", stepProps => {
-      const step = stepProps.currentStep;
-      const {
-        completed
-      } = stepProps;
-      const totalSteps = stepProps.steps.length;
-
-      if (completed === true) {
-        return {
-          currentStep: totalSteps,
-          completed: true
-        };
-      }
-
-      if (parseInt(step, 10) !== step || step < 1 || step > totalSteps) {
-        return {
-          currentStep: 1,
-          completed: false
-        };
-      }
-
-      return {
-        currentStep: step,
-        completed: false
-      };
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "next", () => {
-      if (_this.state.currentStep < _this.totalSteps) {
-        _this.setState(prevState => ({
-          currentStep: prevState.currentStep + 1
-        }));
-      }
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "back", () => {
-      if (_this.state.currentStep > 1) {
-        _this.setState(prevState => ({
-          completed: false,
-          currentStep: prevState.currentStep - 1
-        }));
-      }
-    });
-
-    _defineProperty(_assertThisInitialized(_this), "complete", () => {
-      if (_this.state.currentStep === _this.totalSteps) {
-        _this.setState({
-          completed: true
-        });
-      }
-    });
-
-    if (!deprecatedWarnTriggered) {
-      deprecatedWarnTriggered = true; // eslint-disable-next-line max-len
-
-      _logger.default.deprecate("`Multi Step Wizard` component is deprecated and will soon be removed. Please use Step Sequence instead.");
-    }
-
-    return _this;
-  }
-  /**
-   * Returns wizard object to child components.
-   *
-   * @method getChildContext
-   * @return {void}
-   */
-
-
-  _createClass(MultiStepWizard, [{
-    key: "getChildContext",
-    value: function getChildContext() {
-      return {
-        wizard: {
-          nextHandler: this.props.onNext,
-          backHandler: this.props.onBack,
-          beforeSubmitValidation: this.props.beforeSubmitValidation,
-          submitHandler: this.props.onSubmit,
-          enableInactiveSteps: this.props.enableInactiveSteps,
-          currentStep: this.state.currentStep,
-          completed: this.state.completed,
-          next: this.next,
-          back: this.back,
-          complete: this.complete,
-          totalSteps: this.totalSteps
-        }
-      };
-    }
-    /**
-     * A lifecycle method that is called before initial render.
-     * Can set up state of component without causing a re-render.
-     *
-     * @method componentWillMount
-     */
-
-  }, {
-    key: "UNSAFE_componentWillMount",
-    value: function UNSAFE_componentWillMount() {
-      const validProps = this.validateStepProps(this.props);
-      this.setState({
-        currentStep: validProps.currentStep,
-        completed: validProps.completed
-      });
-    }
-    /**
-     * A lifecycle method to update the currentStep state when a new valid value has been specified.
-     *
-     * @method componentWillReceiveProps
-     * @param {Object} props The new props passed down to the component
-     * @return {void}
-     */
-
-  }, {
-    key: "UNSAFE_componentWillReceiveProps",
-    value: function UNSAFE_componentWillReceiveProps(nextProps) {
-      const validProps = this.validateStepProps(nextProps);
-      this.setState({
-        currentStep: validProps.currentStep,
-        completed: validProps.completed
-      });
-    }
-    /**
-     * Validate step props
-     *
-     * @method validateStepProps
-     * @return {Object}
-     */
-
-  }, {
-    key: "totalSteps",
-    get:
-    /**
-     * Get total number of steps
-     *
-     * @method totalSteps
-     * @return {Number}
-     */
-    function () {
-      return this.props.steps.length;
-    }
-    /**
-     * Moves to the next step.
-     *
-     * @method next
-     * @return {void}
-     */
-
-  }, {
-    key: "wizardStepsHTML",
-    get:
-    /**
-     * Returns the computed HTML for the wizard's steps.
-     *
-     * @method wizardStepsHTML
-     * @return {Object} JSX
-     */
-    function () {
-      return this.props.steps.map((step, index) => {
-        return (
-          /*#__PURE__*/
-          // Step is never going to be re-ordered or changed so index is safe to use
-
-          /* eslint-disable react/no-array-index-key */
-          _react.default.createElement(_step.default, _extends({
-            stepNumber: index + 1,
-            key: `multi-step-wizard-step-${index}`
-          }, step.props), step)
-          /* eslint-enable react/no-array-index-key */
-
-        );
-      });
-    }
-    /**
-     * Renders the component.
-     *
-     * @method render
-     * @return {Object} JSX
-     */
-
-  }, {
-    key: "render",
-    value: function render() {
-      return /*#__PURE__*/_react.default.createElement(_multiStepWizard.StyledMultiStepWizard, {
-        className: this.props.className
-      }, /*#__PURE__*/_react.default.createElement(_multiStepWizard.StyledMultiStepWizardContent, null, this.wizardStepsHTML));
-    }
-  }]);
-
-  return MultiStepWizard;
-}(_react.default.Component);
-
-MultiStepWizard.propTypes = {
-  /**
-   * Individual steps
-   *
-   * @property steps
-   * @type {Array}
-   */
-  steps: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
-
-  /**
-   * Custom function that is called immediately before a submit event
-   *
-   * @property beforeSubmitValidation
-   * @type {Function}
-   */
-  beforeSubmitValidation: _propTypes.default.func,
-
-  /**
-   * Custom className
-   *
-   * @property className
-   * @type {String}
-   */
-  className: _propTypes.default.string,
-
-  /**
-   * A custom submit event handler
-   *
-   * @property onSubmit
-   * @type {Function}
-   */
-  onSubmit: _propTypes.default.func.isRequired,
-
-  /**
-   * Current step
-   *
-   * @property currentStep
-   * @type {Number}
-   * @default 1
-   */
-  currentStep: _propTypes.default.number,
-  // eslint-disable-line react/no-unused-prop-types
-
-  /**
-   * Determines if the wizard disables inactive steps
-   *
-   * @property enableInactiveSteps
-   * @type {Boolean}
-   * @default false
-   */
-  enableInactiveSteps: _propTypes.default.bool,
-
-  /**
-   * Add custom logic to next button
-   *
-   * @property onNext
-   */
-  onNext: _propTypes.default.func,
-
-  /**
-   * Add custom logic to previous button
-   *
-   * @property onPrevious
-   */
-  onBack: _propTypes.default.func,
-
-  /**
-   * The completion state of the wizard
-   *
-   * @property enableInactiveSteps
-   * @type {Boolean}
-   * @default false
-   */
-  completed: _propTypes.default.bool // eslint-disable-line react/no-unused-prop-types
-
-};
-MultiStepWizard.defaultProps = {
-  beforeSubmitValidation: null,
-  className: "",
-  completed: false,
-  currentStep: 1,
-  enableInactiveSteps: false,
-  onNext: null,
-  onBack: null
-};
-MultiStepWizard.childContextTypes = {
-  /**
-   * Defines a context object for child components of this wizard.
-   *
-   * @property wizard
-   * @type {Object}
-   */
-  wizard: _propTypes.default.object
-};
-var _default = MultiStepWizard;
-exports.default = _default;

package/lib/components/multi-step-wizard/multi-step-wizard.style.d.ts

@@ -1,2 +0,0 @@
-export const StyledMultiStepWizard: import("styled-components").StyledComponent<"div", any, {}, never>;
-export const StyledMultiStepWizardContent: import("styled-components").StyledComponent<"div", any, {}, never>;

package/lib/components/multi-step-wizard/multi-step-wizard.style.js

@@ -1,21 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.StyledMultiStepWizardContent = exports.StyledMultiStepWizard = void 0;
-
-var _styledComponents = _interopRequireDefault(require("styled-components"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const StyledMultiStepWizard = _styledComponents.default.div`
-  width: 100%;
-`;
-exports.StyledMultiStepWizard = StyledMultiStepWizard;
-const StyledMultiStepWizardContent = _styledComponents.default.div`
-  width: 90%;
-  padding-left: 5%;
-  padding-top: 10px;
-`;
-exports.StyledMultiStepWizardContent = StyledMultiStepWizardContent;

package/lib/components/multi-step-wizard/package.json

@@ -1,4 +0,0 @@
-{
-  "name": "multi-step-wizard",
-  "main": "./multi-step-wizard.js"
-}

package/lib/components/multi-step-wizard/step/__spec__.d.ts

@@ -1 +0,0 @@
-export {};