govuk_tech_docs 6.3.0.beta → 6.4.0.beta

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
@@ -22,6 +20,9 @@ $govuk-default-functional-colours: (
     "text": (
       name: "black"
     ),
+    "inverse-text": (
+      name: "white"
+    ),
     // The background colour of the template. This is intended to be the same
     // as `surface-background` for the purposes of making the Footer and Cookie
     // banner components merge seamlessly with the template.
@@ -142,14 +143,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 +166,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";
+

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

@@ -0,0 +1,188 @@
+////
+/// @group settings/colours
+////
+@use "../helpers/colour" as *;
+// =============================================================================
+// 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
+// =============================================================================
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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(success)`.
+$govuk-success-colour: govuk-functional-colour(success);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+
+/// 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);
+

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

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

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

@@ -1,4 +1,4 @@
-@import "../settings/warnings";
+@use "warnings--internal";
 
 ////
 /// @group settings/colours
@@ -115,22 +115,3 @@ $govuk-colours-organisations: (
   )
 ) !default;
 
-/// 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"
-);
-
-/*# sourceMappingURL=_colours-organisations.scss.map */

data/node_modules/govuk-frontend/dist/govuk/settings/{_colours-palette.scss → _colours-palette--internal.scss}

@@ -11,7 +11,7 @@
 ///
 /// @access private
 
-$_govuk-palette: (
+$govuk-palette: (
   "blue": (
     "primary": #1d70b8,
     "tint-25": #5694ca,
@@ -112,7 +112,7 @@ $_govuk-palette: (
 ///   the brand colours were introduced
 ///
 /// @access private
-$_govuk-pre-brand-colours: (
+$govuk-pre-brand-colours: (
   "light-pink": "magenta" "tint-50",
   "pink": "magenta" "primary",
   "light-green": "green" "tint-25",
@@ -126,4 +126,3 @@ $_govuk-pre-brand-colours: (
   "light-grey": "black" "tint-95"
 );
 
-/*# sourceMappingURL=_colours-palette.scss.map */

data/node_modules/govuk-frontend/dist/govuk/settings/_custom-properties.import.scss

@@ -0,0 +1,2 @@
+@forward "custom-properties";
+

data/node_modules/govuk-frontend/dist/govuk/settings/_custom-properties.scss

@@ -15,4 +15,3 @@
 
 $govuk-output-custom-properties: true !default;
 
-/*# sourceMappingURL=_custom-properties.scss.map */

data/node_modules/govuk-frontend/dist/govuk/settings/_global-styles.import.scss

@@ -0,0 +1,2 @@
+@forward "global-styles";
+

data/node_modules/govuk-frontend/dist/govuk/settings/_global-styles.scss

@@ -12,4 +12,3 @@
 
 $govuk-global-styles: false !default;
 
-/*# sourceMappingURL=_global-styles.scss.map */

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

@@ -0,0 +1,24 @@
+// The order we import settings in is important, as some settings files rely on
+// others
+
+@import "assets";
+
+@import "warnings";
+@import "global-styles";
+
+@import "custom-properties";
+
+@import "media-queries";
+
+@import "colours-organisations";
+@import "colours-functional";
+@import "colours-legacy-functional";
+
+@import "spacing";
+@import "measurements";
+
+@import "typography-font";
+@import "typography-responsive";
+
+@import "links";
+

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

@@ -1,25 +1,24 @@
 // The order we import settings in is important, as some settings files rely on
 // others
 
-@import "assets";
+@forward "assets";
 
-@import "warnings";
-@import "global-styles";
+@forward "warnings";
+@forward "global-styles";
 
-@import "custom-properties";
+@forward "custom-properties";
 
-@import "media-queries";
+@forward "media-queries";
 
-@import "colours-palette";
-@import "colours-organisations";
-@import "colours-functional";
+@forward "colours-organisations";
+@forward "colours-functional";
+@forward "colours-legacy-functional";
 
-@import "spacing";
-@import "measurements";
+@forward "spacing";
+@forward "measurements";
 
-@import "typography-font";
-@import "typography-responsive";
+@forward "typography-font";
+@forward "typography-responsive";
 
-@import "links";
+@forward "links";
 
-/*# sourceMappingURL=_index.scss.map */

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

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

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

@@ -47,4 +47,3 @@ $govuk-link-underline-offset: 0.1578em !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.import.scss

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

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

@@ -1,3 +1,5 @@
+@use "sass:math";
+
 ////
 /// @group settings/layout
 ////
@@ -11,8 +13,6 @@
 /// @type Number
 /// @access public
 
-@use "sass:math";
-
 $govuk-page-width: 960px !default;
 
 /// Map of grid column widths
@@ -96,4 +96,3 @@ $govuk-focus-width: 3px !default;
 
 $govuk-hover-width: 10px !default;
 
-/*# sourceMappingURL=_measurements.scss.map */

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

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

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

@@ -13,4 +13,3 @@ $govuk-breakpoints: (
   desktop: 769px
 ) !default;
 
-/*# sourceMappingURL=_media-queries.scss.map */

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

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

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

@@ -75,4 +75,3 @@ $govuk-spacing-responsive-scale: (
   )
 ) !default;
 
-/*# sourceMappingURL=_spacing.scss.map */

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

@@ -0,0 +1,2 @@
+@forward "typography-font";
+