@k-int/stripes-kint-components 2.6.5 → 2.7.1

package/es/lib/hooks/useMutateRefdataCategory.js

@@ -0,0 +1,108 @@
+"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 _reactQuery = require("react-query");
+
+var _core = require("@folio/stripes/core");
+
+var _useInvalidateRefdata = _interopRequireDefault(require("./useInvalidateRefdata"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+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; }
+
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return generator._invoke = function (innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; }(innerFn, self, context), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; this._invoke = function (method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); }; } function maybeInvokeDelegate(delegate, context) { var method = delegate.iterator[context.method]; if (undefined === method) { if (context.delegate = null, "throw" === context.method) { if (delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method)) return ContinueSentinel; context.method = "throw", context.arg = new TypeError("The iterator does not provide a 'throw' method"); } return ContinueSentinel; } var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, define(Gp, "constructor", GeneratorFunctionPrototype), define(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (object) { var keys = []; for (var key in object) { keys.push(key); } return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+
+var useMutateRefdataCategory = function useMutateRefdataCategory(_ref) {
+  var afterQueryCalls = _ref.afterQueryCalls,
+      catchQueryCalls = _ref.catchQueryCalls,
+      endpoint = _ref.endpoint,
+      queryParams = _ref.queryParams,
+      _ref$returnQueryObjec = _ref.returnQueryObject,
+      returnQueryObject = _ref$returnQueryObjec === void 0 ? {
+    post: false,
+    delete: false
+  } : _ref$returnQueryObjec;
+  var returnObj = {};
+  var ky = (0, _core.useOkapiKy)();
+  var invalidateRefdata = (0, _useInvalidateRefdata.default)();
+  var deleteQueryObject = (0, _reactQuery.useMutation)(['stripes-kint-components', 'useMutateRefdataCategory', 'delete'], /*#__PURE__*/function () {
+    var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(id) {
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              return _context.abrupt("return", ky.delete("".concat(endpoint, "/").concat(id)).json().then(afterQueryCalls === null || afterQueryCalls === void 0 ? void 0 : afterQueryCalls.delete).then(function () {
+                return invalidateRefdata();
+              }).catch(catchQueryCalls === null || catchQueryCalls === void 0 ? void 0 : catchQueryCalls.delete));
+
+            case 1:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    }));
+
+    return function (_x) {
+      return _ref2.apply(this, arguments);
+    };
+  }(), queryParams === null || queryParams === void 0 ? void 0 : queryParams.delete);
+  var postQueryObject = (0, _reactQuery.useMutation)(['stripes-kint-components', 'useMutateRefdataCategory', 'post'], /*#__PURE__*/function () {
+    var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(payload) {
+      return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              return _context2.abrupt("return", ky.post(endpoint, {
+                json: _objectSpread(_objectSpread({}, payload), {}, {
+                  values: []
+                })
+              }).json().then(afterQueryCalls === null || afterQueryCalls === void 0 ? void 0 : afterQueryCalls.post).then(function () {
+                return invalidateRefdata();
+              }).catch(catchQueryCalls === null || catchQueryCalls === void 0 ? void 0 : catchQueryCalls.post));
+
+            case 1:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    }));
+
+    return function (_x2) {
+      return _ref3.apply(this, arguments);
+    };
+  }(), queryParams === null || queryParams === void 0 ? void 0 : queryParams.post);
+
+  if (returnQueryObject !== null && returnQueryObject !== void 0 && returnQueryObject.delete) {
+    returnObj.delete = deleteQueryObject;
+  } else {
+    returnObj.delete = deleteQueryObject.mutateAsync;
+  }
+
+  if (returnQueryObject !== null && returnQueryObject !== void 0 && returnQueryObject.post) {
+    returnObj.post = postQueryObject;
+  } else {
+    returnObj.post = postQueryObject.mutateAsync;
+  }
+
+  return returnObj;
+};
+
+var _default = useMutateRefdataCategory;
+exports.default = _default;

