defra_ruby_template 3.15.1 → 5.4.0

data/vendor/assets/stylesheets/helpers/_colour.scss

@@ -1,6 +1,6 @@
-@import "../settings/compatibility";
 @import "../settings/colours-palette";
 @import "../settings/colours-organisations";
+@import "../settings/warnings";
 
 ////
 /// @group helpers/colour
@@ -8,35 +8,29 @@
 
 /// Get colour
 ///
-/// @param {String} $colour - Name of colour from the colour palette
+/// @param {String | Colour} $colour - Name of colour from the colour palette
 ///   (`$govuk-colours`)
-/// @param {String} $legacy - Either the name of colour from the legacy palette
-///   or a colour literal, to return instead when in 'legacy mode' - matching
-///   the palette from GOV.UK Template, Elements or Frontend Toolkit
+/// @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.
 /// @return {Colour} Representation of named colour
 ///
-/// @example scss - Using legacy colours from the palette
-///  .foo {
-///    background-colour: govuk-colour("mid-grey", $legacy: "grey-2");
-///  }
-///
-/// @example scss - Using legacy colour literals
-///  .foo {
-///    background-colour: govuk-colour("green", $legacy: #BADA55);
-///  }
-///
 /// @throw if `$colour` is not a colour from the colour palette
 /// @access public
 
 @function govuk-colour($colour, $legacy: false) {
-  @if ($govuk-use-legacy-palette and $legacy) {
-    @if (type-of($legacy) == "color") {
-      @return $legacy;
-    }
-    $colour: $legacy;
+  // 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.");
   }
 
-  $colour: quote($colour);
+  @if type-of($colour) == "color" {
+    // stylelint-disable-next-line scss/function-quote-no-quoted-strings-inside
+    $colour: quote("#{$colour}");
+  }
 
   @if not map-has-key($govuk-colours, $colour) {
     @error "Unknown colour `#{$colour}`";
@@ -65,7 +59,7 @@
 
   $org-colour: map-get($govuk-colours-organisations, $organisation);
 
-  @if ($websafe and map-has-key($org-colour, colour-websafe)) {
+  @if $websafe and map-has-key($org-colour, colour-websafe) {
     @return map-get($org-colour, colour-websafe);
   } @else {
     @return map-get($org-colour, colour);
@@ -75,7 +69,7 @@
 /// Make a colour darker by mixing it with black
 ///
 /// @param {Colour} $colour - colour to shade
-/// @param {Number} $percentage - percentage of `$colour` in returned color
+/// @param {Number} $percentage - percentage of black to mix with $colour
 /// @return {Colour}
 /// @access public
 
@@ -86,10 +80,12 @@
 /// Make a colour lighter by mixing it with white
 ///
 /// @param {Colour} $colour - colour to tint
-/// @param {Number} $percentage - percentage of `$colour` in returned color
+/// @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/vendor/assets/stylesheets/helpers/_device-pixels.scss

@@ -28,10 +28,11 @@
 /// @access public
 
 @mixin govuk-device-pixel-ratio($ratio: 2) {
-  // stylelint-disable indentation
   @media only screen and (-webkit-min-device-pixel-ratio: $ratio),
     only screen and (min-resolution: #{($ratio * 96)}dpi),
     only screen and (min-resolution: #{$ratio}dppx) {
-      @content;
-    }
+    @content;
+  }
 }
+
+/*# sourceMappingURL=_device-pixels.scss.map */

data/vendor/assets/stylesheets/helpers/_focused.scss

@@ -14,15 +14,36 @@
   // backgrounds and box-shadows disappear, so we need to ensure there's a
   // transparent outline which will be set to a visible colour.
 
-  // Since Internet Explorer 8 does not support box-shadow, we want to force the
-  // user-agent outlines
-  @include govuk-not-ie8 {
-    outline: $govuk-focus-width solid transparent;
-  }
+  outline: $govuk-focus-width solid transparent;
   color: $govuk-focus-text-colour;
   background-color: $govuk-focus-colour;
-  box-shadow: 0 -2px $govuk-focus-colour, 0 4px $govuk-focus-text-colour;
+  box-shadow:
+    0 -2px $govuk-focus-colour,
+    0 4px $govuk-focus-text-colour;
   // When link is focussed, hide the default underline since the
   // box shadow adds the "underline"
   text-decoration: none;
+
+  // When a focused box is broken by e.g. a line break, ensure that the
+  // box-shadow is applied to each fragment independently.
+  -webkit-box-decoration-break: clone;
+          box-decoration-break: clone;
 }
+
+/// Focused box
+///
+/// Provides an outline to clearly indicate when the target element is focused.
+/// Unlike govuk-focused-text, which only draws an underline below the element,
+/// govuk-focused-box draws an outline around all sides of the element.
+/// Best used for non-text content contained within links.
+///
+/// @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;
+}
+
+/*# sourceMappingURL=_focused.scss.map */

data/vendor/assets/stylesheets/helpers/_font-faces.scss

@@ -12,30 +12,30 @@
 /// @access private
 
 @mixin _govuk-font-face-gds-transport {
-  @include govuk-not-ie8 { // In IE8, which cannot render WOFF format, we fall back to system fonts
-    @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;
-          src:
-            govuk-font-url("light-94a07e06a1-v2.woff2") format("woff2"),
-            govuk-font-url("light-f591b13f7d-v2.woff") format("woff");
-          font-display: fallback;
-        }
+  @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;
+        src:
+          govuk-font-url("light-94a07e06a1-v2.woff2") format("woff2"),
+          govuk-font-url("light-f591b13f7d-v2.woff") format("woff");
+        font-display: fallback;
+      }
 
-        @font-face {
-          font-family: "GDS Transport";
-          font-style: normal;
-          font-weight: bold;
-          src:
-            govuk-font-url("bold-b542beb274-v2.woff2") format("woff2"),
-            govuk-font-url("bold-affa96571d-v2.woff") format("woff");
-          font-display: fallback;
-        }
+      @font-face {
+        font-family: "GDS Transport";
+        font-style: normal;
+        font-weight: bold;
+        src:
+          govuk-font-url("bold-b542beb274-v2.woff2") format("woff2"),
+          govuk-font-url("bold-affa96571d-v2.woff") format("woff");
+        font-display: fallback;
       }
     }
   }
 }
