@ukhomeoffice/cop-react-form-renderer 2.1.0 → 2.6.0

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

@@ -0,0 +1,122 @@
+"use strict";
+
+var _getUpdatedSectionStates = _interopRequireDefault(require("./getUpdatedSectionStates"));
+
+var _models = require("../../../models");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Local imports
+describe('components', function () {
+  describe('FormRenderer', function () {
+    describe('helpers', function () {
+      describe('getUpdatedSectionStates', function () {
+        it("should set all tasks to '".concat(_models.TaskStates.TYPES.CANNOT_START_YET, "' excluding the first which should be '").concat(_models.TaskStates.TYPES.NOT_STARTED, "'"), function () {
+          var SECTIONS = [{
+            name: 'Add event details',
+            tasks: [{
+              name: 'Date, location and mode details',
+              pages: ['eventDate', 'eventMode']
+            }, {
+              name: 'Officer and agency details',
+              pages: ['officeDetails']
+            }]
+          }, {
+            name: 'Add people details',
+            tasks: [{
+              name: 'People details',
+              pages: ['firstName', 'surname']
+            }, {
+              name: 'Immigration details',
+              pages: ['immigrationDate']
+            }, {
+              name: 'Journey details',
+              pages: ['journeyDetails']
+            }]
+          }];
+          var updatedSections = (0, _getUpdatedSectionStates.default)(SECTIONS, {});
+          expect(updatedSections[0][0].state).toEqual(_models.TaskStates.TYPES.NOT_STARTED);
+          expect(updatedSections[0][1].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+          expect(updatedSections[1][0].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+          expect(updatedSections[1][1].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+          expect(updatedSections[1][2].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+        });
+        it("should set tasks after any '".concat(_models.TaskStates.TYPES.COMPLETE, "' ones to '").concat(_models.TaskStates.TYPES.NOT_STARTED, "'"), function () {
+          var SECTIONS = [{
+            name: 'Add event details',
+            tasks: [{
+              name: 'Date, location and mode details',
+              pages: ['eventDate', 'eventMode']
+            }, {
+              name: 'Officer and agency details',
+              pages: ['officeDetails']
+            }]
+          }];
+          var TASKS = {
+            'Date, location and mode details': {
+              complete: true
+            }
+          };
+          var updatedSections = (0, _getUpdatedSectionStates.default)(SECTIONS, TASKS);
+          expect(updatedSections[0][0].state).toEqual(_models.TaskStates.TYPES.COMPLETE);
+          expect(updatedSections[0][1].state).toEqual(_models.TaskStates.TYPES.NOT_STARTED);
+        });
+        it("should set tasks after any '".concat(_models.TaskStates.TYPES.COMPLETE, "' ones to '").concat(_models.TaskStates.TYPES.NOT_STARTED, " across different sections'"), function () {
+          var SECTIONS = [{
+            name: 'Add event details',
+            tasks: [{
+              name: 'Date, location and mode details',
+              pages: ['eventDate', 'eventMode']
+            }, {
+              name: 'Officer and agency details',
+              pages: ['officeDetails']
+            }]
+          }, {
+            name: 'Add people details',
+            tasks: [{
+              name: 'People details',
+              pages: ['firstName', 'surname']
+            }, {
+              name: 'Immigration details',
+              pages: ['immigrationDate']
+            }]
+          }];
+          var TASKS = {
+            'Date, location and mode details': {
+              complete: true
+            },
+            'Officer and agency details': {
+              complete: true
+            }
+          };
+          var updatedSections = (0, _getUpdatedSectionStates.default)(SECTIONS, TASKS);
+          expect(updatedSections[0][0].state).toEqual(_models.TaskStates.TYPES.COMPLETE);
+          expect(updatedSections[0][1].state).toEqual(_models.TaskStates.TYPES.COMPLETE);
+          expect(updatedSections[1][0].state).toEqual(_models.TaskStates.TYPES.NOT_STARTED);
+          expect(updatedSections[1][1].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+        });
+        it("should set tasks to '".concat(_models.TaskStates.TYPES.IN_PROGRESS, "' if they have a current page but are not complete"), function () {
+          var SECTIONS = [{
+            name: 'Add event details',
+            tasks: [{
+              name: 'Date, location and mode details',
+              pages: ['eventDate', 'eventMode']
+            }, {
+              name: 'Officer and agency details',
+              pages: ['officeDetails']
+            }]
+          }];
+          var TASKS = {
+            'Date, location and mode details': {
+              complete: false,
+              currentPage: 'eventMode'
+            }
+          };
+          var updatedSections = (0, _getUpdatedSectionStates.default)(SECTIONS, TASKS);
+          expect(updatedSections[0][0].state).toEqual(_models.TaskStates.TYPES.IN_PROGRESS);
+          expect(updatedSections[0][1].state).toEqual(_models.TaskStates.TYPES.CANNOT_START_YET);
+        });
+      });
+    });
+  });
+});

package/dist/components/FormRenderer/helpers/index.js

@@ -13,8 +13,12 @@ var _getFormState = _interopRequireDefault(require("./getFormState"));
 
 var _getNextPageId = _interopRequireDefault(require("./getNextPageId"));
 
+var _getPage = _interopRequireDefault(require("./getPage"));
+
 var _getSubmissionStatus = _interopRequireDefault(require("./getSubmissionStatus"));
 
+var _getUpdatedSectionStates = _interopRequireDefault(require("./getUpdatedSectionStates"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 // Local imports
@@ -23,7 +27,9 @@ var helpers = {
   canCYASubmit: _canCYASubmit.default,
   getFormState: _getFormState.default,
   getNextPageId: _getNextPageId.default,
-  getSubmissionStatus: _getSubmissionStatus.default
+  getPage: _getPage.default,
+  getSubmissionStatus: _getSubmissionStatus.default,
+  getUpdatedSectionStates: _getUpdatedSectionStates.default
 };
 exports.helpers = helpers;
 var _default = helpers;

package/dist/components/TaskList/Task.js

@@ -0,0 +1,83 @@
+"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); }
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.DEFAULT_CLASS = void 0;
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+
+var _models = require("../../models");
+
+var _TaskState = _interopRequireDefault(require("./TaskState"));
+
+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 _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; }
+
+var DEFAULT_CLASS = 'hods-task-list';
+exports.DEFAULT_CLASS = DEFAULT_CLASS;
+
+var Task = function Task(_ref) {
+  var task = _ref.task,
+      _onClick = _ref.onClick;
+
+  var classes = _copReactComponents.Utils.classBuilder(DEFAULT_CLASS, undefined, undefined);
+
+  var _useState = (0, _react.useState)(task.state !== _models.TaskStates.TYPES.CANNOT_START_YET),
+      _useState2 = _slicedToArray(_useState, 2),
+      linkActive = _useState2[0],
+      setLinkActive = _useState2[1];
+
+  var _useState3 = (0, _react.useState)(task.state),
+      _useState4 = _slicedToArray(_useState3, 2),
+      currentState = _useState4[0],
+      setCurrentState = _useState4[1];
+
+  (0, _react.useEffect)(function () {
+    setLinkActive(task.state !== _models.TaskStates.TYPES.CANNOT_START_YET);
+    setCurrentState(task.state);
+  }, [task.state, setLinkActive, setCurrentState]);
+  return /*#__PURE__*/_react.default.createElement("li", {
+    className: classes('item')
+  }, /*#__PURE__*/_react.default.createElement("span", {
+    className: classes('task-name')
+  }, linkActive ? /*#__PURE__*/_react.default.createElement(_copReactComponents.Link, {
+    onClick: function onClick() {
+      return _onClick(task);
+    }
+  }, task.name) : task.name), /*#__PURE__*/_react.default.createElement(_TaskState.default, {
+    state: currentState
+  }));
+};
+
+Task.propTypes = {
+  task: _propTypes.default.shape({
+    name: _propTypes.default.string.isRequired,
+    pages: _propTypes.default.array.isRequired,
+    state: _propTypes.default.string.isRequired
+  }).isRequired,
+  onClick: _propTypes.default.func.isRequired
+};
+var _default = Task;
+exports.default = _default;

package/dist/components/TaskList/Task.test.js

@@ -0,0 +1,112 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+
+var _react2 = _interopRequireDefault(require("react"));
+
+var _models = require("../../models");
+
+var _Task = _interopRequireDefault(require("./Task"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Global imports
+// Local imports
+describe('components', function () {
+  describe('TaskList.Task', function () {
+    it('should render a task', function () {
+      var STATE = _models.TaskStates.TYPES.COMPLETE;
+      var TASK = {
+        name: 'taskName',
+        pages: ['pageName'],
+        state: STATE
+      };
+
+      var ON_CLICK = function ON_CLICK() {};
+
+      var _render = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_Task.default, {
+        task: TASK,
+        onClick: ON_CLICK
+      })),
+          container = _render.container;
+
+      expect(container.childNodes.length).toEqual(1);
+      expect(container.childNodes[0].classList).toContain('hods-task-list__item');
+      var span = container.childNodes[0].childNodes[0];
+      var state = container.childNodes[0].childNodes[1];
+      expect(span.classList).toContain('hods-task-list__task-name');
+      expect(state.textContent).toEqual('Completed');
+    });
+    it('should render a task with inactive link if state is cannotStartYet', function () {
+      var NAME = 'taskName';
+      var STATE = _models.TaskStates.TYPES.CANNOT_START_YET;
+      var TASK = {
+        name: 'taskName',
+        pages: ['pageName'],
+        state: STATE
+      };
+
+      var ON_CLICK = function ON_CLICK() {};
+
+      var _render2 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_Task.default, {
+        task: TASK,
+        onClick: ON_CLICK
+      })),
+          container = _render2.container;
+
+      var span = container.childNodes[0].childNodes[0];
+      expect(span.childNodes[0].tagName).toEqual(undefined);
+      expect(span.textContent).toEqual(NAME);
+    });
+    it('should render a task with a link if state is not cannotStartYet', function () {
+      var STATE = _models.TaskStates.TYPES.IN_PROGRESS;
+      var TASK = {
+        name: 'taskName',
+        pages: ['pageName'],
+        state: STATE
+      };
+
+      var ON_CLICK = function ON_CLICK() {};
+
+      var _render3 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_Task.default, {
+        task: TASK,
+        onClick: ON_CLICK
+      })),
+          container = _render3.container;
+
+      var span = container.childNodes[0].childNodes[0];
+      expect(span.childNodes.length).toEqual(1);
+      expect(span.childNodes[0].tagName).toEqual('A');
+    });
+    it('should call then given onClick function when the link is clicked', function () {
+      var STATE = _models.TaskStates.TYPES.IN_PROGRESS;
+      var TASK = {
+        name: 'taskName',
+        pages: ['pageName'],
+        state: STATE
+      };
+      var ON_CLICK_CALLS = [];
+
+      var ON_CLICK = function ON_CLICK(value) {
+        ON_CLICK_CALLS.push(value);
+      };
+
+      var _render4 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_Task.default, {
+        task: TASK,
+        onClick: ON_CLICK
+      })),
+          container = _render4.container;
+
+      var link = container.childNodes[0].childNodes[0].childNodes[0];
+
+      _react.fireEvent.click(link);
+
+      expect(ON_CLICK_CALLS.length).toEqual(1);
+      expect(ON_CLICK_CALLS[0]).toEqual({
+        pages: ['pageName'],
+        name: "taskName",
+        state: STATE
+      });
+    });
+  });
+});

