@ukhomeoffice/cop-react-form-renderer 5.0.0-alpha → 5.0.1

package/dist/components/PageActions/PageActions.test.js

@@ -0,0 +1,132 @@
+"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); }
+var _react = require("@testing-library/react");
+var _react2 = _interopRequireDefault(require("react"));
+var _models = require("../../models");
+var _ActionButton = require("./ActionButton");
+var _PageActions = _interopRequireDefault(require("./PageActions"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: 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, 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 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); }); }; }
+describe('components', function () {
+  describe('PageActions', function () {
+    var ON_ACTION_CALLS = [];
+    var ON_ACTION = function ON_ACTION(action) {
+      ON_ACTION_CALLS.push(action);
+    };
+    beforeEach(function () {
+      ON_ACTION_CALLS.length = 0;
+    });
+    it('should handle an empty array of actions', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+      var ACTIONS, _render, container;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            ACTIONS = [];
+            _render = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_PageActions.default, {
+              actions: ACTIONS,
+              onAction: ON_ACTION
+            })), container = _render.container;
+            expect(container.childNodes.length).toEqual(0);
+          case 3:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    })));
+    it('should appropriately display a single submit action', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+      var ACTIONS, _render2, container, buttonGroup, submit;
+      return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            ACTIONS = [_models.PageAction.TYPES.SUBMIT];
+            _render2 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_PageActions.default, {
+              actions: ACTIONS,
+              onAction: ON_ACTION
+            })), container = _render2.container;
+            buttonGroup = container.childNodes[0];
+            expect(buttonGroup.childNodes.length).toEqual(ACTIONS.length);
+            submit = buttonGroup.childNodes[0];
+            expect(submit.tagName).toEqual('BUTTON');
+            expect(submit.textContent).toEqual(_ActionButton.DEFAULT_LABEL);
+
+            // Click the button and make sure it fires the onAction handler.
+            _react.fireEvent.click(submit, {});
+            expect(ON_ACTION_CALLS.length).toEqual(1);
+            expect(ON_ACTION_CALLS[0]).toEqual(_models.PageAction.DEFAULTS.submit);
+          case 10:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2);
+    })));
+    it('should appropriately display a custom action', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+      var ACTIONS, _render3, container, buttonGroup, navigate;
+      return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            ACTIONS = [{
+              type: 'navigate',
+              page: 'alpha',
+              label: 'Alpha'
+            }];
+            _render3 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_PageActions.default, {
+              actions: ACTIONS,
+              onAction: ON_ACTION
+            })), container = _render3.container;
+            buttonGroup = container.childNodes[0];
+            expect(buttonGroup.childNodes.length).toEqual(1);
+            navigate = buttonGroup.childNodes[0];
+            expect(navigate.tagName).toEqual('BUTTON');
+            expect(buttonGroup.childNodes.length).toEqual(ACTIONS.length);
+
+            // Click the button and make sure it fires the onAction handler.
+            _react.fireEvent.click(navigate, {});
+            expect(ON_ACTION_CALLS.length).toEqual(1);
+            expect(ON_ACTION_CALLS[0]).toEqual(ACTIONS[0]);
+          case 10:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3);
+    })));
+    it('should appropriately display multiple actions', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+      var NAVIGATE, ACTIONS, _render4, container, buttonGroup, navigate, submit;
+      return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+        while (1) switch (_context4.prev = _context4.next) {
+          case 0:
+            NAVIGATE = {
+              type: _models.PageAction.TYPES.NAVIGATE,
+              page: 'alpha',
+              label: 'Alpha'
+            };
+            ACTIONS = [NAVIGATE, _models.PageAction.TYPES.SUBMIT];
+            _render4 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_PageActions.default, {
+              actions: ACTIONS,
+              onAction: ON_ACTION
+            })), container = _render4.container;
+            buttonGroup = container.childNodes[0];
+            expect(buttonGroup.childNodes.length).toEqual(ACTIONS.length);
+            navigate = buttonGroup.childNodes[0];
+            expect(navigate.tagName).toEqual('BUTTON');
+            expect(navigate.textContent).toEqual(NAVIGATE.label);
+            submit = buttonGroup.childNodes[1];
+            expect(submit.tagName).toEqual('BUTTON');
+            expect(submit.textContent).toEqual(_ActionButton.DEFAULT_LABEL);
+
+            // Click each button in turn button and make sure it fires the onAction handler.
+            _react.fireEvent.click(navigate, {});
+            _react.fireEvent.click(submit, {});
+            expect(ON_ACTION_CALLS.length).toEqual(2);
+            expect(ON_ACTION_CALLS[0]).toEqual(NAVIGATE);
+            expect(ON_ACTION_CALLS[1]).toEqual(_models.PageAction.DEFAULTS.submit);
+          case 16:
+          case "end":
+            return _context4.stop();
+        }
+      }, _callee4);
+    })));
+  });
+});

