@unbxd-ui/unbxd-react-components 0.2.104 → 0.2.107-beta.2

package/lib/components/Form/Dropdown.js

@@ -0,0 +1,478 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.DefaultDropdownItem = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _InlineModal = _interopRequireWildcard(require("../InlineModal"));
+var _List = _interopRequireDefault(require("../List"));
+var _Form = require("./Form");
+var _FormElementWrapper = _interopRequireDefault(require("./FormElementWrapper"));
+var _ServerPaginatedDDList = _interopRequireDefault(require("./ServerPaginatedDDList"));
+var _utils = _interopRequireDefault(require("../../core/utils"));
+var _excluded = ["items", "selectedItems", "selectItem", "idAttribute", "nameAttribute", "DropdownItem", "ListHeaderItem", "showClippedContentTitle"],
+  _excluded2 = ["halign", "label", "showLabel", "name", "SelectionSummary", "className", "value", "defaultValue", "onChange", "disabled", "options", "showSearch", "searchPlaceholder", "idAttribute", "nameAttribute", "noSelectionLabel", "appearance", "multiSelect", "DropdownItem", "validations", "paginationType", "requestId", "requestParams", "pageNoKey", "perPageKey", "pageSize", "searchAttribute", "maxHeight", "responseFormatter", "getUrlParams", "showCreateCTA", "createCTAComponent", "onCreateCTAClick", "serverListClassName", "showClear", "onClear", "minPageNo", "ListHeaderItem", "onSearchChange", "showClippedContentTitle"];
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : 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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+var convertToArray = function convertToArray(value) {
+  if (!value) {
+    return [];
+  }
+  return Array.isArray(value) ? value : [value];
+};
+var getFilteredOptions = function getFilteredOptions() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var searchQuery = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
+  var nameAttribute = arguments.length > 2 ? arguments[2] : undefined;
+  return options.filter(function (obj) {
+    var nameValue = obj[nameAttribute].toLowerCase();
+    return nameValue.indexOf(searchQuery.toLowerCase()) !== -1;
+  });
+};
+
+/* eslint-disable react/prop-types */
+var DefaultSelectionSummary = function DefaultSelectionSummary(_ref) {
+  var _ref$selectedItems = _ref.selectedItems,
+    selectedItems = _ref$selectedItems === void 0 ? [] : _ref$selectedItems,
+    multiSelect = _ref.multiSelect,
+    noSelectionLabel = _ref.noSelectionLabel,
+    nameAttribute = _ref.nameAttribute,
+    showClear = _ref.showClear,
+    clearSelectedItems = _ref.clearSelectedItems;
+  var summaryString = "";
+  var selectedCount = selectedItems.length;
+  if (multiSelect) {
+    summaryString = selectedCount ? "".concat(selectedCount, " selected") : noSelectionLabel;
+  } else {
+    summaryString = selectedCount ? selectedItems[0][nameAttribute] : noSelectionLabel;
+  }
+  return /*#__PURE__*/_react["default"].createElement(_react.Fragment, null, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "RCB-dd-label"
+  }, summaryString), /*#__PURE__*/_react["default"].createElement("span", {
+    className: "RCB-selection-wrapper"
+  }, showClear && /*#__PURE__*/_react["default"].createElement("span", {
+    className: "RCB-clear-selected",
+    onClick: clearSelectedItems
+  }, "Clear"), /*#__PURE__*/_react["default"].createElement("span", {
+    className: "RCB-select-arrow"
+  })));
+};
+var DefaultDropdownItem = function DefaultDropdownItem(props) {
+  var itemData = props.itemData,
+    selectItem = props.selectItem,
+    _props$selectedItems = props.selectedItems,
+    selectedItems = _props$selectedItems === void 0 ? [] : _props$selectedItems,
+    idAttribute = props.idAttribute,
+    nameAttribute = props.nameAttribute,
+    showClippedContentTitle = props.showClippedContentTitle;
+  var idValue = itemData[idAttribute];
+  var name = itemData[nameAttribute];
+  var isSelected = selectedItems.find(function (obj) {
+    return obj[idAttribute] === idValue;
+  }) ? true : false;
+  var className = "RCB-list-item " + (isSelected ? "selected" : "");
+  if (showClippedContentTitle) {
+    return /*#__PURE__*/_react["default"].createElement("li", {
+      onClick: function onClick() {
+        return selectItem(itemData);
+      },
+      className: className,
+      title: name
+    }, name);
+  } else {
+    return /*#__PURE__*/_react["default"].createElement("li", {
+      onClick: function onClick() {
+        return selectItem(itemData);
+      },
+      className: className
+    }, name);
+  }
+};
+exports.DefaultDropdownItem = DefaultDropdownItem;
+DefaultDropdownItem.propTypes = {
+  itemData: _propTypes["default"].object.isRequired,
+  selectItem: _propTypes["default"].func.isRequired,
+  selectedItems: _propTypes["default"].array,
+  idAttribute: _propTypes["default"].string,
+  nameAttribute: _propTypes["default"].string,
+  showClippedContentTitle: _propTypes["default"].bool
+};
+var NormalList = function NormalList(_ref2) {
+  var _ref2$items = _ref2.items,
+    items = _ref2$items === void 0 ? [] : _ref2$items,
+    selectedItems = _ref2.selectedItems,
+    selectItem = _ref2.selectItem,
+    idAttribute = _ref2.idAttribute,
+    nameAttribute = _ref2.nameAttribute,
+    DropdownItem = _ref2.DropdownItem,
+    ListHeaderItem = _ref2.ListHeaderItem,
+    showClippedContentTitle = _ref2.showClippedContentTitle,
+    restProps = _objectWithoutProperties(_ref2, _excluded);
+  return /*#__PURE__*/_react["default"].createElement(_react.Fragment, null, items.length ? ListHeaderItem : "", /*#__PURE__*/_react["default"].createElement(_List["default"], _extends({
+    items: items
+  }, restProps, {
+    showNoDataMsg: true,
+    ListItem: DropdownItem,
+    selectedItems: selectedItems,
+    selectItem: selectItem,
+    showClippedContentTitle: showClippedContentTitle,
+    idAttribute: idAttribute,
+    nameAttribute: nameAttribute
+  })));
+};
+NormalList.defaultProps = {
+  DropdownItem: DefaultDropdownItem
+};
+
+/* eslint-enable react/prop-types */
+
+var Dropdown = function Dropdown(props, ref) {
+  var halign = props.halign,
+    label = props.label,
+    showLabel = props.showLabel,
+    name = props.name,
+    SelectionSummary = props.SelectionSummary,
+    className = props.className,
+    value = props.value,
+    defaultValue = props.defaultValue,
+    onChange = props.onChange,
+    disabled = props.disabled,
+    options = props.options,
+    showSearch = props.showSearch,
+    searchPlaceholder = props.searchPlaceholder,
+    idAttribute = props.idAttribute,
+    nameAttribute = props.nameAttribute,
+    noSelectionLabel = props.noSelectionLabel,
+    appearance = props.appearance,
+    multiSelect = props.multiSelect,
+    DropdownItem = props.DropdownItem,
+    validations = props.validations,
+    paginationType = props.paginationType,
+    requestId = props.requestId,
+    requestParams = props.requestParams,
+    pageNoKey = props.pageNoKey,
+    perPageKey = props.perPageKey,
+    pageSize = props.pageSize,
+    searchAttribute = props.searchAttribute,
+    maxHeight = props.maxHeight,
+    responseFormatter = props.responseFormatter,
+    getUrlParams = props.getUrlParams,
+    showCreateCTA = props.showCreateCTA,
+    createCTAComponent = props.createCTAComponent,
+    onCreateCTAClick = props.onCreateCTAClick,
+    serverListClassName = props.serverListClassName,
+    showClear = props.showClear,
+    onClear = props.onClear,
+    minPageNo = props.minPageNo,
+    ListHeaderItem = props.ListHeaderItem,
+    propSearchChange = props.onSearchChange,
+    showClippedContentTitle = props.showClippedContentTitle,
+    restProps = _objectWithoutProperties(props, _excluded2);
+  var _useState = (0, _react.useState)(""),
+    _useState2 = _slicedToArray(_useState, 2),
+    searchQuery = _useState2[0],
+    setSearchQuery = _useState2[1];
+  var debouncedFn = (0, _react.useRef)();
+  var searchIpRef = (0, _react.useRef)();
+  var initialSelected = [];
+  var initialValue = typeof onChange === "function" ? value : defaultValue;
+  if (typeof initialValue !== "undefined") {
+    initialSelected = convertToArray(initialValue);
+  }
+
+  /* array of selected item objects */
+  var _useState3 = (0, _react.useState)(initialSelected),
+    _useState4 = _slicedToArray(_useState3, 2),
+    selectedItems = _useState4[0],
+    setSelectedItems = _useState4[1];
+  var _useContext = (0, _react.useContext)(_Form.FormContext),
+    onValueChange = _useContext.onValueChange;
+  var inlineModalRef = (0, _react.useRef)();
+  var hideModal = function hideModal() {
+    inlineModalRef.current.hideModal();
+  };
+  var postFormValueChange = function postFormValueChange(value) {
+    var _utils$checkIfValid = _utils["default"].checkIfValid(value, validations),
+      error = _utils$checkIfValid.error;
+    typeof onValueChange === "function" && onValueChange(name, value, error);
+  };
+  var selectItem = function selectItem(item) {
+    var id = item[idAttribute];
+    if (multiSelect) {
+      var isPresent = selectedItems.find(function (obj) {
+        return obj[idAttribute] === id;
+      });
+      if (!isPresent) {
+        selectedItems.push(item);
+        postFormValueChange(selectedItems);
+        typeof onChange === "function" && onChange(selectedItems);
+      }
+    } else {
+      selectedItems = [item];
+      postFormValueChange(item);
+      typeof onChange === "function" && onChange(item);
+      /* close the dropdown */
+      hideModal();
+    }
+    setSelectedItems(selectedItems);
+  };
+  (0, _react.useEffect)(function () {
+    /* set the initial form element value in the form context */
+    var postValue = typeof onChange === "function" ? value : defaultValue;
+    if (typeof postValue !== "undefined") {
+      var arrayPostValue = convertToArray(postValue);
+      postValue = multiSelect ? arrayPostValue : postValue;
+      setSelectedItems(arrayPostValue);
+    }
+    postFormValueChange(postValue);
+  }, [value, defaultValue]);
+  var debouncedSearchChange = function debouncedSearchChange(value) {
+    setSearchQuery(value);
+    if (typeof propSearchChange === "function") {
+      propSearchChange(value);
+    }
+  };
+  var onSearchChange = function onSearchChange(event) {
+    event.persist();
+    if (!debouncedFn.current) {
+      debouncedFn.current = _utils["default"].debounce(debouncedSearchChange, 300);
+    }
+    return debouncedFn.current(event.target.value);
+  };
+  var onModalStateChange = function onModalStateChange(isModalOpen) {
+    if (isModalOpen && showSearch) {
+      searchIpRef.current && searchIpRef.current.focus();
+    } else {
+      /* modal is closed */
+      setSearchQuery("");
+    }
+  };
+  var clearSelectedItems = function clearSelectedItems(evnt) {
+    evnt.stopPropagation();
+    setSelectedItems([]);
+    typeof onClear === "function" && onClear();
+    typeof onChange === "function" && onChange(null);
+    /** Close modal after reset */
+    hideModal();
+  };
+  var commonAttributes = {
+    selectedItems: selectedItems,
+    selectItem: selectItem,
+    idAttribute: idAttribute,
+    nameAttribute: nameAttribute,
+    DropdownItem: DropdownItem,
+    ListHeaderItem: ListHeaderItem,
+    showClippedContentTitle: showClippedContentTitle
+  };
+  (0, _react.useImperativeHandle)(ref, function () {
+    return {
+      closeDropdown: hideModal
+    };
+  });
+  var serverListAttrs = {
+    requestId: requestId,
+    requestParams: requestParams,
+    pageNoKey: pageNoKey,
+    perPageKey: perPageKey,
+    pageSize: pageSize,
+    maxHeight: maxHeight,
+    searchQuery: searchQuery,
+    searchAttribute: searchAttribute,
+    responseFormatter: responseFormatter,
+    getUrlParams: getUrlParams,
+    serverListClassName: serverListClassName,
+    minPageNo: minPageNo
+  };
+  var inlineModalClasses = "RCB-form-el " + (showCreateCTA ? "RCB-dd-with-create" : "");
+  return /*#__PURE__*/_react["default"].createElement(_FormElementWrapper["default"], {
+    className: "RCB-dropdown ".concat(disabled ? "RCB-disabled" : "", " ").concat(className),
+    appearance: appearance
+  }, showLabel && /*#__PURE__*/_react["default"].createElement("label", {
+    className: "RCB-form-el-label",
+    htmlFor: name
+  }, label), /*#__PURE__*/_react["default"].createElement(_InlineModal["default"], {
+    className: inlineModalClasses,
+    ref: inlineModalRef,
+    halign: halign,
+    onModalStateChange: onModalStateChange
+  }, /*#__PURE__*/_react["default"].createElement(_InlineModal.InlineModalActivator, null, /*#__PURE__*/_react["default"].createElement(SelectionSummary, _extends({
+    selectedItems: selectedItems,
+    noSelectionLabel: noSelectionLabel,
+    multiSelect: multiSelect,
+    nameAttribute: nameAttribute
+  }, restProps, {
+    showClear: showClear,
+    clearSelectedItems: clearSelectedItems
+  }))), /*#__PURE__*/_react["default"].createElement(_InlineModal.InlineModalBody, null, showSearch && /*#__PURE__*/_react["default"].createElement("div", {
+    className: "RCB-dd-search"
+  }, /*#__PURE__*/_react["default"].createElement("span", {
+    className: "RCB-dd-search-icon"
+  }), /*#__PURE__*/_react["default"].createElement("input", {
+    type: "text",
+    className: "RCB-dd-search-ip",
+    placeholder: searchPlaceholder,
+    onChange: onSearchChange,
+    ref: searchIpRef,
+    "data-hj-allow": true
+  })), paginationType === "SERVER" ? /*#__PURE__*/_react["default"].createElement(_ServerPaginatedDDList["default"], _extends({}, commonAttributes, serverListAttrs, restProps)) : /*#__PURE__*/_react["default"].createElement(NormalList, _extends({}, commonAttributes, restProps, {
+    items: getFilteredOptions(options, searchQuery, nameAttribute)
+  })), showCreateCTA && /*#__PURE__*/_react["default"].createElement("div", {
+    className: "RCB-dd-create-cta",
+    onClick: onCreateCTAClick
+  }, createCTAComponent))));
+};
+
+// const VALUE_SHAPE = PropTypes.shape({
+//     id: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+//     name: PropTypes.string
+// });
+
+Dropdown = /*#__PURE__*/(0, _react.forwardRef)(Dropdown);
+Dropdown.propTypes = {
+  /** Pass any additional classNames to Dropdown component */
+  className: _propTypes["default"].string,
+  /** Pass infinite fixed list classname to Dropdown component */
+  serverListClassName: _propTypes["default"].string,
+  /** Horizontal alignment of the dropdown body */
+  halign: _propTypes["default"].oneOf(["left", "right"]),
+  /** Label for the dropdown element */
+  label: _propTypes["default"].string,
+  /** indicates whether to show or hide label */
+  showLabel: _propTypes["default"].bool,
+  /** Unique ID for the input element */
+  name: _propTypes["default"].string.isRequired,
+  /** Label for dropdown activator */
+  noSelectionLabel: _propTypes["default"].string,
+  /** Selection items list */
+  options: _propTypes["default"].arrayOf(_propTypes["default"].shape({
+    id: _propTypes["default"].oneOfType([_propTypes["default"].string, _propTypes["default"].number]),
+    name: _propTypes["default"].string
+  })),
+  /** array of selected item objects, only considered if onChange event is given */
+  value: _propTypes["default"].any,
+  /** array of default selected item objects */
+  defaultValue: _propTypes["default"].any,
+  onChange: _propTypes["default"].func,
+  /** pass true if dropdown has to be disabled */
+  disabled: _propTypes["default"].bool,
+  /* set to true if you want search ability for dropdown items */
+  showSearch: _propTypes["default"].bool,
+  /* placeholder to show in the search box */
+  searchPlaceholder: _propTypes["default"].string,
+  /** Is dropdown multi select or single select */
+  multiSelect: _propTypes["default"].bool,
+  /** ID attribute key to use when rendering the dropdown items, if the ID attribute is other than "id" */
+  idAttribute: _propTypes["default"].string,
+  /** name attribute key to use when rendering the dropdown items, if the name attribute is other than "name" */
+  nameAttribute: _propTypes["default"].string,
+  /** Add title attribute to list element for large data */
+  showClippedContentTitle: _propTypes["default"].bool,
+  /** Provide a custom element for rendering dropdown item */
+  DropdownItem: _propTypes["default"].oneOfType([_propTypes["default"].instanceOf(Element), _propTypes["default"].func]),
+  /** Pass true to show a create CTA at the end of the dropdown */
+  showCreateCTA: _propTypes["default"].bool,
+  /** Customize the create CTA HTML by passing a createCTAComponent */
+  createCTAComponent: _propTypes["default"].any,
+  /** Callback that gets called when Create CTA button is clicked */
+  onCreateCTAClick: _propTypes["default"].func,
+  /** Pass this component to customise the selection summary HTML. 
+   * The array of selected item objects will be sent as props
+   */
+  SelectionSummary: _propTypes["default"].func,
+  /** Define the appearance of the form element. Accepted values are either "inline" or "block" */
+  appearance: _propTypes["default"].oneOf(["inline", "block"]),
+  /** Array of validations to perform on the form element value. 
+   * If the validation fails, you will get an "error" field in the form onSubmit event */
+  validations: _propTypes["default"].arrayOf(_propTypes["default"].shape({
+    type: _propTypes["default"].oneOf(["REQUIRED", "CUSTOM"]).isRequired,
+    message: _propTypes["default"].string.isRequired,
+    validator: _propTypes["default"].func
+  })),
+  /** Type of pagination for the dropdown list items. Send "SERVER" for server side pagination */
+  paginationType: _propTypes["default"].oneOf(["NONE", "SERVER"]),
+  /** If paginationType is "SERVER", pass the requestId for the server request */
+  requestId: function requestId(props, propName) {
+    if (props["paginationType"] == "SERVER" && (!props[propName] || typeof props[propName] === "undefined")) {
+      return new Error("Please provide a requestId for paginationType 'SERVER'!");
+    }
+  },
+  /** If paginationType is "SERVER", pass any additional params to be sent to the server request */
+  requestParams: _propTypes["default"].object,
+  /** If paginationType is "SERVER", pass the pageNo. attribute to be sent to the server request */
+  pageNoKey: _propTypes["default"].string,
+  /** If paginationType is "SERVER", pass the pageSize attribute to be sent to the server request */
+  perPageKey: _propTypes["default"].string,
+  /** If paginationType is "SERVER", max height of the dropdown container */
+  maxHeight: _propTypes["default"].number,
+  /** If paginationType is "SERVER", height of each dropdown item */
+  ddItemHeight: _propTypes["default"].number,
+  /** If paginationType is "SERVER", max number of items to show for one page in the dropdown container */
+  pageSize: _propTypes["default"].number,
+  /** Default page number to use for server paginated list */
+  minPageNo: _propTypes["default"].number,
+  /** If paginationType is "SERVER" & showSearch is true, pass the search attribute to be sent to the server request */
+  searchAttribute: _propTypes["default"].string,
+  /** If paginationType is "SERVER", 
+   * component expects the response to be of the form
+   * { [pageNoKey]: <pageNo>, [perPageKey]: <pageSize>, total: <totalCount>, entries: [{}] }
+   * If your data is not in this format, use the responseFormatter to format the data to this structure.
+   * Input to this function is the response received from your API
+   *   */
+  responseFormatter: _propTypes["default"].func,
+  /** If paginationType is "SERVER", function that is expected to return the URL Params object */
+  getUrlParams: _propTypes["default"].func,
+  /** Show the optional clear button for resetting selections */
+  showClear: _propTypes["default"].bool,
+  /** Custom on clear function */
+  onClear: _propTypes["default"].func,
+  /** Callback on query search in dropdown */
+  onSearchChange: _propTypes["default"].func,
+  /** List header Component */
+  ListHeaderItem: _propTypes["default"].string
+};
+Dropdown.defaultProps = {
+  className: "",
+  label: "",
+  showLabel: true,
+  showSearch: false,
+  searchPlaceholder: "Search",
+  searchAttribute: "search",
+  multiSelect: false,
+  idAttribute: "id",
+  nameAttribute: "name",
+  noSelectionLabel: "Select",
+  appearance: "inline",
+  halign: "left",
+  validations: [],
+  paginationType: "NONE",
+  pageNoKey: "page",
+  perPageKey: "count",
+  maxHeight: 200,
+  pageSize: 10,
+  getUrlParams: function getUrlParams() {
+    return {};
+  },
+  SelectionSummary: DefaultSelectionSummary,
+  showCreateCTA: false,
+  serverListClassName: "",
+  createCTAComponent: /*#__PURE__*/_react["default"].createElement("span", null, "Create New"),
+  onCreateCTAClick: function onCreateCTAClick() {},
+  showClear: false,
+  ListHeaderItem: "",
+  onClear: function onClear() {}
+};
+var _default = Dropdown;
+exports["default"] = _default;

