From 057251b38317015e3ffa2330fb7762fd03b9bbeb Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 17:57:37 +0100
Subject: [PATCH 1/7] Clarify Accordion mutually exclusive options

This change follows the newer content pattern used by Task List options
---
 src/govuk/components/accordion/accordion.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/govuk/components/accordion/accordion.yaml b/src/govuk/components/accordion/accordion.yaml
index 18639160e3..5866f64250 100644
--- a/src/govuk/components/accordion/accordion.yaml
+++ b/src/govuk/components/accordion/accordion.yaml
@@ -51,27 +51,27 @@ params:
       - name: heading.text
         type: string
         required: true
-        description: The title of each section. If `heading.html` is supplied, this is ignored.
+        description: If `html` is set, this is not required. The heading text of each section. If `html` is provided, the `text` option will be ignored.
       - name: heading.html
         type: string
         required: true
-        description: The HTML content of the header for each section. Used as the title for each section. The header is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it.
+        description: If `text` is set, this is not required. The heading HTML content of each section. The header is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
       - name: summary.text
         type: string
         required: false
-        description: Text content for summary line. If `summary.html` is supplied, this is ignored.
+        description: The summary line text content of each section. If `html` is provided, the `text` option will be ignored.
       - name: summary.html
         type: string
         required: false
-        description: The HTML content for the summary line. The summary line is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it.
+        description: The summary line HTML content of each section. The summary line is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
       - name: content.text
         type: string
         required: true
-        description: The text content of each section, which is hidden when the section is closed. If `content.html` is supplied, this is ignored.
+        description: If `html` is set, this is not required. The text content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
       - name: content.html
         type: string
         required: true
-        description: The HTML content of each section, which is hidden when the section is closed.
+        description: If `text` is set, this is not required. The HTML content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
       - name: expanded
         type: boolean
         required: false

From 9e40397383fcd0b13154e0f0ed9bd547f93d79f7 Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:45:16 +0100
Subject: [PATCH 2/7] Show Accordion `heading` with nested object params

---
 src/govuk/components/accordion/accordion.yaml | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/govuk/components/accordion/accordion.yaml b/src/govuk/components/accordion/accordion.yaml
index 5866f64250..0c8a29db8e 100644
--- a/src/govuk/components/accordion/accordion.yaml
+++ b/src/govuk/components/accordion/accordion.yaml
@@ -48,14 +48,19 @@ params:
     required: true
     description: An array of sections within the accordion.
     params:
-      - name: heading.text
-        type: string
-        required: true
-        description: If `html` is set, this is not required. The heading text of each section. If `html` is provided, the `text` option will be ignored.
-      - name: heading.html
-        type: string
+      - name: heading
+        type: object
         required: true
-        description: If `text` is set, this is not required. The heading HTML content of each section. The header is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
+        description: The heading of each section.
+        params:
+          - name: text
+            type: string
+            required: true
+            description: If `html` is set, this is not required. The heading text of each section. If `html` is provided, the `text` option will be ignored.
+          - name: html
+            type: string
+            required: true
+            description: If `text` is set, this is not required. The heading HTML content of each section. The header is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
       - name: summary.text
         type: string
         required: false

From 3a93e927a76a8d8f80fd941e8edfa92b7450bbf8 Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:45:32 +0100
Subject: [PATCH 3/7] Show Accordion `summary` with nested object params

---
 src/govuk/components/accordion/accordion.yaml | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/govuk/components/accordion/accordion.yaml b/src/govuk/components/accordion/accordion.yaml
index 0c8a29db8e..c7f1f08c93 100644
--- a/src/govuk/components/accordion/accordion.yaml
+++ b/src/govuk/components/accordion/accordion.yaml
@@ -61,14 +61,19 @@ params:
             type: string
             required: true
             description: If `text` is set, this is not required. The heading HTML content of each section. The header is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
-      - name: summary.text
-        type: string
-        required: false
-        description: The summary line text content of each section. If `html` is provided, the `text` option will be ignored.
-      - name: summary.html
-        type: string
+      - name: summary
+        type: object
         required: false
