defra_ruby_template 3.13.0

data/node_modules/govuk-frontend/govuk/components/details/fixtures.json

@@ -0,0 +1,103 @@
+{
+    "component": "details",
+    "fixtures": [
+        {
+            "name": "default",
+            "options": {
+                "summaryText": "Help with nationality",
+                "text": "We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post."
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Help with nationality\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.\n  </div>\n</details>",
+            "hidden": false
+        },
+        {
+            "name": "expanded",
+            "options": {
+                "id": "help-with-nationality",
+                "summaryText": "Help with nationality",
+                "text": "We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.",
+                "open": true
+            },
+            "html": "<details id=\"help-with-nationality\" class=\"govuk-details\" data-module=\"govuk-details\" open>\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Help with nationality\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.\n  </div>\n</details>",
+            "hidden": false
+        },
+        {
+            "name": "with html",
+            "options": {
+                "summaryText": "Where to find your National Insurance Number",
+                "html": "Your National Insurance number can be found on\n<ul>\n  <li>your National Insurance card</li>\n  <li>your payslip</li>\n  <li>P60</li>\n  <li>benefits information</li>\n  <li>tax return</li>\n</ul>\n"
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Where to find your National Insurance Number\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Your National Insurance number can be found on\n<ul>\n  <li>your National Insurance card</li>\n  <li>your payslip</li>\n  <li>P60</li>\n  <li>benefits information</li>\n  <li>tax return</li>\n</ul>\n\n  </div>\n</details>",
+            "hidden": false
+        },
+        {
+            "name": "id",
+            "options": {
+                "id": "my-details-element",
+                "summaryText": "Expand this section",
+                "text": "Here are some more details"
+            },
+            "html": "<details id=\"my-details-element\" class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "html as text",
+            "options": {
+                "summaryText": "Expand this section",
+                "text": "More about the greater than symbol (>)"
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    More about the greater than symbol (&gt;)\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "html",
+            "options": {
+                "summaryText": "Expand this section",
+                "html": "More about <b>bold text</b>"
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    More about <b>bold text</b>\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "summary html as text",
+            "options": {
+                "summaryText": "The greater than symbol (>) is the best",
+                "text": "Here are some more details"
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      The greater than symbol (&gt;) is the best\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "summary html",
+            "options": {
+                "summaryHtml": "Use <b>bold text</b> sparingly",
+                "text": "Here are some more details"
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Use <b>bold text</b> sparingly\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "classes",
+            "options": {
+                "classes": "some-additional-class",
+                "text": "Here are some more details",
+                "summaryText": "Expand me"
+            },
+            "html": "<details class=\"govuk-details some-additional-class\" data-module=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand me\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>",
+            "hidden": true
+        },
+        {
+            "name": "attributes",
+            "options": {
+                "text": "Here are some more details",
+                "summaryText": "Expand me",
+                "attributes": {
+                    "data-some-data-attribute": "i-love-data",
+                    "another-attribute": "foo"
+                }
+            },
+            "html": "<details class=\"govuk-details\" data-module=\"govuk-details\" data-some-data-attribute=\"i-love-data\" another-attribute=\"foo\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand me\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>",
+            "hidden": true
+        }
+    ]
+}

data/node_modules/govuk-frontend/govuk/components/details/implementation.md

@@ -0,0 +1,43 @@
+## Implementation notes
+
+### Marker styling
+
+Firefox uses display: list-item to show the arrow marker for the summary
+element.
+
+Unfortunately we want to use `display: inline-block` to 'shrink-wrap' the focus
+outline around the summary text, which means that the arrow no longer shows up.
+
+Previously in GOV.UK Elements we resolved this by targeting Firefox specifically
+and reverting to `display: list-item`:
+
+```
+@-moz-document regexp('.*') {
+  details summary:not([tabindex]) {
+    // Allow duplicate properties, override the summary display property
+    // scss-lint:disable DuplicateProperty
+    display: list-item;
+    display: revert;
+  }
+}
+```
+
+However, `@-moz-document` has been removed in Firefox nightly as of 29th Nov
+2017 so with this in mind we have taken a different approach, hiding the
+browser's marker and injecting and styling our own one across all browsers
+instead.
+
+This also gives us more control over the styling of the marker, allowing us for
+example to align the summary and disclosed text correctly across all browsers.
+
+The downside of this approach is that older browsers that require a polyfill for
+the details element will display the marker even when Javascript is disabled.
+Whilst this is not perfect, it is a cosmetic issue and the user will still be
+able to access the disclosed content.
+
+For the arrows themselves, we originally tried using unicode glyphs –
+specifically \25B6 (Black right-pointing triangle) and 25BC (Black down-pointing
+triangle) but Android insists on substituting the the former for an emoji even
+when the \00FE0E modifier is applied. Sad face.
+
+Hence the border-based triangles we are using today.

data/node_modules/govuk-frontend/govuk/components/details/macro-options.json

@@ -0,0 +1,50 @@
+[
+    {
+        "name": "summaryText",
+        "type": "string",
+        "required": true,
+        "description": "If `summmaryHtml` is set, this is not required. Text to use within the summary element (the visible part of the details element). If `summaryHtml` is provided, the `summaryText` argument will be ignored."
+    },
+    {
+        "name": "summaryHtml",
+        "type": "string",
+        "required": true,
+        "description": "If `summmaryText` is set, this is not required. HTML to use within the summary element (the visible part of the details element). If `summaryHtml` is provided, the `summaryText` argument will be ignored."
+    },
+    {
+        "name": "text",
+        "type": "string",
+        "required": true,
+        "description": "If `html` is set, this is not required. Text to use within the disclosed part of the details element. If `html` is provided, the `text` argument will be ignored."
+    },
+    {
+        "name": "html",
+        "type": "string",
+        "required": true,
+        "description": "If `text` is set, this is not required. HTML to use within the disclosed part of the details element. If `html` is provided, the `text` argument will be ignored."
+    },
+    {
+        "name": "id",
+        "type": "string",
+        "required": false,
+        "description": "Id to add to the details element."
+    },
+    {
+        "name": "open",
+        "type": "boolean",
+        "required": false,
+        "description": "If true, details element will be expanded."
+    },
+    {
+        "name": "classes",
+        "type": "string",
+        "required": false,
+        "description": "Classes to add to the `<details>` element."
+    },
+    {
+        "name": "attributes",
+        "type": "object",
+        "required": false,
+        "description": "HTML attributes (for example data attributes) to add to the `<details>` element."
+    }
+]

data/node_modules/govuk-frontend/govuk/components/details/macro.njk

@@ -0,0 +1,3 @@
+{% macro govukDetails(params) %}
+  {%- include "./template.njk" -%}
+{% endmacro %}

data/node_modules/govuk-frontend/govuk/components/details/template.njk

@@ -0,0 +1,10 @@
+<details {%- if params.id %} id="{{params.id}}"{% endif %} class="govuk-details {%- if params.classes %} {{ params.classes }}{% endif %}" data-module="govuk-details" {%- for attribute, value in params.attributes %} {{attribute}}="{{value}}"{% endfor %} {{- " open" if params.open }}>
+  <summary class="govuk-details__summary">
+    <span class="govuk-details__summary-text">
+      {{ params.summaryHtml | safe if params.summaryHtml else params.summaryText }}
+    </span>
+  </summary>
+  <div class="govuk-details__text">
+    {{ params.html | safe if params.html else params.text }}
+  </div>
+</details>

data/node_modules/govuk-frontend/govuk/components/error-message/README.md

@@ -0,0 +1,15 @@
+# Error message
+
+## Installation
+
+See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
+
+## Guidance and Examples
+
+Find out when to use the error message component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/error-message).
+
+## Component options
+
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
+
+See [options table](https://design-system.service.gov.uk/components/error-message/#options-error-message-example) for details.

data/node_modules/govuk-frontend/govuk/components/error-message/_error-message.scss

@@ -0,0 +1,2 @@
+@import "../../base";
+@import "./index";

data/node_modules/govuk-frontend/govuk/components/error-message/_index.scss

@@ -0,0 +1,11 @@
+@include govuk-exports("govuk/component/error-message") {
+  .govuk-error-message {
+    @include govuk-font($size: 19, $weight: bold);
+
+    display: block;
+    margin-bottom: govuk-spacing(3);
+    clear: both;
+
+    color: $govuk-error-colour;
+  }
+}

data/node_modules/govuk-frontend/govuk/components/error-message/fixtures.json

@@ -0,0 +1,77 @@
+{
+    "component": "error-message",
+    "fixtures": [
+        {
+            "name": "default",
+            "options": {
+                "text": "Error message about full name goes here"
+            },
+            "html": "<span class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Error message about full name goes here\n</span>",
+            "hidden": false
+        },
+        {
+            "name": "id",
+            "options": {
+                "id": "my-error-message-id",
+                "text": "This is an error message"
+            },
+            "html": "<span id=\"my-error-message-id\" class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "classes",
+            "options": {
+                "classes": "custom-class",
+                "text": "This is an error message"
+            },
+            "html": "<span class=\"govuk-error-message custom-class\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "html as text",
+            "options": {
+                "text": "Unexpected > in body"
+            },
+            "html": "<span class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Unexpected &gt; in body\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "html",
+            "options": {
+                "html": "Unexpected <b>bold text</b> in body copy"
+            },
+            "html": "<span class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Unexpected <b>bold text</b> in body copy\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "attributes",
+            "options": {
+                "text": "This is an error message",
+                "attributes": {
+                    "data-test": "attribute",
+                    "id": "my-error-message"
+                }
+            },
+            "html": "<span class=\"govuk-error-message\" data-test=\"attribute\" id=\"my-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "with visually hidden text",
+            "options": {
+                "text": "Rhowch eich enw llawn",
+                "visuallyHiddenText": "Gwall"
+            },
+            "html": "<span class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Gwall:</span> Rhowch eich enw llawn\n</span>",
+            "hidden": true
+        },
+        {
+            "name": "visually hidden text removed",
+            "options": {
+                "text": "There is an error on line 42",
+                "visuallyHiddenText": false
+            },
+            "html": "<span class=\"govuk-error-message\">\n  There is an error on line 42\n</span>",
+            "hidden": true
+        }
+    ]
+}

data/node_modules/govuk-frontend/govuk/components/error-message/macro-options.json

@@ -0,0 +1,38 @@
+[
+    {
+        "name": "text",
+        "type": "string",
+        "required": true,
+        "description": "If `html` is set, this is not required. Text to use within the error message. If `html` is provided, the `text` argument will be ignored."
+    },
+    {
+        "name": "html",
+        "type": "string",
+        "required": true,
+        "description": "If `text` is set, this is not required. HTML to use within the error message. If `html` is provided, the `text` argument will be ignored."
+    },
+    {
+        "name": "id",
+        "type": "string",
+        "required": false,
+        "description": "Id attribute to add to the error message span tag."
+    },
+    {
+        "name": "classes",
+        "type": "string",
+        "required": false,
+        "description": "Classes to add to the error message span tag."
+    },
+    {
+        "name": "attributes",
+        "type": "object",
+        "required": false,
+        "description": "HTML attributes (for example data attributes) to add to the error message span tag"
+    },
+    {
+        "name": "visuallyHiddenText",
+        "type": "string",
+        "required": false,
+        "description": "A visually hidden prefix used before the error message. Defaults to \"Error\"."
+    }
+]

data/node_modules/govuk-frontend/govuk/components/error-message/macro.njk

@@ -0,0 +1,3 @@
+{% macro govukErrorMessage(params) %}
+  {%- include "./template.njk" -%}
+{% endmacro %}

data/node_modules/govuk-frontend/govuk/components/error-message/template.njk

@@ -0,0 +1,6 @@
+{% set visuallyHiddenText = params.visuallyHiddenText | default("Error") -%}
+
+<span {%- if params.id %} id="{{ params.id }}"{% endif %} class="govuk-error-message{%- if params.classes %} {{ params.classes }}{% endif %}" {%- for attribute, value in params.attributes %} {{ attribute }}="{{ value }}"{% endfor -%}>
+  {% if visuallyHiddenText %}<span class="govuk-visually-hidden">{{ visuallyHiddenText }}:</span> {% endif -%}
+  {{ params.html | safe if params.html else params.text }}
+</span>

data/node_modules/govuk-frontend/govuk/components/error-summary/README.md

@@ -0,0 +1,15 @@
+# Error summary
+
+## Installation
+
+See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
+
+## Guidance and Examples
+
+Find out when to use the error summary component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/error-summary).
+
+## Component options
+
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
+
+See [options table](https://design-system.service.gov.uk/components/error-summary/#options-error-summary-example) for details.

data/node_modules/govuk-frontend/govuk/components/error-summary/_error-summary.scss

@@ -0,0 +1,2 @@
+@import "../../base";
+@import "./index";

data/node_modules/govuk-frontend/govuk/components/error-summary/_index.scss

@@ -0,0 +1,43 @@
+@import "../../core/lists";
+
+@include govuk-exports("govuk/component/error-summary") {
+  .govuk-error-summary {
+    @include govuk-text-colour;
+    @include govuk-responsive-padding(4);
+    @include govuk-responsive-margin(8, "bottom");
+
+    border: $govuk-border-width solid $govuk-error-colour;
+
+    &:focus {
+      outline: $govuk-focus-width solid $govuk-focus-colour;
+    }
+  }
+
+  .govuk-error-summary__title {
+    @include govuk-font($size: 24, $weight: bold);
+
+    margin-top: 0;
+    @include govuk-responsive-margin(4, "bottom");
+  }
+
+  .govuk-error-summary__body {
+    @include govuk-font($size: 19);
+
+    p {
+      margin-top: 0;
+      @include govuk-responsive-margin(4, "bottom");
+    }
+  }
+
+  // Cross-component class - adjusts styling of list component
+  .govuk-error-summary__list {
+    margin-top: 0;
+    margin-bottom: 0;
+  }
+
+  .govuk-error-summary__list a {
+    @include govuk-typography-weight-bold;
+    @include govuk-link-common;
+    @include govuk-link-style-error;
+  }
+}