@ukhomeoffice/cop-react-form-renderer 2.0.0 → 2.5.0

package/dist/components/SummaryList/SummaryList.scss

@@ -1,5 +1,5 @@
-@import "node_modules/govuk-frontend/govuk/_base";
-@import "node_modules/govuk-frontend/govuk/components/summary-list/_summary-list";
+@import 'node_modules/govuk-frontend/govuk/_base';
+@import 'node_modules/govuk-frontend/govuk/components/summary-list/_summary-list';
 
 .govuk-summary-list__actions {
   .govuk-link {
@@ -7,3 +7,11 @@
     cursor: pointer;
   }
 }
+
+.caseview__key {
+  font-weight: normal;
+}
+
+.caseview__value {
+  @include govuk-typography-weight-bold;
+}

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

@@ -1,36 +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 } />
+<Meta
+  title='Components/Summary list'
+  id='D-SummaryList'
+  component={SummaryList}
+/>
 
-<Heading size="xl" caption="Components">Summary list</Heading>
+<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">
+  <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: '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 } },
+        {
+          pageId: 'p2',
+          fieldId: 'dob',
+          key: 'Date of birth',
+          value: '29/08/1993',
+          action: { label: 'Change', onAction },
+        },
       ];
-      return (
-        <SummaryList rows={ROWS} />
-      );
+      return <SummaryList rows={ROWS} />;
     }}
   </Story>
 </Canvas>
 
-<Details summary="Properties" className="no-indent">
-  <ArgsTable of={ SummaryList } />
+<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>

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

@@ -54,6 +54,23 @@ describe('components', function () {
       return [key, value, actions];
     };
 
+    var checkRowNoChangeActions = function checkRowNoChangeActions(summaryList, index) {
+      var row = summaryList.childNodes[index];
+      expect(row.tagName).toEqual('DIV');
+      expect(row.classList).toContain("".concat(_SummaryList.DEFAULT_CLASS, "__row"));
+
+      var _row$childNodes2 = _slicedToArray(row.childNodes, 2),
+          key = _row$childNodes2[0],
+          value = _row$childNodes2[1];
+
+      expect(key.tagName).toEqual('DT');
+      expect(key.classList).toContain("".concat(_SummaryList.DEFAULT_CLASS, "__key"));
+      expect(value.tagName).toEqual('DD');
+      expect(value.classList).toContain("".concat(_SummaryList.DEFAULT_CLASS, "__value"));
+      expect(row.childNodes.length).toEqual(2);
+      return [key, value];
+    };
+
     it('should handle an empty rows array', function () {
       var ID = 'test-id';
       var ROWS = [];
@@ -193,5 +210,42 @@ describe('components', function () {
         expect(ON_ACTION_CALLS[index]).toEqual(row);
       });
     });
+    it('should handle rows with component values and actions set to hidden', function () {
+      var ID = 'test-id';
+      var VALUES = ['Alpha component value', 'Bravo component value'];
+      var ROWS = [{
+        pageId: 'p1',
+        fieldId: 'a',
+        key: 'Alpha',
+        value: /*#__PURE__*/_react2.default.createElement("div", null, VALUES[0])
+      }, {
+        pageId: 'p2',
+        fieldId: 'b',
+        key: 'Bravo',
+        value: /*#__PURE__*/_react2.default.createElement("div", null, VALUES[1])
+      }];
+
+      var _render5 = (0, _react.render)( /*#__PURE__*/_react2.default.createElement(_SummaryList.default, {
+        "data-testid": ID,
+        rows: ROWS,
+        noChangeAction: true
+      })),
+          container = _render5.container;
+
+      var summaryList = checkSummaryList(container, ID);
+      expect(summaryList.childNodes.length).toEqual(ROWS.length);
+      ROWS.forEach(function (row, index) {
+        var _checkRowNoChangeActi = checkRowNoChangeActions(summaryList, index),
+            _checkRowNoChangeActi2 = _slicedToArray(_checkRowNoChangeActi, 2),
+            key = _checkRowNoChangeActi2[0],
+            value = _checkRowNoChangeActi2[1];
+
+        expect(key.textContent).toEqual(row.key);
+        expect(value.childNodes.length).toEqual(1);
+        var valueDiv = value.childNodes[0];
+        expect(valueDiv.tagName).toEqual('DIV');
+        expect(valueDiv.textContent).toEqual(VALUES[index]);
+      });
+    });
   });
 });

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>