package/dist/components/SummaryList/GroupAction.js

@@ -16,8 +16,8 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 var GroupAction = function GroupAction(_ref) {
   var group = _ref.group;

package/dist/components/SummaryList/GroupAction.test.js

@@ -0,0 +1,80 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+var _react2 = _interopRequireDefault(require("react"));
+var _GroupAction = _interopRequireDefault(require("./GroupAction"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// Global imports
+
+// Local imports
+
+describe('components', function () {
+  describe('SummaryList.GroupAction', function () {
+    it('should handle a group row without an action', function () {
+      var ROW = {};
+      var _render = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_GroupAction.default, {
+          group: ROW
+        })),
+        container = _render.container;
+      expect(container.childNodes.length).toEqual(0);
+    });
+    it('should handle a row with an href in the action', function () {
+      var PAGE = 'alpha';
+      var ROW = {
+        action: {
+          page: PAGE,
+          label: 'Change'
+        }
+      };
+      var _render2 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_GroupAction.default, {
+          group: ROW
+        })),
+        container = _render2.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('href')).toEqual("/".concat(PAGE));
+      expect(link.textContent).toEqual(ROW.action.label);
+    });
+    it('should render an aria_suffix appropriately', function () {
+      var PAGE = 'alpha';
+      var ROW = {
+        action: {
+          page: PAGE,
+          label: 'Change',
+          aria_suffix: 'the thing'
+        }
+      };
+      var _render3 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_GroupAction.default, {
+          group: ROW
+        })),
+        container = _render3.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('href')).toEqual("/".concat(PAGE));
+      expect(link.textContent).toEqual("".concat(ROW.action.label, " ").concat(ROW.action.aria_suffix));
+    });
+    it('should handle a row with an onAction in the action', function () {
+      var ON_ACTION_CALLS = [];
+      var ON_ACTION = function ON_ACTION(row) {
+        ON_ACTION_CALLS.push(row);
+      };
+      var ROW = {
+        action: {
+          onAction: ON_ACTION,
+          label: 'Change'
+        }
+      };
+      var _render4 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_GroupAction.default, {
+          group: ROW
+        })),
+        container = _render4.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('onClick')).toBeDefined();
+      expect(link.textContent).toEqual(ROW.action.label);
+      _react.fireEvent.click(link, {});
+      expect(ON_ACTION_CALLS.length).toEqual(1);
+      expect(ON_ACTION_CALLS[0]).toEqual(ROW);
+    });
+  });
+});

package/dist/components/SummaryList/RowAction.js