package/lib/components/Form/FileUploader.js

@@ -0,0 +1,81 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _Form = require("./Form");
+var _FormElementWrapper = _interopRequireDefault(require("./FormElementWrapper"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : 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); }
+var FileUploader = function FileUploader(props) {
+  var label = props.label,
+    name = props.name,
+    multiple = props.multiple,
+    accept = props.accept,
+    className = props.className,
+    appearance = props.appearance,
+    onChange = props.onChange,
+    children = props.children;
+  var _useContext = (0, _react.useContext)(_Form.FormContext),
+    onValueChange = _useContext.onValueChange;
+  var onFileChange = function onFileChange(event) {
+    var value = event.target.files;
+    if (typeof onChange === "function") {
+      onChange(value);
+    }
+    typeof onValueChange === "function" && onValueChange(name, value);
+  };
+  var inputProps = {
+    type: "file",
+    label: label,
+    name: name,
+    id: name,
+    multiple: multiple,
+    accept: accept,
+    className: "RCB-form-el",
+    onChange: onFileChange
+  };
+  return /*#__PURE__*/_react["default"].createElement(_FormElementWrapper["default"], {
+    className: className,
+    appearance: appearance
+  }, /*#__PURE__*/_react["default"].createElement("label", {
+    className: "RCB-form-el-label"
+  }, label), /*#__PURE__*/_react["default"].createElement("input", _extends({}, inputProps, {
+    className: "RCB-hidden"
+  })), /*#__PURE__*/_react["default"].createElement("label", {
+    htmlFor: name,
+    className: "RCB-file-input"
+  }, /*#__PURE__*/_react["default"].createElement("div", {
+    className: "RCB-no-pointer"
+  }, children)));
+};
+FileUploader.propTypes = {
+  /** Pass any additional classNames to Input component */
+  className: _propTypes["default"].string,
+  /** Label for the input element */
+  label: _propTypes["default"].string,
+  /** Unique ID for the input element */
+  name: _propTypes["default"].string.isRequired,
+  /** set to true to upload multiple files at once */
+  multiple: _propTypes["default"].bool,
+  /** mime type of the acceptable files */
+  accept: _propTypes["default"].string,
+  /** Define the appearance of the form element. Accepted values are either "inline" or "block" */
+  appearance: _propTypes["default"].oneOf(["inline", "block"]),
+  /** Becomes a controlled component if onChange function is given */
+  onChange: _propTypes["default"].func
+};
+FileUploader.defaultProps = {
+  className: "",
+  appearance: "inline",
+  multiple: false,
+  accept: "image/*"
+};
+var _default = FileUploader;
+exports["default"] = _default;

