@ukhomeoffice/cop-react-form-renderer 0.1.0-beta → 1.0.0-delta

package/dist/components/FormRenderer/FormRenderer.stories.mdx

@@ -0,0 +1,90 @@
+<!-- Global imports -->
+import { ArgsTable, Canvas, Meta, Story } from '@storybook/addon-docs';
+import { Details, Heading, Link } from '@ukhomeoffice/cop-react-components';
+import withMock from 'storybook-addon-mock';
+
+<!-- Local imports -->
+import { addHook } from '../../hooks/useHooks';
+import FormRenderer from './FormRenderer';
+
+<!-- JSON documents -->
+import CIVIL_SERVANT from '../../json/areYouACivilServant.json';
+import GRADE from '../../json/grade.json';
+import TEAMS from '../../json/team.json';
+import USER_PROFILE_DATA from '../../json/userProfile.data.json';
+import USER_PROFILE from '../../json/userProfile.json';
+import SAVE_AND_CONTINUE from '../../json/saveAndContinue.json';
+
+<Meta title="Components/Form renderer" id="D-FormRenderer" component={ FormRenderer } decorators={[withMock]} />
+
+<Heading size="xl" caption="Components">Form renderer</Heading>
+
+Renders a form with <Link href="https://ukhomeoffice.github.io/cop-react-components/?path=/docs/d-alert--default-story">COP React components</Link>,
+on the basis of a <Link href="/?path=/docs/f-json-form">JSON</Link> that describes which elements are required.
+
+<Canvas withToolbar>
+  <Story name="Default" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.urls.refData}/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.urls.refData}/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.urls.refData}/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      return (
+        <FormRenderer {...USER_PROFILE} data={USER_PROFILE_DATA} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+<Details summary="Properties" className="no-indent">
+  <ArgsTable of={ FormRenderer } />
+</Details>
+
+## Custom hooks
+
+<Canvas>
+  <Story name="Save and continue">
+    {() => {
+      addHook('onRequest', (req) => {
+        // Do whatever you need to do to the request in here, such as adding an Authorization header.
+        console.log('onRequest hook called');
+        return req;
+      });
+      addHook('onFormLoad', () => {
+        console.log('onFormLoad called');
+      });
+      addHook('onPageChange', (pageId) => {
+        console.log('onPageChange called', pageId);
+      });
+      
+      /**
+       * In whatever consumes this, do it as:
+       *   intercepts.add('onSubmit', (...) => { ... })
+       */
+      addHook('onSubmit', (type, payload, onSuccess, onError) => {
+        console.log('onSubmit called of type', type, 'called, with the payload', payload);
+        onSuccess();
+      });
+      return (
+        <FormRenderer {...SAVE_AND_CONTINUE} data={{}} />
+      );
+    }}
+  </Story>
+</Canvas>

package/dist/components/FormRenderer/FormRenderer.test.js

@@ -0,0 +1,469 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
+var _axios = _interopRequireDefault(require("axios"));
+
+var _axiosMockAdapter = _interopRequireDefault(require("axios-mock-adapter"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _react2 = require("@testing-library/react");
+
+var _reactDom = require("react-dom");
+
+var _testUtils = require("react-dom/test-utils");
+
+var _areYouACivilServant = _interopRequireDefault(require("../../json/areYouACivilServant.json"));
+
+var _grade = _interopRequireDefault(require("../../json/grade.json"));
+
+var _team = _interopRequireDefault(require("../../json/team.json"));
+
+var _userProfileData = _interopRequireDefault(require("../../json/userProfile.data.json"));
+
+var _userProfile = _interopRequireDefault(require("../../json/userProfile.json"));
+
+var _FormRenderer = _interopRequireWildcard(require("./FormRenderer"));
+
+var _CheckYourAnswers = require("../CheckYourAnswers/CheckYourAnswers");
+
+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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function _extends() { _extends = Object.assign || 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 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); }); }; }
+
+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 _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+describe('components', function () {
+  describe('FormRenderer', function () {
+    var mockAxios = new _axiosMockAdapter.default(_axios.default);
+    var container = null;
+
+    var refDataUrl = function refDataUrl(suffix) {
+      return "".concat(_userProfileData.default.urls.refData, "/").concat(suffix);
+    };
+
+    beforeEach(function () {
+      container = document.createElement('div');
+      document.body.appendChild(container);
+      mockAxios.reset();
+      mockAxios.onGet(refDataUrl('areYouACivilServant')).reply(200, _areYouACivilServant.default);
+      mockAxios.onGet(refDataUrl('grade')).reply(200, _grade.default);
+      mockAxios.onGet(refDataUrl('team')).reply(200, _team.default);
+    });
+    afterEach(function () {
+      (0, _reactDom.unmountComponentAtNode)(container);
+      container.remove();
+      container = null;
+    });
+
+    var checkForm = function checkForm(container) {
+      var form = container.childNodes[0];
+      expect(form.tagName).toEqual('DIV');
+      expect(form.classList).toContain(_FormRenderer.DEFAULT_CLASS);
+      return form;
+    };
+
+    var getChangeLink = function getChangeLink(summaryList) {
+      var _summaryList$childNod = _slicedToArray(summaryList.childNodes[0].childNodes, 3),
+          actions = _summaryList$childNod[2];
+
+      return actions.childNodes[0];
+    };
+
+    var getContinueButton = function getContinueButton(page) {
+      return page.childNodes[page.childNodes.length - 1].childNodes[0].childNodes[0];
+    };
+
+    it('should start on the hub page correctly and display the title', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee2() {
+      var form, title, hub;
+      return regeneratorRuntime.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.next = 2;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
+                return regeneratorRuntime.wrap(function _callee$(_context) {
+                  while (1) {
+                    switch (_context.prev = _context.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context.stop();
+                    }
+                  }
+                }, _callee);
+              })));
+
+            case 2:
+              form = checkForm(container);
+              expect(form.childNodes.length).toEqual(2); // Title + Hub page (= CYA)
+
+              title = form.childNodes[0];
+              expect(title.tagName).toEqual('H1');
+              expect(title.textContent).toEqual(_userProfile.default.title);
+              hub = form.childNodes[1];
+              expect(hub.tagName).toEqual('DIV');
+              expect(hub.classList).toContain(_CheckYourAnswers.DEFAULT_CLASS);
+
+            case 10:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    })));
+    it('should fire the onFormLoad method passed in the hooks', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee4() {
+      var onFormLoadCalled, ON_FORM_LOAD, HOOKS;
+      return regeneratorRuntime.wrap(function _callee4$(_context4) {
+        while (1) {
+          switch (_context4.prev = _context4.next) {
+            case 0:
+              onFormLoadCalled = false;
+
+              ON_FORM_LOAD = function ON_FORM_LOAD() {
+                onFormLoadCalled = true;
+              };
+
+              HOOKS = {
+                onFormLoad: ON_FORM_LOAD
+              };
+              _context4.next = 5;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee3() {
+                return regeneratorRuntime.wrap(function _callee3$(_context3) {
+                  while (1) {
+                    switch (_context3.prev = _context3.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default,
+                          hooks: HOOKS
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context3.stop();
+                    }
+                  }
+                }, _callee3);
+              })));
+
+            case 5:
+              expect(onFormLoadCalled).toBeTruthy();
+
+            case 6:
+            case "end":
+              return _context4.stop();
+          }
+        }
+      }, _callee4);
+    })));
+    it('should navigate to the first editable page', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee6() {
+      var ON_PAGE_CHANGE_CALLS, ON_PAGE_CHANGE, HOOKS, form, hub, _hub$childNodes, civilServantList, link, page, pageHeading;
+
+      return regeneratorRuntime.wrap(function _callee6$(_context6) {
+        while (1) {
+          switch (_context6.prev = _context6.next) {
+            case 0:
+              ON_PAGE_CHANGE_CALLS = [];
+
+              ON_PAGE_CHANGE = function ON_PAGE_CHANGE(pageId) {
+                ON_PAGE_CHANGE_CALLS.push(pageId);
+              };
+
+              HOOKS = {
+                onPageChange: ON_PAGE_CHANGE
+              };
+              _context6.next = 5;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee5() {
+                return regeneratorRuntime.wrap(function _callee5$(_context5) {
+                  while (1) {
+                    switch (_context5.prev = _context5.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default,
+                          hooks: HOOKS
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context5.stop();
+                    }
+                  }
+                }, _callee5);
+              })));
+
+            case 5:
+              form = checkForm(container);
+              hub = form.childNodes[1]; // Hub = CYA
+
+              _hub$childNodes = _slicedToArray(hub.childNodes, 3), civilServantList = _hub$childNodes[2];
+              link = getChangeLink(civilServantList);
+              expect(ON_PAGE_CHANGE_CALLS.length).toEqual(0);
+
+              _react2.fireEvent.click(link, {});
+
+              expect(ON_PAGE_CHANGE_CALLS.length).toEqual(1);
+              expect(ON_PAGE_CHANGE_CALLS[0]).toEqual(_userProfile.default.pages[1].id); // The form layout should have changed to the current page.
+
+              expect(form.childNodes.length).toEqual(1); // Just the page.
+
+              page = form.childNodes[0];
+              pageHeading = page.childNodes[0];
+              expect(pageHeading.tagName).toEqual('H1');
+              expect(pageHeading.textContent).toEqual(_userProfile.default.pages[1].title);
+
+            case 18:
+            case "end":
+              return _context6.stop();
+          }
+        }
+      }, _callee6);
+    })));
+    it('should handle a page submission', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee8() {
+      var ON_SUBMIT_CALLS, ON_SUBMIT, HOOKS, form, hub, _hub$childNodes2, civilServantList, link, page, continueButton, title;
+
+      return regeneratorRuntime.wrap(function _callee8$(_context8) {
+        while (1) {
+          switch (_context8.prev = _context8.next) {
+            case 0:
+              ON_SUBMIT_CALLS = [];
+
+              ON_SUBMIT = function ON_SUBMIT(type, payload, onSuccess, onError) {
+                ON_SUBMIT_CALLS.push({
+                  type: type,
+                  payload: payload,
+                  onSuccess: onSuccess,
+                  onError: onError
+                });
+                onSuccess();
+              };
+
+              HOOKS = {
+                onSubmit: ON_SUBMIT
+              };
+              _context8.next = 5;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee7() {
+                return regeneratorRuntime.wrap(function _callee7$(_context7) {
+                  while (1) {
+                    switch (_context7.prev = _context7.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default,
+                          hooks: HOOKS
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context7.stop();
+                    }
+                  }
+                }, _callee7);
+              })));
+
+            case 5:
+              form = checkForm(container); // Navigate to the "Are you a civil servant?" page.
+
+              hub = form.childNodes[1]; // Hub = CYA
+
+              _hub$childNodes2 = _slicedToArray(hub.childNodes, 3), civilServantList = _hub$childNodes2[2];
+              link = getChangeLink(civilServantList);
+
+              _react2.fireEvent.click(link, {}); // Should already be answered "Yes", so simply click "Continue".
+
+
+              page = form.childNodes[0];
+              continueButton = getContinueButton(page);
+              expect(ON_SUBMIT_CALLS.length).toEqual(0);
+
+              _react2.fireEvent.click(continueButton, {});
+
+              expect(ON_SUBMIT_CALLS.length).toEqual(1);
+              expect(ON_SUBMIT_CALLS[0].type).toEqual('submit');
+              expect(ON_SUBMIT_CALLS[0].payload.areYouACivilServant).toEqual('yes'); // And we should be back on the hub.
+
+              expect(form.childNodes.length).toEqual(2); // Title + Hub page (= CYA)
+
+              title = form.childNodes[0];
+              expect(title.tagName).toEqual('H1');
+              expect(title.textContent).toEqual(_userProfile.default.title);
+
+            case 21:
+            case "end":
+              return _context8.stop();
+          }
+        }
+      }, _callee8);
+    })));
+    it('should handle a page submission error', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee10() {
+      var ON_SUBMIT_CALLS, ON_SUBMIT, HOOKS, form, hub, _hub$childNodes3, civilServantList, link, page, continueButton, pageHeading;
+
+      return regeneratorRuntime.wrap(function _callee10$(_context10) {
+        while (1) {
+          switch (_context10.prev = _context10.next) {
+            case 0:
+              ON_SUBMIT_CALLS = [];
+
+              ON_SUBMIT = function ON_SUBMIT(type, payload, onSuccess, onError) {
+                ON_SUBMIT_CALLS.push({
+                  type: type,
+                  payload: payload,
+                  onSuccess: onSuccess,
+                  onError: onError
+                });
+                onError([{
+                  id: 'unknown',
+                  error: 'Something went wrong'
+                }]);
+              };
+
+              HOOKS = {
+                onSubmit: ON_SUBMIT
+              };
+              _context10.next = 5;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee9() {
+                return regeneratorRuntime.wrap(function _callee9$(_context9) {
+                  while (1) {
+                    switch (_context9.prev = _context9.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default,
+                          hooks: HOOKS
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context9.stop();
+                    }
+                  }
+                }, _callee9);
+              })));
+
+            case 5:
+              form = checkForm(container); // Navigate to the "Are you a civil servant?" page.
+
+              hub = form.childNodes[1]; // Hub = CYA
+
+              _hub$childNodes3 = _slicedToArray(hub.childNodes, 3), civilServantList = _hub$childNodes3[2];
+              link = getChangeLink(civilServantList);
+
+              _react2.fireEvent.click(link, {}); // Should already be answered "Yes", so simply click "Continue".
+
+
+              page = form.childNodes[0];
+              continueButton = getContinueButton(page);
+              expect(ON_SUBMIT_CALLS.length).toEqual(0);
+
+              _react2.fireEvent.click(continueButton, {});
+
+              expect(ON_SUBMIT_CALLS.length).toEqual(1);
+              expect(ON_SUBMIT_CALLS[0].type).toEqual('submit');
+              expect(ON_SUBMIT_CALLS[0].payload.areYouACivilServant).toEqual('yes'); // And we should be kept on the same page.
+
+              expect(form.childNodes.length).toEqual(1); // Just the page.
+
+              pageHeading = form.childNodes[0].childNodes[0];
+              expect(pageHeading.tagName).toEqual('H1');
+              expect(pageHeading.textContent).toEqual(_userProfile.default.pages[1].title);
+
+            case 21:
+            case "end":
+              return _context10.stop();
+          }
+        }
+      }, _callee10);
+    })));
+    it('should handle page navigation', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee12() {
+      var ON_PAGE_CHANGE_CALLS, ON_PAGE_CHANGE, HOOKS, form, hub, _hub$childNodes4, lineManagerList, link, page, pageHeading, continueButton, newPageHeading;
+
+      return regeneratorRuntime.wrap(function _callee12$(_context12) {
+        while (1) {
+          switch (_context12.prev = _context12.next) {
+            case 0:
+              ON_PAGE_CHANGE_CALLS = [];
+
+              ON_PAGE_CHANGE = function ON_PAGE_CHANGE(pageId) {
+                ON_PAGE_CHANGE_CALLS.push(pageId);
+              };
+
+              HOOKS = {
+                onPageChange: ON_PAGE_CHANGE
+              };
+              _context12.next = 5;
+              return (0, _testUtils.act)( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee11() {
+                return regeneratorRuntime.wrap(function _callee11$(_context11) {
+                  while (1) {
+                    switch (_context11.prev = _context11.next) {
+                      case 0:
+                        (0, _reactDom.render)( /*#__PURE__*/_react.default.createElement(_FormRenderer.default, _extends({}, _userProfile.default, {
+                          data: _userProfileData.default,
+                          hooks: HOOKS
+                        })), container);
+
+                      case 1:
+                      case "end":
+                        return _context11.stop();
+                    }
+                  }
+                }, _callee11);
+              })));
+
+            case 5:
+              form = checkForm(container); // Navigate to the "Add or change a line manager" page.
+
+              hub = form.childNodes[1]; // Hub = CYA
+
+              _hub$childNodes4 = _slicedToArray(hub.childNodes, 6), lineManagerList = _hub$childNodes4[5];
+              link = getChangeLink(lineManagerList);
+              expect(ON_PAGE_CHANGE_CALLS.length).toEqual(0);
+
+              _react2.fireEvent.click(link, {});
+
+              expect(ON_PAGE_CHANGE_CALLS[0]).toEqual(_userProfile.default.pages[4].id); // Should be on the page explaining what changing the line manager means.
+
+              page = form.childNodes[0];
+              pageHeading = page.childNodes[0];
+              expect(pageHeading.tagName).toEqual('H1');
+              expect(pageHeading.textContent).toEqual(_userProfile.default.pages[4].title); // Now click on the "Continue" button on here.
+
+              continueButton = getContinueButton(page);
+              expect(ON_PAGE_CHANGE_CALLS.length).toEqual(1);
+
+              _react2.fireEvent.click(continueButton, {});
+
+              expect(ON_PAGE_CHANGE_CALLS.length).toEqual(2);
+              expect(ON_PAGE_CHANGE_CALLS[1]).toEqual(_userProfile.default.pages[5].id);
+              newPageHeading = form.childNodes[0].childNodes[0];
+              expect(newPageHeading.tagName).toEqual('H1');
+              expect(newPageHeading.textContent).toEqual(_userProfile.default.pages[5].title);
+
+            case 24:
+            case "end":
+              return _context12.stop();
+          }
+        }
+      }, _callee12);
+    })));
+  });
+});

