@ukhomeoffice/cop-react-form-renderer 4.81.1 → 4.82.1-alpha

package/dist/components/FormComponent/Collection.js

@@ -12,9 +12,12 @@ var _models = require("../../models");
 var _utils = _interopRequireDefault(require("../../utils"));
 var _Container = _interopRequireDefault(require("./Container"));
 require("./Collection.scss");
+var _excluded = ["firstOnlyLabel"];
 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 _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; }
 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) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -149,9 +152,21 @@ var Collection = function Collection(_ref) {
         required: config.required,
         full_path: fullPath,
         components: config.item.map(function (component) {
-          return _objectSpread(_objectSpread({}, component), {}, {
+          var firstOnlyLabel = component.firstOnlyLabel,
+            cleanedComponent = _objectWithoutProperties(component, _excluded);
+          var hint = component.hint;
+          if (config.restrictHint && index > 0) {
+            hint = undefined;
+          }
+          var label = component.label;
+          if (index === 0) {
+            var _component$firstOnlyL;
+            label = (_component$firstOnlyL = component.firstOnlyLabel) !== null && _component$firstOnlyL !== void 0 ? _component$firstOnlyL : component.label;
+          }
+          return _objectSpread(_objectSpread({}, cleanedComponent), {}, {
+            hint: hint,
             readonly: !!(config !== null && config !== void 0 && config.readonly || component.readonly),
-            label: _utils.default.interpolateString(component.label, _objectSpread(_objectSpread({}, item), {}, {
+            label: _utils.default.interpolateString(label, _objectSpread(_objectSpread({}, item), {}, {
               index: labelCount
             })),
             fullPath: "".concat(fullPath, ".").concat(component.fieldId)
@@ -182,6 +197,7 @@ Collection.propTypes = {
     id: _propTypes.default.string.isRequired,
     fieldId: _propTypes.default.string.isRequired,
     fullPath: _propTypes.default.string,
+    restrictHint: _propTypes.default.bool,
     item: _propTypes.default.arrayOf(_propTypes.default.shape({
       fieldId: _propTypes.default.string,
       type: _propTypes.default.string

package/dist/components/FormComponent/Collection.test.js

@@ -11,6 +11,8 @@ var _Container = require("./Container");
 var _FormComponent = _interopRequireDefault(require("./FormComponent"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 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); }
+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 _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, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $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 defineProperty(generator, "_invoke", { value: makeInvokeMethod(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; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(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); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), 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, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), 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 (val) { var object = Object(val), 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 _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."); }
@@ -451,4 +453,279 @@ describe('components.FormComponent.Collection', function () {
       }
     }, _callee10);
   })));
+  it('should render a collection component with only a hint on the first item(s) when restrictHint is truthy', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11() {
+    var FORM_DATA_TWO_ITEMS, TEXT_COMPONENT_TWO, COLLECTION, _renderWithValidation7, container, c, item, _item$childNodes4, title, itemContainer, formGroup, label, hint, input, itemTwo, _itemTwo$childNodes, titleTwo, itemContainerTwo, formGroupTwo, labelTwo, hintTwo, inputTwo;
+    return _regeneratorRuntime().wrap(function _callee11$(_context11) {
+      while (1) switch (_context11.prev = _context11.next) {
+        case 0:
+          FORM_DATA_TWO_ITEMS = [{
+            id: '1',
+            text: 'alpha',
+            textTwo: 'charlie'
+          }, {
+            id: '2',
+            text: 'beta',
+            textTwo: 'delta'
+          }];
+          TEXT_COMPONENT_TWO = {
+            id: 'textTwo',
+            fieldId: 'textTwo',
+            type: _models.ComponentTypes.TEXT,
+            label: 'Text component two',
+            hint: 'Text hint two'
+          };
+          COLLECTION = {
+            id: ID,
+            fieldId: ID,
+            type: _models.ComponentTypes.COLLECTION,
+            item: [TEXT_COMPONENT, TEXT_COMPONENT_TWO]
+          };
+          _renderWithValidation7 = (0, _setupTests.renderWithValidation)( /*#__PURE__*/_react2.default.createElement(_FormComponent.default, {
+            component: _objectSpread(_objectSpread({}, COLLECTION), {}, {
+              restrictHint: true
+            }),
+            value: FORM_DATA_TWO_ITEMS,
+            formData: FORM_DATA
+          })), container = _renderWithValidation7.container; // Check the container itself.
+          c = container.childNodes[0];
+          expect(c.tagName).toEqual('DIV');
+          expect(c.classList).toContain(_Collection.DEFAULT_CLASS);
+
+          // And now check the first text component within it.
+          item = c.childNodes[0];
+          expect(item.tagName).toEqual('DIV');
+          expect(item.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item"));
+          _item$childNodes4 = _slicedToArray(item.childNodes, 2), title = _item$childNodes4[0], itemContainer = _item$childNodes4[1];
+          expect(title.tagName).toEqual('LABEL');
+          expect(title.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item-title"));
+          expect(itemContainer.tagName).toEqual('DIV');
+          expect(itemContainer.classList).toContain(_Container.DEFAULT_CLASS);
+
+          // First item component 1
+          formGroup = itemContainer.childNodes[0];
+          expect(formGroup.tagName).toEqual('DIV');
+          expect(formGroup.classList).toContain('govuk-form-group');
+          label = formGroup.childNodes[0].childNodes[0].childNodes[0];
+          expect(label.tagName).toEqual('LABEL');
+          expect(label.classList).toContain('govuk-label');
+          expect(label.textContent).toEqual("".concat(TEXT_COMPONENT.label, " (optional)"));
+          expect(label.getAttribute('for')).toEqual("".concat(ID, "[0].").concat(TEXT_ID));
+          hint = formGroup.childNodes[0].childNodes[1];
+          expect(hint.tagName).toEqual('DIV');
+          expect(hint.classList).toContain('govuk-hint');
+          expect(hint.textContent).toEqual(TEXT_COMPONENT.hint);
+          input = formGroup.childNodes[0].childNodes[2];
+          expect(input.tagName).toEqual('INPUT');
+          expect(input.classList).toContain('govuk-input');
+          expect(input.id).toEqual("".concat(ID, "[0].").concat(TEXT_ID));
+          expect(input.value).toEqual(TEXT_VALUE);
+
+          // First item component 2
+          formGroup = itemContainer.childNodes[1];
+          expect(formGroup.tagName).toEqual('DIV');
+          expect(formGroup.classList).toContain('govuk-form-group');
+          label = formGroup.childNodes[0].childNodes[0].childNodes[0];
+          expect(label.tagName).toEqual('LABEL');
+          expect(label.classList).toContain('govuk-label');
+          expect(label.textContent).toEqual('Text component two (optional)');
+          expect(label.getAttribute('for')).toEqual("".concat(ID, "[0].textTwo"));
+          hint = formGroup.childNodes[0].childNodes[1];
+          expect(hint.tagName).toEqual('DIV');
+          expect(hint.classList).toContain('govuk-hint');
+          expect(hint.textContent).toEqual('Text hint two');
+          input = formGroup.childNodes[0].childNodes[2];
+          expect(input.tagName).toEqual('INPUT');
+          expect(input.classList).toContain('govuk-input');
+          expect(input.id).toEqual("".concat(ID, "[0].textTwo"));
+          expect(input.value).toEqual('charlie');
+
+          // Check the second item and confirm there is no hint
+          itemTwo = c.childNodes[1];
+          expect(itemTwo.tagName).toEqual('DIV');
+          expect(itemTwo.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item"));
+          _itemTwo$childNodes = _slicedToArray(itemTwo.childNodes, 2), titleTwo = _itemTwo$childNodes[0], itemContainerTwo = _itemTwo$childNodes[1];
+          expect(titleTwo.tagName).toEqual('LABEL');
+          expect(titleTwo.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item-title"));
+          expect(itemContainerTwo.tagName).toEqual('DIV');
+          expect(itemContainerTwo.classList).toContain(_Container.DEFAULT_CLASS);
+
+          // Second item first component
+          formGroupTwo = itemContainerTwo.childNodes[0];
+          expect(formGroupTwo.tagName).toEqual('DIV');
+          expect(formGroupTwo.classList).toContain('govuk-form-group');
+          labelTwo = formGroupTwo.childNodes[0].childNodes[0].childNodes[0];
+          expect(labelTwo.tagName).toEqual('LABEL');
+          expect(labelTwo.classList).toContain('govuk-label');
+          expect(labelTwo.textContent).toEqual("".concat(TEXT_COMPONENT.label, " (optional)"));
+          expect(labelTwo.getAttribute('for')).toEqual("".concat(ID, "[1].").concat(TEXT_ID));
+          hintTwo = formGroupTwo.childNodes[0].childNodes[1];
+          expect(hintTwo.tagName).toEqual(undefined);
+          inputTwo = formGroupTwo.childNodes[0].childNodes[2];
+          expect(inputTwo.tagName).toEqual('INPUT');
+          expect(inputTwo.classList).toContain('govuk-input');
+          expect(inputTwo.id).toEqual("".concat(ID, "[1].").concat(TEXT_ID));
+          expect(inputTwo.value).toEqual('beta');
+
+          // Second item second component
+          formGroupTwo = itemContainerTwo.childNodes[1];
+          expect(formGroupTwo.tagName).toEqual('DIV');
+          expect(formGroupTwo.classList).toContain('govuk-form-group');
+          labelTwo = formGroupTwo.childNodes[0].childNodes[0].childNodes[0];
+          expect(labelTwo.tagName).toEqual('LABEL');
+          expect(labelTwo.classList).toContain('govuk-label');
+          expect(labelTwo.textContent).toEqual('Text component two (optional)');
+          expect(labelTwo.getAttribute('for')).toEqual("".concat(ID, "[1].textTwo"));
+          hintTwo = formGroupTwo.childNodes[0].childNodes[1];
+          expect(hintTwo.tagName).toEqual(undefined);
+          inputTwo = formGroupTwo.childNodes[0].childNodes[2];
+          expect(inputTwo.tagName).toEqual('INPUT');
+          expect(inputTwo.classList).toContain('govuk-input');
+          expect(inputTwo.id).toEqual("".concat(ID, "[1].textTwo"));
+          expect(inputTwo.value).toEqual('delta');
+        case 87:
+        case "end":
+          return _context11.stop();
+      }
+    }, _callee11);
+  })));
+  it('should render a unique label for the first item(s) when firstOnlyLabel is defined', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12() {
+    var UNIQUE_FIRST_LABEL_ONE, UNIQUE_FIRST_LABEL_TWO, FORM_DATA_TWO_ITEMS, TEXT_COMPONENT_TWO, COLLECTION, _renderWithValidation8, container, c, item, _item$childNodes5, title, itemContainer, formGroup, label, hint, input, itemTwo, _itemTwo$childNodes2, titleTwo, itemContainerTwo, formGroupTwo, labelTwo, hintTwo, inputTwo;
+    return _regeneratorRuntime().wrap(function _callee12$(_context12) {
+      while (1) switch (_context12.prev = _context12.next) {
+        case 0:
+          UNIQUE_FIRST_LABEL_ONE = 'justForTextOne';
+          UNIQUE_FIRST_LABEL_TWO = 'justForTextTwo';
+          FORM_DATA_TWO_ITEMS = [{
+            id: '1',
+            text: 'alpha',
+            textTwo: 'charlie'
+          }, {
+            id: '2',
+            text: 'beta',
+            textTwo: 'delta'
+          }];
+          TEXT_COMPONENT_TWO = {
+            id: 'textTwo',
+            fieldId: 'textTwo',
+            type: _models.ComponentTypes.TEXT,
+            label: 'Text component two',
+            hint: 'Text hint two',
+            firstOnlyLabel: UNIQUE_FIRST_LABEL_TWO
+          };
+          COLLECTION = {
+            id: ID,
+            fieldId: ID,
+            type: _models.ComponentTypes.COLLECTION,
+            item: [_objectSpread(_objectSpread({}, TEXT_COMPONENT), {}, {
+              firstOnlyLabel: UNIQUE_FIRST_LABEL_ONE
+            }), TEXT_COMPONENT_TWO]
+          };
+          _renderWithValidation8 = (0, _setupTests.renderWithValidation)( /*#__PURE__*/_react2.default.createElement(_FormComponent.default, {
+            component: _objectSpread(_objectSpread({}, COLLECTION), {}, {
+              restrictHint: true
+            }),
+            value: FORM_DATA_TWO_ITEMS,
+            formData: FORM_DATA
+          })), container = _renderWithValidation8.container; // Check the container itself.
+          c = container.childNodes[0];
+          expect(c.tagName).toEqual('DIV');
+          expect(c.classList).toContain(_Collection.DEFAULT_CLASS);
+
+          // And now check the first text component within it.
+          item = c.childNodes[0];
+          expect(item.tagName).toEqual('DIV');
+          expect(item.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item"));
+          _item$childNodes5 = _slicedToArray(item.childNodes, 2), title = _item$childNodes5[0], itemContainer = _item$childNodes5[1];
+          expect(title.tagName).toEqual('LABEL');
+          expect(title.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item-title"));
+          expect(itemContainer.tagName).toEqual('DIV');
+          expect(itemContainer.classList).toContain(_Container.DEFAULT_CLASS);
+
+          // First item component 1
+          formGroup = itemContainer.childNodes[0];
+          expect(formGroup.tagName).toEqual('DIV');
+          expect(formGroup.classList).toContain('govuk-form-group');
+          label = formGroup.childNodes[0].childNodes[0].childNodes[0];
+          expect(label.tagName).toEqual('LABEL');
+          expect(label.classList).toContain('govuk-label');
+          expect(label.textContent).toEqual("".concat(UNIQUE_FIRST_LABEL_ONE, " (optional)"));
+          expect(label.getAttribute('for')).toEqual("".concat(ID, "[0].").concat(TEXT_ID));
+          hint = formGroup.childNodes[0].childNodes[1];
+          expect(hint.tagName).toEqual('DIV');
+          expect(hint.classList).toContain('govuk-hint');
+          expect(hint.textContent).toEqual(TEXT_COMPONENT.hint);
+          input = formGroup.childNodes[0].childNodes[2];
+          expect(input.tagName).toEqual('INPUT');
+          expect(input.classList).toContain('govuk-input');
+          expect(input.id).toEqual("".concat(ID, "[0].").concat(TEXT_ID));
+          expect(input.value).toEqual(TEXT_VALUE);
+
+          // First item component 2
+          formGroup = itemContainer.childNodes[1];
+          expect(formGroup.tagName).toEqual('DIV');
+          expect(formGroup.classList).toContain('govuk-form-group');
+          label = formGroup.childNodes[0].childNodes[0].childNodes[0];
+          expect(label.tagName).toEqual('LABEL');
+          expect(label.classList).toContain('govuk-label');
+          expect(label.textContent).toEqual("".concat(UNIQUE_FIRST_LABEL_TWO, " (optional)"));
+          expect(label.getAttribute('for')).toEqual("".concat(ID, "[0].textTwo"));
+          hint = formGroup.childNodes[0].childNodes[1];
+          expect(hint.tagName).toEqual('DIV');
+          expect(hint.classList).toContain('govuk-hint');
+          expect(hint.textContent).toEqual('Text hint two');
+          input = formGroup.childNodes[0].childNodes[2];
+          expect(input.tagName).toEqual('INPUT');
+          expect(input.classList).toContain('govuk-input');
+          expect(input.id).toEqual("".concat(ID, "[0].textTwo"));
+          expect(input.value).toEqual('charlie');
+
+          // Check the second item and confirm there is no hint
+          itemTwo = c.childNodes[1];
+          expect(itemTwo.tagName).toEqual('DIV');
+          expect(itemTwo.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item"));
+          _itemTwo$childNodes2 = _slicedToArray(itemTwo.childNodes, 2), titleTwo = _itemTwo$childNodes2[0], itemContainerTwo = _itemTwo$childNodes2[1];
+          expect(titleTwo.tagName).toEqual('LABEL');
+          expect(titleTwo.classList).toContain("".concat(_Collection.DEFAULT_CLASS, "__item-title"));
+          expect(itemContainerTwo.tagName).toEqual('DIV');
+          expect(itemContainerTwo.classList).toContain(_Container.DEFAULT_CLASS);
+
+          // Second item first component
+          formGroupTwo = itemContainerTwo.childNodes[0];
+          expect(formGroupTwo.tagName).toEqual('DIV');
+          expect(formGroupTwo.classList).toContain('govuk-form-group');
+          labelTwo = formGroupTwo.childNodes[0].childNodes[0].childNodes[0];
+          expect(labelTwo.tagName).toEqual('LABEL');
+          expect(labelTwo.classList).toContain('govuk-label');
+          expect(labelTwo.textContent).toEqual("".concat(TEXT_COMPONENT.label, " (optional)"));
+          expect(labelTwo.getAttribute('for')).toEqual("".concat(ID, "[1].").concat(TEXT_ID));
+          hintTwo = formGroupTwo.childNodes[0].childNodes[1];
+          expect(hintTwo.tagName).toEqual(undefined);
+          inputTwo = formGroupTwo.childNodes[0].childNodes[2];
+          expect(inputTwo.tagName).toEqual('INPUT');
+          expect(inputTwo.classList).toContain('govuk-input');
+          expect(inputTwo.id).toEqual("".concat(ID, "[1].").concat(TEXT_ID));
+          expect(inputTwo.value).toEqual('beta');
+
+          // Second item second component
+          formGroupTwo = itemContainerTwo.childNodes[1];
+          expect(formGroupTwo.tagName).toEqual('DIV');
+          expect(formGroupTwo.classList).toContain('govuk-form-group');
+          labelTwo = formGroupTwo.childNodes[0].childNodes[0].childNodes[0];
+          expect(labelTwo.tagName).toEqual('LABEL');
+          expect(labelTwo.classList).toContain('govuk-label');
+          expect(labelTwo.textContent).toEqual('Text component two (optional)');
+          expect(labelTwo.getAttribute('for')).toEqual("".concat(ID, "[1].textTwo"));
+          hintTwo = formGroupTwo.childNodes[0].childNodes[1];
+          expect(hintTwo.tagName).toEqual(undefined);
+          inputTwo = formGroupTwo.childNodes[0].childNodes[2];
+          expect(inputTwo.tagName).toEqual('INPUT');
+          expect(inputTwo.classList).toContain('govuk-input');
+          expect(inputTwo.id).toEqual("".concat(ID, "[1].textTwo"));
+          expect(inputTwo.value).toEqual('delta');
+        case 89:
+        case "end":
+          return _context12.stop();
+      }
+    }, _callee12);
+  })));
 });

package/dist/components/FormRenderer/FormRenderer.js

@@ -349,12 +349,16 @@ var InternalFormRenderer = function InternalFormRenderer(_ref2) {
       (0, _onPageAction.default)(action, patch, patchLabel, hooks, data, formState, validate, onPageChange, type, pages, components, pageId, setPagePoint, currentTask, setData, hubDetails, setSubmitted, addErrors);
     },
     onChange: onChange,
-    hashLink: hashLink
+    hashLink: hashLink,
+    classModifiers: formState.page.classModifiers,
+    className: formState.page.className
   }), formState.page && !formState.cya && formState.page.collection && /*#__PURE__*/_react.default.createElement(_CollectionPage.default, {
     page: formState.page,
     onAction: function onAction(action, patch, patchLabel) {
       (0, _onPageAction.default)(action, patch, patchLabel, hooks, data, formState, validate, onPageChange, type, pages, components, pageId, setPagePoint, currentTask, setData, hubDetails, setSubmitted, addErrors);
-    }
+    },
+    classModifiers: formState.page.classModifiers,
+    className: formState.page.className
   }));
 };
 var propTypes = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ukhomeoffice/cop-react-form-renderer",
-  "version": "4.81.1",
+  "version": "4.82.1-alpha",
   "private": false,
   "scripts": {
     "clean": "rimraf dist",