@ukhomeoffice/cop-react-form-renderer 3.26.2 → 3.31.0

package/dist/components/FormRenderer/FormRenderer.js

@@ -23,6 +23,8 @@ var _utils = _interopRequireDefault(require("../../utils"));
 
 var _CheckYourAnswers = _interopRequireDefault(require("../CheckYourAnswers"));
 
+var _CollectionPage = _interopRequireDefault(require("../CollectionPage"));
+
 var _FormPage = _interopRequireDefault(require("../FormPage"));
 
 var _TaskList = _interopRequireDefault(require("../TaskList"));
@@ -191,7 +193,7 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
 
 
   (0, _react.useEffect)(function () {
-    if (components && _pages && _data && (['load', 'submit'].includes(pagePoint) || viewOnly)) {
+    if (components && _pages && _data && (pagePoint === 'load' || viewOnly)) {
       var _data$formStatus;
 
       setData(_utils.default.Data.setupForm(_pages, components, _data));
@@ -289,11 +291,49 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
     if (_helpers.default.canActionProceed(action, formState.page, validate.page)) {
       patch = _helpers.default.cleanHiddenNestedData(patch, formState.page);
 
+      if (action.addToFormData) {
+        formState.page.formData[action.addToFormData.field] = action.addToFormData.value;
+      }
+
       if (action.type === _models.PageAction.TYPES.NAVIGATE) {
         _handlers.default.navigate(action, pageId, onPageChange);
       } else {
-        if (action.type === 'submit') {
-          setPagePoint('submit');
+        var pageUpdate = function pageUpdate(next) {
+          return onPageChange(_helpers.default.getNextPageId(type, pages, pageId, action, next));
+        };
+
+        switch (action.type) {
+          case _models.PageAction.TYPES.SUBMIT:
+            setPagePoint('end');
+            break;
+
+          case _models.PageAction.TYPES.SAVE_AND_NAVIGATE:
+            pageUpdate = function pageUpdate() {
+              return _handlers.default.navigate(action, pageId, onPageChange);
+            };
+
+            break;
+
+          case _models.PageAction.TYPES.COLLECTION_ADD:
+            formState.page.formData["".concat(action.collection, "ActiveId")] = Date.now().toString();
+
+            pageUpdate = function pageUpdate() {
+              return _handlers.default.navigate(action, pageId, onPageChange);
+            };
+
+            break;
+
+          case _models.PageAction.TYPES.COLLECTION_DUPLICATE:
+            if (_utils.default.CollectionPage.duplicateActiveEntry(action.collection, formState.page.formData)) {
+              pageUpdate = function pageUpdate() {
+                return _handlers.default.navigate(action, pageId, onPageChange);
+              };
+            }
+
+            break;
+
+          default:
+            break;
         } // Save draft or submit.
 
 
@@ -306,18 +346,6 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
 
         if (patch) {
           setData(submissionData);
-        }
-
-        var pageUpdate = function pageUpdate(next) {
-          return onPageChange(_helpers.default.getNextPageId(type, pages, pageId, action, next));
-        }; // const navigablePages = currentTask?.fullPages || pages;
-        // let pageUpdate = (next) => onPageChange(helpers.getNextPageId(type, navigablePages, pageId, action, next));
-
-
-        if (action.type === _models.PageAction.TYPES.SAVE_AND_NAVIGATE) {
-          pageUpdate = function pageUpdate() {
-            return _handlers.default.navigate(action, pageId, onPageChange);
-          };
         } // Now submit the data to the backend...
 
 
@@ -336,10 +364,23 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
       }
     }
   }; // Handle navigation from "Check your answers".
+  // Passing a dataCallback allows changes to formData from the
+  // CYA screen. This is necessary to alow changing the active
+  // entry in page collections.
+
 
+  var onCYARowAction = function onCYARowAction(page, dataCallback) {
+    if (typeof dataCallback === 'function') {
+      var newData = dataCallback(_objectSpread({}, data));
 
-  var onCYARowAction = function onCYARowAction(page) {
-    _handlers.default.cyaAction(page, pageId, onPageChange);
+      if (newData) {
+        setData(newData);
+      }
+    }
+
+    if (page) {
+      _handlers.default.cyaAction(page, pageId, onPageChange);
+    }
   }; //Kick off a task, gather required pages and move to the correct point
 
 
@@ -466,7 +507,10 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
     refNumber: data['businessKey'],
     refTitle: _hub.refTitle,
     onTaskAction: onTaskAction
-  }), formState.page && !formState.cya && /*#__PURE__*/_react.default.createElement(_FormPage.default, {
+  }), formState.page && !formState.cya && !formState.page.collection && /*#__PURE__*/_react.default.createElement(_FormPage.default, {
+    page: formState.page,
+    onAction: onPageAction
+  }), formState.page && !formState.cya && formState.page.collection && /*#__PURE__*/_react.default.createElement(_CollectionPage.default, {
     page: formState.page,
     onAction: onPageAction
   }));

package/dist/components/PageActions/ActionButton.js

@@ -42,7 +42,7 @@ var ActionButton = function ActionButton(_ref) {
     className: action.className,
     classModifiers: action.classModifiers,
     start: action.start || false,
-    onClick: function onClick() {
+    onClick: action.disabled ? function () {} : function () {
       return onAction(action);
     }
   }), action.label || (actionLabel === null || actionLabel === void 0 ? void 0 : actionLabel.label) || DEFAULT_LABEL);

package/dist/components/TaskList/TaskList.js

@@ -68,11 +68,11 @@ var TaskList = function TaskList(_ref) {
   return /*#__PURE__*/_react.default.createElement("div", _extends({}, attrs, {
     className: classes()
   }), refNumber && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("h2", {
-    className: "hods-task-reference-description govuk-heading-s govuk-!-margin-bottom-2 govuk-!-padding-right-1"
+    className: "govuk-heading-s govuk-!-margin-bottom-0"
   }, "".concat(refTitle)), /*#__PURE__*/_react.default.createElement("h2", {
     className: "govuk-heading-s govuk-!-font-weight-regular"
   }, "".concat(refNumber))), numberOfSections !== numberOfCompleteSections && /*#__PURE__*/_react.default.createElement("h2", {
-    className: "govuk-heading-s govuk-!-margin-bottom-2"
+    className: "govuk-heading-s govuk-!-margin-bottom-0"
   }, "Incomplete form"), /*#__PURE__*/_react.default.createElement("p", {
     className: "govuk-body govuk-!-margin-bottom-7"
   }, "You have completed ".concat(numberOfCompleteSections, " of ").concat(numberOfSections, " sections")), sections.map(function (section, index) {

package/dist/components/TaskList/TaskList.scss

@@ -7,11 +7,13 @@
   padding-left: 0;
   margin-top: 0;
   margin-bottom: 0;
+
   @include govuk-media-query($from: tablet) {
     min-width: 550px;
   }
+
   .hods-task-list__items {
-   font-size: 19px;
+    font-size: 19px;
     @include govuk-responsive-margin(9, 'bottom');
     list-style: none;
     padding-left: 0;
@@ -21,8 +23,14 @@
 
 .hods-task-list__section {
   display: table;
- font-size: 24px;
- font-weight: bold;
+  font-size: 1.25rem;
+  font-weight: bold;
+
+  @include govuk-media-query($from: tablet) {
+    font-size: 1.5rem;
+    line-height: 1.875rem;
+  }
+
 }
 
 .hods-task-list__section-number {
@@ -40,6 +48,7 @@
   padding-top: govuk-spacing(2);
   padding-bottom: govuk-spacing(2);
   @include govuk-clearfix;
+
   &:first-child {
     border-top: 1px solid $govuk-border-colour;
   }
@@ -48,13 +57,20 @@
 .hods-task-list__task-name {
   display: block;
   cursor: auto;
+  font-size: 1rem;
+
+  @include govuk-media-query($from: tablet) {
+    font-size: 1.1875rem;
+  }
+
   @include govuk-media-query($from: 450px) {
     float: left;
   }
+
   font-weight: normal;
 }
 
-.hods-task-reference-description{
+.hods-task-reference-description {
   @include govuk-media-query($from: 450px) {
     float: left;
   }
@@ -66,6 +82,8 @@
 // avoid breaking task lists in existing prototypes.
 .hods-task-list__tag,
 .hods-task-list__task-completed {
+  letter-spacing: 0;
+  padding: 0.25rem 0.5rem;
   margin-top: govuk-spacing(2);
   margin-bottom: govuk-spacing(1);
 

package/dist/models/PageAction.js

@@ -10,6 +10,8 @@ var _DefaultPageActions;
 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; }
 
 var TYPE_CANCEL = 'cancel';
+var TYPE_COLLECTION_ADD = 'collectionAdd';
+var TYPE_COLLECTION_DUPLICATE = 'collectionDuplicate';
 var TYPE_NAVIGATE = 'navigate';
 var TYPE_SAVE_AND_CONTINUE = 'saveAndContinue';
 var TYPE_SAVE_AND_NAVIGATE = 'saveAndNavigate';
@@ -17,6 +19,8 @@ var TYPE_SAVE_AND_RETURN = 'saveAndReturn';
 var TYPE_SUBMIT = 'submit';
 var PageActionTypes = {
   CANCEL: TYPE_CANCEL,
+  COLLECTION_ADD: TYPE_COLLECTION_ADD,
+  COLLECTION_DUPLICATE: TYPE_COLLECTION_DUPLICATE,
   NAVIGATE: TYPE_NAVIGATE,
   SAVE_AND_CONTINUE: TYPE_SAVE_AND_CONTINUE,
   SAVE_AND_NAVIGATE: TYPE_SAVE_AND_NAVIGATE,
@@ -29,7 +33,7 @@ var DefaultPageActions = (_DefaultPageActions = {}, _defineProperty(_DefaultPage
   validate: false,
   label: 'Cancel',
   classModifiers: 'secondary'
-}), _defineProperty(_DefaultPageActions, TYPE_NAVIGATE, undefined), _defineProperty(_DefaultPageActions, TYPE_SAVE_AND_CONTINUE, {
+}), _defineProperty(_DefaultPageActions, TYPE_COLLECTION_ADD, undefined), _defineProperty(_DefaultPageActions, TYPE_COLLECTION_DUPLICATE, undefined), _defineProperty(_DefaultPageActions, TYPE_NAVIGATE, undefined), _defineProperty(_DefaultPageActions, TYPE_SAVE_AND_CONTINUE, {
   type: TYPE_SAVE_AND_CONTINUE,
   validate: true,
   label: 'Save and continue'

package/dist/utils/CheckYourAnswers/getCYARowsForCollectionPage.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+
+var _models = require("../../models");
+
+var _getCYARowsForContainer = _interopRequireDefault(require("./getCYARowsForContainer"));
+
+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; }
+
+var getChangeActionForItem = function getChangeActionForItem(page, item, onAction) {
+  return function (row) {
+    var changeCallback = function changeCallback(data) {
+      data["".concat(page.collection.name, "ActiveId")] = item.id;
+      return data;
+    };
+
+    onAction(row, changeCallback);
+  };
+};
+
+var getContainerForPage = function getContainerForPage(page, item, labelCount, full_path) {
+  return {
+    id: item.id,
+    fieldId: item.id,
+    type: _models.ComponentTypes.CONTAINER,
+    required: true,
+    full_path: full_path,
+    components: page.components.map(function (component) {
+      return _objectSpread(_objectSpread({}, component), {}, {
+        label: _copReactComponents.Utils.interpolateString(component.label, _objectSpread(_objectSpread({}, item), {}, {
+          index: labelCount
+        })),
+        full_path: "".concat(full_path, ".").concat(component.fieldId)
+      });
+    })
+  };
+};
+
+var getTitleRowForItem = function getTitleRowForItem(page, item, pageId, labelCount, full_path) {
+  var labels = _objectSpread(_objectSpread({}, _models.CollectionLabels), page.collection.labels);
+
+  return {
+    pageId: pageId,
+    fieldId: 'Title',
+    full_path: "".concat(full_path, ".Title"),
+    key: _copReactComponents.Utils.interpolateString(labels.item, _objectSpread(_objectSpread({}, item), {}, {
+      index: labelCount
+    })),
+    type: 'title'
+  };
+};
+
+var getCYARowsForCollectionPage = function getCYARowsForCollectionPage(page, onAction) {
+  var _page$formData, _page$formData$page$c;
+
+  var rows = [];
+  (_page$formData = page.formData) === null || _page$formData === void 0 ? void 0 : (_page$formData$page$c = _page$formData[page.collection.name]) === null || _page$formData$page$c === void 0 ? void 0 : _page$formData$page$c.forEach(function (item, index) {
+    var labelCount = index + 1;
+    var full_path = "".concat(page.collection.name, "[").concat(index, "]");
+    var container = getContainerForPage(page, item, labelCount, full_path);
+    var itemChangeAction = getChangeActionForItem(page, item, onAction);
+    var containerRows = (0, _getCYARowsForContainer.default)(page, container, item, itemChangeAction);
+    var titleRow = getTitleRowForItem(page, item, page.id, labelCount, full_path);
+    rows = rows.concat(titleRow);
+    rows = rows.concat(containerRows);
+  });
+  return rows.filter(function (row) {
+    return !!row;
+  });
+};
+
+var _default = getCYARowsForCollectionPage;
+exports.default = _default;

package/dist/utils/CheckYourAnswers/getCYARowsForCollectionPage.test.js

@@ -0,0 +1,107 @@
+"use strict";
+
+var _getCYARowsForCollectionPage = _interopRequireDefault(require("./getCYARowsForCollectionPage"));
+
+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; }
+
+describe('utils.CheckYourAnswers.getCYARowsForCollectionPage', function () {
+  var TEXT_COMP = {
+    id: 'testText',
+    fieldId: 'testText',
+    label: 'Test text',
+    type: 'text'
+  };
+  var MASTER_PAGE = {
+    id: 'page1',
+    collection: {
+      name: 'collection',
+      labels: {
+        item: 'Collection entry ${index}'
+      }
+    },
+    title: 'Collection',
+    components: [TEXT_COMP]
+  };
+  it('should return an empty array if the collection has no entries', function () {
+    var FORM_DATA = {};
+
+    var PAGE = _objectSpread(_objectSpread({}, MASTER_PAGE), {}, {
+      formData: FORM_DATA
+    });
+
+    var ROWS = (0, _getCYARowsForCollectionPage.default)(PAGE, null);
+    expect(ROWS.length).toEqual(0);
+  });
+  it('should format titles correctly when collection.labels.item is specified', function () {
+    var FORM_DATA = {
+      collection: [{
+        id: '01',
+        testText: 'value'
+      }]
+    };
+
+    var PAGE = _objectSpread(_objectSpread({}, MASTER_PAGE), {}, {
+      formData: FORM_DATA
+    });
+
+    var ROWS = (0, _getCYARowsForCollectionPage.default)(PAGE, null);
+    expect(ROWS.length).toEqual(2); // Title row + component row
+
+    expect(ROWS[0].key).toEqual('Collection entry 1');
+  });
+  it('should provide default titles if collection.labels.item is not specified', function () {
+    var FORM_DATA = {
+      collection: [{
+        id: '01',
+        testText: 'value'
+      }]
+    };
+
+    var PAGE = _objectSpread(_objectSpread({}, MASTER_PAGE), {}, {
+      collection: _objectSpread(_objectSpread({}, MASTER_PAGE.collection), {}, {
+        labels: {}
+      }),
+      formData: FORM_DATA
+    });
+
+    var ROWS = (0, _getCYARowsForCollectionPage.default)(PAGE, null);
+    expect(ROWS.length).toEqual(2); // Title row + component row
+
+    expect(ROWS[0].key).toEqual('Item 1');
+  });
+  it('should return correctly formatted rows for mutliple entries', function () {
+    var FORM_DATA = {
+      collection: [{
+        id: '01',
+        testText: 'value'
+      }, {
+        id: '02',
+        testText: 'value'
+      }]
+    };
+
+    var PAGE = _objectSpread(_objectSpread({}, MASTER_PAGE), {}, {
+      formData: FORM_DATA
+    });
+
+    var ROWS = (0, _getCYARowsForCollectionPage.default)(PAGE, null);
+    expect(ROWS.length).toEqual(4); // Title row + component row for each item
+
+    expect(ROWS[0].type).toEqual('title');
+    expect(ROWS[0].key).toEqual('Collection entry 1'); // Formatted according to collection.labels.item
+
+    expect(ROWS[1].value).toEqual('value');
+    expect(ROWS[1].key).toEqual('Test text');
+    expect(ROWS[2].type).toEqual('title');
+    expect(ROWS[2].key).toEqual('Collection entry 2'); // Formatted according to collection.labels.item
+
+    expect(ROWS[3].value).toEqual('value');
+    expect(ROWS[3].key).toEqual('Test text');
+  });
+});

package/dist/utils/CheckYourAnswers/getCYARowsForPage.js

@@ -11,6 +11,8 @@ var _FormPage = _interopRequireDefault(require("../FormPage"));
 
 var _getCYARow = _interopRequireDefault(require("./getCYARow"));
 
+var _getCYARowsForCollectionPage = _interopRequireDefault(require("./getCYARowsForCollectionPage"));
+
 var _getCYARowForGroup2 = _interopRequireDefault(require("./getCYARowForGroup"));
 
 var _getCYARowsForCollection = _interopRequireDefault(require("./getCYARowsForCollection"));
@@ -35,6 +37,10 @@ var getCYARowsForPage = function getCYARowsForPage(page, onAction) {
   if (_FormPage.default.showCYA(page, page.formData)) {
     var _page$groups;
 
+    if (page.collection) {
+      return (0, _getCYARowsForCollectionPage.default)(page, onAction);
+    }
+
     var rows = page.components.filter(function (c) {
       return (0, _showComponentCYA.default)(c, page.formData);
     }).flatMap(function (component) {

package/dist/utils/CheckYourAnswers/showComponentCYA.js

@@ -33,6 +33,10 @@ var showComponentCYA = function showComponentCYA(options, data) {
     return false;
   }
 
+  if (options.hasOwnProperty('show_on_cya') && !options.show_on_cya) {
+    return false;
+  }
+
   if (options.type === _models.ComponentTypes.CONTAINER) {
     return _Container.default.show(options, data);
   }

package/dist/utils/CheckYourAnswers/showComponentCYA.test.js

@@ -13,6 +13,11 @@ describe('utils', function () {
       it('should not show when there are no options', function () {
         expect((0, _showComponentCYA.default)(null, null)).toBeFalsy();
       });
+      it('should not show when show_on_cya is defined and falsy', function () {
+        expect((0, _showComponentCYA.default)({
+          show_on_cya: false
+        })).toBeFalsy();
+      });
       it('should not show when it is a heading type', function () {
         expect((0, _showComponentCYA.default)({
           type: _models.ComponentTypes.HEADING
@@ -34,6 +39,11 @@ describe('utils', function () {
           disabled: true
         }, null)).toBeFalsy();
       });
+      it('should show when show_on_cya is defined and truthy', function () {
+        expect((0, _showComponentCYA.default)({
+          show_on_cya: true
+        })).toBeTruthy();
+      });
       it('should show when it hidden but not disabled', function () {
         expect((0, _showComponentCYA.default)({
           hidden: true

package/dist/utils/CollectionPage/duplicateCollectionPageActiveEntry.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _getCollectionPageActiveIndex = _interopRequireDefault(require("./getCollectionPageActiveIndex"));
+
+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; }
+
+/**
+ * Duplicates the currently active entry in a named collection's data.
+ * Once duplicated, the new entry is set as the active entry.
+ * @param {string} collectionName The name of the collection.
+ * @param {object} formData A page's form data containing the collection's data.
+ * @return true if the entry ws successfully duplicated, false if not.
+ */
+var duplicateCollectionPageActiveEntry = function duplicateCollectionPageActiveEntry(collectionName, formData) {
+  var _formData$collectionN;
+
+  var currentIndex = (0, _getCollectionPageActiveIndex.default)(collectionName, formData);
+  var currentEntry = (_formData$collectionN = formData[collectionName]) === null || _formData$collectionN === void 0 ? void 0 : _formData$collectionN[currentIndex];
+
+  if (!currentEntry) {
+    return false;
+  }
+
+  var newEntry = _objectSpread(_objectSpread({}, currentEntry), {}, {
+    id: Date.now().toString()
+  });
+
+  formData[collectionName].push(newEntry);
+  formData["".concat(collectionName, "ActiveId")] = newEntry.id;
+  return true;
+};
+
+var _default = duplicateCollectionPageActiveEntry;
+exports.default = _default;

package/dist/utils/CollectionPage/duplicateCollectionPageActiveEntry.test.js

@@ -0,0 +1,41 @@
+"use strict";
+
+var _duplicateCollectionPageActiveEntry = _interopRequireDefault(require("./duplicateCollectionPageActiveEntry"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+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; }
+
+describe('utils.CollectionPage.duplicateCollectionPageActiveEntry', function () {
+  var COLLECTION_NAME = 'testCollection';
+  var OBJ = {
+    id: '1',
+    value: 'value'
+  };
+  it('should duplicate the active entry if one exists', function () {
+    var _FORM_DATA;
+
+    var FORM_DATA = (_FORM_DATA = {}, _defineProperty(_FORM_DATA, "".concat(COLLECTION_NAME, "ActiveId"), '1'), _defineProperty(_FORM_DATA, COLLECTION_NAME, [OBJ]), _FORM_DATA);
+    (0, _duplicateCollectionPageActiveEntry.default)(COLLECTION_NAME, FORM_DATA);
+    expect(FORM_DATA[COLLECTION_NAME].length).toEqual(2);
+    expect(FORM_DATA[COLLECTION_NAME][1].value).toEqual(FORM_DATA[COLLECTION_NAME][0].value);
+    expect(FORM_DATA[COLLECTION_NAME][1].id).toBeTruthy();
+    expect(FORM_DATA[COLLECTION_NAME][1].id === '1').toBeFalsy();
+    expect(FORM_DATA["".concat(COLLECTION_NAME, "ActiveId")]).toBeTruthy();
+    expect(FORM_DATA["".concat(COLLECTION_NAME, "ActiveId")] === '1').toBeFalsy();
+  });
+  it('should do nothing if there is no active entry', function () {
+    var _FORM_DATA2;
+
+    var FORM_DATA = (_FORM_DATA2 = {}, _defineProperty(_FORM_DATA2, "".concat(COLLECTION_NAME, "ActiveId"), '2'), _defineProperty(_FORM_DATA2, COLLECTION_NAME, [OBJ]), _FORM_DATA2);
+    (0, _duplicateCollectionPageActiveEntry.default)(COLLECTION_NAME, FORM_DATA);
+    expect(FORM_DATA[COLLECTION_NAME].length).toEqual(1);
+    expect(FORM_DATA[COLLECTION_NAME][0]).toEqual(OBJ);
+    expect(FORM_DATA["".concat(COLLECTION_NAME, "ActiveId")]).toEqual('2'); // Shouldn't have changed.
+  });
+  it('should do nothing if the collection does not exist', function () {
+    var FORM_DATA = {};
+    (0, _duplicateCollectionPageActiveEntry.default)(COLLECTION_NAME, FORM_DATA);
+    expect(FORM_DATA).toEqual({});
+  });
+});

package/dist/utils/CollectionPage/getCollectionPageActiveIndex.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+/**
+ * Gets the index of the active entry in a named collection's data.
+ * @param {string} collectionName The name of the collection.
+ * @param {object} formData A page's form data containing the collection's data. 
+ * @returns The index of the active entry, or null if there isn't one.
+ */
+var getCollectionPageActiveIndex = function getCollectionPageActiveIndex(collectionName, formData) {
+  var _formData$collectionN;
+
+  if (!collectionName) {
+    return null;
+  }
+
+  var id = formData === null || formData === void 0 ? void 0 : formData["".concat(collectionName, "ActiveId")];
+
+  if (!id) {
+    return null;
+  }
+
+  var activeIndex = (_formData$collectionN = formData[collectionName]) === null || _formData$collectionN === void 0 ? void 0 : _formData$collectionN.findIndex(function (item) {
+    return item.id === id;
+  });
+  return activeIndex > -1 ? activeIndex : null;
+};
+
+var _default = getCollectionPageActiveIndex;
+exports.default = _default;

package/dist/utils/CollectionPage/getCollectionPageActiveIndex.test.js

@@ -0,0 +1,54 @@
+"use strict";
+
+var _getCollectionPageActiveIndex = _interopRequireDefault(require("./getCollectionPageActiveIndex"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Local imports
+describe('utils.CollectionPage.getCollectionPageActiveIndex', function () {
+  it('should return the index of the active item in the collection, if one exists', function () {
+    var COLLECTION_NAME = 'test';
+    var ACTIVE_ID = '002';
+    var FORM_DATA = {
+      testActiveId: ACTIVE_ID,
+      test: [{
+        id: '001'
+      }, {
+        id: '002'
+      }]
+    };
+    var PAGE = {
+      collection: {
+        name: COLLECTION_NAME
+      },
+      formData: FORM_DATA
+    };
+    expect((0, _getCollectionPageActiveIndex.default)(PAGE.collection.name, PAGE.formData)).toEqual(1);
+  });
+  it('should return null if no active item can be found in the collection', function () {
+    var COLLECTION_NAME = 'test';
+    var ACTIVE_ID = '002';
+    var FORM_DATA = {
+      testActiveId: ACTIVE_ID,
+      test: [{
+        id: '001'
+      }]
+    };
+    var PAGE = {
+      collection: {
+        name: COLLECTION_NAME
+      },
+      formData: FORM_DATA
+    };
+    expect((0, _getCollectionPageActiveIndex.default)(PAGE.collection.name, PAGE.formData)).toEqual(null);
+  });
+  it('should return null if formData is null', function () {
+    var COLLECTION_NAME = 'test';
+    var PAGE = {
+      collection: {
+        name: COLLECTION_NAME
+      }
+    };
+    expect((0, _getCollectionPageActiveIndex.default)(PAGE.collection.name, null)).toEqual(null);
+  });
+});