govuk_tech_docs 6.3.0.beta → 6.4.0.beta

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

@@ -1,10 +1,6 @@
-@import "../settings/spacing";
-@import "../tools/exports";
-@import "../helpers/spacing";
-@import "display";
-@import "spacing";
-@import "text-align";
-@import "typography";
-@import "width";
+@use "display";
+@use "spacing";
+@use "text-align";
+@use "typography";
+@use "width";
 
-/*# sourceMappingURL=_index.scss.map */

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

@@ -0,0 +1,8 @@
+@use "spacing.mixin" as mixin;
+
+@import "../tools/exports";
+
+@include govuk-exports("govuk/overrides/spacing") {
+  @include mixin.styles;
+}
+

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

@@ -0,0 +1,89 @@
+////
+/// @group overrides
+////
+@use "sass:map";
+@use "../base";
+@use "../helpers/spacing--internal";
+
+// stylelint-disable declaration-no-important
+
+/// Directions for spacing
+///
+/// @type Map
+/// @access private
+
+$_spacing-directions: ("top", "right", "bottom", "left") !default;
+
+/// Generate responsive spacing override classes
+///
+/// Generate spacing override classes for the given property (e.g. margin)
+/// for each point in the responsive spacing scale.
+///
+/// @param {String} $property - Property to add spacing to (e.g. 'margin')
+///
+/// @example css
+///  .govuk-\!-margin-4 {
+///    margin: 15px !important;
+///  }
+///
+///  @media (min-width: 40.0625em) {
+///    .govuk-\!-margin-4 {
+///      margin: 20px !important;
+///    }
+///  }
+///
+/// @access private
+
+@mixin _govuk-generate-responsive-spacing-overrides($property) {
+  // For each point in the spacing scale (defined in settings), create an
+  // override that affects all directions...
+  @each $scale-point, $scale-map in base.$govuk-spacing-responsive-scale {
+    .govuk-\!-#{$property}-#{$scale-point} {
+      @include spacing--internal.responsive-spacing($scale-point, $property, "all", true);
+    }
+
+    // ... and then an override for each individual direction
+    @each $direction in $_spacing-directions {
+      .govuk-\!-#{$property}-#{$direction}-#{$scale-point} {
+        @include spacing--internal.responsive-spacing($scale-point, $property, $direction, true);
+      }
+    }
+  }
+}
+
+/// Generate static spacing override classes
+///
+/// Generate spacing override classes for the given property (e.g. margin)
+/// for each point in the non-responsive spacing scale.
+///
+/// @param {String} $property - Property to add spacing to (e.g. 'margin')
+///
+/// @example css
+///   .govuk-\!-static-margin-4 {
+///      margin: 20px !important;
+///   }
+///
+/// @access private
+@mixin _govuk-generate-static-spacing-overrides($property) {
+  @each $spacing-point in map.keys(base.$govuk-spacing-points) {
+    .govuk-\!-static-#{$property}-#{$spacing-point} {
+      #{$property}: base.govuk-spacing($spacing-point) !important;
+    }
+
+    @each $direction in $_spacing-directions {
+      .govuk-\!-static-#{$property}-#{$direction}-#{$spacing-point} {
+        #{$property}-#{$direction}: base.govuk-spacing($spacing-point) !important;
+      }
+    }
+  }
+}
+
+/// @access private
+@mixin styles {
+  @include _govuk-generate-responsive-spacing-overrides("margin");
+  @include _govuk-generate-responsive-spacing-overrides("padding");
+
+  @include _govuk-generate-static-spacing-overrides("margin");
+  @include _govuk-generate-static-spacing-overrides("padding");
+}
+

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

@@ -1,90 +1,4 @@
-////
-/// @group overrides
-////
-@use "sass:map";
-@import "../settings/spacing";
-@import "../tools/exports";
-@import "../helpers/spacing";
+@use "spacing.mixin" as spacing;
 
-// stylelint-disable declaration-no-important
+@include spacing.styles;
 
