govuk_tech_docs 6.1.0 → 6.2.1

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

@@ -2,6 +2,8 @@
 /// @group helpers/accessibility
 ////
 
+@import "../tools/if";
+
 /// 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

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

@@ -1,3 +1,5 @@
+@use "sass:map";
+
 @import "../base";
 
 @include govuk-exports("govuk/objects/grid") {
@@ -7,7 +9,7 @@
     margin-left: -($govuk-gutter-half);
   }
 
-  @each $width in map-keys($govuk-grid-widths) {
+  @each $width in map.keys($govuk-grid-widths) {
     .govuk-grid-column-#{$width} {
       @include govuk-grid-column($width);
     }
@@ -16,7 +18,7 @@
   // These *must* be defined in a separate loop as they have the same
   // specificity as the non-breakpoint specific classes, so need to appear after
   // them in the outputted CSS
-  @each $width in map-keys($govuk-grid-widths) {
+  @each $width in map.keys($govuk-grid-widths) {
     .govuk-grid-column-#{$width}-from-desktop {
       @include govuk-grid-column($width, $at: desktop);
     }

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

@@ -1,8 +1,9 @@
-@import "../base";
-
 ////
 /// @group objects/layout
 ////
+@use "sass:string";
+
+@import "../base";
 
 /// Width container mixin
 ///
@@ -26,14 +27,14 @@
   margin-left: $govuk-gutter-half;
 
   // Respect 'display cutout' safe area (avoids notches and rounded corners)
-  @supports (margin: unquote("max(calc(0px))")) {
+  @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: unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-right})");
-    margin-left: unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-left})");
+    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
@@ -42,14 +43,14 @@
     margin-left: $govuk-gutter;
 
     // Respect 'display cutout' safe area (avoids notches and rounded corners)
-    @supports (margin: unquote("max(calc(0px))")) {
+    @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: unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-right})");
-      margin-left: unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-left})");
+      margin-right: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-right})");
+      margin-left: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-left})");
     }
   }
 
@@ -61,7 +62,7 @@
 
     // Since a safe area may have previously been set above,
     // we need to duplicate this margin that centers the page.