+
+/*# sourceMappingURL=_font-faces.scss.map */

data/vendor/assets/stylesheets/helpers/_grid.scss

@@ -59,3 +59,5 @@
     float: $float;
   }
 }
+
+/*# sourceMappingURL=_grid.scss.map */

data/vendor/assets/stylesheets/helpers/_index.scss

@@ -0,0 +1,14 @@
+@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";
+
+/*# sourceMappingURL=_index.scss.map */

data/vendor/assets/stylesheets/helpers/_links.scss

@@ -30,14 +30,12 @@
 @mixin govuk-link-decoration {
   text-decoration: underline;
 
-  @if ($govuk-new-link-styles) {
-    @if ($govuk-link-underline-thickness) {
-      text-decoration-thickness: $govuk-link-underline-thickness;
-    }
+  @if $govuk-link-underline-thickness {
+    text-decoration-thickness: $govuk-link-underline-thickness;
+  }
 
-    @if ($govuk-link-underline-offset) {
-      text-underline-offset: $govuk-link-underline-offset;
-    }
+  @if $govuk-link-underline-offset {
+    text-underline-offset: $govuk-link-underline-offset;
   }
 }
 
@@ -50,7 +48,7 @@
 /// @access public
 
 @mixin govuk-link-hover-decoration {
-  @if ($govuk-new-link-styles and $govuk-link-hover-underline-thickness) {
+  @if $govuk-link-hover-underline-thickness {
     text-decoration-thickness: $govuk-link-hover-underline-thickness;
     // Disable ink skipping on underlines on hover. Browsers haven't
     // standardised on this part of the spec yet, so set both properties
@@ -98,17 +96,6 @@
   &:focus {
     color: $govuk-focus-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector
-  // designed to make unvisited link  s a slightly darker blue when focussed, so
-  // we need to override the text colour for that combination of selectors so
-  // so that unvisited links styled as buttons do not end up with dark blue
-  // text when focussed.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      color: $govuk-focus-text-colour;
-    }
-  }
 }
 
 /// Error link styles
@@ -146,17 +133,6 @@
   &:focus {
     color: $govuk-focus-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector
-  // designed to make unvisited link  s a slightly darker blue when focussed, so
-  // we need to override the text colour for that combination of selectors so
-  // so that unvisited links styled as buttons do not end up with dark blue
-  // text when focussed.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      color: $govuk-focus-text-colour;
-    }
-  }
 }
 
 /// Success link styles
@@ -194,17 +170,6 @@
   &:focus {
     color: $govuk-focus-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector
-  // designed to make unvisited link  s a slightly darker blue when focussed, so
-  // we need to override the text colour for that combination of selectors so
-  // so that unvisited links styled as buttons do not end up with dark blue
-  // text when focussed.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      color: $govuk-focus-text-colour;
-    }
-  }
 }
 
 /// Muted link styles
@@ -239,15 +204,6 @@
   &:focus {
     color: $govuk-focus-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector designed
-  // to make unvisited links a slightly darker blue when focussed, so we need to
-  // override the text colour for that combination of selectors.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      @include govuk-text-colour;
-    }
-  }
 }
 
 /// Text link styles