@@ -15,8 +15,8 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 var RowAction = function RowAction(_ref) {
   var row = _ref.row;

package/dist/components/SummaryList/RowAction.test.js

@@ -0,0 +1,80 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+var _react2 = _interopRequireDefault(require("react"));
+var _RowAction = _interopRequireDefault(require("./RowAction"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// Global imports
+
+// Local imports
+
+describe('components', function () {
+  describe('SummaryList.RowAction', function () {
+    it('should handle a row without an action', function () {
+      var ROW = {};
+      var _render = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_RowAction.default, {
+          row: ROW
+        })),
+        container = _render.container;
+      expect(container.childNodes.length).toEqual(0);
+    });
+    it('should handle a row with an href in the action', function () {
+      var PAGE = 'alpha';
+      var ROW = {
+        action: {
+          page: PAGE,
+          label: 'Change'
+        }
+      };
+      var _render2 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_RowAction.default, {
+          row: ROW
+        })),
+        container = _render2.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('href')).toEqual("/".concat(PAGE));
+      expect(link.textContent).toEqual(ROW.action.label);
+    });
+    it('should render an aria_suffix appropriately', function () {
+      var PAGE = 'alpha';
+      var ROW = {
+        action: {
+          page: PAGE,
+          label: 'Change',
+          aria_suffix: 'the thing'
+        }
+      };
+      var _render3 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_RowAction.default, {
+          row: ROW
+        })),
+        container = _render3.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('href')).toEqual("/".concat(PAGE));
+      expect(link.textContent).toEqual("".concat(ROW.action.label, " ").concat(ROW.action.aria_suffix));
+    });
+    it('should handle a row with an onAction in the action', function () {
+      var ON_ACTION_CALLS = [];
+      var ON_ACTION = function ON_ACTION(row) {
+        ON_ACTION_CALLS.push(row);
+      };
+      var ROW = {
+        action: {
+          onAction: ON_ACTION,
+          label: 'Change'
+        }
+      };
+      var _render4 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_RowAction.default, {
+          row: ROW
+        })),
+        container = _render4.container;
+      var link = container.childNodes[0];
+      expect(link.tagName).toEqual('A');
+      expect(link.getAttribute('onClick')).toBeDefined();
+      expect(link.textContent).toEqual(ROW.action.label);
+      _react.fireEvent.click(link, {});
+      expect(ON_ACTION_CALLS.length).toEqual(1);
+      expect(ON_ACTION_CALLS[0]).toEqual(ROW);
+    });
+  });
+});

package/dist/components/SummaryList/SummaryList.js

@@ -9,9 +9,10 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 var _react = _interopRequireDefault(require("react"));
 var _GroupAction = _interopRequireDefault(require("./GroupAction"));
 var _SummaryListRow = _interopRequireDefault(require("./SummaryListRow"));
+var _SummaryListHeadingRow = _interopRequireDefault(require("./SummaryListHeadingRow"));
 var _SummaryListTitleRow = _interopRequireDefault(require("./SummaryListTitleRow"));
 require("./SummaryList.scss");
-var _excluded = ["rows", "noChangeAction", "isGroup", "classBlock", "classModifiers", "className"];
+var _excluded = ["rows", "noChangeAction", "noGroupAction", "isGroup", "classBlock", "classModifiers", "className"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
@@ -21,6 +22,7 @@ exports.DEFAULT_CLASS = DEFAULT_CLASS;
 var SummaryList = function SummaryList(_ref) {
   var rows = _ref.rows,
     noChangeAction = _ref.noChangeAction,
+    noGroupAction = _ref.noGroupAction,
     isGroup = _ref.isGroup,
     classBlock = _ref.classBlock,
     classModifiers = _ref.classModifiers,
@@ -32,7 +34,7 @@ var SummaryList = function SummaryList(_ref) {
     var rowActions = rows.filter(function (r) {
       return !!r.action;
     });
-    groupActionRow = rowActions.length > 0 ? rowActions[0] : null;
+    groupActionRow = rowActions !== null && rowActions !== void 0 && rowActions.length ? rowActions[0] : null;
   }
   return /*#__PURE__*/_react.default.createElement("div", {
     className: "group-of-rows"
@@ -47,8 +49,16 @@ var SummaryList = function SummaryList(_ref) {
         classes: classes
       });
     }
+    if (row.type === 'heading') {
+      return /*#__PURE__*/_react.default.createElement(_SummaryListHeadingRow.default, {
+        key: key,
+        title: row.key,
+        size: row.size || 's',
+        classes: classes
+      });
+    }
     if (row.type === 'action') {
-      return /*#__PURE__*/_react.default.createElement("div", {
+      return noChangeAction ? null : /*#__PURE__*/_react.default.createElement("div", {
         key: "".concat(key, "-actions")
       }, /*#__PURE__*/_react.default.createElement(_GroupAction.default, {
         group: row
@@ -60,35 +70,42 @@ var SummaryList = function SummaryList(_ref) {
       classes: classes,
       showAction: !noChangeAction
     });
-  }), isGroup && /*#__PURE__*/_react.default.createElement("div", {
+  }).filter(function (r) {
+    return !!r;
+  }), isGroup && !noGroupAction && /*#__PURE__*/_react.default.createElement("div", {
     className: "change-group-button"
   }, /*#__PURE__*/_react.default.createElement(_GroupAction.default, {
     group: groupActionRow
   }))));
 };
 SummaryList.propTypes = {
+  classBlock: _propTypes.default.string,
+  classModifiers: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
+  className: _propTypes.default.string,
+  isGroup: _propTypes.default.bool,
+  noChangeAction: _propTypes.default.bool,
+  noGroupAction: _propTypes.default.bool,
   rows: _propTypes.default.arrayOf(_propTypes.default.shape({
     pageId: _propTypes.default.string.isRequired,
     fieldId: _propTypes.default.string.isRequired,
     full_path: _propTypes.default.string,
     key: _propTypes.default.string.isRequired,
-    value: _propTypes.default.any,
+    value: _propTypes.default.node,
     action: _propTypes.default.shape({
       page: _propTypes.default.string,
       label: _propTypes.default.string,
       aria_suffix: _propTypes.default.string,
       onAction: _propTypes.default.func
     })
-  })).isRequired,
-  noChangeAction: _propTypes.default.bool,
-  isGroup: _propTypes.default.bool,
-  classBlock: _propTypes.default.string,
-  classModifiers: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
-  className: _propTypes.default.string
+  })).isRequired
 };
 SummaryList.defaultProps = {
   classBlock: DEFAULT_CLASS,
-  noChangeAction: false
+  classModifiers: [],
+  className: '',
+  isGroup: false,
+  noChangeAction: false,
+  noGroupAction: false
 };
 var _default = SummaryList;
 exports.default = _default;

