@ukhomeoffice/cop-react-form-renderer 0.1.0-beta → 0.1.0-gamma

package/dist/components/CheckYourAnswers/Answer.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _FormComponent = _interopRequireDefault(require("../FormComponent"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (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 = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+var Answer = function Answer(_ref) {
+  var value = _ref.value,
+      component = _ref.component;
+
+  if (!value) {
+    return null;
+  }
+
+  if (!component) {
+    return value;
+  }
+
+  return /*#__PURE__*/_react.default.createElement(_FormComponent.default, {
+    component: _objectSpread(_objectSpread({}, component), {}, {
+      readonly: true
+    }),
+    wrap: false,
+    value: value
+  });
+};
+
+Answer.propTypes = {
+  value: _propTypes.default.any,
+  component: _propTypes.default.object
+};
+var _default = Answer;
+exports.default = _default;

package/dist/components/CheckYourAnswers/CheckYourAnswers.js

@@ -7,27 +7,32 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = exports.DEFAULT_MARGIN_BOTTOM = void 0;
 
-var _react = _interopRequireWildcard(require("react"));
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
-var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+var _react = _interopRequireWildcard(require("react"));
+
+var _utils = _interopRequireDefault(require("../../utils"));
 
 var _SummaryList = _interopRequireDefault(require("../SummaryList"));
 
-var _utils = _interopRequireDefault(require("../../utils"));
+var _Answer = _interopRequireDefault(require("./Answer"));
 
 require("./CheckYourAnswers.scss");
 
-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; }
 
-// Global imports
-// Local imports
-// Styles
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (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 = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
 var DEFAULT_MARGIN_BOTTOM = 9;
 exports.DEFAULT_MARGIN_BOTTOM = DEFAULT_MARGIN_BOTTOM;
 
@@ -42,12 +47,26 @@ var CheckYourAnswers = function CheckYourAnswers(_ref) {
     return index === pages.length - 1;
   };
 
+  var getRows = function getRows(page, index) {
+    var rows = _utils.default.CheckYourAnswers.getRows(page, onAction);
+
+    return rows.map(function (row) {
+      return _objectSpread(_objectSpread({}, row), {}, {
+        value: /*#__PURE__*/_react.default.createElement(_Answer.default, {
+          key: index,
+          value: row.value,
+          component: row.component
+        })
+      });
+    });
+  };
+
   return /*#__PURE__*/_react.default.createElement("div", {
     className: "hods-check-your-answers"
   }, title && /*#__PURE__*/_react.default.createElement(_copReactComponents.LargeHeading, {
     key: "heading"
   }, title), pages && pages.map(function (page, pageIndex) {
-    var rows = _utils.default.CheckYourAnswers.getRows(page, onAction);
+    var rows = getRows(page, pageIndex);
 
     if (rows.length === 0) {
       return null;

package/dist/components/CheckYourAnswers/CheckYourAnswers.stories.mdx

@@ -0,0 +1,23 @@
+<!-- Global imports -->
+import { ArgsTable, Canvas, Meta, Story } from '@storybook/addon-docs';
+import { Details, Heading, Link, Tag } from '@ukhomeoffice/cop-react-components';
+import withMock from 'storybook-addon-mock';
+
+<!-- Local imports -->
+import Utils from '../../utils';
+import CheckYourAnswers from './CheckYourAnswers';
+
+<!-- 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';
+
+<Meta title="Components/Check your answers" id="D-CheckYourAnswers" component={ CheckYourAnswers } decorators={[withMock]} />
+
+<Heading size="xl" caption="Components">Check your answers</Heading>
+
+Renders the **Check your answers** screen for a form.
+
+<Tag>To do</Tag>

package/dist/components/FormComponent/FormComponent.js

@@ -15,7 +15,7 @@ var _useRefData2 = _interopRequireWildcard(require("../../hooks/useRefData"));
 
 var _utils = _interopRequireDefault(require("../../utils"));
 
-var _excluded = ["component", "value", "noWrap", "onChange"];
+var _excluded = ["component", "value", "wrap", "onChange"];
 
 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); }
 
@@ -48,7 +48,7 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
 var FormComponent = function FormComponent(_ref) {
   var component = _ref.component,
       value = _ref.value,
-      noWrap = _ref.noWrap,
+      wrap = _ref.wrap,
       onChange = _ref.onChange,
       attrs = _objectWithoutProperties(_ref, _excluded);
 
@@ -70,9 +70,9 @@ var FormComponent = function FormComponent(_ref) {
     label: component.label || '',
     hint: component.hint || '',
     options: options,
-    value: value,
+    value: value || '',
     onChange: onChange
-  }), noWrap);
+  }), wrap);
 };
 
 FormComponent.propTypes = {
@@ -84,12 +84,12 @@ FormComponent.propTypes = {
       url: _propTypes.default.string
     })
   }).isRequired,