-/// Directions for spacing
-///
-/// @type Map
-/// @access private
-
-$_spacing-directions: ("top", "right", "bottom", "left") !default;
-
-/// Generate responsive spacing override classes
-///
-/// Generate spacing override classes for the given property (e.g. margin)
-/// for each point in the responsive spacing scale.
-///
-/// @param {String} $property - Property to add spacing to (e.g. 'margin')
-///
-/// @example css
-///  .govuk-\!-margin-4 {
-///    margin: 15px !important;
-///  }
-///
-///  @media (min-width: 40.0625em) {
-///    .govuk-\!-margin-4 {
-///      margin: 20px !important;
-///    }
-///  }
-///
-/// @access private
-
-@mixin _govuk-generate-responsive-spacing-overrides($property) {
-  // For each point in the spacing scale (defined in settings), create an
-  // override that affects all directions...
-  @each $scale-point, $scale-map in $govuk-spacing-responsive-scale {
-    .govuk-\!-#{$property}-#{$scale-point} {
-      @include _govuk-responsive-spacing($scale-point, $property, "all", true);
-    }
-
-    // ... and then an override for each individual direction
-    @each $direction in $_spacing-directions {
-      .govuk-\!-#{$property}-#{$direction}-#{$scale-point} {
-        @include _govuk-responsive-spacing($scale-point, $property, $direction, true);
-      }
-    }
-  }
-}
-
-/// Generate static spacing override classes
-///
-/// Generate spacing override classes for the given property (e.g. margin)
-/// for each point in the non-responsive spacing scale.
-///
-/// @param {String} $property - Property to add spacing to (e.g. 'margin')
-///
-/// @example css
-///   .govuk-\!-static-margin-4 {
-///      margin: 20px !important;
-///   }
-///
-/// @access private
-@mixin _govuk-generate-static-spacing-overrides($property) {
-  @each $spacing-point in map.keys($govuk-spacing-points) {
-    .govuk-\!-static-#{$property}-#{$spacing-point} {
-      #{$property}: govuk-spacing($spacing-point) !important;
-    }
-
-    @each $direction in $_spacing-directions {
-      .govuk-\!-static-#{$property}-#{$direction}-#{$spacing-point} {
-        #{$property}-#{$direction}: govuk-spacing($spacing-point) !important;
-      }
-    }
-  }
-}
-
-@include govuk-exports("govuk/overrides/spacing") {
-  @include _govuk-generate-responsive-spacing-overrides("margin");
-  @include _govuk-generate-responsive-spacing-overrides("padding");
-
-  @include _govuk-generate-static-spacing-overrides("margin");
-  @include _govuk-generate-static-spacing-overrides("padding");
-}
-
-/*# sourceMappingURL=_spacing.scss.map */

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

@@ -0,0 +1,8 @@
+@use "text-align.mixin" as mixin;
+
+@import "../tools/exports";
+
+@include govuk-exports("govuk/overrides/text-align") {
+  @include mixin.styles;
+}
+

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

@@ -0,0 +1,16 @@
+// stylelint-disable declaration-no-important
+/// @access private
+@mixin styles {
+  .govuk-\!-text-align-left {
+    text-align: left !important;
+  }
+
+  .govuk-\!-text-align-centre {
+    text-align: center !important;
+  }
+
+  .govuk-\!-text-align-right {
+    text-align: right !important;
+  }
+}
+

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

@@ -1,18 +1,4 @@
-@import "../tools/exports";
+@use "text-align.mixin" as text-align;
 
-// stylelint-disable declaration-no-important
-@include govuk-exports("govuk/overrides/text-align") {
-  .govuk-\!-text-align-left {
-    text-align: left !important;
-  }
+@include text-align.styles;
 
-  .govuk-\!-text-align-centre {
-    text-align: center !important;
-  }
-
-  .govuk-\!-text-align-right {
-    text-align: right !important;
-  }
-}
-
-/*# sourceMappingURL=_text-align.scss.map */

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

@@ -0,0 +1,8 @@
+@use "typography.mixin" as mixin;
+
+@import "../tools/exports";
+
+@include govuk-exports("govuk/overrides/typography") {
+  @include mixin.styles;
+}
+

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

@@ -0,0 +1,43 @@
+@use "sass:map";
+@use "../base";
+
+/// @access private
+@mixin styles {
+  // Font size and line height
+
+  // Generate typography override classes for each responsive font map in the
+  // typography scale eg .govuk-\!-font-size-80
+  @each $size, $font-map in base.$govuk-typography-scale {
+    .govuk-\!-font-size-#{$size} {
+      $font-map: map.get(base.$govuk-typography-scale, $size);
+
+      // Add underscore to deprecated typography scale keys
+      @if map.has-key($font-map, "deprecation") {
+        $size: _#{$size};
+      }
+
+      @include base.govuk-font-size($size, $important: true);
+    }
+  }
+
+  // Weights
+
+  .govuk-\!-font-weight-regular {
+    @include base.govuk-typography-weight-regular($important: true);
+  }
+
+  .govuk-\!-font-weight-bold {
+    @include base.govuk-typography-weight-bold($important: true);
+  }
+
+  // Typography helpers
+
+  .govuk-\!-font-tabular-numbers {
+    @include base.govuk-font-tabular-numbers($important: true);
+  }
+
+  .govuk-\!-text-break-word {
+    @include base.govuk-text-break-word($important: true);
+  }
+}
+

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