-        description: The summary line HTML content of each section. The summary line is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
+        description: The summary line of each section.
+        params:
+          - name: text
+            type: string
+            required: false
+            description: The summary line text content of each section. If `html` is provided, the `text` option will be ignored.
+          - name: html
+            type: string
+            required: false
+            description: The summary line HTML content of each section. The summary line is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
       - name: content.text
         type: string
         required: true

From 90ee7b1d7e4494edb5b7aa246e39083fd1e84ddc Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:46:00 +0100
Subject: [PATCH 4/7] Show Accordion `content` with nested object params

---
 src/govuk/components/accordion/accordion.yaml | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/govuk/components/accordion/accordion.yaml b/src/govuk/components/accordion/accordion.yaml
index c7f1f08c93..5fb4a973a5 100644
--- a/src/govuk/components/accordion/accordion.yaml
+++ b/src/govuk/components/accordion/accordion.yaml
@@ -74,14 +74,19 @@ params:
             type: string
             required: false
             description: The summary line HTML content of each section. The summary line is inside the HTML `<button>` element, so you can only add [phrasing content](https://html.spec.whatwg.org/#phrasing-content) to it. If `html` is provided, the `text` option will be ignored.
-      - name: content.text
-        type: string
-        required: true
-        description: If `html` is set, this is not required. The text content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
-      - name: content.html
-        type: string
+      - name: content
+        type: object
         required: true
-        description: If `text` is set, this is not required. The HTML content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
+        description: The content of each section.
+        params:
+          - name: text
+            type: string
+            required: true
+            description: If `html` is set, this is not required. The text content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
+          - name: html
+            type: string
+            required: true
+            description: If `text` is set, this is not required. The HTML content of each section, which is hidden when the section is closed. If `html` is provided, the `text` option will be ignored.
       - name: expanded
         type: boolean
         required: false

From 65906adcbcf3a6346ed1d954d1b047e7e247420a Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:46:18 +0100
Subject: [PATCH 5/7] Show Summary list row `key` with nested object params

---
 .../components/summary-list/summary-list.yaml | 27 +++++++++++--------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/src/govuk/components/summary-list/summary-list.yaml b/src/govuk/components/summary-list/summary-list.yaml
index 2c635eaa61..0006d4a585 100644
--- a/src/govuk/components/summary-list/summary-list.yaml
+++ b/src/govuk/components/summary-list/summary-list.yaml
@@ -8,18 +8,23 @@ params:
         type: string
         required: false
         description: Classes to add to the row `div`.
-      - name: key.text
-        type: string
-        required: true
-        description: If `html` is set, this is not required. Text to use within each key. If `html` is provided, the `text` option will be ignored.
-      - name: key.html
-        type: string
+      - name: key
+        type: object
         required: true
-        description: If `text` is set, this is not required. HTML to use within each key. If `html` is provided, the `text` option will be ignored.
-      - name: key.classes
-        type: string
-        required: false
-        description: Classes to add to the key wrapper.
+        description: The key of each row.
+        params:
+          - name: text
+            type: string
+            required: true
+            description: If `html` is set, this is not required. Text to use within each key. If `html` is provided, the `text` option will be ignored.
+          - name: html
+            type: string
+            required: true
+            description: If `text` is set, this is not required. HTML to use within each key. If `html` is provided, the `text` option will be ignored.
+          - name: classes
+            type: string
+            required: false
+            description: Classes to add to the key wrapper.
       - name: value.text
         type: string
         required: true

From c3904ac5d5501015caac03258eca83ac7cad09ff Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:46:54 +0100
Subject: [PATCH 6/7] Show Summary list row `value` with nested object params

---
 .../components/summary-list/summary-list.yaml | 27 +++++++++++--------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/src/govuk/components/summary-list/summary-list.yaml b/src/govuk/components/summary-list/summary-list.yaml
index 0006d4a585..3d523d4b4d 100644
--- a/src/govuk/components/summary-list/summary-list.yaml
+++ b/src/govuk/components/summary-list/summary-list.yaml
@@ -25,18 +25,23 @@ params:
             type: string
             required: false
             description: Classes to add to the key wrapper.
-      - name: value.text
-        type: string
-        required: true
-        description: If `html` is set, this is not required. Text to use within each value. If `html` is provided, the `text` option will be ignored.
-      - name: value.html
-        type: string
+      - name: value
+        type: object
         required: true
-        description: If `text` is set, this is not required. HTML to use within each value. If `html` is provided, the `text` option will be ignored.
-      - name: value.classes
-        type: string
-        required: false
-        description: Classes to add to the value wrapper.
+        description: The value of each row.
+        params:
+          - name: text
+            type: string
+            required: true
+            description: If `html` is set, this is not required. Text to use within each value. If `html` is provided, the `text` option will be ignored.
+          - name: html
+            type: string
+            required: true
+            description: If `text` is set, this is not required. HTML to use within each value. If `html` is provided, the `text` option will be ignored.
+          - name: classes
+            type: string
+            required: false
+            description: Classes to add to the value wrapper.
       - name: actions.classes
         type: string
         required: false

From d8e453f7a5a26c153cb6a7a9be001a7fd557901b Mon Sep 17 00:00:00 2001
From: Colin Rotherham <work@colinr.com>
Date: Thu, 6 Jul 2023 18:47:20 +0100
Subject: [PATCH 7/7] Show Summary list row `actions` with nested object params

---
 .../components/summary-list/summary-list.yaml | 59 ++++++++++---------
 1 file changed, 32 insertions(+), 27 deletions(-)

diff --git a/src/govuk/components/summary-list/summary-list.yaml b/src/govuk/components/summary-list/summary-list.yaml
index 3d523d4b4d..17caca1300 100644
--- a/src/govuk/components/summary-list/summary-list.yaml
+++ b/src/govuk/components/summary-list/summary-list.yaml
@@ -42,39 +42,44 @@ params:
             type: string
             required: false
             description: Classes to add to the value wrapper.
-      - name: actions.classes
-        type: string
-        required: false
-        description: Classes to add to the actions wrapper.
-      - name: actions.items
-        type: array
+      - name: actions
+        type: object
         required: false
-        description: Array of action item objects.
+        description: The actions of each row.
         params:
-          - name: href
-            type: string
-            required: true
-            description: The value of the link's `href` attribute for an action item.
-          - name: text
-            type: string
-            required: true
-            description: If `html` is set, this is not required. Text to use within each action item. If `html` is provided, the `text` option will be ignored.
-          - name: html
-            type: string
-            required: true
-            description: If `text` is set, this is not required. HTML to use within each action item. If `html` is provided, the `text` option will be ignored.
-          - name: visuallyHiddenText
-            type: string
-            required: false
-            description: Actions rely on context from the surrounding content so may require additional accessible text. Text supplied to this option is appended to the end. Use `html` for more complicated scenarios.
           - name: classes
             type: string
             required: false
-            description: Classes to add to the action item.
-          - name: attributes
-            type: object
+            description: Classes to add to the actions wrapper.
+          - name: items
+            type: array
             required: false
-            description: HTML attributes (for example data attributes) to add to the action item.
+            description: Array of action item objects.
+            params:
+              - name: href
+                type: string
+                required: true
+                description: The value of the link's `href` attribute for an action item.
+              - name: text
+                type: string
+                required: true
+                description: If `html` is set, this is not required. Text to use within each action item. If `html` is provided, the `text` option will be ignored.
+              - name: html
+                type: string
+                required: true
+                description: If `text` is set, this is not required. HTML to use within each action item. If `html` is provided, the `text` option will be ignored.
+              - name: visuallyHiddenText
+                type: string
+                required: false
+                description: Actions rely on context from the surrounding content so may require additional accessible text. Text supplied to this option is appended to the end. Use `html` for more complicated scenarios.
+              - name: classes
+                type: string
+                required: false
+                description: Classes to add to the action item.
+              - name: attributes
+                type: object
+                required: false
+                description: HTML attributes (for example data attributes) to add to the action item.
   - name: card
     type: object
     required: false