-  value: _propTypes.default.any.isRequired,
-  noWrap: _propTypes.default.bool,
+  value: _propTypes.default.any,
+  wrap: _propTypes.default.bool,
   onChange: _propTypes.default.func
 };
 FormComponent.defaultProps = {
-  noWrap: false
+  wrap: true
 };
 var _default = FormComponent;
 exports.default = _default;

package/dist/components/FormComponent/FormComponent.stories.mdx

@@ -0,0 +1,167 @@
+<!-- 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 FormComponent from './FormComponent';
+
+<!-- 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';
+
+<Meta title="Components/Form component" id="D-FormComponent" component={ FormComponent } decorators={[withMock]} />
+
+<Heading size="xl" caption="Components">Form component</Heading>
+
+Renders a single component on 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-component">JSON</Link> configuration.
+
+<Canvas withToolbar>
+  <Story name="Default" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      const COMPONENT = {
+        ...USER_PROFILE.components.find(c => c.id === 'areYouACivilServant'),
+        data: {
+          url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`
+        }
+      };
+      const ON_CHANGE = ({ target }) => {
+        // Do something with the target here.
+      };
+      return (
+        <FormComponent component={COMPONENT} value={''} onChange={ON_CHANGE} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+<Details summary="Properties" className="no-indent">
+  <ArgsTable of={ FormComponent } />
+</Details>
+
+
+## Variants
+### `autocomplete`
+<Canvas>
+  <Story name="Autocomplete" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      const COMPONENT = {
+        ...USER_PROFILE.components.find(c => c.id === 'team'),
+        data: {
+          url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`
+        }
+      };
+      const ON_CHANGE = ({ target }) => {
+        // Do something with the target here.
+      };
+      return (
+        <FormComponent component={COMPONENT} value={''} onChange={ON_CHANGE} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+### `html`
+
+<Canvas>
+  <Story name="HTML">
+    {() => {
+      const COMPONENT = { type: 'html', tagName: 'p', content: 'A paragraph of text to render' };
+      const ON_CHANGE = ({ target }) => {
+        // Do something with the target here.
+      };
+      return (
+        <FormComponent component={COMPONENT} value={''} onChange={ON_CHANGE} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+### Unwrapped `autocomplete`
+<Canvas>
+  <Story name="Unwrapped autocomplete" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      const COMPONENT = {
+        ...USER_PROFILE.components.find(c => c.id === 'team'),
+        id: 'team2',
+        fieldId: 'team2',
+        data: {
+          url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`
+        }
+      };
+      const ON_CHANGE = ({ target }) => {
+        // Do something with the target here.
+      };
+      return (
+        <FormComponent component={COMPONENT} value={''} wrap={false} onChange={ON_CHANGE} />
+      );
+    }}
+  </Story>
+</Canvas>

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

@@ -0,0 +1,137 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+
+var _react2 = _interopRequireDefault(require("react"));
+
+var _FormComponent = _interopRequireDefault(require("./FormComponent"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+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('FormComponent', function () {
+    it('should render a text component appropriately', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
+      var ID, VALUE, COMPONENT, ON_CHANGE, _render, container, formGroup, label, hint, input;
+
+      return regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              ID = 'component';
+              VALUE = 'Text value';
+              COMPONENT = {
+                id: ID,
+                fieldId: ID,
+                type: 'text',
+                label: 'Text component',
+                hint: 'Text hint'
+              };
+
+              ON_CHANGE = function ON_CHANGE() {};
+
+              _render = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_FormComponent.default, {
+                "data-testid": ID,
+                component: COMPONENT,
+                value: VALUE,
+                onChange: ON_CHANGE
+              })), container = _render.container; // text components are wrapper in a FormGroup by default.
+
+              formGroup = container.childNodes[0];
+              expect(formGroup.tagName).toEqual('DIV');
+              expect(formGroup.classList).toContain('govuk-form-group');
+              label = formGroup.childNodes[0];
+              expect(label.tagName).toEqual('LABEL');
+              expect(label.classList).toContain('govuk-label');
+              expect(label.textContent).toEqual("".concat(COMPONENT.label, " (optional)"));
+              expect(label.getAttribute('for')).toEqual(ID);
+              hint = formGroup.childNodes[1];
+              expect(hint.tagName).toEqual('SPAN');
+              expect(hint.classList).toContain('govuk-hint');
+              expect(hint.textContent).toEqual(COMPONENT.hint);
+              input = formGroup.childNodes[2];
+              expect(input.tagName).toEqual('INPUT');
+              expect(input.classList).toContain('govuk-input');
+              expect(input.id).toEqual(ID);
+              expect(input.value).toEqual(VALUE);
+
+            case 22:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    })));
+    it('should render a text component appropriately with wrap turned off', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee2() {
+      var ID, VALUE, COMPONENT, ON_CHANGE, _render2, container, input;
+
+      return regeneratorRuntime.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              ID = 'component';
+              VALUE = 'Text value';
+              COMPONENT = {
+                id: ID,
+                fieldId: ID,
+                type: 'text',
+                label: 'Text component',
+                hint: 'Text hint'
+              };
+
+              ON_CHANGE = function ON_CHANGE() {};
+
+              _render2 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_FormComponent.default, {
+                "data-testid": ID,
+                component: COMPONENT,
+                wrap: false,
+                value: VALUE,
+                onChange: ON_CHANGE
+              })), container = _render2.container; // With wrap = false, there should be no form group.
+
+              input = container.childNodes[0];
+              expect(input.tagName).toEqual('INPUT');
+              expect(input.classList).toContain('govuk-input');
+              expect(input.id).toEqual(ID);
+              expect(input.value).toEqual(VALUE);
+
+            case 10:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    })));
+    it('should render an html component appropriately', /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee3() {
+      var ID, COMPONENT, _render3, container, p;
+
+      return regeneratorRuntime.wrap(function _callee3$(_context3) {
+        while (1) {
+          switch (_context3.prev = _context3.next) {
+            case 0:
+              ID = 'component';
+              COMPONENT = {
+                type: 'html',
+                tagName: 'p',
+                content: 'HTML content'
+              };
+              _render3 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_FormComponent.default, {
+                "data-testid": ID,
+                component: COMPONENT
+              })), container = _render3.container;
+              p = container.childNodes[0];
+              expect(p.tagName).toEqual('P');
+              expect(p.textContent).toEqual(COMPONENT.content);
+
+            case 6:
+            case "end":
+              return _context3.stop();
+          }
+        }
+      }, _callee3);
+    })));
+  });
+});

package/dist/components/FormPage/FormPage.js

@@ -5,28 +5,28 @@ function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "functi
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.default = exports.DEFAULT_CLASS = void 0;
 
-var _react = _interopRequireWildcard(require("react"));
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
 
-var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+var _react = _interopRequireWildcard(require("react"));
+
+var _utils = _interopRequireDefault(require("../../utils"));
 
 var _FormComponent = _interopRequireDefault(require("../FormComponent"));
 
 var _PageActions = _interopRequireDefault(require("../PageActions"));
 
-var _utils = _interopRequireDefault(require("../../utils"));
-
 require("./FormPage.scss");
 
-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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (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 = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
@@ -46,6 +46,7 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 var DEFAULT_CLASS = 'hods-form';
+exports.DEFAULT_CLASS = DEFAULT_CLASS;
 
 var FormPage = function FormPage(_ref) {
   var page = _ref.page,
@@ -89,10 +90,10 @@ var FormPage = function FormPage(_ref) {
     return /*#__PURE__*/_react.default.createElement(_FormComponent.default, {
       key: index,
       component: component,
-      value: page.formData[component.fieldId] || '',
-      onChange: onPageChange
+      onChange: onPageChange,
+      value: page.formData[component.fieldId] || ''
     });
-  }), page.actions && /*#__PURE__*/_react.default.createElement(_PageActions.default, {
+  }), /*#__PURE__*/_react.default.createElement(_PageActions.default, {
     actions: page.actions,
     onAction: function onAction(action) {
       return _onAction(action, patch, setErrors);
@@ -106,7 +107,7 @@ FormPage.propTypes = {
     title: _propTypes.default.string,
     components: _propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.object])).isRequired,
     actions: _propTypes.default.array,
-    formData: _propTypes.default.object
+    formData: _propTypes.default.object.isRequired
   }).isRequired,
   onAction: _propTypes.default.func.isRequired,
   classBlock: _propTypes.default.string,

package/dist/components/FormPage/FormPage.stories.mdx

@@ -0,0 +1,118 @@
+<!-- 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 Utils from '../../utils';
+import FormPage from './FormPage';
+
+<!-- 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';
+
+<Meta title="Components/Form page" id="D-FormPage" component={ FormPage } decorators={[withMock]} />
+
+<Heading size="xl" caption="Components">Form page</Heading>
+
+Renders a page on 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-page">JSON</Link> configuration.
+
+<Canvas withToolbar>
+  <Story name="Default" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      const PAGE_JSON = USER_PROFILE.pages.find(p => p.id === 'civil-servant-status');
+      const PAGE = Utils.FormPage.get(PAGE_JSON, USER_PROFILE.components, { ...USER_PROFILE_DATA });
+      const ON_ACTION = (action, patch, onError) => {
+        console.log('action invoked', action, patch);
+      };
+      return (
+        <FormPage page={PAGE} onAction={ON_ACTION} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+<Details summary="Properties" className="no-indent">
+  <ArgsTable of={ FormPage } />
+</Details>
+
+
+## Variants
+### With `autocomplete`
+<Canvas>
+  <Story name="With autocomplete" parameters={{
+    mockData: [
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/areYouACivilServant`,
+        method: 'GET',
+        status: 200,
+        response: CIVIL_SERVANT
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v2/entities/grade`,
+        method: 'GET',
+        status: 200,
+        response: GRADE
+      },
+      {
+        url: `${USER_PROFILE_DATA.environmentContext.referenceDataUrl}/v1/entities/team`,
+        method: 'GET',
+        status: 200,
+        response: TEAMS
+      }
+    ]
+  }}>
+    {() => {
+      const PAGE_JSON = USER_PROFILE.pages.find(p => p.id === 'team-name');
+      const PAGE = Utils.FormPage.get(PAGE_JSON, USER_PROFILE.components, { ...USER_PROFILE_DATA });
+      const ON_ACTION = (action, patch, onError) => {
+        console.log('action invoked', action, patch);
+      };
+      return (
+        <FormPage page={PAGE} onAction={ON_ACTION} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+### Without editable controls
+
+<Canvas>
+  <Story name="Without editable controls">
+    {() => {
+      const PAGE_JSON = USER_PROFILE.pages.find(p => p.id === 'add-or-change-line-manager');
+      const PAGE = Utils.FormPage.get(PAGE_JSON, USER_PROFILE.components, { ...USER_PROFILE_DATA });
+      const ON_ACTION = (action, patch, onError) => {
+        console.log('action invoked', action, patch);
+      };
+      return (
+        <FormPage page={PAGE} onAction={ON_ACTION} />
+      );
+    }}
+  </Story>
+</Canvas>