style(EMS-4039): declarations - modern slavery - definition of terms

.cspell.json

@@ -114,6 +114,7 @@
         "npmrc",
         "numbergenerator",
         "NVARCHAR",
+        "OHCHR",
         "octocat",
         "organisation",
         "osgb",

e2e-tests/content-strings/pages/insurance/declarations/modern-slavery/index.js

@@ -11,4 +11,85 @@ export const MODERN_SLAVERY = {
     },
     IF_YOU_SAY_NO: 'If you say no to any of the questions you must explain why.',
   },
+  EXPANDABLE: {
+    VERSIONS: [
+      {
+        VERSION: '1',
+        INTRO: 'Definition of terms in this declaration',
+        TABLE: {
+          HEADERS: {
+            TERM: 'Term',
+            DEFINITION: 'Definition',
+          },
+          BODY: [
+            {
+              TERM: 'Holding company',
+              DEFINITION: [{ TEXT: 'Means, in relation to a person, any other person in respect of which it is a Subsidiary.' }],
+            },
+            {
+              TERM: 'Modern slavery',
+              DEFINITION: [
+                {
+                  TEXT: 'Means the recruitment, movement, harbouring or receiving of children, women or men through the use of force, coercion, abuse of vulnerability, deception or other means for the purpose of exploitation and includes holding a person in a position of slavery, servitude forced or compulsory labour, or facilitating their travel with the intention of exploiting them soon after.',
+                },
+              ],
+            },
+            {
+              TERM: 'Subsidiary',
+              DEFINITION: [
+                {
+                  CHILDREN: [
+                    {
+                      TEXT: 'Means a subsidiary within the meaning of ',
+                    },
+                    {
+                      HREF: '#',
+                      TEXT: 'section 1159 of the Companies Act 2006',
+                    },
+                    {
+                      TEXT: '.',
+                    },
+                  ],
+                },
+              ],
+            },
+            {
+              TERM: 'The Modern Slavery Act 2015',
+              DEFINITION: [
+                {
+                  CHILDREN: [
+                    {
+                      TEXT: 'The ',
+                    },
+                    {
+                      HREF: '#',
+                      TEXT: 'Modern Slavery Act 2015',
+                    },
+                    {
+                      TEXT: ' is an Act of the Parliament of the United Kingdom. It is designed to combat modern slavery in the UK and consolidates previous offences relating to trafficking and slavery. The Act also imposes reporting obligations on businesses that exceed a given annual turnover value and that carry out business in the UK. Please refer to ',
+                    },
+                    {
+                      HREF: '#',
+                      TEXT: 'the guidance on the reporting obligations established by the Act',
+                    },
+                    {
+                      TEXT: 'for further information.',
+                    },
+                  ],
+                },
+              ],
+            },
+            {
+              TERM: 'UN Guiding Principles  on Business and Human Rights',
+              DEFINITION: [
+                {
+                  TEXT: 'The UN Guiding Principles on Business and Human Rights (Guiding Principles on Business and Human Rights: Implementing the United Nations “Protect, Respect and Remedy” Framework | OHCHR) provide guidance and advice on the approach companies should take to respecting human rights wherever they operate.',
+                },
+              ],
+            },
+          ],
+        },
+      },
+    ],
+  },
 };

e2e-tests/insurance/cypress/e2e/journeys/declarations/anti-bribery/anti-bribery-expandable-definition-content.spec.js

@@ -1,4 +1,4 @@
-import { antiBriberyPage } from '../../../../../../pages/insurance/declarations';
+import { expandable } from '../../../../../../partials';
 import { PAGES } from '../../../../../../content-strings';
 import { INSURANCE_ROUTES } from '../../../../../../constants/routes/insurance';
 
@@ -11,8 +11,6 @@ const {
   },
 } = INSURANCE_ROUTES;
 
-const { expandable } = antiBriberyPage;
-
 const { INTRO, TABLE } = CONTENT_STRINGS.EXPANDABLE;
 
 const baseUrl = Cypress.config('baseUrl');

e2e-tests/insurance/cypress/e2e/journeys/declarations/modern-slavery/modern-slavery-expandable-definition-content.spec.js