package/dist/components/FormRenderer/handlers/cyaAction.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _getPageId = _interopRequireDefault(require("./getPageId"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Gets the pageId from the invoked CYA action and calls onChange if it is
+ * different to the currentPageId.
+ * @param {object} page The page on which the CYA action was invoked.
+ * @param {string} currentPageId The current pageId.
+ * @param {Function} onChange The handler to call if the pageId is different to the currentPageId.
+ */
+var cyaAction = function cyaAction(page, currentPageId, onChange) {
+  var pageId = (0, _getPageId.default)(page.action, page.pageId);
+
+  if (pageId !== currentPageId) {
+    onChange(pageId);
+  }
+};
+
+var _default = cyaAction;
+exports.default = _default;

package/dist/components/FormRenderer/handlers/getPageId.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+/**
+ * Gets the pageId from the invoked CYA action.
+ * @param {object} action The invoked action.
+ * @param {string} pageId The id of the page on which the action was invoked.
+ * @returns A page id.
+ */
+var getPageId = function getPageId(action, pageId) {
+  if (action) {
+    // TODO: Improve how this is handled.
+    if (action.href) {
+      return action.href.split('/').pop();
+    } else if (action.url) {
+      return action.url.split('/').pop();
+    }
+  }
+
+  return pageId;
+};
+
+var _default = getPageId;
+exports.default = _default;

package/dist/components/FormRenderer/handlers/getPageId.test.js

@@ -0,0 +1,61 @@
+"use strict";
+
+var _getPageId = _interopRequireDefault(require("./getPageId"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Local imports
+describe('components', function () {
+  describe('FormRenderer', function () {
+    describe('handlers', function () {
+      describe('getPageId', function () {
+        it('should return the pageId when the action is null', function () {
+          var PAGE_ID = 'alpha';
+          var ACTION = null;
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(PAGE_ID);
+        });
+        it('should return the pageId when the action contains no href or url', function () {
+          var PAGE_ID = 'alpha';
+          var ACTION = {
+            id: 'bravo'
+          };
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(PAGE_ID);
+        });
+        it('should return the final part of the href when provided', function () {
+          var LAST_PART = 'delta';
+          var HREF = "/bravo/charlie/".concat(LAST_PART);
+          var PAGE_ID = 'alpha';
+          var ACTION = {
+            href: HREF
+          };
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(LAST_PART);
+        });
+        it('should return the final part of the url when provided', function () {
+          var LAST_PART = 'delta';
+          var URL = "/bravo/charlie/".concat(LAST_PART);
+          var PAGE_ID = 'alpha';
+          var ACTION = {
+            url: URL
+          };
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(LAST_PART);
+        });
+        it('should return the whole href when it contains no backslashes', function () {
+          var HREF = 'delta';
+          var PAGE_ID = 'alpha';
+          var ACTION = {
+            href: HREF
+          };
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(HREF);
+        });
+        it('should return the whole url when it contains no backslashes', function () {
+          var URL = 'delta';
+          var PAGE_ID = 'alpha';
+          var ACTION = {
+            url: URL
+          };
+          expect((0, _getPageId.default)(ACTION, PAGE_ID)).toEqual(URL);
+        });
+      });
+    });
+  });
+});