-    @supports (margin: unquote("max(calc(0px))")) {
+    @supports (margin: string.unquote("max(calc(0px))")) {
       margin-right: auto;
       margin-left: auto;
     }

data/node_modules/govuk-frontend/dist/govuk/overrides/_display.scss

@@ -1,3 +1,5 @@
+@import "../tools/exports";
+
 // stylelint-disable declaration-no-important
 @include govuk-exports("govuk/overrides/display") {
   .govuk-\!-display-inline {

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

@@ -1,3 +1,6 @@
+@import "../settings/spacing";
+@import "../tools/exports";
+@import "../helpers/spacing";
 @import "display";
 @import "spacing";
 @import "text-align";

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

@@ -1,6 +1,10 @@
 ////
 /// @group overrides
 ////
+@use "sass:map";
+@import "../settings/spacing";
+@import "../tools/exports";
+@import "../helpers/spacing";
 
 // stylelint-disable declaration-no-important
 
@@ -62,7 +66,7 @@ $_spacing-directions: ("top", "right", "bottom", "left") !default;
 ///
 /// @access private
 @mixin _govuk-generate-static-spacing-overrides($property) {
-  @each $spacing-point in map-keys($govuk-spacing-points) {
+  @each $spacing-point in map.keys($govuk-spacing-points) {
     .govuk-\!-static-#{$property}-#{$spacing-point} {
       #{$property}: govuk-spacing($spacing-point) !important;
     }

data/node_modules/govuk-frontend/dist/govuk/overrides/_text-align.scss

@@ -1,3 +1,5 @@
+@import "../tools/exports";
+
 // stylelint-disable declaration-no-important
 @include govuk-exports("govuk/overrides/text-align") {
   .govuk-\!-text-align-left {

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

@@ -1,3 +1,8 @@
+@use "sass:map";
+@import "../settings/typography-responsive";
+@import "../tools/exports";
+@import "../helpers/typography";
+
 @include govuk-exports("govuk/overrides/typography") {
   // Font size and line height
 
@@ -5,10 +10,10 @@
   // typography scale eg .govuk-\!-font-size-80
   @each $size, $font-map in $govuk-typography-scale {
     .govuk-\!-font-size-#{$size} {
-      $font-map: map-get($govuk-typography-scale, $size);
+      $font-map: map.get($govuk-typography-scale, $size);
 
       // Add underscore to deprecated typography scale keys
-      @if map-has-key($font-map, "deprecation") {
+      @if map.has-key($font-map, "deprecation") {
         $size: _#{$size};
       }
 

data/node_modules/govuk-frontend/dist/govuk/overrides/_width.scss

@@ -1,3 +1,6 @@
+@import "../tools/exports";
+@import "../helpers/media-queries";
+
 // stylelint-disable declaration-no-important
 @include govuk-exports("govuk/overrides/width") {
   .govuk-\!-width-full {

data/node_modules/govuk-frontend/dist/govuk/settings/_assets.scss

@@ -50,6 +50,15 @@ $govuk-fonts-path: "#{$govuk-assets-path}fonts/" !default;
 ///
 ///   $govuk-image-url-function: 'my-url-handler';
 ///
+/// @example scss - From an external module
+///
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
+///
+///   // Then pass the handler function using `meta.get-function`
+///   $govuk-image-url-function: meta.get-function("image-url", $module: "url-handlers");
+///
 /// @access public
 
 $govuk-image-url-function: false !default;
@@ -77,6 +86,15 @@ $govuk-image-url-function: false !default;
 ///
 ///   $govuk-font-url-function: 'my-url-handler';
 ///
+/// @example scss - From an external module
+///
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
+///
+///   // Then pass the handler function using `meta.get-function`
+///   $govuk-font-url-function: meta.get-function("font-url", $module: "url-handlers");
+///
 /// @access public
 
 $govuk-font-url-function: false !default;

data/node_modules/govuk-frontend/dist/govuk/settings/_colours-functional.scss

@@ -1,8 +1,11 @@
 ////
 /// @group settings/colours
 ////
+@use "sass:list";
+@use "sass:map";
+@use "sass:meta";
 
-@import "../helpers/colour";
+@import "../settings/warnings";
 
 /// Default definitions of the functional colours
 ///
@@ -99,6 +102,27 @@ $govuk-default-functional-colours: (
   )
 );
 
+/// Validates and merges functional colour overrides with defaults.
+///
+/// Throws an error if any provided colour name does not exist in the default
+/// functional colours map.
+///
+/// @param {Map} $colours Functional colour overrides.
+/// @param {Map} $defaults Default functional colours.
+/// @return {Map} Merged functional colours.
+/// @access private
+@function _govuk-define-functional-colours($colours, $defaults) {
+  $existing-colours: map.keys($defaults);
+
+  @each $colour-name, $colour in $colours {
+    @if not list.index($existing-colours, $colour-name) {
+      @error 'Unknown colour `#{$colour-name}` (available colours: #{$existing-colours})';
+    }
+  }
+
+  @return map.merge($defaults, $colours);
+}
+
 /// Functional colours for the GOV.UK palette.
 ///
 /// Each functional colour is represented by a name (for example `'brand'`) to
@@ -156,14 +180,14 @@ $_govuk-deprecated-applied-colour-variables: () !default;
 /// @param {String} Name of variable to check
 /// @access private
 @mixin _warn-if-applied-colour-variable-set($functional-colour-name) {
-  @if not index($_govuk-deprecated-applied-colour-variables, $functional-colour-name) {
-    @if variable-exists("govuk-#{$functional-colour-name}-colour") {
+  @if not list.index($_govuk-deprecated-applied-colour-variables, $functional-colour-name) {
+    @if meta.variable-exists("govuk-#{$functional-colour-name}-colour") {
       $deprecation-message: "Setting \`$govuk-#{$functional-colour-name}-colour\` no longer has any effect. Use \`$govuk-functional-colours: (#{$functional-colour-name}: <NEW_COLOUR_VALUE>);\` instead.";
 
       @include _warning("applied-colour-variables", $deprecation-message);
     }
 
-    $_govuk-deprecated-applied-colour-variables: append(
+    $_govuk-deprecated-applied-colour-variables: list.append(
       $_govuk-deprecated-applied-colour-variables,
       $functional-colour-name
     ) !global;

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

@@ -1,6 +1,7 @@
 ////
 /// @group settings/links
 ////
+@use "sass:string";
 
 /// Thickness of link underlines
 ///
@@ -15,7 +16,7 @@
 /// @type Number
 /// @access public
 
-$govuk-link-underline-thickness: unquote("max(1px, .0625rem)") !default;
+$govuk-link-underline-thickness: string.unquote("max(1px, .0625rem)") !default;
 
 /// Offset of link underlines from text baseline
 ///
@@ -44,6 +45,6 @@ $govuk-link-underline-offset: 0.1578em !default;
 /// @type Number
 /// @access public
 
-$govuk-link-hover-underline-thickness: unquote("max(3px, .1875rem, .12em)") !default;
+$govuk-link-hover-underline-thickness: string.unquote("max(3px, .1875rem, .12em)") !default;
 
 /*# sourceMappingURL=_links.scss.map */

data/node_modules/govuk-frontend/dist/govuk/settings/_measurements.scss

@@ -11,6 +11,8 @@
 /// @type Number
 /// @access public
 
+@use "sass:math";
+
 $govuk-page-width: 960px !default;
 
 /// Map of grid column widths
@@ -19,21 +21,11 @@ $govuk-page-width: 960px !default;
 /// @access public
 
 $govuk-grid-widths: (
-  one-quarter: (
-    100% / 4
-  ),
-  one-third: (
-    100% / 3
-  ),
-  one-half: (
-    100% / 2
-  ),
-  two-thirds: (
-    200% / 3
-  ),
-  three-quarters: (
-    300% / 4
-  ),
+  one-quarter: math.div(100%, 4),
+  one-third: math.div(100%, 3),
+  one-half: math.div(100%, 2),
+  two-thirds: math.div(200%, 3),
+  three-quarters: math.div(300%, 4),
   full: 100%
 ) !default;
 
@@ -49,7 +41,7 @@ $govuk-gutter: 30px !default;
 /// @type Number
 /// @access public
 
-$govuk-gutter-half: $govuk-gutter / 2;
+$govuk-gutter-half: math.div($govuk-gutter, 2);
 
 // =========================================================
 // Borders

data/node_modules/govuk-frontend/dist/govuk/settings/_typography-font.scss

@@ -1,6 +1,9 @@
 ////
 /// @group settings/typography
 ////
+@use "sass:list";
+
+@import "../tools/if";
 
 // =========================================================
 // Font families
@@ -31,7 +34,7 @@ $govuk-font-family-print: sans-serif !default;
 /// @type Boolean
 /// @access public
 
-$govuk-include-default-font-face: if(index($govuk-font-family, "GDS Transport"), true, false) !default;
+$govuk-include-default-font-face: govuk-if(list.index($govuk-font-family, "GDS Transport"), true, false) !default;
 
 // =========================================================
 // Font weights

data/node_modules/govuk-frontend/dist/govuk/settings/_warnings.scss

@@ -1,6 +1,7 @@
 ////
 /// @group settings/warnings
 ////
+@use "sass:list";
 
 /// Suppressed warnings map
 ///
@@ -51,18 +52,30 @@ $govuk-suppressed-warnings: () !default;
     @warn _warning-text($key, $message);
 
     @if $silence-further-warnings {
-      $govuk-suppressed-warnings: append($govuk-suppressed-warnings, $key) !global;
+      $govuk-suppressed-warnings: list.append($govuk-suppressed-warnings, $key) !global;
     }
   }
 }
 
+/// Logs a deprecation warning that the given component's `<COMPONENT_NAME>.scss` file is deprecated
+///
+/// @param {string} $component-name - The name of component, as it appears in the folder gathering its files
+/// @access private
+@mixin _component-scss-file-warning($component-name) {
+  $component-path: "<PATH_TO_GOVUK_FRONTEND>/components/#{$component-name}";
+
+  $message: "Importing `#{$component-path}/#{$component-name}` is deprecated." + " Import `#{$component-path}` instead.";
+
+  @include _warning("component-scss-files", $message, $silence-further-warnings: false);
+}
+
 /// Check whether a key is present in the suppressed warnings list.
 ///
 /// @param {String} $key - The key to be checked against `$govuk-suppressed-warnings`.
 /// @access private
 
 @function _should-warn($key) {
-  @return index($govuk-suppressed-warnings, $key) == null;
+  @return list.index($govuk-suppressed-warnings, $key) == null;
 }
 
 /// Format a warning by appending information on how to suppress it.

data/node_modules/govuk-frontend/dist/govuk/tools/_exports.scss

@@ -1,6 +1,7 @@
 ////
 /// @group tools
 ////
+@use "sass:list";
 
 /// List of modules which have already been exported
 ///
@@ -22,9 +23,9 @@ $_govuk-imported-modules: () !default;
 
 @mixin govuk-exports($name) {
   // If the mixin is not in the list of modules already exported...
-  @if not index($_govuk-imported-modules, $name) {
+  @if not list.index($_govuk-imported-modules, $name) {
     // ... then add it to the list
-    $_govuk-imported-modules: append($_govuk-imported-modules, $name) !global;
+    $_govuk-imported-modules: list.append($_govuk-imported-modules, $name) !global;
     // ... and output the CSS for that module
     @content;
   }

data/node_modules/govuk-frontend/dist/govuk/tools/_font-url.scss

@@ -1,6 +1,7 @@
 ////
 /// @group tools/assets
 ////
+@use "sass:meta";
 
 /// Font URL
 ///
@@ -14,12 +15,19 @@
 
 @function govuk-font-url($filename) {
   // prettier-ignore
-  $use-custom-function: variable-exists("govuk-font-url-function")
-    and $govuk-font-url-function
-    and function-exists($govuk-font-url-function);
+  $custom-function: meta.variable-exists("govuk-font-url-function")
+    and $govuk-font-url-function;
 
-  @if $use-custom-function {
-    @return call(get-function($govuk-font-url-function), $filename);
+  @if meta.type-of($custom-function) == "string" {
+    @if meta.function-exists($custom-function) {
+      $custom-function: meta.get-function($custom-function);
+    } @else {
+      $custom-function: null;
+    }
+  }
+
+  @if $custom-function {
+    @return meta.call($custom-function, $filename);
   } @else {
     @return url($govuk-fonts-path + $filename);
   }

data/node_modules/govuk-frontend/dist/govuk/tools/_if.scss

@@ -0,0 +1,24 @@
+////
+/// @group tools/if
+////
+
+/// Inline `if` function
+///
+/// Replicates the syntax of the original Sass `if` function
+/// to support Sass `>=1.79 <1.95`. Defaults `$if-false` to `null`
+/// when not set.
+///
+/// @param {Boolean} $condition - The condition
+/// @param {any} $if-true - The value if the condition is met
+/// @param {any} $if-false [null] - The value if the condition is not met, defaults to `null`.
+/// @returns {any} `$if-true` if the condition is met, `$if-false` otherwise.
+/// @access public
+@function govuk-if($condition, $if-true, $if-false: null) {
+  @if $condition {
+    @return $if-true;
+  } @else {
+    @return $if-false;
+  }
+}
+
+/*# sourceMappingURL=_if.scss.map */

data/node_modules/govuk-frontend/dist/govuk/tools/_image-url.scss

@@ -1,6 +1,7 @@
 ////
 /// @group tools/assets
 ////
+@use "sass:meta";
 
 /// Image URL
 ///
@@ -14,12 +15,19 @@
 
 @function govuk-image-url($filename) {
   // prettier-ignore
-  $use-custom-function: variable-exists("govuk-image-url-function")
-    and $govuk-image-url-function
-    and function-exists($govuk-image-url-function);
+  $custom-function: meta.variable-exists("govuk-image-url-function")
+    and $govuk-image-url-function;
 
-  @if $use-custom-function {
-    @return call(get-function($govuk-image-url-function), $filename);
+  @if meta.type-of($custom-function) == "string" {
+    @if meta.function-exists($custom-function) {
+      $custom-function: meta.get-function($custom-function);
+    } @else {
+      $custom-function: null;
+    }
+  }
+
+  @if $custom-function {
+    @return meta.call($custom-function, $filename);
   } @else {
     @return url($govuk-images-path + $filename);
   }

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

@@ -1,5 +1,6 @@
 @import "exports";
 @import "font-url";
+@import "if";
 @import "image-url";
 @import "px-to-em";
 @import "px-to-rem";

data/node_modules/govuk-frontend/dist/govuk/tools/_px-to-em.scss

@@ -2,6 +2,8 @@
 /// @group tools/unit-conversion
 ////
 
+@use "sass:math";
+
 @import "../settings/typography-responsive";
 
 /// Convert pixels to em
@@ -12,13 +14,13 @@
 /// @access public
 
 @function govuk-em($value, $context-font-size: $govuk-root-font-size) {
-  @if unitless($value) {
+  @if math.is-unitless($value) {
     $value: $value * 1px;
   }
-  @if unitless($context-font-size) {
+  @if math.is-unitless($context-font-size) {
     $context-font-size: $context-font-size * 1px;
   }
-  @return $value / $context-font-size * 1em;
+  @return math.div($value, $context-font-size) * 1em;
 }
 
 /*# sourceMappingURL=_px-to-em.scss.map */

data/node_modules/govuk-frontend/dist/govuk/tools/_px-to-rem.scss

@@ -2,6 +2,8 @@
 /// @group tools/unit-conversion
 ////
 
+@use "sass:math";
+
 @import "../settings/typography-responsive";
 
 /// Convert pixels to rem
@@ -14,11 +16,11 @@
 /// @access public
 
 @function govuk-px-to-rem($value) {
-  @if unitless($value) {
+  @if math.is-unitless($value) {
     $value: $value * 1px;
   }
 
-  @return $value / $govuk-root-font-size * 1rem;
+  @return math.div($value, $govuk-root-font-size) * 1rem;
 }
 
 /*# sourceMappingURL=_px-to-rem.scss.map */

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

@@ -1,3 +1,6 @@
+@import "../tools/exports";
+@import "../helpers/clearfix";
+
 @include govuk-exports("govuk/utilities/clearfix") {
   .govuk-clearfix {
     @include govuk-clearfix;

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

@@ -1,3 +1,4 @@
+@import "../tools/exports";
 @import "clearfix";
 @import "visually-hidden";
 

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

@@ -1,3 +1,6 @@
+@import "../tools/exports";
+@import "../helpers/visually-hidden";
+
 @include govuk-exports("govuk/utilities/visually-hidden") {
   .govuk-visually-hidden {
     @include govuk-visually-hidden;

data/node_modules/govuk-frontend/dist/govuk-prototype-kit/init.scss

@@ -1,6 +1,8 @@
+@import "../govuk/tools/if";
+
 $govuk-prototype-kit-major-version: 0 !default;
 
-$govuk-assets-path: if(
+$govuk-assets-path: govuk-if(
   $govuk-prototype-kit-major-version > 12,
   $govuk-extensions-url-context + "/govuk-frontend/dist/govuk/assets/",
   "/govuk/assets/"