defra_ruby_template 5.11.0 → 6.4.0

data/node_modules/govuk-frontend/dist/govuk/helpers/_clearfix.import.scss

@@ -0,0 +1,2 @@
+@forward "clearfix";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_clearfix.scss

@@ -14,4 +14,3 @@
   }
 }
 
-/*# sourceMappingURL=_clearfix.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_colour.import.scss

@@ -0,0 +1,2 @@
+@forward "colour";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_colour.scss

@@ -1,48 +1,201 @@
-@import "../settings/colours-palette";
-@import "../settings/colours-organisations";
-@import "../settings/warnings";
-
 ////
 /// @group helpers/colour
 ////
+@use "sass:list";
+@use "sass:map";
+@use "sass:meta";
+@use "sass:string";
+
+@use "../settings/colours-palette--internal";
+@use "../settings/warnings--internal";
+
+@use "../settings/colours-functional" as *;
+@use "../settings/colours-organisations" as *;
 
-/// Get colour
+/// Get a colour from the palette
 ///
-/// @param {String | Colour} $colour - Name of colour from the colour palette
-///   (`$govuk-colours`)
-/// @param {String | Colour | Boolean} $legacy [false] - Deprecated.
-///   The `$legacy` parameter is deprecated and is non-operational, as the
-///   legacy colour palette has been removed. The parameter will be removed in
-///   the next major version.
+/// Before using this function, check if your use case is covered by a
+/// functional colour. For example, use `govuk-functional-colour("link")` for
+/// links rather than `govuk-colour("blue")`.
+///
+/// @param {String | Colour} $colour - Name of colour from the [colour
+///   palette](https://design-system.service.gov.uk/styles/colour/#add-colours-using-govuk-colour)
+/// @param {String | Colour} $variant - Name of the variant from the [colour
+///   palette](https://design-system.service.gov.uk/styles/colour/#add-colours-using-govuk-colour)
 /// @return {Colour} Representation of named colour
 ///
+/// @example scss - Getting the primary variant of a colour
+///   .my-component {
+///     color: govuk-colour("blue");
+///   }
+///
+/// @example scss - Getting a 50% shade of blue
+///   .my-component {
+///     color: govuk-colour("blue", $variant: "shade-50")
+///   }
+///
 /// @throw if `$colour` is not a colour from the colour palette
+/// @throw if `$variant` is not a variant of the `$colour` in the colour palette
+/// @throw if the palette is misformatted and doesn't associate a colour or map to `$colour`
 /// @access public
 
-@function govuk-colour($colour, $legacy: false) {
-  // Output a warning if $legacy is set to anything.
-  @if $legacy and _should-warn("legacy-colour-param") {
-    @warn _warning-text("legacy-colour-param", "The `$legacy` parameter of " +
-    "`govuk-colour` is deprecated and is non-operational. It will be " +
-    "removed in the next major version.");
+@function govuk-colour($colour, $variant: primary, $colours: colours-palette--internal.$govuk-palette) {
+  // Sass parses unquoted colours as colours, so we need to turn them into
+  // strings before looking them up in the colour palette
+  // https://sass-lang.com/documentation/values/strings#unquoted
+  @if meta.type-of($colour) != "string" {
+    $colour: "#{$colour}";
+  }
+
+  $colour-variants: map.get($colours, $colour);
+
+  @if not $colour-variants {
+    // To ease the transition between the brand palette and old GOV.UK Frontend colours
+    // we'll automatically convert old colour names into their equivalent in the palette
+    @if $colours == colours-palette--internal.$govuk-palette {
+      $corresponding-colour: _govuk-corresponding-brand-colour($colour);
+      @if $corresponding-colour {
+        @return $corresponding-colour;
+      }
+    }
+
+    @error "Unknown colour `#{$colour}` (available colours: #{map.keys($colours)})";
+  }
+
+  // Some colours may not have variants, if that's the case, we can return the colour straight away
+  @if meta.type-of($colour-variants) == "color" {
+    @return $colour-variants;
+  }
+
+  @if meta.type-of($colour-variants) != "map" {
+    @error "Colour `#{$colour}` should either be a `map` or `color`, not a `#{meta.type-of($colour-variants)}`";
+  }
+
+  $result: map.get($colour-variants, $variant);
+
+  @if not $result {
+    @error "Unknown variant `#{$variant}` for colour `#{$colour}` (available variants: #{map.keys($colour-variants)})";
+  }
+
+  @return $result;
+}
+
+@function _govuk-corresponding-brand-colour($colour) {
+  $pre-brand-colour: map.get(colours-palette--internal.$govuk-pre-brand-colours, $colour);
+
+  @if $pre-brand-colour {
+    $corresponding-colour: list.nth($pre-brand-colour, 1);
+    $corresponding-variant: list.nth($pre-brand-colour, 2);
+
+    $corresponding-govuk-colour-call: 'govuk-colour("#{$corresponding-colour}", $variant: "#{$corresponding-variant}")';
+
+    @if _should-warn("pre-brand-colour") {
+      @warn warnings--internal.warning-text("pre-brand-colour",
+        "We've updated GOV.UK Frontend's colour palette. Use " +
+        "`#{$corresponding-govuk-colour-call}` instead of " +
+        "`govuk-colour(\"#{$colour}\")`. The `#{$colour}` colour is " +
+        "deprecated and we'll remove it in the next major version."
+      );
+    }
+
+    @return govuk-colour($corresponding-colour, $variant: $corresponding-variant);
   }
+}
 
-  @if type-of($colour) == "color" {
-    // stylelint-disable-next-line scss/function-quote-no-quoted-strings-inside
-    $colour: quote("#{$colour}");
+/// Get a functional colour
+///
+/// @param {String|Colour} $colour - Name of the colour from the list of
+///   [functional colours](https://design-system.service.gov.uk/styles/colour/)
+/// @return {String} A reference to the functional colour's custom property
+///   wrapped in a var function, with the functional colour's hex value as a
+///   fallback value.
+///
+/// @example scss - Getting a functional colour
+///   .branded-element {
+///     color: govuk-functional-colour('brand');
+///   }
+///
+/// @example css - Output from getting a functional colour
+///   .branded-element {
+///     /* Assuming the 'brand' colour is hotpink */
+///     color: var(--govuk-brand-colour, hotpink);
+///   }
+///
+/// @throw if `$colour` is not an functional colour of GOV.UK Frontend
+/// @access public
+/// @see $govuk-functional-colours
+@function govuk-functional-colour($colour) {
+  // Sass parses unquoted colours as colours, so we need to turn them into
+  // strings before looking them up in the colour palette
+  // https://sass-lang.com/documentation/values/strings#unquoted
+  @if meta.type-of($colour) != "string" {
+    $colour: "#{$colour}";
   }
 
-  @if not map-has-key($govuk-colours, $colour) {
-    @error "Unknown colour `#{$colour}`";
+  @if map.has-key($govuk-functional-colours, $colour) {
+    $value: govuk-resolve-colour(map.get($govuk-functional-colours, $colour));
+
+    @return var(--govuk-#{$colour}-colour, #{$value});
   }
 
-  @return map-get($govuk-colours, $colour);
+  @error "Unknown colour `#{$colour}` (available colours: #{map.keys($govuk-functional-colours)})";
 }
 
+/// Resolves the given reference to a colour in the palette
+///
+/// @param {Map|Colour} $colour-reference - A map with the `name`, and optionally a `variant` for the colour in the palette
+/// @returns {Colour} The colour
+/// @throws if the `name` is present but falsy
+/// @throws if the `variant` is present but falsy
+/// @access public
+@function govuk-resolve-colour($colour-reference) {
+  // If the reference is already a colour, return the colour
+  @if meta.type-of($colour-reference) == "color" {
+    @return $colour-reference;
+  }
+
+  @if not meta.type-of($colour-reference) == "map" {
+    @error 'Colour reference should be a Sass colour or a Sass map';
+  }
+
+  $name: map.get($colour-reference, "name");
+  @if not $name or $name == "" {
+    @error "Colour reference `name` shouldn't be empty.";
+  }
+
+  $variant: "primary";
+  @if map.has-key($colour-reference, "variant") {
+    $variant: map.get($colour-reference, "variant");
+  }
+
+  @if not $variant or $variant == "" {
+    @error "Colour reference `variant` shouldn't be empty.";
+  }
+
+  @return govuk-colour($name, $variant: $variant);
+}
+
+/// Organisation colour aliases
+///
+/// Some organisations have been renamed within our code over time. Here we
+/// map the prior key to the new equivalent key.
+///
+/// Note: This is for internal renames only. If a department has changed name
+/// or brand colour in a machinery of government change, it should be added to
+/// $govuk-colours-organisations as a new entry with any superseded
+/// organisations marked deprecated.
+///
+/// @type Map
+///
+/// @access private
+
+$_govuk-colours-organisations-aliases: (
+  "department-for-business-and-trade": "department-for-business-trade"
+);
+
 /// Get the colour for a government organisation
 ///
 /// @param {String} $organisation - Organisation name, lowercase, hyphenated
-/// @param {Boolean} $websafe - Deprecated. Use $contrast-safe instead.
 /// @param {Boolean} $contrast-safe [true] - By default a version of the colour
 ///   will be returned which has a minimum 4.5:1 contrast ratio when used with
 ///   white, as per the WCAG 2.1 Level AA guidelines. If you want to use the
@@ -54,85 +207,33 @@
 /// @throw if `$organisation` is not a known organisation
 /// @access public
 
-@function govuk-organisation-colour($organisation, $websafe: null, $contrast-safe: true) {
+@function govuk-organisation-colour($organisation, $contrast-safe: true) {
   // Check if the $organisation exists in the aliases map. If so, change the
   // value of $organisation to the aliased value.
-  @if map-has-key($_govuk_colours-organisations-aliases, $organisation) {
-    $organisation: map-get($_govuk_colours-organisations-aliases, $organisation);
+  @if map.has-key($_govuk_colours-organisations-aliases, $organisation) {
+    $organisation: map.get($_govuk_colours-organisations-aliases, $organisation);
   }
 
   // Check to see if the organisation exists
-  @if not map-has-key($govuk-colours-organisations, $organisation) {
+  @if not map.has-key($govuk-colours-organisations, $organisation) {
     @error "Unknown organisation `#{$organisation}`";
   }
 
-  // Output a deprecation warning if the legacy colour palette is being used.
-  // Remove in next major version.
-  $is-legacy: $govuk-colours-organisations == $_govuk-legacy-organisation-colours;
-  @if $is-legacy and _should-warn("legacy-organisation-colours") {
-    @warn _warning-text("legacy-organisation-colours",
-      "We've updated the organisation colour palette. Opt in to the new " +
-      "colours using `$govuk-new-organisation-colours: true`. The old " +
-      "palette is deprecated and we'll remove it in the next major version."
-    );
-  }
+  $org-colour: map.get($govuk-colours-organisations, $organisation);
 
-  // Output a warning if $websafe is set.
-  @if $websafe and _should-warn("organisation-colour-websafe-param") {
-    @warn _warning-text("organisation-colour-websafe-param",
-      "The `$websafe` parameter of `govuk-organisation-colour` has been " +
-      "renamed to `$contrast-safe`. The old parameter name will be removed in " +
-      "the next major version."
-    );
-  }
-
-  $org-colour: map-get($govuk-colours-organisations, $organisation);
-
-  @if map-has-key($org-colour, deprecation-message) and _should-warn("organisation-colours") {
-    @warn _warning-text(
+  // If the organisation has a deprecation message associated with it
+  // (e.g. it has ceased to exist) then output a warning.
+  @if map.has-key($org-colour, "deprecation-message") and _should-warn("organisation-colours") {
+    @warn warnings--internal.warning-text(
       "organisation-colours",
-      map-get($org-colour, deprecation-message)
+      map.get($org-colour, "deprecation-message")
     );
   }
 
-  // If the $websafe parameter is being used (it has been explicitly set as true
-  // or false), assume the user hasn't updated to use $contrast-safe yet and map
-  // the old parameter's value onto the new parameter.
-  @if type-of($websafe) != "null" {
-    $contrast-safe: $websafe;
-  }
-
-  // Determine the contrast-safe key to use depending on whether it's the new
-  // palette or the legacy palette
-  $safe-key: if($govuk-new-organisation-colours, "contrast-safe", "colour-websafe");
-
-  @if $contrast-safe and map-has-key($org-colour, $safe-key) {
-    @return map-get($org-colour, $safe-key);
+  @if $contrast-safe and map.has-key($org-colour, "contrast-safe") {
+    @return map.get($org-colour, "contrast-safe");
   } @else {
-    @return map-get($org-colour, colour);
+    @return map.get($org-colour, "colour");
   }
 }
 
-/// Make a colour darker by mixing it with black
-///
-/// @param {Colour} $colour - colour to shade
-/// @param {Number} $percentage - percentage of black to mix with $colour
-/// @return {Colour}
-/// @access public
-
-@function govuk-shade($colour, $percentage) {
-  @return mix(#000000, $colour, $percentage);
-}
-
-/// Make a colour lighter by mixing it with white
-///
-/// @param {Colour} $colour - colour to tint
-/// @param {Number} $percentage - percentage of white to mix with $colour
-/// @return {Colour}
-/// @access public
-
-@function govuk-tint($colour, $percentage) {
-  @return mix(govuk-colour("white"), $colour, $percentage);
-}
-
-/*# sourceMappingURL=_colour.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_device-pixels.import.scss

@@ -0,0 +1,2 @@
+@forward "device-pixels";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_device-pixels.scss

@@ -1,3 +1,5 @@
+@use "sass:list";
+
 ////
 /// @group helpers
 ////
@@ -35,4 +37,3 @@
   }
 }
 
-/*# sourceMappingURL=_device-pixels.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_focused.import.scss

@@ -0,0 +1,2 @@
+@forward "focused";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_focused.scss

@@ -2,11 +2,19 @@
 /// @group helpers/accessibility
 ////
 
+@use "../settings/measurements" as *;
+@use "colour" as *;
+
 /// Focused text
 ///
 /// Provides an outline to clearly indicate when the target element is focused.
 /// Used for interactive text-based elements.
 ///
+/// @example scss - Styling the focus state for a link
+///   .govuk-link:focus {
+///     @include govuk-focused-text;
+///   }
+///
 /// @access public
 
 @mixin govuk-focused-text {
@@ -15,11 +23,11 @@
   // transparent outline which will be set to a visible colour.
 
   outline: $govuk-focus-width solid transparent;
-  color: $govuk-focus-text-colour;
-  background-color: $govuk-focus-colour;
+  color: govuk-functional-colour(focus-text);
+  background-color: govuk-functional-colour(focus);
   box-shadow:
-    0 -2px $govuk-focus-colour,
-    0 4px $govuk-focus-text-colour;
+    0 -2px govuk-functional-colour(focus),
+    0 4px govuk-functional-colour(focus-text);
   // When link is focussed, hide the default underline since the
   // box shadow adds the "underline"
   text-decoration: none;
@@ -47,13 +55,42 @@
 /// govuk-focused-box draws an outline around all sides of the element.
 /// Best used for non-text content contained within links.
 ///
+/// @example scss - Styling the focus state for a linked image
+///   .govuk-link-image:focus {
+///     @include govuk-focused-box;
+///   }
+///
 /// @access public
 
 @mixin govuk-focused-box {
   outline: $govuk-focus-width solid transparent;
   box-shadow:
-    0 0 0 4px $govuk-focus-colour,
-    0 0 0 8px $govuk-focus-text-colour;
+    0 0 0 4px govuk-functional-colour(focus),
+    0 0 0 8px govuk-functional-colour(focus-text);
+}
+
+/// Focused form input
+///
+/// Provides an outline to clearly indicate when the target element is focused.
+/// Used for form inputs.
+///
+/// @example scss - Styling the focus state for a form input
+///   .govuk-input:focus {
+///     @include govuk-focused-form-input;
+///   }
+///
+/// @access public
+
+@mixin govuk-focused-form-input {
+  outline: $govuk-focus-width solid;
+  outline-color: govuk-functional-colour(focus);
+  // Ensure outline appears outside of the element
+  outline-offset: 0;
+  // Double the border by adding its width again. Use `box-shadow` for this
+  // instead of changing `border-width` - this is for consistency with
+  // components such as textarea where we avoid changing `border-width` as
+  // it will change the element size. Also, `outline` cannot be utilised
+  // here as it is already used for the yellow focus state.
+  box-shadow: inset 0 0 0 $govuk-border-width-form-element govuk-functional-colour(input-border);
 }
 
-/*# sourceMappingURL=_focused.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_font-faces--internal.scss

@@ -0,0 +1,41 @@
+////
+/// @group helpers
+////
+
+@use "../tools/exports" as *;
+@use "../tools/font-url" as *;
+
+/// Font Face - GDS Transport
+///
+/// Outputs the font-face declaration for GDS Transport at the root of the CSS document
+/// the first time it is called.
+///
+/// @access private
+
+@mixin gds-transport {
+  @include govuk-exports("govuk/helpers/font-faces") {
+    @at-root {
+      /*! Copyright (c) 2011 by Margaret Calvert & Henrik Kubel. All rights reserved. The font has been customised for exclusive use on gov.uk. This cut is not commercially available. */ /* stylelint-disable-line scss/comment-no-loud  */
+      @font-face {
+        font-family: "GDS Transport";
+        font-style: normal;
+        font-weight: normal;
+        font-display: fallback;
+        src:
+          govuk-font-url("light-94a07e06a1-v2.woff2") format("woff2"),
+          govuk-font-url("light-f591b13f7d-v2.woff") format("woff");
+      }
+
+      @font-face {
+        font-family: "GDS Transport";
+        font-style: normal;
+        font-weight: bold;
+        font-display: fallback;
+        src:
+          govuk-font-url("bold-b542beb274-v2.woff2") format("woff2"),
+          govuk-font-url("bold-affa96571d-v2.woff") format("woff");
+      }
+    }
+  }
+}
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_grid.import.scss

@@ -0,0 +1,2 @@
+@forward "grid";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_grid.scss

@@ -1,6 +1,10 @@
 ////
 /// @group helpers/layout
 ////
+@use "sass:map";
+
+@use "../settings/measurements" as *;
+@use "media-queries" as *;
 
 /// Grid width percentage
 ///
@@ -10,8 +14,8 @@
 /// @access public
 
 @function govuk-grid-width($key) {
-  @if map-has-key($govuk-grid-widths, $key) {
-    @return map-get($govuk-grid-widths, $key);
+  @if map.has-key($govuk-grid-widths, $key) {
+    @return map.get($govuk-grid-widths, $key);
   }
 
   @error "Unknown grid width `#{$key}`";
@@ -54,10 +58,9 @@
     width: 100%;
   }
   padding: 0 $govuk-gutter-half;
-  @include govuk-media-query($from: $at) {
+  @media #{govuk-from-breakpoint($at)} {
     width: govuk-grid-width($width);
     float: $float;
   }
 }
 
-/*# sourceMappingURL=_grid.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_index.import.scss

@@ -0,0 +1,2 @@
+@forward "index";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_index.scss

@@ -1,14 +1,13 @@
-@import "clearfix";
-@import "colour";
-@import "device-pixels";
-@import "focused";
-@import "font-faces";
-@import "grid";
-@import "links";
-@import "media-queries";
-@import "shape-arrow";
-@import "spacing";
-@import "typography";
-@import "visually-hidden";
+@forward "clearfix";
+@forward "colour";
+@forward "device-pixels";
+@forward "focused";
+@forward "grid";
+@forward "links";
+@forward "media-queries";
+@forward "shape-arrow";
+@forward "spacing";
+@forward "typography";
+@forward "visually-hidden";
+@forward "width-container";
 
-/*# sourceMappingURL=_index.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_links.import.scss

@@ -0,0 +1,2 @@
+@forward "links";
+