@@ -1,45 +1,4 @@
-@use "sass:map";
-@import "../settings/typography-responsive";
-@import "../tools/exports";
-@import "../helpers/typography";
+@use "typography.mixin" as typography;
 
-@include govuk-exports("govuk/overrides/typography") {
-  // Font size and line height
+@include typography.styles;
 
-  // Generate typography override classes for each responsive font map in the
-  // 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);
-
-      // Add underscore to deprecated typography scale keys
-      @if map.has-key($font-map, "deprecation") {
-        $size: _#{$size};
-      }
-
-      @include govuk-font-size($size, $important: true);
-    }
-  }
-
-  // Weights
-
-  .govuk-\!-font-weight-regular {
-    @include govuk-typography-weight-regular($important: true);
-  }
-
-  .govuk-\!-font-weight-bold {
-    @include govuk-typography-weight-bold($important: true);
-  }
-
-  // Typography helpers
-
-  .govuk-\!-font-tabular-numbers {
-    @include govuk-font-tabular-numbers($important: true);
-  }
-
-  .govuk-\!-text-break-word {
-    @include govuk-text-break-word($important: true);
-  }
-}
-
-/*# sourceMappingURL=_typography.scss.map */

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

@@ -0,0 +1,8 @@
+@use "width.mixin" as mixin;
+
+@import "../tools/exports";
+
+@include govuk-exports("govuk/overrides/width") {
+  @include mixin.styles;
+}
+

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

@@ -0,0 +1,50 @@
+@use "../base";
+
+// stylelint-disable declaration-no-important
+/// @access private
+@mixin styles {
+  .govuk-\!-width-full {
+    width: 100% !important;
+  }
+
+  .govuk-\!-width-three-quarters {
+    width: 100% !important;
+
+    @media #{base.govuk-from-breakpoint(tablet)} {
+      width: 75% !important;
+    }
+  }
+
+  .govuk-\!-width-two-thirds {
+    width: 100% !important;
+
+    @media #{base.govuk-from-breakpoint(tablet)} {
+      width: 66.66% !important;
+    }
+  }
+
+  .govuk-\!-width-one-half {
+    width: 100% !important;
+
+    @media #{base.govuk-from-breakpoint(tablet)} {
+      width: 50% !important;
+    }
+  }
+
+  .govuk-\!-width-one-third {
+    width: 100% !important;
+
+    @media #{base.govuk-from-breakpoint(tablet)} {
+      width: 33.33% !important;
+    }
+  }
+
+  .govuk-\!-width-one-quarter {
+    width: 100% !important;
+
+    @media #{base.govuk-from-breakpoint(tablet)} {
+      width: 25% !important;
+    }
+  }
+}
+

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

@@ -1,51 +1,4 @@
-@import "../tools/exports";
-@import "../helpers/media-queries";
+@use "width.mixin" as width;
 
-// stylelint-disable declaration-no-important
-@include govuk-exports("govuk/overrides/width") {
-  .govuk-\!-width-full {
-    width: 100% !important;
-  }
+@include width.styles;
 
-  .govuk-\!-width-three-quarters {
-    width: 100% !important;
-
-    @media #{govuk-from-breakpoint(tablet)} {
-      width: 75% !important;
-    }
-  }
-
-  .govuk-\!-width-two-thirds {
-    width: 100% !important;
-
-    @media #{govuk-from-breakpoint(tablet)} {
-      width: 66.66% !important;
-    }
-  }
-
-  .govuk-\!-width-one-half {
-    width: 100% !important;
-
-    @media #{govuk-from-breakpoint(tablet)} {
-      width: 50% !important;
-    }
-  }
-
-  .govuk-\!-width-one-third {
-    width: 100% !important;
-
-    @media #{govuk-from-breakpoint(tablet)} {
-      width: 33.33% !important;
-    }
-  }
-
-  .govuk-\!-width-one-quarter {
-    width: 100% !important;
-
-    @media #{govuk-from-breakpoint(tablet)} {
-      width: 25% !important;
-    }
-  }
-}
-
-/*# sourceMappingURL=_width.scss.map */

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

