@defra/forms-model 3.0.431 → 3.0.433

package/schemas/form-definition-schema.json

@@ -0,0 +1,1886 @@
+{
+  "type": "object",
+  "description": "Complete form definition describing all aspects of a form",
+  "properties": {
+    "engine": {
+      "type": "string",
+      "description": "Form engine version to use (V1 or V2)",
+      "default": "V1",
+      "title": "Engine"
+    },
+    "name": {
+      "type": "string",
+      "description": "Unique name identifying the form",
+      "title": "Name"
+    },
+    "feedback": {
+      "type": "object",
+      "description": "Feedback mechanism configuration",
+      "properties": {
+        "feedbackForm": {
+          "type": "boolean",
+          "description": "Whether to show the built-in feedback form",
+          "default": false,
+          "title": "Feedback Form"
+        },
+        "url": {
+          "type": "string",
+          "description": "URL to an external feedback form when not using built-in feedback",
+          "title": "Url"
+        },
+        "emailAddress": {
+          "type": "string",
+          "description": "Email address where feedback is sent",
+          "format": "email",
+          "title": "Email Address"
+        }
+      },
+      "additionalProperties": false,
+      "title": "Feedback"
+    },
+    "startPage": {
+      "type": "string",
+      "description": "Path of the first page to show when starting the form",
+      "title": "Start Page"
+    },
+    "pages": {
+      "type": "array",
+      "description": "All pages within the form",
+      "uniqueItems": true,
+      "items": {
+        "title": "Pages Item"
+      },
+      "oneOf": [
+        {
+          "type": "array",
+          "description": "Pages definition for forms using engine version V2.",
+          "items": {
+            "type": "object",
+            "description": "Enhanced page schema for V2 forms with support for empty titles",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique identifier for the page",
+                "format": "uuid",
+                "title": "Id"
+              },
+              "path": {
+                "type": "string",
+                "description": "URL path for this page, must not be the reserved \"/status\" path",
+                "not": {
+                  "type": "string",
+                  "enum": [
+                    "/status"
+                  ]
+                },
+                "title": "Path"
+              },
+              "section": {
+                "type": "string",
+                "description": "Section this page belongs to",
+                "title": "Section"
+              },
+              "controller": {
+                "type": "string",
+                "description": "Custom controller class name for special page behavior",
+                "title": "Controller"
+              },
+              "components": {
+                "type": "array",
+                "description": "UI components displayed on this page",
+                "uniqueItems": true,
+                "items": {
+                  "type": "object",
+                  "description": "Form component definition specifying UI element behavior",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "Unique identifier for the component",
+                      "format": "uuid",
+                      "title": "Id"
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "Component type (TextField, RadioButtons, DateField, etc.)",
+                      "title": "Type"
+                    },
+                    "shortDescription": {
+                      "type": "string",
+                      "description": "Brief description of the component purpose",
+                      "title": "Short Description"
+                    },
+                    "name": {
+                      "type": [
+                        "array",
+                        "boolean",
+                        "number",
+                        "object",
+                        "string",
+                        "null"
+                      ],
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "description": "Name format for display-only components like HTML, Markdown, etc.",
+                          "pattern": "^[a-zA-Z]+$",
+                          "title": "Display Component Name"
+                        },
+                        {
+                          "type": "string",
+                          "description": "Name format for input components that collect user data.",
+                          "pattern": "^[a-zA-Z]+$",
+                          "title": "Input Component Name"
+                        }
+                      ],
+                      "title": "Name",
+                      "description": "The name value.",
+                      "oneOfTitles": [
+                        "Display Component Name",
+                        "Input Component Name"
+                      ]
+                    },
+                    "title": {
+                      "type": [
+                        "array",
+                        "boolean",
+                        "number",
+                        "object",
+                        "string",
+                        "null"
+                      ],
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "description": "Title format for display-only components.",
+                          "title": "Display Component Title"
+                        },
+                        {
+                          "type": "string",
+                          "description": "Title displayed above input components.",
+                          "title": "Input Component Title"
+                        }
+                      ],
+                      "title": "Title",
+                      "description": "The title value.",
+                      "oneOfTitles": [
+                        "Display Component Title",
+                        "Input Component Title"
+                      ]
+                    },
+                    "hint": {
+                      "type": "string",
+                      "description": "Additional guidance text displayed below the component title",
+                      "title": "Hint"
+                    },
+                    "options": {
+                      "type": "object",
+                      "description": "Component-specific configuration options",
+                      "default": {},
+                      "properties": {
+                        "rows": {
+                          "type": "number",
+                          "description": "Number of rows for textarea components",
+                          "title": "Rows"
+                        },
+                        "maxWords": {
+                          "type": "number",
+                          "description": "Maximum number of words allowed in text inputs",
+                          "title": "Max Words"
+                        },
+                        "maxDaysInPast": {
+                          "type": "number",
+                          "description": "Maximum days in the past allowed for date inputs",
+                          "title": "Max Days In Past"
+                        },
+                        "maxDaysInFuture": {
+                          "type": "number",
+                          "description": "Maximum days in the future allowed for date inputs",
+                          "title": "Max Days In Future"
+                        },
+                        "customValidationMessage": {
+                          "type": "string",
+                          "description": "Custom error message for validation failures",
+                          "title": "Custom Validation Message"
+                        },
+                        "customValidationMessages": {
+                          "type": "object",
+                          "description": "Custom error messages keyed by validation rule name",
+                          "properties": {},
+                          "additionalProperties": true,
+                          "title": "Custom Validation Messages"
+                        }
+                      },
+                      "additionalProperties": true,
+                      "title": "Options"
+                    },
+                    "schema": {
+                      "type": "object",
+                      "description": "Validation rules for the component",
+                      "default": {},
+                      "properties": {
+                        "min": {
+                          "type": "number",
+                          "description": "Minimum value or length for validation",
+                          "title": "Min"
+                        },
+                        "max": {
+                          "type": "number",
+                          "description": "Maximum value or length for validation",
+                          "title": "Max"
+                        },
+                        "length": {
+                          "type": "number",
+                          "description": "Exact length required for validation",
+                          "title": "Length"
+                        }
+                      },
+                      "additionalProperties": true,
+                      "title": "Schema"
+                    },
+                    "list": {
+                      "type": "string",
+                      "description": "Reference to a predefined list of options for select components",
+                      "title": "List"
+                    }
+                  },
+                  "required": [
+                    "type"
+                  ],
+                  "additionalProperties": true,
+                  "title": "Components Item"
+                },
+                "title": "Components"
+              },
+              "repeat": {
+                "type": "object",
+                "title": "Repeat Configuration",
+                "description": "Configuration for repeatable pages, used with RepeatPageController. Defines how repeatable sections behave including min/max repetitions and display options.\n\nNOTE: This configuration is only used when the 'controller' property is set to 'RepeatPageController'. Otherwise, this property should not be specified.",
+                "oneOfTitles": [
+                  "Repeat Configuration",
+                  "Alternative Validation"
+                ],
+                "properties": {
+                  "options": {
+                    "type": "object",
+                    "description": "Display and identification options for the repetition",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "Identifier for the repeatable section, used in data structure",
+                        "title": "Name"
+                      },
+                      "title": {
+                        "type": "string",
+                        "description": "Title displayed for each repeatable item",
+                        "title": "Title"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "title"
+                    ],
+                    "additionalProperties": false,
+                    "title": "Options"
+                  },
+                  "schema": {
+                    "type": "object",
+                    "description": "Validation constraints for the number of repetitions",
+                    "properties": {
+                      "min": {
+                        "type": "number",
+                        "description": "Minimum number of repetitions required",
+                        "title": "Min"
+                      },
+                      "max": {
+                        "type": "number",
+                        "description": "Maximum number of repetitions allowed",
+                        "title": "Max"
+                      }
+                    },
+                    "required": [
+                      "min",
+                      "max"
+                    ],
+                    "additionalProperties": false,
+                    "title": "Schema"
+                  }
+                },
+                "required": [
+                  "options",
+                  "schema"
+                ],
+                "additionalProperties": false
+              },
+              "condition": {
+                "type": "string",
+                "description": "Optional condition that determines if this page is shown",
+                "title": "Condition"
+              },
+              "next": {
+                "type": "array",
+                "description": "Possible navigation paths after this page",
+                "default": [],
+                "items": {
+                  "type": "object",
+                  "description": "Navigation link defining where to go after completing a page",
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "description": "The target page path to navigate to",
+                      "title": "Path"
+                    },
+                    "condition": {
+                      "type": "string",
+                      "description": "Optional condition that determines if this path should be taken",
+                      "title": "Condition"
+                    },
+                    "redirect": {
+                      "type": "string",
+                      "description": "Optional external URL to redirect to instead of an internal page",
+                      "title": "Redirect"
+                    }
+                  },
+                  "required": [
+                    "path"
+                  ],
+                  "additionalProperties": false,
+                  "title": "Next Item"
+                },
+                "title": "Next"
+              },
+              "events": {
+                "type": "object",
+                "description": "Event handlers for page lifecycle events",
+                "properties": {
+                  "onLoad": {
+                    "type": "object",
+                    "description": "Event handler triggered when the page is loaded",
+                    "properties": {
+                      "type": {
+                        "type": "string",
+                        "description": "Type of the event handler (currently only \"http\" supported)",
+                        "title": "Type"
+                      },
+                      "options": {
+                        "type": "object",
+                        "description": "Options specific to the event handler type",
+                        "properties": {
+                          "method": {
+                            "type": "string",
+                            "description": "HTTP method to use for the request",
+                            "title": "Method"
+                          },
+                          "url": {
+                            "type": "string",
+                            "description": "URL endpoint to call when the event fires",
+                            "format": "uri",
+                            "title": "Url"
+                          }
+                        },
+                        "required": [
+                          "method",
+                          "url"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Options"
+                      }
+                    },
+                    "required": [
+                      "type"
+                    ],
+                    "additionalProperties": false,
+                    "title": "On Load"
+                  },
+                  "onSave": {
+                    "type": "object",
+                    "description": "Event handler triggered when the page data is saved",
+                    "properties": {
+                      "type": {
+                        "type": "string",
+                        "description": "Type of the event handler (currently only \"http\" supported)",
+                        "title": "Type"
+                      },
+                      "options": {
+                        "type": "object",
+                        "description": "Options specific to the event handler type",
+                        "properties": {
+                          "method": {
+                            "type": "string",
+                            "description": "HTTP method to use for the request",
+                            "title": "Method"
+                          },
+                          "url": {
+                            "type": "string",
+                            "description": "URL endpoint to call when the event fires",
+                            "format": "uri",
+                            "title": "Url"
+                          }
+                        },
+                        "required": [
+                          "method",
+                          "url"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Options"
+                      }
+                    },
+                    "required": [
+                      "type"
+                    ],
+                    "additionalProperties": false,
+                    "title": "On Save"
+                  }
+                },
+                "additionalProperties": false,
+                "title": "Events"
+              },
+              "view": {
+                "type": "string",
+                "description": "Optional custom view template to use for rendering this page",
+                "title": "View"
+              },
+              "title": {
+                "type": "string",
+                "description": "Page title with enhanced support for empty titles in V2",
+                "title": "Title"
+              }
+            },
+            "required": [
+              "path",
+              "title"
+            ],
+            "additionalProperties": false,
+            "title": "V2  Pages Item"
+          },
+          "title": "V2 Pages"
+        },
+        {
+          "type": "array",
+          "description": "Pages definition for forms using engine version V1.",
+          "items": {
+            "type": "object",
+            "description": "Form page definition specifying content and behavior",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique identifier for the page",
+                "format": "uuid",
+                "title": "Id"
+              },
+              "path": {
+                "type": "string",
+                "description": "URL path for this page, must not be the reserved \"/status\" path",
+                "not": {
+                  "type": "string",
+                  "enum": [
+                    "/status"
+                  ]
+                },
+                "title": "Path"
+              },
+              "title": {
+                "type": "string",
+                "description": "Page title displayed at the top of the page",
+                "title": "Title"
+              },
+              "section": {
+                "type": "string",
+                "description": "Section this page belongs to",
+                "title": "Section"
+              },
+              "controller": {
+                "type": "string",
+                "description": "Custom controller class name for special page behavior",
+                "title": "Controller"
+              },
+              "components": {
+                "type": "array",
+                "description": "UI components displayed on this page",
+                "uniqueItems": true,
+                "items": {
+                  "type": "object",
+                  "description": "Form component definition specifying UI element behavior",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "Unique identifier for the component",
+                      "format": "uuid",
+                      "title": "Id"
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "Component type (TextField, RadioButtons, DateField, etc.)",
+                      "title": "Type"
+                    },
+                    "shortDescription": {
+                      "type": "string",
+                      "description": "Brief description of the component purpose",
+                      "title": "Short Description"
+                    },
+                    "name": {
+                      "type": [
+                        "array",
+                        "boolean",
+                        "number",
+                        "object",
+                        "string",
+                        "null"
+                      ],
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "description": "Name format for display-only components like HTML, Markdown, etc.",
+                          "pattern": "^[a-zA-Z]+$",
+                          "title": "Display Component Name"
+                        },
+                        {
+                          "type": "string",
+                          "description": "Name format for input components that collect user data.",
+                          "pattern": "^[a-zA-Z]+$",
+                          "title": "Input Component Name"
+                        }
+                      ],
+                      "title": "Name",
+                      "description": "The name value.",
+                      "oneOfTitles": [
+                        "Display Component Name",
+                        "Input Component Name"
+                      ]
+                    },
+                    "title": {
+                      "type": [
+                        "array",
+                        "boolean",
+                        "number",
+                        "object",
+                        "string",
+                        "null"
+                      ],
+                      "oneOf": [
+                        {
+                          "type": "string",
+                          "description": "Title format for display-only components.",
+                          "title": "Display Component Title"
+                        },
+                        {
+                          "type": "string",
+                          "description": "Title displayed above input components.",
+                          "title": "Input Component Title"
+                        }
+                      ],
+                      "title": "Title",
+                      "description": "The title value.",
+                      "oneOfTitles": [
+                        "Display Component Title",
+                        "Input Component Title"
+                      ]
+                    },
+                    "hint": {
+                      "type": "string",
+                      "description": "Additional guidance text displayed below the component title",
+                      "title": "Hint"
+                    },
+                    "options": {
+                      "type": "object",
+                      "description": "Component-specific configuration options",
+                      "default": {},
+                      "properties": {
+                        "rows": {
+                          "type": "number",
+                          "description": "Number of rows for textarea components",
+                          "title": "Rows"
+                        },
+                        "maxWords": {
+                          "type": "number",
+                          "description": "Maximum number of words allowed in text inputs",
+                          "title": "Max Words"
+                        },
+                        "maxDaysInPast": {
+                          "type": "number",
+                          "description": "Maximum days in the past allowed for date inputs",
+                          "title": "Max Days In Past"
+                        },
+                        "maxDaysInFuture": {
+                          "type": "number",
+                          "description": "Maximum days in the future allowed for date inputs",
+                          "title": "Max Days In Future"
+                        },
+                        "customValidationMessage": {
+                          "type": "string",
+                          "description": "Custom error message for validation failures",
+                          "title": "Custom Validation Message"
+                        },
+                        "customValidationMessages": {
+                          "type": "object",
+                          "description": "Custom error messages keyed by validation rule name",
+                          "properties": {},
+                          "additionalProperties": true,
+                          "title": "Custom Validation Messages"
+                        }
+                      },
+                      "additionalProperties": true,
+                      "title": "Options"
+                    },
+                    "schema": {
+                      "type": "object",
+                      "description": "Validation rules for the component",
+                      "default": {},
+                      "properties": {
+                        "min": {
+                          "type": "number",
+                          "description": "Minimum value or length for validation",
+                          "title": "Min"
+                        },
+                        "max": {
+                          "type": "number",
+                          "description": "Maximum value or length for validation",
+                          "title": "Max"
+                        },
+                        "length": {
+                          "type": "number",
+                          "description": "Exact length required for validation",
+                          "title": "Length"
+                        }
+                      },
+                      "additionalProperties": true,
+                      "title": "Schema"
+                    },
+                    "list": {
+                      "type": "string",
+                      "description": "Reference to a predefined list of options for select components",
+                      "title": "List"
+                    }
+                  },
+                  "required": [
+                    "type"
+                  ],
+                  "additionalProperties": true,
+                  "title": "Components Item"
+                },
+                "title": "Components"
+              },
+              "repeat": {
+                "type": "object",
+                "title": "Repeat Configuration",
+                "description": "Configuration for repeatable pages, used with RepeatPageController. Defines how repeatable sections behave including min/max repetitions and display options.\n\nNOTE: This configuration is only used when the 'controller' property is set to 'RepeatPageController'. Otherwise, this property should not be specified.",
+                "oneOfTitles": [
+                  "Repeat Configuration",
+                  "Alternative Validation"
+                ],
+                "properties": {
+                  "options": {
+                    "type": "object",
+                    "description": "Display and identification options for the repetition",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "Identifier for the repeatable section, used in data structure",
+                        "title": "Name"
+                      },
+                      "title": {
+                        "type": "string",
+                        "description": "Title displayed for each repeatable item",
+                        "title": "Title"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "title"
+                    ],
+                    "additionalProperties": false,
+                    "title": "Options"
+                  },
+                  "schema": {
+                    "type": "object",
+                    "description": "Validation constraints for the number of repetitions",
+                    "properties": {
+                      "min": {
+                        "type": "number",
+                        "description": "Minimum number of repetitions required",
+                        "title": "Min"
+                      },
+                      "max": {
+                        "type": "number",
+                        "description": "Maximum number of repetitions allowed",
+                        "title": "Max"
+                      }
+                    },
+                    "required": [
+                      "min",
+                      "max"
+                    ],
+                    "additionalProperties": false,
+                    "title": "Schema"
+                  }
+                },
+                "required": [
+                  "options",
+                  "schema"
+                ],
+                "additionalProperties": false
+              },
+              "condition": {
+                "type": "string",
+                "description": "Optional condition that determines if this page is shown",
+                "title": "Condition"
+              },
+              "next": {
+                "type": "array",
+                "description": "Possible navigation paths after this page",
+                "default": [],
+                "items": {
+                  "type": "object",
+                  "description": "Navigation link defining where to go after completing a page",
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "description": "The target page path to navigate to",
+                      "title": "Path"
+                    },
+                    "condition": {
+                      "type": "string",
+                      "description": "Optional condition that determines if this path should be taken",
+                      "title": "Condition"
+                    },
+                    "redirect": {
+                      "type": "string",
+                      "description": "Optional external URL to redirect to instead of an internal page",
+                      "title": "Redirect"
+                    }
+                  },
+                  "required": [
+                    "path"
+                  ],
+                  "additionalProperties": false,
+                  "title": "Next Item"
+                },
+                "title": "Next"
+              },
+              "events": {
+                "type": "object",
+                "description": "Event handlers for page lifecycle events",
+                "properties": {
+                  "onLoad": {
+                    "type": "object",
+                    "description": "Event handler triggered when the page is loaded",
+                    "properties": {
+                      "type": {
+                        "type": "string",
+                        "description": "Type of the event handler (currently only \"http\" supported)",
+                        "title": "Type"
+                      },
+                      "options": {
+                        "type": "object",
+                        "description": "Options specific to the event handler type",
+                        "properties": {
+                          "method": {
+                            "type": "string",
+                            "description": "HTTP method to use for the request",
+                            "title": "Method"
+                          },
+                          "url": {
+                            "type": "string",
+                            "description": "URL endpoint to call when the event fires",
+                            "format": "uri",
+                            "title": "Url"
+                          }
+                        },
+                        "required": [
+                          "method",
+                          "url"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Options"
+                      }
+                    },
+                    "required": [
+                      "type"
+                    ],
+                    "additionalProperties": false,
+                    "title": "On Load"
+                  },
+                  "onSave": {
+                    "type": "object",
+                    "description": "Event handler triggered when the page data is saved",
+                    "properties": {
+                      "type": {
+                        "type": "string",
+                        "description": "Type of the event handler (currently only \"http\" supported)",
+                        "title": "Type"
+                      },
+                      "options": {
+                        "type": "object",
+                        "description": "Options specific to the event handler type",
+                        "properties": {
+                          "method": {
+                            "type": "string",
+                            "description": "HTTP method to use for the request",
+                            "title": "Method"
+                          },
+                          "url": {
+                            "type": "string",
+                            "description": "URL endpoint to call when the event fires",
+                            "format": "uri",
+                            "title": "Url"
+                          }
+                        },
+                        "required": [
+                          "method",
+                          "url"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Options"
+                      }
+                    },
+                    "required": [
+                      "type"
+                    ],
+                    "additionalProperties": false,
+                    "title": "On Save"
+                  }
+                },
+                "additionalProperties": false,
+                "title": "Events"
+              },
+              "view": {
+                "type": "string",
+                "description": "Optional custom view template to use for rendering this page",
+                "title": "View"
+              }
+            },
+            "required": [
+              "path",
+              "title"
+            ],
+            "additionalProperties": false,
+            "title": "V1  Pages Item"
+          },
+          "title": "V1 Pages"
+        }
+      ],
+      "title": "Pages",
+      "oneOfTitles": [
+        "V2 Pages",
+        "V1 Pages"
+      ]
+    },
+    "sections": {
+      "type": "array",
+      "description": "Sections grouping related pages together",
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "description": "A form section grouping related pages together",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Unique identifier for the section, used in code and page references",
+            "title": "Name"
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable section title displayed to users",
+            "title": "Title"
+          },
+          "hideTitle": {
+            "type": "boolean",
+            "description": "When true, the section title will not be displayed in the UI",
+            "default": false,
+            "title": "Hide Title"
+          }
+        },
+        "required": [
+          "name",
+          "title"
+        ],
+        "additionalProperties": false,
+        "title": "Sections Item"
+      },
+      "title": "Sections"
+    },
+    "conditions": {
+      "type": "array",
+      "description": "Named conditions used for form logic",
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "description": "Container for a named condition with its definition",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Unique identifier used to reference this condition",
+            "title": "Name"
+          },
+          "displayName": {
+            "type": "string",
+            "description": "Human-readable name for display in the UI",
+            "title": "Display Name"
+          },
+          "value": {
+            "type": "object",
+            "description": "The complete condition definition",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Unique identifier for the condition set",
+                "title": "Name"
+              },
+              "conditions": {
+                "type": "array",
+                "description": "Array of conditions, condition references, or condition groups\n\nElements can be direct conditions, references to named conditions, or nested condition groups. This structure allows building complex logical expressions with AND/OR operators.",
+                "items": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "description": "Condition definition specifying a logical comparison",
+                      "properties": {
+                        "field": {
+                          "type": "object",
+                          "description": "The form field being evaluated in this condition",
+                          "properties": {
+                            "name": {
+                              "type": "string",
+                              "description": "Component name referenced by this condition",
+                              "title": "Name"
+                            },
+                            "type": {
+                              "type": "string",
+                              "description": "Data type of the field (e.g., string, number, date)",
+                              "title": "Type"
+                            },
+                            "display": {
+                              "type": "string",
+                              "description": "Human-readable name of the field for display purposes",
+                              "title": "Display"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "type",
+                            "display"
+                          ],
+                          "additionalProperties": false,
+                          "title": "Field"
+                        },
+                        "operator": {
+                          "type": "string",
+                          "description": "Comparison operator: equals, notEquals, contains, notContains, greaterThan, lessThan, isEmpty, isNotEmpty",
+                          "title": "Operator"
+                        },
+                        "value": {
+                          "description": "Value to compare the field against, either fixed or relative date",
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "description": "Value specification for a condition",
+                              "properties": {
+                                "type": {
+                                  "type": "string",
+                                  "description": "Data type of the value (e.g., string, number, date)",
+                                  "title": "Type"
+                                },
+                                "value": {
+                                  "type": "string",
+                                  "description": "The actual value to compare against",
+                                  "title": "Value"
+                                },
+                                "display": {
+                                  "type": "string",
+                                  "description": "Human-readable version of the value for display purposes",
+                                  "title": "Display"
+                                }
+                              },
+                              "required": [
+                                "type",
+                                "value",
+                                "display"
+                              ],
+                              "additionalProperties": false,
+                              "title": "Static Value"
+                            },
+                            {
+                              "type": "object",
+                              "description": "Relative date specification for date-based conditions",
+                              "properties": {
+                                "type": {
+                                  "type": "string",
+                                  "description": "Data type identifier, should be \"RelativeDate\"",
+                                  "title": "Type"
+                                },
+                                "period": {
+                                  "type": "string",
+                                  "description": "Numeric amount of the time period, as a string",
+                                  "title": "Period"
+                                },
+                                "unit": {
+                                  "type": "string",
+                                  "description": "Time unit (e.g., days, weeks, months, years)",
+                                  "title": "Unit"
+                                },
+                                "direction": {
+                                  "type": "string",
+                                  "description": "Temporal direction, either \"past\" or \"future\"",
+                                  "title": "Direction"
+                                }
+                              },
+                              "required": [
+                                "type",
+                                "period",
+                                "unit",
+                                "direction"
+                              ],
+                              "additionalProperties": false,
+                              "title": "Relative Date Value"
+                            }
+                          ],
+                          "title": "Value",
+                          "anyOfTitles": [
+                            "Static Value",
+                            "Relative Date Value"
+                          ]
+                        },
+                        "coordinator": {
+                          "type": "string",
+                          "description": "Logical operator connecting this condition with others (AND, OR)",
+                          "title": "Coordinator"
+                        }
+                      },
+                      "required": [
+                        "operator"
+                      ],
+                      "additionalProperties": false,
+                      "title": "Unknown Value Type"
+                    },
+                    {
+                      "type": "object",
+                      "description": "Reference to a named condition defined elsewhere",
+                      "properties": {
+                        "conditionName": {
+                          "type": "string",
+                          "description": "Name of the referenced condition",
+                          "title": "Condition Name"
+                        },
+                        "conditionDisplayName": {
+                          "type": "string",
+                          "description": "Human-readable name of the condition for display purposes",
+                          "title": "Condition Display Name"
+                        },
+                        "coordinator": {
+                          "type": "string",
+                          "description": "Logical operator connecting this condition with others (AND, OR)",
+                          "title": "Coordinator"
+                        }
+                      },
+                      "required": [
+                        "conditionName",
+                        "conditionDisplayName"
+                      ],
+                      "additionalProperties": false,
+                      "title": "Unknown Value Type"
+                    },
+                    {
+                      "$ref": "#/$defs/conditionGroupSchema",
+                      "title": "Nested Condition Group",
+                      "description": "A nested group of conditions that allows building complex logical expressions with multiple levels."
+                    }
+                  ],
+                  "title": "Conditions Item",
+                  "anyOfTitles": [
+                    "Condition Definition",
+                    "Condition Reference",
+                    "Nested Condition Group"
+                  ]
+                },
+                "title": "Conditions"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false,
+            "title": "Value"
+          }
+        },
+        "required": [
+          "name",
+          "value"
+        ],
+        "additionalProperties": false,
+        "title": "Conditions Item"
+      },
+      "title": "Conditions"
+    },
+    "lists": {
+      "type": "array",
+      "description": "Reusable lists of options for select components",
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "description": "Reusable list of options for select components",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for the list",
+            "format": "uuid",
+            "title": "Id"
+          },
+          "name": {
+            "type": "string",
+            "description": "Name used to reference this list from components",
+            "title": "Name"
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable title for the list",
+            "title": "Title"
+          },
+          "type": {
+            "type": "string",
+            "description": "Data type for list values (string or number)",
+            "enum": [
+              "string",
+              "number"
+            ],
+            "title": "Type"
+          },
+          "items": {
+            "type": [
+              "array",
+              "boolean",
+              "number",
+              "object",
+              "string",
+              "null"
+            ],
+            "oneOf": [
+              {
+                "type": "array",
+                "description": "Array of items with string values",
+                "uniqueItems": true,
+                "items": {
+                  "type": "object",
+                  "description": "List item with string value",
+                  "properties": {
+                    "text": {
+                      "type": "string",
+                      "description": "Display text shown to the user",
+                      "title": "Text"
+                    },
+                    "description": {
+                      "type": "string",
+                      "description": "Optional additional descriptive text for the item",
+                      "title": "Description"
+                    },
+                    "conditional": {
+                      "type": "object",
+                      "description": "Optional components to show when this item is selected",
+                      "properties": {
+                        "components": {
+                          "type": "array",
+                          "description": "Components to display conditionally",
+                          "uniqueItems": true,
+                          "items": {
+                            "type": "object",
+                            "description": "Form component definition specifying UI element behavior",
+                            "properties": {
+                              "id": {
+                                "type": "string",
+                                "description": "Unique identifier for the component",
+                                "format": "uuid",
+                                "title": "Id"
+                              },
+                              "type": {
+                                "type": "string",
+                                "description": "Component type (TextField, RadioButtons, DateField, etc.)",
+                                "title": "Type"
+                              },
+                              "shortDescription": {
+                                "type": "string",
+                                "description": "Brief description of the component purpose",
+                                "title": "Short Description"
+                              },
+                              "name": {
+                                "type": [
+                                  "array",
+                                  "boolean",
+                                  "number",
+                                  "object",
+                                  "string",
+                                  "null"
+                                ],
+                                "oneOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Name format for display-only components like HTML, Markdown, etc.",
+                                    "pattern": "^[a-zA-Z]+$",
+                                    "title": "Display Component Name"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "description": "Name format for input components that collect user data.",
+                                    "pattern": "^[a-zA-Z]+$",
+                                    "title": "Input Component Name"
+                                  }
+                                ],
+                                "title": "Name",
+                                "description": "The name value.",
+                                "oneOfTitles": [
+                                  "Display Component Name",
+                                  "Input Component Name"
+                                ]
+                              },
+                              "title": {
+                                "type": [
+                                  "array",
+                                  "boolean",
+                                  "number",
+                                  "object",
+                                  "string",
+                                  "null"
+                                ],
+                                "oneOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Title format for display-only components.",
+                                    "title": "Display Component Title"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "description": "Title displayed above input components.",
+                                    "title": "Input Component Title"
+                                  }
+                                ],
+                                "title": "Title",
+                                "description": "The title value.",
+                                "oneOfTitles": [
+                                  "Display Component Title",
+                                  "Input Component Title"
+                                ]
+                              },
+                              "hint": {
+                                "type": "string",
+                                "description": "Additional guidance text displayed below the component title",
+                                "title": "Hint"
+                              },
+                              "options": {
+                                "type": "object",
+                                "description": "Component-specific configuration options",
+                                "default": {},
+                                "properties": {
+                                  "rows": {
+                                    "type": "number",
+                                    "description": "Number of rows for textarea components",
+                                    "title": "Rows"
+                                  },
+                                  "maxWords": {
+                                    "type": "number",
+                                    "description": "Maximum number of words allowed in text inputs",
+                                    "title": "Max Words"
+                                  },
+                                  "maxDaysInPast": {
+                                    "type": "number",
+                                    "description": "Maximum days in the past allowed for date inputs",
+                                    "title": "Max Days In Past"
+                                  },
+                                  "maxDaysInFuture": {
+                                    "type": "number",
+                                    "description": "Maximum days in the future allowed for date inputs",
+                                    "title": "Max Days In Future"
+                                  },
+                                  "customValidationMessage": {
+                                    "type": "string",
+                                    "description": "Custom error message for validation failures",
+                                    "title": "Custom Validation Message"
+                                  },
+                                  "customValidationMessages": {
+                                    "type": "object",
+                                    "description": "Custom error messages keyed by validation rule name",
+                                    "properties": {},
+                                    "additionalProperties": true,
+                                    "title": "Custom Validation Messages"
+                                  }
+                                },
+                                "additionalProperties": true,
+                                "title": "Options"
+                              },
+                              "schema": {
+                                "type": "object",
+                                "description": "Validation rules for the component",
+                                "default": {},
+                                "properties": {
+                                  "min": {
+                                    "type": "number",
+                                    "description": "Minimum value or length for validation",
+                                    "title": "Min"
+                                  },
+                                  "max": {
+                                    "type": "number",
+                                    "description": "Maximum value or length for validation",
+                                    "title": "Max"
+                                  },
+                                  "length": {
+                                    "type": "number",
+                                    "description": "Exact length required for validation",
+                                    "title": "Length"
+                                  }
+                                },
+                                "additionalProperties": true,
+                                "title": "Schema"
+                              },
+                              "list": {
+                                "type": "string",
+                                "description": "Reference to a predefined list of options for select components",
+                                "title": "List"
+                              }
+                            },
+                            "required": [
+                              "type"
+                            ],
+                            "additionalProperties": true,
+                            "title": "Components Item"
+                          },
+                          "title": "Components"
+                        }
+                      },
+                      "required": [
+                        "components"
+                      ],
+                      "additionalProperties": false,
+                      "title": "Conditional"
+                    },
+                    "condition": {
+                      "type": "string",
+                      "description": "Condition that determines if this item is shown",
+                      "title": "Condition"
+                    },
+                    "hint": {
+                      "type": "string",
+                      "description": "Optional hint text to be shown on list item",
+                      "title": "Hint"
+                    },
+                    "value": {
+                      "type": "string",
+                      "description": "String value stored when this item is selected",
+                      "title": "Value"
+                    }
+                  },
+                  "required": [
+                    "value"
+                  ],
+                  "additionalProperties": false,
+                  "title": "Items (array) Item"
+                },
+                "title": "String List Items"
+              },
+              {
+                "type": "array",
+                "description": "Array of items with numeric values",
+                "uniqueItems": true,
+                "items": {
+                  "type": "object",
+                  "description": "List item with numeric value",
+                  "properties": {
+                    "text": {
+                      "type": "string",
+                      "description": "Display text shown to the user",
+                      "title": "Text"
+                    },
+                    "description": {
+                      "type": "string",
+                      "description": "Optional additional descriptive text for the item",
+                      "title": "Description"
+                    },
+                    "conditional": {
+                      "type": "object",
+                      "description": "Optional components to show when this item is selected",
+                      "properties": {
+                        "components": {
+                          "type": "array",
+                          "description": "Components to display conditionally",
+                          "uniqueItems": true,
+                          "items": {
+                            "type": "object",
+                            "description": "Form component definition specifying UI element behavior",
+                            "properties": {
+                              "id": {
+                                "type": "string",
+                                "description": "Unique identifier for the component",
+                                "format": "uuid",
+                                "title": "Id"
+                              },
+                              "type": {
+                                "type": "string",
+                                "description": "Component type (TextField, RadioButtons, DateField, etc.)",
+                                "title": "Type"
+                              },
+                              "shortDescription": {
+                                "type": "string",
+                                "description": "Brief description of the component purpose",
+                                "title": "Short Description"
+                              },
+                              "name": {
+                                "type": [
+                                  "array",
+                                  "boolean",
+                                  "number",
+                                  "object",
+                                  "string",
+                                  "null"
+                                ],
+                                "oneOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Name format for display-only components like HTML, Markdown, etc.",
+                                    "pattern": "^[a-zA-Z]+$",
+                                    "title": "Display Component Name"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "description": "Name format for input components that collect user data.",
+                                    "pattern": "^[a-zA-Z]+$",
+                                    "title": "Input Component Name"
+                                  }
+                                ],
+                                "title": "Name",
+                                "description": "The name value.",
+                                "oneOfTitles": [
+                                  "Display Component Name",
+                                  "Input Component Name"
+                                ]
+                              },
+                              "title": {
+                                "type": [
+                                  "array",
+                                  "boolean",
+                                  "number",
+                                  "object",
+                                  "string",
+                                  "null"
+                                ],
+                                "oneOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Title format for display-only components.",
+                                    "title": "Display Component Title"
+                                  },
+                                  {
+                                    "type": "string",
+                                    "description": "Title displayed above input components.",
+                                    "title": "Input Component Title"
+                                  }
+                                ],
+                                "title": "Title",
+                                "description": "The title value.",
+                                "oneOfTitles": [
+                                  "Display Component Title",
+                                  "Input Component Title"
+                                ]
+                              },
+                              "hint": {
+                                "type": "string",
+                                "description": "Additional guidance text displayed below the component title",
+                                "title": "Hint"
+                              },
+                              "options": {
+                                "type": "object",
+                                "description": "Component-specific configuration options",
+                                "default": {},
+                                "properties": {
+                                  "rows": {
+                                    "type": "number",
+                                    "description": "Number of rows for textarea components",
+                                    "title": "Rows"
+                                  },
+                                  "maxWords": {
+                                    "type": "number",
+                                    "description": "Maximum number of words allowed in text inputs",
+                                    "title": "Max Words"
+                                  },
+                                  "maxDaysInPast": {
+                                    "type": "number",
+                                    "description": "Maximum days in the past allowed for date inputs",
+                                    "title": "Max Days In Past"
+                                  },
+                                  "maxDaysInFuture": {
+                                    "type": "number",
+                                    "description": "Maximum days in the future allowed for date inputs",
+                                    "title": "Max Days In Future"
+                                  },
+                                  "customValidationMessage": {
+                                    "type": "string",
+                                    "description": "Custom error message for validation failures",
+                                    "title": "Custom Validation Message"
+                                  },
+                                  "customValidationMessages": {
+                                    "type": "object",
+                                    "description": "Custom error messages keyed by validation rule name",
+                                    "properties": {},
+                                    "additionalProperties": true,
+                                    "title": "Custom Validation Messages"
+                                  }
+                                },
+                                "additionalProperties": true,
+                                "title": "Options"
+                              },
+                              "schema": {
+                                "type": "object",
+                                "description": "Validation rules for the component",
+                                "default": {},
+                                "properties": {
+                                  "min": {
+                                    "type": "number",
+                                    "description": "Minimum value or length for validation",
+                                    "title": "Min"
+                                  },
+                                  "max": {
+                                    "type": "number",
+                                    "description": "Maximum value or length for validation",
+                                    "title": "Max"
+                                  },
+                                  "length": {
+                                    "type": "number",
+                                    "description": "Exact length required for validation",
+                                    "title": "Length"
+                                  }
+                                },
+                                "additionalProperties": true,
+                                "title": "Schema"
+                              },
+                              "list": {
+                                "type": "string",
+                                "description": "Reference to a predefined list of options for select components",
+                                "title": "List"
+                              }
+                            },
+                            "required": [
+                              "type"
+                            ],
+                            "additionalProperties": true,
+                            "title": "Components Item"
+                          },
+                          "title": "Components"
+                        }
+                      },
+                      "required": [
+                        "components"
+                      ],
+                      "additionalProperties": false,
+                      "title": "Conditional"
+                    },
+                    "condition": {
+                      "type": "string",
+                      "description": "Condition that determines if this item is shown",
+                      "title": "Condition"
+                    },
+                    "hint": {
+                      "type": "string",
+                      "description": "Optional hint text to be shown on list item",
+                      "title": "Hint"
+                    },
+                    "value": {
+                      "type": "number",
+                      "description": "Numeric value stored when this item is selected",
+                      "title": "Value"
+                    }
+                  },
+                  "required": [
+                    "value"
+                  ],
+                  "additionalProperties": false,
+                  "title": "Items (array) Item"
+                },
+                "title": "Number List Items"
+              }
+            ],
+            "title": "Items",
+            "description": "The items value.",
+            "oneOfTitles": [
+              "Items (array)",
+              "Items (array)"
+            ]
+          }
+        },
+        "required": [
+          "name",
+          "title",
+          "type"
+        ],
+        "additionalProperties": false,
+        "title": "Lists Item"
+      },
+      "title": "Lists"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Custom metadata for the form",
+      "properties": {
+        "a": {
+          "type": [
+            "array",
+            "boolean",
+            "number",
+            "object",
+            "string",
+            "null"
+          ],
+          "title": "A",
+          "description": "The a value."
+        }
+      },
+      "additionalProperties": true,
+      "title": "Metadata"
+    },
+    "declaration": {
+      "type": "string",
+      "description": "Declaration text shown on the summary page",
+      "title": "Declaration"
+    },
+    "skipSummary": {
+      "type": [
+        "array",
+        "boolean",
+        "number",
+        "object",
+        "string",
+        "null"
+      ],
+      "description": "option to skip the summary page",
+      "title": "Skip Summary"
+    },
+    "phaseBanner": {
+      "type": "object",
+      "description": "Phase banner configuration",
+      "properties": {
+        "phase": {
+          "type": "string",
+          "description": "Development phase of the service (alpha or beta)",
+          "enum": [
+            "alpha",
+            "beta"
+          ],
+          "title": "Phase"
+        }
+      },
+      "additionalProperties": false,
+      "title": "Phase Banner"
+    },
+    "outputEmail": {
+      "type": "string",
+      "description": "Email address where form submissions are sent",
+      "format": "email",
+      "title": "Output Email"
+    },
+    "output": {
+      "type": "object",
+      "description": "Configuration for submission output format",
+      "properties": {
+        "audience": {
+          "type": "string",
+          "description": "Target audience for the output (human readable or machine processable)",
+          "enum": [
+            "human",
+            "machine"
+          ],
+          "title": "Audience"
+        },
+        "version": {
+          "type": "string",
+          "description": "Version identifier for the output format",
+          "title": "Version"
+        }
+      },
+      "required": [
+        "audience",
+        "version"
+      ],
+      "additionalProperties": false,
+      "title": "Output"
+    }
+  },
+  "required": [
+    "pages",
+    "sections"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "conditionGroupSchema": {
+      "type": "object",
+      "description": "Group of conditions combined with logical operators",
+      "properties": {
+        "conditions": {
+          "type": "array",
+          "description": "Array of conditions or condition references in this group",
+          "items": {
+            "anyOf": [
+              {
+                "type": "object",
+                "description": "Condition definition specifying a logical comparison",
+                "properties": {
+                  "field": {
+                    "type": "object",
+                    "description": "The form field being evaluated in this condition",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "Component name referenced by this condition",
+                        "title": "Name"
+                      },
+                      "type": {
+                        "type": "string",
+                        "description": "Data type of the field (e.g., string, number, date)",
+                        "title": "Type"
+                      },
+                      "display": {
+                        "type": "string",
+                        "description": "Human-readable name of the field for display purposes",
+                        "title": "Display"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "type",
+                      "display"
+                    ],
+                    "additionalProperties": false,
+                    "title": "Field"
+                  },
+                  "operator": {
+                    "type": "string",
+                    "description": "Comparison operator (equals, greaterThan, contains, etc.)",
+                    "title": "Operator"
+                  },
+                  "value": {
+                    "description": "Value to compare the field against, either fixed or relative date",
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "description": "Value specification for a condition",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "description": "Data type of the value (e.g., string, number, date)",
+                            "title": "Type"
+                          },
+                          "value": {
+                            "type": "string",
+                            "description": "The actual value to compare against",
+                            "title": "Value"
+                          },
+                          "display": {
+                            "type": "string",
+                            "description": "Human-readable version of the value for display purposes",
+                            "title": "Display"
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "value",
+                          "display"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Static Value"
+                      },
+                      {
+                        "type": "object",
+                        "description": "Relative date specification for date-based conditions",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "description": "Data type identifier, should be \"RelativeDate\"",
+                            "title": "Type"
+                          },
+                          "period": {
+                            "type": "string",
+                            "description": "Numeric amount of the time period, as a string",
+                            "title": "Period"
+                          },
+                          "unit": {
+                            "type": "string",
+                            "description": "Time unit (e.g., days, weeks, months, years)",
+                            "title": "Unit"
+                          },
+                          "direction": {
+                            "type": "string",
+                            "description": "Temporal direction, either \"past\" or \"future\"",
+                            "title": "Direction"
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "period",
+                          "unit",
+                          "direction"
+                        ],
+                        "additionalProperties": false,
+                        "title": "Relative Date Value"
+                      }
+                    ],
+                    "title": "Value",
+                    "anyOfTitles": [
+                      "Static Value",
+                      "Relative Date Value"
+                    ]
+                  },
+                  "coordinator": {
+                    "type": "string",
+                    "description": "Logical operator connecting this condition with others (AND, OR)",
+                    "title": "Coordinator"
+                  }
+                },
+                "required": [
+                  "operator"
+                ],
+                "additionalProperties": false,
+                "title": "Condition Definition"
+              },
+              {
+                "type": "object",
+                "description": "Reference to a named condition defined elsewhere",
+                "properties": {
+                  "conditionName": {
+                    "type": "string",
+                    "description": "Name of the referenced condition",
+                    "title": "Condition Name"
+                  },
+                  "conditionDisplayName": {
+                    "type": "string",
+                    "description": "Human-readable name of the condition for display purposes",
+                    "title": "Condition Display Name"
+                  },
+                  "coordinator": {
+                    "type": "string",
+                    "description": "Logical operator connecting this condition with others (AND, OR)",
+                    "title": "Coordinator"
+                  }
+                },
+                "required": [
+                  "conditionName",
+                  "conditionDisplayName"
+                ],
+                "additionalProperties": false,
+                "title": "Condition Reference"
+              },
+              {
+                "$ref": "#/$defs/conditionGroupSchema",
+                "title": "Nested Condition Group",
+                "description": "A nested group of conditions that allows building complex logical expressions with multiple levels."
+              }
+            ],
+            "title": "Conditions Item",
+            "anyOfTitles": [
+              "Condition Definition",
+              "Condition Reference",
+              "Nested Condition Group"
+            ]
+          },
+          "title": "Conditions"
+        }
+      },
+      "additionalProperties": false,
+      "title": "Condition Group Schema"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Form Definition Schema",
+  "$id": "@defra/forms-model/schemas/form-definition-schema.json"
+}