defra_ruby_template 5.11.0 → 6.4.0

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

@@ -1,6 +1,13 @@
 ////
 /// @group helpers/spacing
 ////
+@use "sass:map";
+@use "sass:math";
+@use "sass:meta";
+
+@use "../tools/if" as *;
+@use "../settings/spacing" as *;
+@use "spacing--internal";
 
 /// Single point spacing
 ///
@@ -29,7 +36,7 @@
 /// @access public
 
 @function govuk-spacing($spacing-point) {
-  $actual-input-type: type-of($spacing-point);
+  $actual-input-type: meta.type-of($spacing-point);
   @if $actual-input-type != "number" {
     @error "Expected a number (integer), but got a "
       + "#{$actual-input-type}.";
@@ -38,93 +45,22 @@
   $is-negative: false;
   @if $spacing-point < 0 {
     $is-negative: true;
-    $spacing-point: abs($spacing-point);
+    $spacing-point: math.abs($spacing-point);
   }
 
-  @if not map-has-key($govuk-spacing-points, $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`.";
   }
 
-  $value: map-get($govuk-spacing-points, $spacing-point);
-  @return if($is-negative, $value * -1, $value);
-}
-
-/// Responsive spacing
-///
-/// Adds responsive spacing (either padding or margin, depending on `$property`)
-/// by fetching a 'spacing map' from the responsive spacing scale, which defines
-/// different spacing values at different breakpoints.
-///
-/// To generate responsive spacing, use 'govuk-responsive-margin' or
-/// 'govuk-responsive-padding' mixins
-///
-/// @param {Number} $responsive-spacing-point - Point on the responsive spacing
-///   scale, corresponds to a map of breakpoints and spacing values
-/// @param {String} $property - Property to add spacing to (e.g. 'margin')
-/// @param {String} $direction [all] - Direction to add spacing to
-///   (`top`, `right`, `bottom`, `left`, `all`)
-/// @param {Boolean} $important [false] - Whether to mark as `!important`
-/// @param {Number} $adjustment [false] - Offset to adjust spacing by
-///
-/// @access private
-
-@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}.";
-  }
-
-  @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`.";
-  }
-
-  // Make sure that the return value from `_settings/spacing.scss` is a map.
-  $scale-map: map-get($govuk-spacing-responsive-scale, $responsive-spacing-point);
-  $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`)";
-  }
-
-  // Loop through each breakpoint in the map
-  @each $breakpoint, $breakpoint-value in $scale-map {
-    @if $adjustment {
-      $breakpoint-value: $breakpoint-value + $adjustment;
-    }
-
-    // The 'null' breakpoint is for mobile.
-    @if not $breakpoint {
-      @if $direction == all {
-        #{$property}: $breakpoint-value if($important, !important, null);
-      } @else {
-        #{$property}-#{$direction}: $breakpoint-value if($important, !important, null);
-      }
-    } @else {
-      @include govuk-media-query($from: $breakpoint) {
-        @if $direction == all {
-          #{$property}: $breakpoint-value if($important, !important, null);
-        } @else {
-          #{$property}-#{$direction}: $breakpoint-value if($important, !important, null);
-        }
-      }
-    }
-  }
+  $value: map.get($govuk-spacing-points, $spacing-point);
+  @return govuk-if($is-negative, $value * -1, $value);
 }
 
 /// Responsive margin
 ///
 /// Adds responsive margin by fetching a 'spacing map' from the responsive
 /// spacing scale, which defines different spacing values at different
-/// breakpoints. Wrapper for the `_govuk-responsive-spacing` mixin.
-///
-/// @see {mixin} _govuk-responsive-spacing
+/// breakpoints. Wrapper for the `govuk-responsive-spacing.govuk-responsive-spacing` mixin.
 ///
 /// @param {Number} $responsive-spacing-point - Point on the responsive spacing
 /// scale, corresponds to a map of breakpoints and spacing values
@@ -141,7 +77,13 @@
 /// @access public
 
 @mixin govuk-responsive-margin($responsive-spacing-point, $direction: "all", $important: false, $adjustment: false) {
-  @include _govuk-responsive-spacing($responsive-spacing-point, "margin", $direction, $important, $adjustment);
+  @include spacing--internal.responsive-spacing(
+    $responsive-spacing-point,
+    "margin",
+    $direction,
+    $important,
+    $adjustment
+  );
 }
 
 /// Responsive padding
@@ -150,8 +92,6 @@
 /// spacing scale, which defines different spacing values at different
 /// breakpoints. Wrapper for the `_govuk-responsive-spacing` mixin.
 ///
-/// @see {mixin} _govuk-responsive-spacing
-///
 /// @param {Number} $responsive-spacing-point - Point on the responsive spacing
 ///   scale, corresponds to a map of breakpoints and spacing values
 /// @param {String} $direction [all] - Direction to add spacing to
@@ -167,7 +107,12 @@
 /// @access public
 
 @mixin govuk-responsive-padding($responsive-spacing-point, $direction: "all", $important: false, $adjustment: false) {
-  @include _govuk-responsive-spacing($responsive-spacing-point, "padding", $direction, $important, $adjustment);
+  @include spacing--internal.responsive-spacing(
+    $responsive-spacing-point,
+    "padding",
+    $direction,
+    $important,
+    $adjustment
+  );
 }
 
-/*# sourceMappingURL=_spacing.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_typography--internal.scss

@@ -0,0 +1,24 @@
+////
+/// @group helpers/typography
+////
+
+@use "sass:math";
+
+/// Convert line-heights specified in pixels into a relative value, unless
+/// they are already unit-less (and thus already treated as relative values)
+/// or the units do not match the units used for the font size.
+///
+/// @param {Number} $line-height Line height
+/// @param {Number} $font-size Font size
+/// @return {Number} The line height as either a relative value or unmodified
+///
+/// @access private
+
+@function line-height($line-height, $font-size) {
+  @if not math.is-unitless($line-height) and math.unit($line-height) == math.unit($font-size) {
+    $line-height: math.div($line-height, $font-size);
+  }
+
+  @return $line-height;
+}
+

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

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

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

@@ -1,8 +1,23 @@
 ////
 /// @group helpers/typography
 ////
-
-@import "../tools/px-to-rem";
+@use "sass:map";
+@use "sass:string";
+
+@use "../settings/warnings--internal";
+
+@use "../settings/assets" as *;
+@use "../settings/colours-functional" as *;
+@use "../settings/spacing" as *;
+@use "../settings/typography-font" as *;
+@use "../settings/typography-responsive" as *;
+@use "../tools/font-url" as *;
+@use "../tools/px-to-rem" as *;
+@use "../tools/if" as *;
+@use "colour" as *;
+@use "font-faces--internal";
+@use "typography--internal";
+@use "media-queries" as *;
 
 /// 'Common typography' helper
 ///
@@ -20,10 +35,10 @@
   // If the user is using the default GDS Transport font we need to include
   // the font-face declarations.
   @if $govuk-include-default-font-face {
-    @include _govuk-font-face-gds-transport;
+    @include font-faces--internal.gds-transport;
   }
 
-  @include govuk-media-query($media-type: print) {
+  @media print {
     font-family: $govuk-font-family-print;
   }
 }
@@ -32,14 +47,16 @@
 ///
 /// Sets the text colour, including a suitable override for print.
 ///
+/// @deprecated
 /// @access public
 
 @mixin govuk-text-colour {
-  color: $govuk-text-colour;
+  @include warnings--internal.warning(
+    "govuk-text-colour",
+    "The `govuk-text-colour` mixin is deprecated. Use `color: govuk-functional-colour(text)` instead."
+  );
 
-  @include govuk-media-query($media-type: print) {
-    color: $govuk-print-text-colour;
-  }
+  color: govuk-functional-colour(text);
 }
 
 /// Regular font weight helper
@@ -49,7 +66,7 @@
 /// @access public
 
 @mixin govuk-typography-weight-regular($important: false) {
-  font-weight: $govuk-font-weight-regular if($important, !important, null);
+  font-weight: $govuk-font-weight-regular govuk-if($important, !important);
 }
 
 /// Bold font weight helper
@@ -59,7 +76,7 @@
 /// @access public
 
 @mixin govuk-typography-weight-bold($important: false) {
-  font-weight: $govuk-font-weight-bold if($important, !important, null);
+  font-weight: $govuk-font-weight-bold govuk-if($important, !important);
 }
 
 /// Tabular number helper
@@ -76,7 +93,7 @@
 /// @access public
 
 @mixin govuk-font-tabular-numbers($important: false) {
-  font-variant-numeric: tabular-nums if($important, !important, null);
+  font-variant-numeric: tabular-nums govuk-if($important, !important);
 }
 
 /// Word break helper
@@ -90,52 +107,10 @@
 
 @mixin govuk-text-break-word($important: false) {
   // IE 11 and Edge 16–17 only support the non-standard `word-wrap` property
-  word-wrap: break-word if($important, !important, null);
+  word-wrap: break-word govuk-if($important, !important);
 
   // All other browsers support `overflow-wrap`
-  overflow-wrap: break-word if($important, !important, null);
-}
-
-/// Convert line-heights specified in pixels into a relative value, unless
-/// they are already unit-less (and thus already treated as relative values)
-/// or the units do not match the units used for the font size.
-///
-/// @param {Number} $line-height Line height
-/// @param {Number} $font-size Font size
-/// @return {Number} The line height as either a relative value or unmodified
-///
-/// @access private
-
-@function _govuk-line-height($line-height, $font-size) {
-  @if not unitless($line-height) and unit($line-height) == unit($font-size) {
-    $line-height: $line-height / $font-size;
-  }
-
-  @return $line-height;
-}
-
-/// Font size and line height helper
-///
-/// @param {Number} $size - Point from the type scale (the size as it would
-///   appear on tablet and above)
-/// @param {Number} $override-line-height [false] - Non responsive custom line
-///   height. Omit to use the line height from the font map.
-/// @param {Boolean} $important [false] - Whether to mark declarations as
-///   `!important`.
-///
-/// @throw if `$size` is not a valid point from the type scale
-///
-/// @access public
-///
-/// @alias govuk-font-size
-/// @deprecated Use `govuk-font-size` instead
-
-@mixin govuk-typography-responsive($size, $override-line-height: false, $important: false) {
-  @include _warning(
-    "govuk-typography-responsive",
-    "govuk-typography-responsive is deprecated. Use govuk-font-size instead."
-  );
-  @include govuk-font-size($size, $override-line-height, $important);
+  overflow-wrap: break-word govuk-if($important, !important);
 }
 
 /// Font size and line height helper
@@ -177,21 +152,21 @@
 @mixin govuk-font-size($size, $line-height: false, $important: false) {
   // Flag font sizes that start with underscores so we can suppress warnings on
   // deprecated sizes used internally, for example `govuk-font($size: "_14")`
-  $size-internal-use-only: str-slice(#{$size}, 1, 1) == "_";
+  $size-internal-use-only: string.slice(#{$size}, 1, 1) == "_";
 
   // Remove underscore from font sizes flagged for internal use
   @if $size-internal-use-only {
-    $size: str-slice(#{$size}, 2);
+    $size: string.slice(#{$size}, 2);
   }
 
   // Check for a font map exactly matching the given size
-  $font-map: map-get($govuk-typography-scale, $size);
+  $font-map: map.get($govuk-typography-scale, $size);
 
   // No match? Try with string type (e.g. $size: "16" not 16)
   @if not $font-map {
-    @each $font-size in map-keys($govuk-typography-scale) {
+    @each $font-size in map.keys($govuk-typography-scale) {
       @if not $font-map and "#{$font-size}" == "#{$size}" {
-        $font-map: map-get($govuk-typography-scale, $font-size);
+        $font-map: map.get($govuk-typography-scale, $font-size);
       }
     }
   }
@@ -202,50 +177,57 @@
   }
 
   // Check for a deprecation within the type scale
-  $deprecation: map-get($font-map, "deprecation");
+  $deprecation: map.get($font-map, "deprecation");
 
   @if $deprecation {
     // Warn on deprecated font sizes unless flagged for internal use
     @if not $size-internal-use-only {
-      @include _warning(map-get($deprecation, "key"), map-get($deprecation, "message"));
+      @include warnings--internal.warning(map.get($deprecation, "key"), map.get($deprecation, "message"));
     }
 
     // remove the deprecation map keys so they do not break the breakpoint loop
-    $font-map: map-remove($font-map, "deprecation");
+    $font-map: map.remove($font-map, "deprecation");
   }
 
   @each $breakpoint, $breakpoint-map in $font-map {
-    $font-size: map-get($breakpoint-map, "font-size");
+    $font-size: map.get($breakpoint-map, "font-size");
     $font-size-rem: govuk-px-to-rem($font-size);
 
     // $calculated-line-height is a separate variable from $line-height,
     // as otherwise the value would get redefined with each loop and
-    // eventually break _govuk-line-height.
-    //
+    // eventually break typography--internal.line-height.
+    // 1. See if the function was called with a specific line-height
+    $calculated-line-height: $line-height;
+    // 2. Default to the breakpoint-map if no specific value was given
+    @if not $calculated-line-height {
+      $calculated-line-height: map.get($breakpoint-map, "line-height");
+    }
+
+    // 3. Turn the value into a unitless line-height if possible
     // We continue to call the param $line-height to stay consistent with the
     // naming with govuk-font.
-    $calculated-line-height: _govuk-line-height(
-      $line-height: if($line-height, $line-height, map-get($breakpoint-map, "line-height")),
+    $calculated-line-height: typography--internal.line-height(
+      $line-height: $calculated-line-height,
       $font-size: $font-size
     );
 
     // Mark rules as !important if $important is true - this will result in
     // these variables becoming strings, so this needs to happen *after* they
     // are used in calculations
-    $font-size: $font-size if($important, !important, null);
-    $font-size-rem: $font-size-rem if($important, !important, null);
-    $calculated-line-height: $calculated-line-height if($important, !important, null);
+    $font-size: $font-size govuk-if($important, !important);
+    $font-size-rem: $font-size-rem govuk-if($important, !important);
+    $calculated-line-height: $calculated-line-height govuk-if($important, !important);
 
     @if not $breakpoint {
       font-size: $font-size-rem;
       line-height: $calculated-line-height;
     } @else if $breakpoint == "print" {
-      @include govuk-media-query($media-type: print) {
+      @media print {
         font-size: $font-size;
         line-height: $calculated-line-height;
       }
     } @else {
-      @include govuk-media-query($from: $breakpoint) {
+      @media #{govuk-from-breakpoint($breakpoint)} {
         font-size: $font-size-rem;
         line-height: $calculated-line-height;
       }
@@ -285,4 +267,3 @@
   }
 }
 
-/*# sourceMappingURL=_typography.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_visually-hidden.import.scss

@@ -0,0 +1,2 @@
+@forward "visually-hidden";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_visually-hidden.scss

@@ -2,6 +2,8 @@
 /// @group helpers/accessibility
 ////
 
+@use "../tools/if" as *;
+
 /// Helper function containing the common code for the following two mixins
 ///
 /// @link https://snook.ca/archives/html_and_css/hiding-content-for-accessibility
@@ -14,28 +16,28 @@
 /// @access private
 
 @mixin _govuk-visually-hide-content($important: true) {
-  position: absolute if($important, !important, null);
+  position: absolute govuk-if($important, !important);
 
-  width: 1px if($important, !important, null);
-  height: 1px if($important, !important, null);
+  width: 1px govuk-if($important, !important);
+  height: 1px govuk-if($important, !important);
   // If margin is set to a negative value it can cause text to be announced in
   // the wrong order in VoiceOver for OSX
-  margin: 0 if($important, !important, null);
-  padding: 0 if($important, !important, null);
+  margin: 0 govuk-if($important, !important);
+  padding: 0 govuk-if($important, !important);
 
-  overflow: hidden if($important, !important, null);
+  overflow: hidden govuk-if($important, !important);
 
   // `clip` is needed for IE11 support
-  clip: rect(0 0 0 0) if($important, !important, null);
-  -webkit-clip-path: inset(50%) if($important, !important, null);
-          clip-path: inset(50%) if($important, !important, null);
+  clip: rect(0 0 0 0) govuk-if($important, !important);
+  -webkit-clip-path: inset(50%) govuk-if($important, !important);
+          clip-path: inset(50%) govuk-if($important, !important);
 
-  border: 0 if($important, !important, null);
+  border: 0 govuk-if($important, !important);
 
   // For long content, line feeds are not interpreted as spaces and small width
   // causes content to wrap 1 word per line:
   // https://medium.com/@jessebeach/beware-smushed-off-screen-accessible-text-5952a4c2cbfe
-  white-space: nowrap if($important, !important, null);
+  white-space: nowrap govuk-if($important, !important);
 
   // Prevent users from selecting or copying visually-hidden text. This prevents
   // a user unintentionally copying more text than they intended and needing to
@@ -77,9 +79,11 @@
 
 @mixin govuk-visually-hidden-focusable($important: true) {
   // IE 11 doesn't support the combined `:not(:active, :focus)` syntax.
-  &:not(:active):not(:focus) {
+  // Also allows for ':focus' companion classes from postcss-pseudo-classes
+  // which the plugin unfortunately doesn't handle automatically.
+  // stylelint-disable-next-line selector-class-pattern
+  &:not(:active):not(:focus):not(.\:focus) {
     @include _govuk-visually-hide-content($important: $important);
   }
 }
 
-/*# sourceMappingURL=_visually-hidden.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_width-container.import.scss

@@ -0,0 +1,2 @@
+@forward "width-container";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_width-container.scss

@@ -0,0 +1,73 @@
+////
+/// @group helpers/width-container
+////
+
+@use "sass:string";
+
+@use "../settings/measurements" as *;
+@use "media-queries" as *;
+
+/// Width container mixin
+///
+/// Used to create page width and custom width container classes.
+///
+/// @param {String} $width [$govuk-page-width] - Width in pixels
+///
+/// @example scss - Creating a 1200px wide container class
+///  .app-width-container--wide {
+///    @include govuk-width-container(1200px);
+///  }
+///
+/// @access public
+
+@mixin govuk-width-container($width: $govuk-page-width) {
+  // By default, limit the width of the container to the page width
+  max-width: $width;
+
+  // On mobile, add half width gutters
+  margin-right: $govuk-gutter-half;
+  margin-left: $govuk-gutter-half;
+
+  // Respect 'display cutout' safe area (avoids notches and rounded corners)
+  @supports (margin: string.unquote("max(calc(0px))")) {
+    $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
+    $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
+
+    // Use max() to pick largest margin, default or with safe area
+    // Escaped due to Sass max() vs. CSS native max()
+    margin-right: string.unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-right})");
+    margin-left: string.unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-left})");
+  }
+
+  // On tablet, add full width gutters
+  @media #{govuk-from-breakpoint(tablet)} {
+    margin-right: $govuk-gutter;
+    margin-left: $govuk-gutter;
+
+    // Respect 'display cutout' safe area (avoids notches and rounded corners)
+    @supports (margin: string.unquote("max(calc(0px))")) {
+      $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
+      $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
+
+      // Use max() to pick largest margin, default or with safe area
+      // Escaped due to Sass max() vs. CSS native max()
+      margin-right: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-right})");
+      margin-left: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-left})");
+    }
+  }
+
+  // As soon as the viewport is greater than the width of the page plus the
+  // gutters, just centre the content instead of adding gutters.
+  @media (min-width: #{($width + $govuk-gutter * 2)}) {
+    margin-right: auto;
+    margin-left: auto;
+
+    // Since a safe area may have previously been set above,
+    // we need to duplicate this margin that centers the page.
+    @supports (margin: string.unquote("max(calc(0px))")) {
+      margin-right: auto;
+      margin-left: auto;
+    }
+  }
+}
+