@@ -275,22 +231,15 @@
   // Force a colour change on hover to work around a bug in Safari
   // https://bugs.webkit.org/show_bug.cgi?id=224483
   &:hover {
-    color: rgba($govuk-text-colour, .99);
+    @if type-of($govuk-text-colour) == color {
+      color: rgba($govuk-text-colour, 0.99);
+    }
   }
 
   &:active,
   &:focus {
     @include govuk-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector designed
-  // to make unvisited links a slightly darker blue when focussed, so we need to
-  // override the text colour for that combination of selectors.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      @include govuk-text-colour;
-    }
-  }
 }
 
 /// Inverse link styles
@@ -319,21 +268,12 @@
   // https://bugs.webkit.org/show_bug.cgi?id=224483
   &:hover,
   &:active {
-    color: rgba(govuk-colour("white"), .99);
+    color: rgba(govuk-colour("white"), 0.99);
   }
 
   &:focus {
     color: $govuk-focus-text-colour;
   }
-
-  // alphagov/govuk_template includes a specific a:link:focus selector designed
-  // to make unvisited links a slightly darker blue when focussed, so we need to
-  // override the text colour for that combination of selectors.
-  @include govuk-compatibility(govuk_template) {
-    &:link:focus {
-      color: $govuk-focus-text-colour;
-    }
-  }
 }
 
 /// Default link styles, without a visited state
@@ -383,8 +323,7 @@
 /// Remove underline from links
 ///
 /// Remove underlines from links unless the link is active or a user hovers
-/// their cursor over it. This has no effect in Internet Explorer 8 (IE8),
-/// because IE8 does not support `:not`.
+/// their cursor over it.
 ///
 /// @example scss
 ///   .govuk-component__link {
@@ -412,8 +351,9 @@
   @include govuk-media-query($media-type: print) {
     &[href^="/"],
     &[href^="http://"],
-    &[href^="https://"] {
-      &:after {
+    &[href^="https://"]
+    {
+      &::after {
         content: " (" attr(href) ")";
         font-size: 90%;
 
@@ -425,3 +365,27 @@
     }
   }
 }
+
+/// Image link styles
+///
+/// Prepares and provides the focus state for links that only contain images
+/// with no accompanying text.
+///
+/// @access public
+
+@mixin govuk-link-image {
+  // Needed to draw the focus around the entire image
+  display: inline-block;
+
+  // Remove extra space at the bottom of the image that's added by line-height
+  line-height: 0;
+
+  // Don't render an underline
+  text-decoration: none;
+
+  &:focus {
+    @include govuk-focused-box;
+  }
+}
+
+/*# sourceMappingURL=_links.scss.map */

data/vendor/assets/stylesheets/helpers/_media-queries.scss

@@ -6,24 +6,15 @@
 // Wrangle sass-mq config...
 // =========================================================
 
-// Pass our breakpoints and static breakpoint definitions through to sass-mq.
+// Pass our breakpoint definitions through to sass-mq.
 $mq-breakpoints: if(variable-exists(govuk-breakpoints), $govuk-breakpoints, ());
-$mq-static-breakpoint: if(variable-exists(govuk-ie8-breakpoint), $govuk-ie8-breakpoint, desktop);
 
 $mq-show-breakpoints: ();
 
-@if (variable-exists(govuk-show-breakpoints) and $govuk-show-breakpoints) {
+@if variable-exists(govuk-show-breakpoints) and $govuk-show-breakpoints {
   $mq-show-breakpoints: map-keys($govuk-breakpoints);
 }
 
-// When building a stylesheet for IE8, set $mq-responsive to false in order to
-// 'rasterize' any media queries.
-
-$mq-responsive: true;
-@if (variable-exists(govuk-is-ie8) and $govuk-is-ie8) {
-  $mq-responsive: false;
-}
-
 // This is a horrible, horrible hack to prevent the 'dev mode' CSS to display
 // the current breakpoint from being included multiple times.
 //
@@ -55,8 +46,6 @@ $sass-mq-already-included: true;
 ///
 /// @ignore Undocumented mq API, for advanced use only:
 /// @ignore @param {Map} $breakpoints [$govuk-breakpoints]
-/// @ignore @param {String} $static-breakpoint [$govuk-ie8-breakpoint]
-/// @ignore @param {Boolean} $responsive [$govuk-is-ie8]
 ///
 /// @content styling rules, wrapped into a @media query when $responsive is true
 ///
@@ -89,3 +78,5 @@ $sass-mq-already-included: true;
     @content;
   }
 }
+
+/*# sourceMappingURL=_media-queries.scss.map */

data/vendor/assets/stylesheets/helpers/_shape-arrow.scss

@@ -46,7 +46,7 @@
 
   $perpendicular: $base / 2;
 
-  @if ($height == null) {
+  @if not $height {
     $height: _govuk-equilateral-height($base);
   }
 
@@ -78,3 +78,5 @@
     @error "Invalid arrow direction: expected `up`, `right`, `down` or `left`, got `#{$direction}`";
   }
 }