@@ -0,0 +1,199 @@
+import { expandable } from '../../../../../../partials';
+import { PAGES } from '../../../../../../content-strings';
+import { INSURANCE_ROUTES } from '../../../../../../constants/routes/insurance';
+
+const CONTENT_STRINGS = PAGES.INSURANCE.DECLARATIONS.MODERN_SLAVERY.EXPANDABLE.VERSIONS[0];
+
+const {
+  ROOT: INSURANCE_ROOT,
+  DECLARATIONS: { MODERN_SLAVERY },
+} = INSURANCE_ROUTES;
+
+const { INTRO, TABLE } = CONTENT_STRINGS;
+
+// TODO: DRY - with anti bribery expandable content
+const assertTermColumn = (selector, content) => {
+  cy.checkText(selector, content.TERM);
+};
+
+const baseUrl = Cypress.config('baseUrl');
+
+context('Insurance - Declarations - Modern slavery page - expandable `definition` content', () => {
+  let referenceNumber;
+  let url;
+
+  before(() => {
+    cy.completeSignInAndGoToApplication({}).then(({ referenceNumber: refNumber }) => {
+      referenceNumber = refNumber;
+
+      url = `${baseUrl}${INSURANCE_ROOT}/${referenceNumber}${MODERN_SLAVERY}`;
+
+      cy.navigateToUrl(url);
+      cy.assertUrl(url);
+    });
+  });
+
+  beforeEach(() => {
+    cy.saveSession();
+
+    cy.navigateToUrl(url);
+  });
+
+  after(() => {
+    cy.deleteApplication(referenceNumber);
+  });
+
+  it('renders summary text', () => {
+    expandable.summary().should('exist');
+
+    cy.checkText(expandable.summary(), INTRO);
+  });
+
+  it('clicking summary text reveals details', () => {
+    expandable.summary().click();
+
+    expandable.table.headers.term().should('be.visible');
+    expandable.table.headers.definition().should('be.visible');
+  });
+
+  describe('table', () => {
+    const { BODY, HEADERS } = TABLE;
+
+    let row;
+    let content;
+
+    it('renders table headers', () => {
+      expandable.summary().click();
+
+      cy.checkText(expandable.table.headers.term(), HEADERS.TERM);
+      cy.checkText(expandable.table.headers.definition(), HEADERS.DEFINITION);
+    });
+
+    describe('body row 1', () => {
+      beforeEach(() => {
+        expandable.summary().click();
+
+        row = expandable.table.body.row(1);
+
+        const { 0: contentRow } = BODY;
+        content = contentRow;
+      });
+
+      it('renders `term` column', () => {
+        assertTermColumn(row.term(), content);
+      });
+
+      it('renders `definition` column', () => {
+        cy.checkText(row.definition(), content.DEFINITION[0].TEXT);
+      });
+    });
+
+    describe('body row 2', () => {
+      beforeEach(() => {
+        expandable.summary().click();
+
+        row = expandable.table.body.row(2);
+
+        const { 1: contentRow } = BODY;
+        content = contentRow;
+      });
+
+      it('renders `term` column', () => {
+        assertTermColumn(row.term(), content);
+      });
+
+      it('renders `definition` column', () => {
+        cy.checkText(row.definition(), content.DEFINITION[0].TEXT);
+      });
+    });
+
+    describe('body row 3', () => {
+      beforeEach(() => {
+        expandable.summary().click();
+
+        row = expandable.table.body.row(3);
+
+        const { 2: contentRow } = BODY;
+        content = contentRow;
+      });
+
+      it('renders `term` column', () => {
+        assertTermColumn(row.term(), content);
+      });
+
+      it('renders `definition` column', () => {
+        row
+          .definitionListItemChild(1, 1)
+          .invoke('text')
+          .then((text) => {
+            expect(text).includes(content.DEFINITION[0].CHILDREN[0].TEXT);
+          });
+
+        cy.checkLink(row.definitionListItemChild(1, 2), '#', content.DEFINITION[0].CHILDREN[1].TEXT);
+
+        cy.checkText(row.definitionListItemChild(1, 3), content.DEFINITION[0].CHILDREN[2].TEXT);
+      });
+    });
+
+    describe('body row 4', () => {
+      beforeEach(() => {
+        expandable.summary().click();
+
+        row = expandable.table.body.row(4);
+
+        const { 3: contentRow } = BODY;
+        content = contentRow;
+      });
+
+      it('renders `term` column', () => {
+        assertTermColumn(row.term(), content);
+      });
+
+      it('renders `definition` column', () => {
+        row
+          .definitionListItemChild(1, 1)
+          .invoke('text')
+          .then((text) => {
+            expect(text).includes(content.DEFINITION[0].CHILDREN[0].TEXT);
+          });
+
+        cy.checkLink(row.definitionListItemChild(1, 2), '#', content.DEFINITION[0].CHILDREN[1].TEXT);
+
+        row
+          .definitionListItemChild(1, 3)
+          .invoke('text')
+          .then((text) => {
+            expect(text).includes(content.DEFINITION[0].CHILDREN[2].TEXT);
+          });
+
+        cy.checkLink(row.definitionListItemChild(1, 4), '#', content.DEFINITION[0].CHILDREN[3].TEXT);
+
+        row
+          .definitionListItemChild(1, 5)
+          .invoke('text')
+          .then((text) => {
+            expect(text).includes(content.DEFINITION[0].CHILDREN[4].TEXT);
+          });
+      });
+    });
+
+    describe('body row 5', () => {
+      beforeEach(() => {
+        expandable.summary().click();
+
+        row = expandable.table.body.row(5);
+
+        const { 4: contentRow } = BODY;
+        content = contentRow;
+      });
+
+      it('renders `term` column', () => {
+        assertTermColumn(row.term(), content);
+      });
+
+      it('renders `definition` column', () => {
+        cy.checkText(row.definition(), content.DEFINITION[0].TEXT);
+      });
+    });
+  });
+});

