govuk_tech_docs 6.3.0.beta → 6.3.0

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

@@ -6,10 +6,11 @@
 @use "sass:meta";
 @use "sass:string";
 
-@import "../settings/colours-functional";
-@import "../settings/colours-palette";
-@import "../settings/colours-organisations";
-@import "../settings/warnings";
+@use "../settings/colours-palette--internal";
+@use "../settings/warnings--internal";
+
+@use "../settings/colours-functional" as *;
+@use "../settings/colours-organisations" as *;
 
 /// Get a colour from the palette
 ///
@@ -17,10 +18,10 @@
 /// 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
-///   (`$_govuk-palette`)
-/// @param {String | Colour} $variant - Name of the variant from the colour palette
-///   (`$_govuk-palette`)
+/// @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
@@ -38,7 +39,7 @@
 /// @throw if the palette is misformatted and doesn't associate a colour or map to `$colour`
 /// @access public
 
-@function govuk-colour($colour, $variant: primary, $colours: $_govuk-palette) {
+@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
@@ -51,7 +52,7 @@
   @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 == $_govuk-palette {
+    @if $colours == colours-palette--internal.$govuk-palette {
       $corresponding-colour: _govuk-corresponding-brand-colour($colour);
       @if $corresponding-colour {
         @return $corresponding-colour;
@@ -80,7 +81,7 @@
 }
 
 @function _govuk-corresponding-brand-colour($colour) {
-  $pre-brand-colour: map.get($_govuk-pre-brand-colours, $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);
@@ -89,7 +90,7 @@
     $corresponding-govuk-colour-call: 'govuk-colour("#{$corresponding-colour}", $variant: "#{$corresponding-variant}")';
 
     @if _should-warn("pre-brand-colour") {
-      @warn _warning-text("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 " +
@@ -132,7 +133,7 @@
   }
 
   @if map.has-key($govuk-functional-colours, $colour) {
-    $value: _govuk-resolve-colour(map.get($govuk-functional-colours, $colour));
+    $value: govuk-resolve-colour(map.get($govuk-functional-colours, $colour));
 
     @return var(--govuk-#{$colour}-colour, #{$value});
   }
@@ -146,8 +147,8 @@
 /// @returns {Colour} The colour
 /// @throws if the `name` is present but falsy
 /// @throws if the `variant` is present but falsy
-/// @access private
-@function _govuk-resolve-colour($colour-reference) {
+/// @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;
@@ -174,6 +175,24 @@
   @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
@@ -205,7 +224,7 @@
   // 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 _warning-text(
+    @warn warnings--internal.warning-text(
       "organisation-colours",
       map.get($org-colour, "deprecation-message")
     );
@@ -218,4 +237,3 @@
   }
 }
 
-/*# 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
 ////
@@ -27,8 +29,6 @@
 ///
 /// @access public
 
-@use "sass:list";
-
 @mixin govuk-device-pixel-ratio($ratio: 2) {
   @media only screen and (-webkit-min-device-pixel-ratio: $ratio),
     only screen and (min-resolution: #{($ratio * 96)}dpi),
@@ -37,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,6 +2,9 @@
 /// @group helpers/accessibility
 ////
 
+@use "../settings/measurements" as *;
+@use "colour" as *;
+
 /// Focused text
 ///
 /// Provides an outline to clearly indicate when the target element is focused.
@@ -91,4 +94,3 @@
   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.scss → _font-faces--internal.scss}

@@ -2,7 +2,8 @@
 /// @group helpers
 ////
 
-@import "../tools/exports";
+@use "../tools/exports" as *;
+@use "../tools/font-url" as *;
 
 /// Font Face - GDS Transport
 ///
@@ -11,7 +12,7 @@
 ///
 /// @access private
 
-@mixin _govuk-font-face-gds-transport {
+@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  */
@@ -19,23 +20,22 @@
         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-display: fallback;
       }
 
       @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");
-        font-display: fallback;
       }
     }
   }
 }
 
-/*# sourceMappingURL=_font-faces.scss.map */

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

@@ -3,6 +3,9 @@
 ////
 @use "sass:map";
 
+@use "../settings/measurements" as *;
+@use "media-queries" as *;
+
 /// Grid width percentage
 ///
 /// @param {String} $key - Name of grid width (e.g. two-thirds)
@@ -61,4 +64,3 @@
   }
 }
 
-/*# 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";
+

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

@@ -2,6 +2,12 @@
 /// @group helpers/links
 ////
 
+@use "../settings/links" as *;
+@use "../settings/measurements" as *;
+@use "colour" as *;
+@use "focused" as *;
+@use "typography" as *;
+
 /// Common link styles
 ///
 /// Provides the typography and focus state, regardless of link style.
@@ -372,4 +378,3 @@
   }
 }
 
-/*# sourceMappingURL=_links.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_media-queries.import.scss

@@ -0,0 +1,2 @@
+@forward "media-queries";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_media-queries.scss

@@ -6,8 +6,8 @@
 @use "sass:meta";
 @use "sass:string";
 
-@import "../settings/media-queries";
-@import "../tools/px-to-em";
+@use "../settings/media-queries" as *;
+@use "../tools/px-to-em" as *;
 
 // =========================================================
 // Helpers
@@ -220,4 +220,3 @@
   }
 }
 
-/*# sourceMappingURL=_media-queries.scss.map */

data/node_modules/govuk-frontend/dist/govuk/helpers/_shape-arrow.import.scss

@@ -0,0 +1,2 @@
+@forward "shape-arrow";
+

data/node_modules/govuk-frontend/dist/govuk/helpers/_shape-arrow.scss

@@ -79,4 +79,3 @@
   }
 }
 
-/*# sourceMappingURL=_shape-arrow.scss.map */

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

@@ -0,0 +1,80 @@
+////
+/// @group helpers/spacing
+////
+@use "sass:map";
+@use "sass:meta";
+
+@use "../settings/spacing" as *;
+@use "media-queries" as *;
+
+@use "../tools/if" as *;
+
+/// 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 responsive-spacing(
+  $responsive-spacing-point,
+  $property,
+  $direction: "all",
+  $important: false,
+  $adjustment: false
+) {
+  $actual-input-type: meta.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: meta.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 govuk-if($important, !important);
+      } @else {
+        #{$property}-#{$direction}: $breakpoint-value govuk-if($important, !important);
+      }
+    } @else {
+      @media #{govuk-from-breakpoint($breakpoint)} {
+        @if $direction == all {
+          #{$property}: $breakpoint-value govuk-if($important, !important);
+        } @else {
+          #{$property}-#{$direction}: $breakpoint-value govuk-if($important, !important);
+        }
+      }
+    }
+  }
+}
+

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

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

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

@@ -5,8 +5,9 @@
 @use "sass:math";
 @use "sass:meta";
 
-@import "../tools/if";
-@import "../helpers/media-queries";
+@use "../tools/if" as *;
+@use "../settings/spacing" as *;
+@use "spacing--internal";
 
 /// Single point spacing
 ///
@@ -55,82 +56,11 @@
   @return govuk-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: meta.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: meta.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 govuk-if($important, !important);
-      } @else {
-        #{$property}-#{$direction}: $breakpoint-value govuk-if($important, !important);
-      }
-    } @else {
-      @media #{govuk-from-breakpoint($breakpoint)} {
-        @if $direction == all {
-          #{$property}: $breakpoint-value govuk-if($important, !important);
-        } @else {
-          #{$property}-#{$direction}: $breakpoint-value govuk-if($important, !important);
-        }
-      }
-    }
-  }
-}
-
 /// 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
@@ -147,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
@@ -156,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
@@ -173,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";
+