package/dist/components/TaskList/TaskList.js

@@ -0,0 +1,112 @@
+"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); }
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.DEFAULT_CLASS = void 0;
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _copReactComponents = require("@ukhomeoffice/cop-react-components");
+
+var _models = require("../../models");
+
+var _Task = _interopRequireDefault(require("./Task"));
+
+require("./TaskList.scss");
+
+var _excluded = ["refTitle", "refNumber", "sections", "fieldId", "onTaskAction", "classBlock", "classModifiers", "className"];
+
+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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+
+var DEFAULT_CLASS = 'hods-task-list';
+exports.DEFAULT_CLASS = DEFAULT_CLASS;
+
+var TaskList = function TaskList(_ref) {
+  var refTitle = _ref.refTitle,
+      refNumber = _ref.refNumber,
+      sections = _ref.sections,
+      fieldId = _ref.fieldId,
+      onTaskAction = _ref.onTaskAction,
+      classBlock = _ref.classBlock,
+      classModifiers = _ref.classModifiers,
+      className = _ref.className,
+      attrs = _objectWithoutProperties(_ref, _excluded);
+
+  var classes = _copReactComponents.Utils.classBuilder(classBlock, classModifiers, className); //TODO state will be retrieved from a document in S3 rather than given in the component definition, covered under COP-9885
+
+
+  var numberOfCompleteSections = sections.reduce(function (totalComplete, currentSection) {
+    return totalComplete + currentSection.tasks.filter(function (t) {
+      return t.state === _models.TaskStates.TYPES.COMPLETE;
+    }).length;
+  }, 0);
+  var numberOfSections = sections.reduce(function (totalSections, current) {
+    return totalSections + current.tasks.length;
+  }, 0);
+
+  var onClick = function onClick(task) {
+    if (typeof onTaskAction === 'function') {
+      onTaskAction(task);
+    }
+  };
+
+  return /*#__PURE__*/_react.default.createElement("div", _extends({}, attrs, {
+    className: classes()
+  }), /*#__PURE__*/_react.default.createElement("h2", {
+    className: "govuk-heading-s govuk-!-margin-bottom-2"
+  }, "".concat(refTitle, " ").concat(refNumber)), numberOfSections !== numberOfCompleteSections && /*#__PURE__*/_react.default.createElement("h2", {
+    className: "govuk-heading-s govuk-!-margin-bottom-2"
+  }, "Incomplete form"), /*#__PURE__*/_react.default.createElement("p", {
+    className: "govuk-body govuk-!-margin-bottom-7"
+  }, "You have completed ".concat(numberOfCompleteSections, " of ").concat(numberOfSections, " sections")), sections.map(function (section, index) {
+    return /*#__PURE__*/_react.default.createElement(_react.Fragment, {
+      key: "".concat(section.name)
+    }, /*#__PURE__*/_react.default.createElement("h2", {
+      className: classes('section')
+    }, sections.length > 1 ? "".concat(index + 1, ". ") : '', section.name), /*#__PURE__*/_react.default.createElement("ol", {
+      className: classes('items')
+    }, section.tasks.map(function (task) {
+      return /*#__PURE__*/_react.default.createElement(_Task.default, {
+        key: "".concat(section.name, "-").concat(task.name),
+        task: task,
+        onClick: onClick
+      });
+    })));
+  }));
+};
+
+TaskList.propTypes = {
+  refNumber: _propTypes.default.string,
+  refTitle: _propTypes.default.string,
+  sections: _propTypes.default.arrayOf(_propTypes.default.shape({
+    name: _propTypes.default.string.isRequired,
+    tasks: _propTypes.default.arrayOf(_propTypes.default.shape({
+      name: _propTypes.default.string.isRequired,
+      pages: _propTypes.default.array.isRequired,
+      state: _propTypes.default.string.isRequired
+    })).isRequired
+  })).isRequired,
+  classBlock: _propTypes.default.string,
+  classModifiers: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
+  className: _propTypes.default.string
+};
+TaskList.defaultProps = {
+  classBlock: DEFAULT_CLASS
+};
+var _default = TaskList;
+exports.default = _default;