e2e-tests/pages/insurance/declarations/anti-bribery.js

@@ -11,23 +11,6 @@ const antiBriberyPage = {
       item: (itemNumber) => cy.get('.lower-alpha-counter-list').last().children(`[data-cy='list-level-2-item-${itemNumber}']`),
     },
   },
-  expandable: {
-    summary: () => cy.get('[data-cy="definition-of-terms"] summary'),
-    details: () => cy.get('[data-cy="definition-of-terms"]'),
-    table: {
-      headers: {
-        term: () => cy.get('[data-cy="header-term"]'),
-        definition: () => cy.get('[data-cy="header-definition"]'),
-      },
-      body: {
-        row: (row) => ({
-          term: () => cy.get(`[data-cy="row-${row}-cell-term"]`),
-          definition: () => cy.get(`[data-cy="row-${row}-cell-definition"]`),
-          definitionListItem: (listItem) => cy.get(`[data-cy="row-${row}-cell-definition-list-item-${listItem}"]`),
-        }),
-      },
-    },
-  },
 };
 
 export default antiBriberyPage;

e2e-tests/partials/expandable.js

@@ -0,0 +1,18 @@
+export const expandable = {
+  summary: () => cy.get('[data-cy="definition-of-terms"] summary'),
+  details: () => cy.get('[data-cy="definition-of-terms"]'),
+  table: {
+    headers: {
+      term: () => cy.get('[data-cy="header-term"]'),
+      definition: () => cy.get('[data-cy="header-definition"]'),
+    },
+    body: {
+      row: (row) => ({
+        term: () => cy.get(`[data-cy="row-${row}-cell-term"]`),
+        definition: () => cy.get(`[data-cy="row-${row}-cell-definition"]`),
+        definitionListItem: (listItem) => cy.get(`[data-cy="row-${row}-cell-definition-list-item-${listItem}"]`),
+        definitionListItemChild: (listItem, childItem) => cy.get(`[data-cy="row-${row}-cell-definition-list-item-${listItem}-child-${childItem}"]`),
+      }),
+    },
+  },
+};

e2e-tests/partials/index.js

@@ -2,6 +2,7 @@ export * from './contactDetails';
 export * from './cookieBanner';
 export * from './creditPeriodWithBuyer';
 export * from './errorSummaryList';
+export * from './expandable';
 export * from './footer';
 export * from './header';
 export * from './headingCaption';