+
+/*# sourceMappingURL=_shape-arrow.scss.map */

data/vendor/assets/stylesheets/helpers/_spacing.scss

@@ -2,36 +2,51 @@
 /// @group helpers/spacing
 ////
 
-// stylelint-disable indentation
-
 /// Single point spacing
 ///
 /// Returns measurement corresponding to the spacing point requested.
 ///
-/// @param {Number} $spacing-point - Point on the spacing scale (set in `settings/_spacing.sccs`)
+/// @param {Number} $spacing-point - Point on the spacing scale
+///  (set in `settings/_spacing.scss`)
 ///
-/// @returns {String} Spacing Measurement eg. 10px
+/// @returns {String} Spacing measurement eg. 10px
 ///
 /// @example scss
 ///   .element {
 ///     padding: govuk-spacing(5);
-///     top: govuk-spacing(2) !important; // if `!important` is required
 ///   }
+///
+/// @example scss Using negative spacing
+///   .element {
+///     margin-top: govuk-spacing(-1);
+///   }
+///
+/// @example scss Marking spacing declarations as important
+///   .element {
+///     margin-top: govuk-spacing(1) !important;
+///   }
+///
 /// @access public
 
 @function govuk-spacing($spacing-point) {
-
   $actual-input-type: type-of($spacing-point);
   @if $actual-input-type != "number" {
     @error "Expected a number (integer), but got a "
-    + "#{$actual-input-type}.";
+      + "#{$actual-input-type}.";
+  }
+
+  $is-negative: false;
+  @if $spacing-point < 0 {
+    $is-negative: true;
+    $spacing-point: abs($spacing-point);
   }
 
   @if not map-has-key($govuk-spacing-points, $spacing-point) {
     @error "Unknown spacing variable `#{$spacing-point}`. Make sure you are using a point from the spacing scale in `_settings/spacing.scss`.";
   }
 
-  @return map-get($govuk-spacing-points, $spacing-point);
+  $value: map-get($govuk-spacing-points, $spacing-point);
+  @return if($is-negative, $value * -1, $value);
 }
 
 /// Responsive spacing
@@ -53,8 +68,13 @@
 ///
 /// @access private
 
-@mixin _govuk-responsive-spacing($responsive-spacing-point, $property, $direction: "all", $important: false, $adjustment: false) {
-
+@mixin _govuk-responsive-spacing(
+  $responsive-spacing-point,
+  $property,
+  $direction: "all",
+  $important: false,
+  $adjustment: false
+) {
   $actual-input-type: type-of($responsive-spacing-point);
   @if $actual-input-type != "number" {
     @error "Expected a number (integer), but got a " + "#{$actual-input-type}.";
@@ -62,7 +82,7 @@
 
   @if not map-has-key($govuk-spacing-responsive-scale, $responsive-spacing-point) {
     @error "Unknown spacing point `#{$responsive-spacing-point}`. Make sure you are using a point from the "
-    + "responsive spacing scale in `_settings/spacing.scss`.";
+      + "responsive spacing scale in `_settings/spacing.scss`.";
   }
 
   // Make sure that the return value from `_settings/spacing.scss` is a map.
@@ -70,19 +90,17 @@
   $actual-map-type: type-of($scale-map);
   @if $actual-map-type != "map" {
     @error "Expected a number (integer), but got a "
-    + "#{$actual-map-type}. Make sure you are using a map to set the responsive spacing in `_settings/spacing.scss`)";
+      + "#{$actual-map-type}. Make sure you are using a map to set the responsive spacing in `_settings/spacing.scss`)";
   }
 
   // Loop through each breakpoint in the map
   @each $breakpoint, $breakpoint-value in $scale-map {
-
-    @if ($adjustment) {
+    @if $adjustment {
       $breakpoint-value: $breakpoint-value + $adjustment;
     }
 
     // The 'null' breakpoint is for mobile.
-    @if $breakpoint == null {
-
+    @if not $breakpoint {
       @if $direction == all {
         #{$property}: $breakpoint-value if($important, !important, null);
       } @else {
@@ -151,3 +169,5 @@
 @mixin govuk-responsive-padding($responsive-spacing-point, $direction: "all", $important: false, $adjustment: false) {
   @include _govuk-responsive-spacing($responsive-spacing-point, "padding", $direction, $important, $adjustment);
 }
+
+/*# sourceMappingURL=_spacing.scss.map */