package/lib/components/Form/Form.js

@@ -0,0 +1,106 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.FormContext = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _dequal = _interopRequireDefault(require("dequal"));
+var _lodash = _interopRequireDefault(require("lodash.clonedeep"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+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; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+var FormContext = /*#__PURE__*/(0, _react.createContext)({
+  onValueChange: function onValueChange() {}
+});
+exports.FormContext = FormContext;
+var Form = function Form(props, ref) {
+  var _useState = (0, _react.useState)({}),
+    _useState2 = _slicedToArray(_useState, 2),
+    formData = _useState2[0],
+    setFormData = _useState2[1];
+  var _useState3 = (0, _react.useState)({}),
+    _useState4 = _slicedToArray(_useState3, 2),
+    formErrors = _useState4[0],
+    setFormErrors = _useState4[1];
+  var _useState5 = (0, _react.useState)(0),
+    _useState6 = _slicedToArray(_useState5, 2),
+    formRefreshCount = _useState6[0],
+    setFormRefreshCount = _useState6[1];
+  var className = props.className,
+    onChange = props.onChange,
+    onSubmit = props.onSubmit;
+  var dataRef = (0, _react.useRef)();
+  var getFormData = function getFormData() {
+    return {
+      data: formData,
+      errors: formErrors
+    };
+  };
+
+  /* add methods that can be accessed via this component's ref */
+  (0, _react.useImperativeHandle)(ref, function () {
+    return {
+      getFormData: getFormData
+    };
+  });
+  var onValueChange = function onValueChange(key, value, error) {
+    formData[key] = value;
+    setFormData(formData);
+    if (error) {
+      formErrors[key] = error;
+    } else {
+      /* remove the error value */
+      delete formErrors[key];
+    }
+    setFormErrors(formErrors);
+    setFormRefreshCount(formRefreshCount + 1);
+  };
+  var onFormSubmit = function onFormSubmit(event) {
+    event.preventDefault();
+    onSubmit(getFormData());
+  };
+  (0, _react.useEffect)(function () {
+    /* 
+        As useEffect does not do a deep comparision on dependent props, 
+        do a manual deep comparision to decide whether data changed
+    */
+    if (typeof onChange === "function") {
+      var _formData = getFormData();
+      if (!(0, _dequal["default"])(_formData, dataRef.current)) {
+        dataRef.current = (0, _lodash["default"])(_formData);
+        onChange(_formData);
+      }
+    }
+  }, [formRefreshCount]);
+  return /*#__PURE__*/_react["default"].createElement("form", {
+    onSubmit: onFormSubmit,
+    className: className
+  }, /*#__PURE__*/_react["default"].createElement(FormContext.Provider, {
+    value: {
+      onValueChange: onValueChange
+    }
+  }, props.children));
+};
+Form = /*#__PURE__*/(0, _react.forwardRef)(Form);
+Form.propTypes = {
+  /** Pass any additional classNames to Form component */
+  className: _propTypes["default"].string,
+  /** Pass a callback function to listen to changes on any of the form elements */
+  onChange: _propTypes["default"].func,
+  /** Pass a callback function to listen to form submit event */
+  onSubmit: _propTypes["default"].func
+};
+Form.defaultProps = {
+  className: ""
+};
+var _default = Form;
+exports["default"] = _default;