@@ -0,0 +1,13 @@
+@forward "assets";
+
+@use "sass:meta";
+@use "assets";
+
+@if meta.variable-exists("govuk-font-url-function") and meta.type-of($govuk-font-url-function) == "string" {
+  assets.$govuk-font-url-function: meta.get-function($govuk-font-url-function);
+}
+
+@if meta.variable-exists("govuk-image-url-function") and meta.type-of($govuk-image-url-function) == "string" {
+  assets.$govuk-image-url-function: meta.get-function($govuk-image-url-function);
+}
+

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

@@ -29,20 +29,30 @@ $govuk-fonts-path: "#{$govuk-assets-path}fonts/" !default;
 
 /// Custom image URL function
 ///
-/// If the built-in image URL helper does not meet your needs, you can specify
-/// the name of a custom handler – either built in or by writing your own
-/// function.
+/// If you need more control than $govuk-images-path provides, you can use a
+/// function to resolve image filenames to URLs.
 ///
-/// If you are writing your own handler, ensure that it returns a string wrapped
-/// with `url()`
+/// The function should accept a filename and return the URL as a string,
+/// wrapped with `url()`.
 ///
-/// @type String
+/// Passing the name of a function as a string is deprecated.
+///
+/// @type Function | String | null
 ///
-/// @example scss - Rails asset handling
-///   $govuk-image-url-function: 'image-url';
+/// @example scss - Passing a function
 ///
-/// @example scss - Custom asset handling
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
+///
+///   // Then pass the handler function using `meta.get-function`
+///   @use "node_modules/govuk-frontend/dist/govuk" as * with (
+///     $govuk-image-url-function: meta.get-function("image-url", $module: "url-handlers")
+///   )
 ///
+/// @example scss - Passing the name of a function (deprecated)
+///
+///   // This is only available if you still use `@import`
 ///   @function my-url-handler($filename) {
 ///     // Some custom URL handling
 ///     @return url('example.jpg');
@@ -50,35 +60,41 @@ $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";
+///   @import "node_modules/govuk-frontend/dist/govuk";
 ///
-///   // Then pass the handler function using `meta.get-function`
-///   $govuk-image-url-function: meta.get-function("image-url", $module: "url-handlers");
+/// @see $govuk-images-path
+/// @see {function} govuk-image-url
 ///
 /// @access public
 
-$govuk-image-url-function: false !default;
+$govuk-image-url-function: null !default;
 
 /// Custom font URL function
 ///
-/// If the built-in font URL helper does not meet your needs, you can specify
-/// the name of a custom handler – either built in or by writing your own
-/// function.
+/// If you need more control than $govuk-fonts-path provides, you can use a
+/// function to resolve font filenames to URLs.
 ///
-/// If you are writing your own handler, ensure that it returns a string wrapped
-/// with `url()`
+/// The function should accept a filename and return the URL as a string,
+/// wrapped with `url()`.
 ///
-/// @type String
+/// Passing the name of a function as a string is deprecated.
+///
+/// @type Function | String | null
 ///
-/// @example scss - Rails asset handling
-///   $govuk-font-url-function: 'font-url';
+/// @example scss - Passing a function
 ///
-/// @example scss - Custom asset handling
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
+///
+///   // Then pass the handler function using `meta.get-function`
+///   @use "node_modules/govuk-frontend/dist/govuk" as * with (
+///     $govuk-font-url-function: meta.get-function("font-url", $module: "url-handlers")
+///   )
 ///
+/// @example scss - Passing the name of a function (deprecated)
+///
+///   // This is only available if you still use `@import`
 ///   @function my-url-handler($filename) {
 ///     // Some custom URL handling
 ///     @return url('example.woff');
@@ -86,17 +102,12 @@ $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";
+///   @import "node_modules/govuk-frontend/dist/govuk";
 ///
-///   // Then pass the handler function using `meta.get-function`
-///   $govuk-font-url-function: meta.get-function("font-url", $module: "url-handlers");
+/// @see $govuk-fonts-path
+/// @see {function} govuk-font-url
 ///
 /// @access public
 
-$govuk-font-url-function: false !default;
+$govuk-font-url-function: null !default;
 
-/*# sourceMappingURL=_assets.scss.map */

data/node_modules/govuk-frontend/dist/govuk/settings/_colours-applied.import.scss

@@ -0,0 +1,13 @@
+////
+/// @group settings/colours
+////
+@use "warnings--internal";
+
+@forward "colours-functional";
+
+@include warnings--internal.warning(
+  "colours-applied",
+  "The '_colours-applied' file is deprecated. Please import '_colours-functional' instead. " +
+    "See https://github.com/alphagov/govuk-frontend/releases/tag/v6.0.0 for more details."
+);
+

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

@@ -0,0 +1,2 @@
+@forward "colours-functional";
+