package/es/lib/utils/refdataOptions.js

@@ -8,6 +8,9 @@ var _default = {
   filterKeys: {
     DescKey: 'desc'
   },
+  sort: [{
+    path: 'desc'
+  }],
   stats: false,
   max: 100
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-int/stripes-kint-components",
-  "version": "2.6.5",
+  "version": "2.7.1",
   "description": "Stripes Component library for K-Int specific applications",
   "sideEffects": [
     "*.css"

package/src/index.js

@@ -53,6 +53,7 @@ export {
 // ActionList & RefdataEditor components
 export { default as ActionList } from './lib/ActionList';
 export { default as EditableRefdataList } from './lib/EditableRefdataList';
+export { default as EditableRefdataCategoryList } from './lib/EditableRefdataCategoryList';
 
 // Typedown
 export {
@@ -121,3 +122,6 @@ export {
 } from './lib/CustomProperties';
 
 export * as customPropertyContants from './lib/constants/customProperties';
+
+export { default as CycleButton } from './lib/CycleButton';
+export { default as IconSelect } from './lib/IconSelect';

package/src/lib/ActionList/ActionList.js

@@ -32,6 +32,7 @@ const ActionList = forwardRef(({
   fieldComponents = {},
   hideCreateButton,
   label,
+  validateFields,
   visibleFields,
   ...mclProps // Assume anything left over is to directly apply to the MCL
 }, ref) => {
@@ -48,7 +49,7 @@ const ActionList = forwardRef(({
         onSubmit={() => null}
         subscription={{ contentData: true }}
       >
-        {() => (
+        {({ handleSubmit }) => (
           <form onSubmit={e => { e.preventDefault(); }}>
             <FieldArray
               actionAssigner={actionAssigner}
@@ -62,6 +63,8 @@ const ActionList = forwardRef(({
               hideCreateButton={hideCreateButton}
               label={label}
               name="contentData"
+              triggerFormSubmit={handleSubmit}
+              validateFields={validateFields}
               visibleFields={visibleFields}
               {...mclProps}
             />

package/src/lib/ActionList/ActionListFieldArray.js

@@ -37,12 +37,14 @@ const ActionListFieldArray = forwardRef(({
   fieldComponents,
   hideCreateButton = false,
   label,
+  validateFields,
   visibleFields,
+  triggerFormSubmit,
   ...mclProps // Assume anything left over is to directly apply to the MCL
 }, ref) => {
   // Grab finalForm functions/values from form hooks
   const { change } = useForm();
-  const { initialValues, pristine, submitting, values } = useFormState();
+  const { hasValidationErrors, initialValues, pristine, submitting, values } = useFormState();
 
   /*
     Keep track of which field we are editing.
@@ -136,13 +138,18 @@ const ActionListFieldArray = forwardRef(({
             disabled={submitting || pristine}
             marginBottom0
             onClick={() => {
-              if (!data.id && editing === 'NEW_ROW') {
-                handleCreate(data.rowIndex);
-              } else {
-                handleSave(data.rowIndex);
+              triggerFormSubmit(); // This is set up as () => null in ActionList, so essentially only acts here to force validation
+
+              if (!hasValidationErrors) {
+                if (!data.id && editing === 'NEW_ROW') {
+                  handleCreate(data.rowIndex);
+                } else {
+                  handleSave(data.rowIndex);
+                }
+                toggleEditing(data.id);
               }
-              toggleEditing(data.id);
             }}
+            type="submit"
           >
             <FormattedMessage id="stripes-kint-components.actionList.save" />
           </Button>
@@ -183,12 +190,23 @@ const ActionListFieldArray = forwardRef(({
             actionFunction = () => toggleEditing(data.id);
           }
 
+          let ariaLabel = `action-${action.name}[${data.rowIndex}]`;
+          if (action?.ariaLabel) {
+            if (typeof action.ariaLabel === 'function') {
+              ariaLabel = action.ariaLabel(data);
+            } else if (typeof action.ariaLabel === 'string') {
+              ariaLabel = action.ariaLabel;
+            } else {
+              throw new Error(`Provided ariaLabel for action "${action.name}" must be a function or a string.`);
+            }
+          }
+
           // If we're handed an icon, use that for the action button
           if (action.icon) {
             return (
               <IconButton
                 key={`action-${action.name}[${data.rowIndex}]`}
-                ariaLabel={action?.ariaLabel(data)}
+                ariaLabel={ariaLabel}
                 disabled={editing}
                 icon={action.icon}
                 onClick={() => (actionFunction ? actionFunction() : () => null)}
@@ -201,6 +219,7 @@ const ActionListFieldArray = forwardRef(({
           return (
             <Button
               key={`action-${action.name}[${data.rowIndex}]`}
+              ariaLabel={ariaLabel}
               disabled={editing}
               marginBottom0
               onClick={() => (actionFunction ? actionFunction() : () => null)}
@@ -229,6 +248,9 @@ const ActionListFieldArray = forwardRef(({
   const fieldAwareFormatter = () => {
     const returnObj = {};
     // For each visible field, if it's being edited then ignore passed formatters, else use them
+
+    // Track whether we've autoFocused on a field yet
+    let autoFocus = true;
     visibleFields.forEach(key => {
       returnObj[key] = cd => {
          // Row is being edited if it has no id, or its id is in the editing string
@@ -255,27 +277,28 @@ const ActionListFieldArray = forwardRef(({
           */
           if (
               (!cd.id && createFunction(cd)) ||
-              (editFunction(cd))
+              (!!cd.id && editFunction(cd))
           ) {
+            const validateFunction = validateFields?.[key] ? validateFields?.[key](cd) : null;
+            
             returnValue =
               fieldComponents[key] ?
               fieldComponents[key]({
                 name: `${cd.fieldName}.${key}`
               }) :
               <Field
-                autoFocus={cd.fieldIndex === 0}
+                autoFocus={autoFocus}
                 component={TextField}
                 marginBottom0
                 name={`${cd.fieldName}.${key}`}
                 parse={v => v}
+                validate={validateFunction}
               />;
+            // After first field, every other field should not autofocus
+            autoFocus = false;
           }
         }
 
-        if (formatter?.[key]) {
-          returnValue = formatter[key](cd);
-        }
-
         return returnValue;
       };
     });

package/src/lib/ActionList/README.md

@@ -2,6 +2,8 @@
 A component designed to render a list of objects, along with actions for each item.
 Special actions are reserved for `create` and `edit`. Currently `edit` can only deal with scalar properties.
 
+It is assumed that a unique `id` is present on each object in the contentData, as this is used internally to work out when a row is being edited/created.
+
 ## Basic Usage
 ```
 import { useState } from 'react';
@@ -89,15 +91,16 @@ const myRef = useRef();
 
 Name | Type | Description | default | required
 --- | --- | --- | --- | ---
-actionAssigner | function | A function which will be passed the entire row object, and can use that to assign an array of actions valid for that row, in the form `{ name: 'actionName', label: "Action Label", icon: 'someIcon', callback: () => null, to: toObject, ariaLabel: () => null }`. The prop `name` is required, but `label` and `icon` are optional props. The `callback` prop will be prioritised ahead of the deprecated actionCalls prop. The `ariaLabel` prop will give the associated icon button an aria-label, including information about the associated content data. If a `to` prop is passed, then the resulting button will be rendered as a <Link/> element, as per Stripes Button/IconButton.| | ✓ |
-actionCalls (DEPRECATED) | object<function> | An object with keys matching any "actions" the `actionAssigner` may have assigned (In addition to special case `create`, if relevant), and values which are functions. These functions will be handed the row as a parameter. THESE CAN NOW BE PASSED AS "callback" in the actionAssigner. | {} | ✕ |
+actionAssigner | function | A function which will be passed the entire row object, and can use that to assign an array of actions valid for that row, in the form `{ name: 'actionName', label: "Action Label", icon: 'someIcon', callback: () => null, to: toObject, ariaLabel: () => null }`. The prop `name` is required, but `label` and `icon` are optional props. The `callback` prop will be prioritised ahead of the deprecated actionCalls prop. The `ariaLabel` prop, which can be either a static string or a function accepting the row data and returning a string, will give the associated icon button an aria-label. If a `to` prop is passed, then the resulting button will be rendered as a \<Link/> element, as per Stripes Button/IconButton.| | ✓ |
+actionCalls (DEPRECATED) | object\<function> | An object with keys matching any "actions" the `actionAssigner` may have assigned (In addition to special case `create`, if relevant), and values which are functions. These functions will be handed the row as a parameter. THESE CAN NOW BE PASSED AS "callback" in the actionAssigner. | {} | ✕ |
 columnMapping | object | An object which will act on the rendered MultiColumnList headers to map the labels for each `visibleField` | | ✕ |
 contentData | array | An array of objects to render along with their actions | | ✓ |
-creatableFields | object<function> | An object with keys from the `visibleFields` array, and values of functions which take the entire row object and return a boolean indicating whether that field is fillable on create or not. | | ✕ |
-createCallback | <function> | A callback to be used for the built in "create" action (ie "save" on a new row). Will be prioritised ahead of a `create` entry in the deprecated actionCalls prop. | {} | ✕ |
-editableFields | object<function> | An object with keys from the `visibleFields` array, and values of functions which take the entire row object and return a boolean indicating whether that field is editable or not. No key for a given field will be interpreted as () => true, so a field is editable by default. | | ✕ |
-fieldComponents | object<function> | An object with keys from the `visibleFields` array, and values of functions which take some `fieldProps` (currently only the name of the field `name`), and returns a Field component to be used in "edit mode" for the visible field specified. | | ✕ |
-formatter | object<function> | A "formatter" object that takes the same shape as an MCL formatter, and is used in the same way whilst a row is NOT being edited. While editing a given row, this formatter entry is ignored. | | ✕ |
+creatableFields | object\<function> | An object with keys from the `visibleFields` array, and values of functions which take the entire row object and return a boolean indicating whether that field is fillable on create or not. | | ✕ |
+createCallback | function | A callback to be used for the built in "create" action (ie "save" on a new row). Will be prioritised ahead of a `create` entry in the deprecated actionCalls prop. | {} | ✕ |
+editableFields | object\<function> | An object with keys from the `visibleFields` array, and values of functions which take the entire row object and return a boolean indicating whether that field is editable or not. No key for a given field will be interpreted as () => true, so a field is editable by default. | | ✕ |
+fieldComponents | object\<function> | An object with keys from the `visibleFields` array, and values of functions which take some `fieldProps` (currently only the name of the field `name`), and returns a Field component to be used in "edit mode" for the visible field specified. | | ✕ |
+formatter | object\<function> | A "formatter" object that takes the same shape as an MCL formatter, and is used in the same way whilst a row is NOT being edited. While editing a given row, this formatter entry is ignored. | | ✕ |
 hideCreateButton | boolean | A simple bool to hide the create button. Default behaviour without create action is disabled. | false | ✕ |
-visibleFields | array<String> | An array of strings corresponding to those fields to be displayed in the rendered MultiColumnList | | ✓ |
+validateFields | object\<function> | An object with keys from the `visibleFields` array, and values of functions which take the entire row object and either return a validate function for final-form, or null | | ✕ |
+visibleFields | array\<String> | An array of strings corresponding to those fields to be displayed in the rendered MultiColumnList | | ✓ |
 ...mclProps | any | Any other props supplied to ActionList will be applied to the MCL directly. *WARNING* Some MCL props may override important functionality within ActionList | | ✕ |

package/src/lib/CustomProperties/Config/CustomPropertiesLookup.js

@@ -14,7 +14,7 @@ import css from '../../../../styles/CustomProperties.css';
 const CustomPropertiesLookup = ({
   contextFilterOptions, // expects an array of the form [{value: "OpenAccess", label: "Open Access"}, {value: false, label: "None"}]
   customPropertiesEndpoint: endpoint,
-  labelOverrides,
+  labelOverrides = {},
   mclProps,
   onSelectCustomProperty,
   queryParams

package/src/lib/CustomProperties/Config/CustomPropertiesSettings.js

@@ -27,7 +27,7 @@ const CustomPropertiesSettings = ({
   contextFilterOptions,
   customPropertiesEndpoint,
   helpPopovers,
-  labelOverrides,
+  labelOverrides = {},
   refdataEndpoint,
 }) => {
   const callout = useContext(CalloutContext);

package/src/lib/CustomProperties/Config/CustomPropertyForm.js

@@ -26,7 +26,7 @@ import {
 const CustomPropertyForm = ({
   contextFilterOptions,
   helpPopovers,
-  labelOverrides,
+  labelOverrides = {},
   refdata
 }) => {
   const { values } = useFormState();

package/src/lib/CustomProperties/Config/CustomPropertyView.js

@@ -8,7 +8,7 @@ import { MULTI_REFDATA_CLASS_NAME, REFDATA_CLASS_NAME } from '../../constants/cu
 const CustomPropertyView = ({
   customProperty,
   helpPopovers,
-  labelOverrides
+  labelOverrides = {}
 }) => {
   return (
     <>

package/src/lib/CustomProperties/Edit/CustomPropertiesEditCtx.js

@@ -9,7 +9,7 @@ const CustomPropertiesEditCtx = ({
   ctx,
   customPropertiesEndpoint,
   id,
-  labelOverrides,
+  labelOverrides = {},
   nameOverride
 }) => {
   // Deal with all the possible label override options

package/src/lib/CustomProperties/Edit/CustomPropertiesListField.js

@@ -14,7 +14,7 @@ const CustomPropertiesList = ({
     onChange,
     value
   },
-  labelOverrides,
+  labelOverrides = {},
   meta: {
     pristine
   },

package/src/lib/CustomProperties/Edit/CustomPropertyField.js

@@ -24,7 +24,7 @@ const CustomPropertyField = ({
   customPropertyType,
   customProperties,
   index,
-  labelOverrides,
+  labelOverrides = {},
   name,
   onChange,
   value,

package/src/lib/CustomProperties/Edit/CustomPropertyFormCard.js

@@ -19,7 +19,7 @@ const CustomPropertyFormCard = ({
   handleDeleteCustomProperty,
   index,
   internalPropertyCounter,
-  labelOverrides,
+  labelOverrides = {},
   name,
   onChange,
   setCustomProperties,

package/src/lib/CustomProperties/Filter/CustomPropertiesFilter.js

@@ -20,7 +20,7 @@ const CustomPropertiesFilter = ({
   },
   customPropertiesEndpoint,
   filterHandlers,
-  labelOverrides
+  labelOverrides = {}
  }) => {
   const [editingFilters, setEditingFilters] = useState(false);
   const openEditModal = () => setEditingFilters(true);

package/src/lib/CustomProperties/Filter/CustomPropertiesFilterFieldArray.js

@@ -17,7 +17,7 @@ import CustomPropertiesFilterField from './CustomPropertiesFilterField';
 
 const CustomPropertiesFilterFieldArray = ({
   customProperties,
-  labelOverrides,
+  labelOverrides = {},
 }) => {
   const { mutators: { push } } = useForm();
 

package/src/lib/CustomProperties/Filter/CustomPropertiesFilterForm.js

@@ -19,7 +19,7 @@ const CustomPropertyFiltersForm = ({
     closeEditModal,
     openEditModal,
   },
-  labelOverrides,
+  labelOverrides = {},
   onSubmit,
 }) => {
   return (

package/src/lib/CustomProperties/View/CustomPropertiesViewCtx.js

@@ -11,7 +11,7 @@ const CustomPropertiesViewCtx = ({
   customProperties = [],
   customPropertiesEndpoint,
   id,
-  labelOverrides
+  labelOverrides = {}
 }) => {
   // Deal with all the possible label override options
   const getAccordionLabel = () => {
@@ -51,8 +51,7 @@ const CustomPropertiesViewCtx = ({
         { path: 'retired' }, // Place retired custprops at the end
         { path: 'primary', direction: 'desc' }, // Primary properties should display before optional
         { path: 'weight' }, // Within those groups, sort by weight
-        { path: 'label' } // For those with the same weight, sort by label
-
+        { path: 'label' } //For those with the same weight, sort by label
       ]
     }
   });

package/src/lib/CustomProperties/View/CustomPropertyCard.js

@@ -19,7 +19,7 @@ const CustomPropertyCard = ({
   customProperty,
   customPropertyDefinition = {},
   index,
-  labelOverrides
+  labelOverrides = {}
 }) => {
   // We only need to display primary and set properties
   const toDisplay = !!(customPropertyDefinition.primary || customProperty);

package/src/lib/CycleButton/CycleButton.js

@@ -0,0 +1,43 @@
+import { useState } from 'react';
+import PropTypes from 'prop-types';
+
+import classnames from 'classnames';
+
+import { IconButton } from '@folio/stripes/components';
+import css from '../../../styles/CycleButton.css';
+
+const CycleButton = ({
+  buttons,
+  startIndex = 0
+}) => {
+  const [index, setIndex] = useState(startIndex);
+
+  const { className, onClick, ...buttonProps } = buttons[index];
+
+  return (
+    <IconButton
+      {...buttonProps}
+      className={classnames(
+        className,
+        css.buttonStyle,
+      )}
+      onClick={(e) => {
+        if (onClick) {
+          onClick(e);
+        }
+
+        setIndex(index !== (buttons?.length -1) ? index + 1 : 0);
+      }}
+    />
+  );
+};
+
+CycleButton.propTypes = {
+  buttons: PropTypes.arrayOf(PropTypes.shape({
+    className: PropTypes.object,
+    icon: PropTypes.string.isRequired,
+    onClick: PropTypes.func.isRequired,
+  }))
+};
+
+export default CycleButton;

package/src/lib/CycleButton/README.md

@@ -0,0 +1,28 @@
+# CycleButton
+A component designed to render an icon button which cycles through a list of available icons, styles and actions.
+
+## Basic Usage
+```
+import { CycleButton } from '@k-int/stripes-kint-components'
+
+<CycleButton
+  buttons={[
+    {
+      icon: "comment",
+      onClick: () => console.log("CLICKED BUTTON"),
+    },
+    {
+      icon: "trash",
+      onClick: () => console.log("CLICKED OTHER BUTTON"),
+    }
+  ]}
+/>
+```
+
+
+## Props
+
+Name | Type | Description | default | required
+--- | --- | --- | --- | ---
+buttons | array\<Object> | An array of objects corresponding to states in the cycle of the action button. Object of the form `{icon: "trash", onClick: () => alert("Clicked trash icon"), ...rest }`, where `icon` and `onClick` are mandatory props and all other props are directly passed through to the underlying `IconButton`. On clicking the icon button, the `onClick` call will fire before the button is moved onto the next state. | | ✓ |
+startIndex | integer | The starting index in the array for the cycle. | 0 | ✕ |

package/src/lib/CycleButton/index.js

@@ -0,0 +1 @@
+export { default } from './CycleButton';