govuk_tech_docs 6.3.0.beta → 6.3.0

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";
+

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

@@ -5,8 +5,6 @@
 @use "sass:map";
 @use "sass:meta";
 
-@import "../settings/warnings";
-
 /// Default definitions of the functional colours
 ///
 /// @type Map
@@ -142,14 +140,16 @@ $govuk-default-functional-colours: (
 ///
 /// @example scss – Redefining functional colours by setting them before import
 ///
-///   // These will be merged with the default functional colours
-///   $govuk-functional-colours: (
-///     // set the 'brand' colour to the 'primary' variant of 'purple'
-///     brand: (name: 'purple'),
-///     // set the 'template-background' colour to the 'tint-95' variant of 'purple'
-///     template-background: (name: 'purple', variant: 'tint-95'),
-///     // set the 'text' colour to an arbitrary colour `#221133`
-///     text: #221133
+///   @use "node_modules/govuk-frontend/dist/govuk" as * with (
+///     // These will be merged with the default functional colours
+///     $govuk-functional-colours: (
+///       // set the 'brand' colour to the 'primary' variant of 'purple'
+///       brand: (name: 'purple'),
+///       // set the 'template-background' colour to the 'tint-95' variant of 'purple'
+///       template-background: (name: 'purple', variant: 'tint-95'),
+///       // set the 'text' colour to an arbitrary colour `#221133`
+///       text: #221133
+///     )
 ///   );
 ///
 /// @see {function} govuk-functional-colour
@@ -163,228 +163,3 @@ $govuk-functional-colours: _govuk-define-functional-colours(
   $defaults: $govuk-default-functional-colours
 );
 
-// =============================================================================
-// Legacy variables
-//
-// To help migrate to `govuk-functional-colour`, we're keeping the variables
-// which were previously storing the functional colours. This should reduce
-// breakage as teams upgrade
-// =============================================================================
-
-// Because the file may be imported multiple times, subsequent imports will see
-// the legacy variable and warn when they shouldn't so we need to track those
-$_govuk-deprecated-applied-colour-variables: () !default;
-
-/// Warn if a given legacy applied colour variable is set
-///
-/// @param {String} Name of variable to check
-/// @access private
-@mixin _warn-if-applied-colour-variable-set($functional-colour-name) {
-  @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: list.append(
-      $_govuk-deprecated-applied-colour-variables,
-      $functional-colour-name
-    ) !global;
-  }
-}
-
-@include _warn-if-applied-colour-variable-set(brand);
-/// Brand colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(brand)`.
-$govuk-brand-colour: govuk-functional-colour(brand);
-
-@include _warn-if-applied-colour-variable-set(text);
-/// Text colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(text)`.
-$govuk-text-colour: govuk-functional-colour(text);
-
-@include _warn-if-applied-colour-variable-set(template-background);
-/// Template background colour
-///
-/// Used by components that want to give the illusion of extending
-/// the template background (such as the footer and cookie banner).
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(template-background)`.
-$govuk-template-background-colour: govuk-functional-colour(template-background);
-
-@include _warn-if-applied-colour-variable-set(body-background);
-/// Body background colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(body-background)`.
-$govuk-body-background-colour: govuk-functional-colour(body-background);
-
-@include _warn-if-applied-colour-variable-set(print-text);
-/// Text colour for print media
-///
-/// Use 'true black' to avoid printers using colour ink to print body text
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(print-text)`.
-$govuk-print-text-colour: govuk-functional-colour(print-text);
-
-@include _warn-if-applied-colour-variable-set(secondary-text);
-/// Secondary text colour
-///
-/// Used in for example 'muted' text and help text.
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(secondary-text)`.
-$govuk-secondary-text-colour: govuk-functional-colour(secondary-text);
-
-@include _warn-if-applied-colour-variable-set(focus);
-/// Focus colour
-///
-/// Used for outline (and background, where appropriate) when interactive
-/// elements (links, form controls) have keyboard focus.
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(focus)`.
-$govuk-focus-colour: govuk-functional-colour(focus);
-
-@include _warn-if-applied-colour-variable-set(focus-text);
-/// Focused text colour
-///
-/// Ensure that the contrast between the text and background colour passes
-/// WCAG Level AA contrast requirements.
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(focus-text)`.
-$govuk-focus-text-colour: govuk-functional-colour(focus-text);
-
-@include _warn-if-applied-colour-variable-set(error);
-/// Error colour
-///
-/// Used to highlight error messages and form controls in an error state
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(error)`.
-$govuk-error-colour: govuk-functional-colour(error);
-
-@include _warn-if-applied-colour-variable-set(success);
-/// Success colour
-///
-/// Used to highlight success messages and banners
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(error)`.
-$govuk-success-colour: govuk-functional-colour(success);
-
-@include _warn-if-applied-colour-variable-set(border);
-/// Border colour
-///
-/// Used in for example borders, separators, rules and keylines.
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(border)`.
-$govuk-border-colour: govuk-functional-colour(border);
-
-@include _warn-if-applied-colour-variable-set(input-border);
-/// Input border colour
-///
-/// Used for form inputs and controls
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(input-border)`.
-$govuk-input-border-colour: govuk-functional-colour(input-border);
-
-@include _warn-if-applied-colour-variable-set(hover);
-/// Input hover colour
-///
-/// Used for hover states on form controls
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(hover)`.
-$govuk-hover-colour: govuk-functional-colour(hover);
-
-@include _warn-if-applied-colour-variable-set(link);
-/// Link colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(link)`.
-$govuk-link-colour: govuk-functional-colour(link);
-
-@include _warn-if-applied-colour-variable-set(link-visited);
-/// Visited link colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(link-visited)`.
-$govuk-link-visited-colour: govuk-functional-colour(link-visited);
-
-@include _warn-if-applied-colour-variable-set(link-hover);
-/// Link hover colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(link-hover)`.
-$govuk-link-hover-colour: govuk-functional-colour(link-hover);
-
-@include _warn-if-applied-colour-variable-set(link-active);
-/// Active link colour
-///
-/// @type Colour
-/// @access public
-/// @deprecated
-///   Variables for applied colours are deprecated. Please use the `govuk-functional-colour`
-///   function instead: `govuk-functional-colour(link-active)`.
-$govuk-link-active-colour: govuk-functional-colour(link-active);
-
-/*# sourceMappingURL=_colours-functional.scss.map */

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

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