govuk_tech_docs 6.0.1 → 6.2.0

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/"