package/dist/components/TaskList/TaskList.scss

@@ -0,0 +1,70 @@
+@import 'node_modules/govuk-frontend/govuk/_base';
+
+// Task list pattern
+
+.hods-task-list {
+  list-style-type: none;
+  padding-left: 0;
+  margin-top: 0;
+  margin-bottom: 0;
+  @include govuk-media-query($from: tablet) {
+    min-width: 550px;
+  }
+  .hods-task-list__items {
+    @include govuk-font($size: 19);
+    @include govuk-responsive-margin(9, 'bottom');
+    list-style: none;
+    padding-left: 0;
+    @include govuk-media-query($from: tablet) {
+      padding-left: govuk-spacing(6);
+    }
+  }
+}
+
+.hods-task-list__section {
+  display: table;
+  @include govuk-font($size: 24, $weight: bold);
+}
+
+.hods-task-list__section-number {
+  display: table-cell;
+
+  @include govuk-media-query($from: tablet) {
+    min-width: govuk-spacing(6);
+    padding-right: 0;
+  }
+}
+
+.hods-task-list__item {
+  border-bottom: 1px solid $govuk-border-colour;
+  margin-bottom: 0 !important;
+  padding-top: govuk-spacing(2);
+  padding-bottom: govuk-spacing(2);
+  @include govuk-clearfix;
+  &:first-child {
+    border-top: 1px solid $govuk-border-colour;
+  }
+}
+
+.hods-task-list__task-name {
+  display: block;
+  cursor: pointer;
+  @include govuk-media-query($from: 450px) {
+    float: left;
+  }
+}
+
+// The `hods-task-list__task-completed` class was previously used on the task
+// list for the completed tag (changed in 86c90ec) – it's still included here to
+// avoid breaking task lists in existing prototypes.
+.hods-task-list__tag,
+.hods-task-list__task-completed {
+  margin-top: govuk-spacing(2);
+  margin-bottom: govuk-spacing(1);
+
+  @include govuk-media-query($from: 450px) {
+    float: right;
+    margin-top: 0;
+    margin-bottom: 0;
+  }
+}