package/dist/components/SummaryList/SummaryList.scss

@@ -14,6 +14,25 @@
   }
 }
 
+.govuk-summary-list__heading {
+  width: 100%;
+  white-space: nowrap;
+  .govuk-heading-s {
+    margin-bottom: 10px;
+  }
+  .govuk-heading-m {
+    margin-bottom: 10px;
+  }
+  &:not(:first-child) {
+    .govuk-heading-s {
+      margin-top: 20px;
+    }
+    .govuk-heading-m {
+      margin-top: 30px;
+    }
+  }
+}
+
 .changeRow {
   .govuk-link {
     float: right;

package/dist/components/SummaryList/SummaryList.stories.mdx

@@ -0,0 +1,90 @@
+<!-- Global imports -->
+
+import { ArgsTable, Canvas, Meta, Story } from '@storybook/addon-docs';
+import { Details, Heading } from '@ukhomeoffice/cop-react-components';
+
+<!-- Local imports -->
+
+import Utils from '../../utils';
+import SummaryList from './SummaryList';
+
+<Meta
+  title='Components/Summary list'
+  id='D-SummaryList'
+  component={SummaryList}
+/>
+
+<Heading size='xl' caption='Components'>
+  Summary list
+</Heading>
+
+Renders a list of key-value pairs, most commonly on the **Check your answers** screen, and optionally
+display action links.
+
+<Canvas withToolbar>
+  <Story name='Default'>
+    {() => {
+      const onAction = (row) => {
+        console.log('action clicked', row);
+      };
+      const ROWS = [
+        {
+          pageId: 'p1',
+          fieldId: 'forename',
+          key: 'Forename(s)',
+          value: 'John',
+        },
+        { pageId: 'p1', fieldId: 'surname', key: 'Surname', value: 'Smith' },
+        {
+          pageId: 'p2',
+          fieldId: 'dob',
+          key: 'Date of birth',
+          value: '29/08/1993',
+          action: { label: 'Change', onAction },
+        },
+      ];
+      return <SummaryList rows={ROWS} />;
+    }}
+  </Story>
+</Canvas>
+
+<Details summary='Properties' className='no-indent'>
+  <ArgsTable of={SummaryList} />
+</Details>
+
+## Variant
+
+### Read-only style
+
+<Canvas>
+  <Story name='Read-only style'>
+    {() => {
+      const onAction = (row) => {
+        console.log('action clicked', row);
+      };
+      const ROWS = [
+        {
+          pageId: 'p1',
+          fieldId: 'forename',
+          key: 'Forename(s)',
+          value: 'John',
+        },
+        { pageId: 'p1', fieldId: 'surname', key: 'Surname', value: 'Smith' },
+        {
+          pageId: 'p2',
+          fieldId: 'dob',
+          key: 'Date of birth',
+          value: '29/08/1993',
+          action: { label: 'Change', onAction },
+        },
+      ];
+      return (
+        <SummaryList
+          classModifiers='no-border'
+          rows={ROWS}
+          noChangeAction={true}
+        />
+      );
+    }}
+  </Story>
+</Canvas>