package/dist/components/TaskList/TaskList.stories.mdx

@@ -0,0 +1,57 @@
+<!-- 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 TaskList from './TaskList';
+
+<Meta title="Components/Task list" id="D-TaskList" component={ TaskList } />
+
+<Heading size="xl" caption="Components">Task list</Heading>
+
+Renders a list of tasks along with the current status for each. Each task that is not in the `Cannot start yet` state can be 
+selected to navigate to that task.
+
+<Canvas withToolbar>
+  <Story name="Default">
+    {() => {
+      const onAction = (row) => {
+        console.log('action clicked', row);
+      };
+      const COP_REF = '123';
+      const REF_TITLE = 'COP reference number';
+      const SECTIONS = [
+        {
+          name: 'Add event details',
+          tasks: [
+            { name: 'Date, location and mode details', state: 'complete' },
+            { name: 'Officer and agency details', state: 'inProgress' },
+          ],
+        },
+        {
+          name: 'Add people details',
+          tasks: [
+            { name: 'People details', state: 'complete' },
+            { name: 'Immigration details', state: 'inProgress' },
+            { name: 'Journey details', state: 'notStarted' },
+          ],
+        },
+        {
+          name: 'Add item details',
+          tasks: [
+            { name: 'Item details', state: 'cannotStartYet' },
+            { name: 'Search and interception details', state: 'cannotStartYet' },
+          ],
+        },
+      ];
+      return (
+        <TaskList refNumber={COP_REF} refTitle={REF_TITLE} sections={SECTIONS} />
+      );
+    }}
+  </Story>
+</Canvas>
+
+<Details summary="Properties" className="no-indent">
+  <ArgsTable of={ TaskList } />
+</Details>