govuk_publishing_components 17.21.0 → 18.0.0

data/node_modules/govuk-frontend/{helpers → govuk/helpers}/_visually-hidden.scss

@@ -18,7 +18,8 @@
 
   width: 1px iff($important, !important);
   height: 1px iff($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
+  // 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 iff($important, !important);
   padding: 0 iff($important, !important);
 
@@ -51,7 +52,8 @@
 
   width: 1px iff($important, !important);
   height: 1px iff($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
+  // 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 iff($important, !important);
 
   overflow: hidden iff($important, !important);

data/node_modules/govuk-frontend/{objects → govuk/objects}/_grid.scss

@@ -12,7 +12,7 @@
 
   @each $width in map-keys($govuk-grid-widths) {
     .govuk-grid-column-#{$width} {
-      @include govuk-grid-column($width, $class: false)
+      @include govuk-grid-column($width)
     }
   }
 
@@ -21,7 +21,7 @@
   // them in the outputted CSS
   @each $width in map-keys($govuk-grid-widths) {
     .govuk-grid-column-#{$width}-from-desktop {
-      @include govuk-grid-column($width, $at: desktop, $class: false)
+      @include govuk-grid-column($width, $at: desktop)
     }
   }
 }

data/node_modules/govuk-frontend/{objects → govuk/objects}/_main-wrapper.scss

@@ -20,6 +20,8 @@
 // </div>
 
 
+/// @deprecated Replace this mixin with more direct references to the [spacing
+/// mixins](https://design-system.service.gov.uk/styles/spacing/#spacing-on-custom-components).
 @mixin govuk-main-wrapper {
   // In IE11 the `main` element can be used, but is not recognized  –
   // meaning it's not defined in IE's default style sheet,
@@ -37,7 +39,11 @@
   }
 }
 
-// Use govuk-main-wrapper--l when you page does not have Breadcrumbs, phase banners or back links
+/// Use govuk-main-wrapper--l when you page does not have Breadcrumbs, phase
+/// banners or back links.
+///
+/// @deprecated Replace this mixin with more direct references to the [spacing
+/// mixins](https://design-system.service.gov.uk/styles/spacing/#spacing-on-custom-components).
 @mixin govuk-main-wrapper--l {
   @include govuk-responsive-padding(8, "top");
 }
@@ -47,6 +53,14 @@
     @include govuk-main-wrapper;
   }
 
+  // Using the `.govuk-main-wrapper--auto-spacing` modifier should apply the
+  // correct spacing depending on whether there are any elements
+  // (such the back link, breadcrumbs or phase banner components) before the
+  // `.govuk-main-wrapper` in the `govuk-width-container`.
+  //
+  // If you need to control the spacing manually, use the
+  // `govuk-main-wrapper--l` modifier instead.
+  .govuk-main-wrapper--auto-spacing:first-child,
   .govuk-main-wrapper--l {
     @include govuk-main-wrapper--l;
   }

data/node_modules/govuk-frontend/{settings → govuk/settings}/_colours-applied.scss

@@ -26,12 +26,13 @@ $govuk-text-colour: govuk-colour("black") !default;
 
 /// Canvas background colour
 ///
-/// Used by the footer component and template to give the illusion of a long footer.
+/// Used by the footer component and template to give the illusion of a long
+/// footer.
 ///
 /// @type Colour
 /// @access public
 
-$govuk-canvas-background-colour: govuk-colour("grey-3") !default;
+$govuk-canvas-background-colour: govuk-colour("light-grey", $legacy: "grey-3") !default;
 
 /// Body background colour
 ///
@@ -56,7 +57,7 @@ $govuk-print-text-colour: #000000 !default;
 /// @type Colour
 /// @access public
 
-$govuk-secondary-text-colour: govuk-colour("grey-1") !default;
+$govuk-secondary-text-colour: govuk-colour("dark-grey", $legacy: "grey-1") !default;
 
 /// Focus colour
 ///
@@ -94,7 +95,7 @@ $govuk-error-colour: govuk-colour("red") !default;
 /// @type Colour
 /// @access public
 
-$govuk-border-colour: govuk-colour("grey-2") !default;
+$govuk-border-colour: govuk-colour("mid-grey", $legacy: "grey-2");
 
 /// Input border colour
 ///
@@ -112,7 +113,7 @@ $govuk-input-border-colour: govuk-colour("black") !default;
 /// @type Colour
 /// @access public
 
-$govuk-hover-colour: govuk-colour("grey-3") !default;
+$govuk-hover-colour: govuk-colour("mid-grey", $legacy: "grey-3");
 
 
 // =============================================================================
@@ -131,18 +132,18 @@ $govuk-link-colour: govuk-colour("blue") !default;
 /// @type Colour
 /// @access public
 
-$govuk-link-visited-colour: #4c2c92 !default;
+$govuk-link-visited-colour: govuk-colour("purple", $legacy: #4c2c92) !default;
 
 /// Link hover colour
 ///
 /// @type Colour
 /// @access public
 
-$govuk-link-hover-colour: govuk-colour("light-blue") !default;
+$govuk-link-hover-colour: govuk-colour("dark-blue", $legacy: "light-blue") !default;
 
 /// Active link colour
 ///
 /// @type Colour
 /// @access public
 
-$govuk-link-active-colour: govuk-colour("light-blue") !default;
+$govuk-link-active-colour: govuk-colour("black", $legacy: "light-blue") !default;

data/node_modules/govuk-frontend/{settings → govuk/settings}/_colours-organisations.scss

@@ -31,7 +31,7 @@ $govuk-colours-organisations: (
     colour-websafe: #347da4
   ),
   "department-for-communities-and-local-government": (
-    colour: #00857e,
+    colour: #009999,
     colour-websafe: #37836e
   ),
   "department-for-culture-media-sport": (

data/node_modules/govuk-frontend/govuk/settings/_colours-palette.scss

@@ -0,0 +1,101 @@
+@import "compatibility";
+
+////
+/// @group settings/colours
+////
+
+/// Use 'legacy' colour palette
+///
+/// Whether or not to use the colour palette from GOV.UK Elements / Frontend
+/// Toolkit, for teams that are migrating to GOV.UK Frontend and may be using
+/// components from both places in a single application.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-use-legacy-palette: if((
+    $govuk-compatibility-govukfrontendtoolkit or
+    $govuk-compatibility-govuktemplate or
+    $govuk-compatibility-govukelements
+  ), true, false) !default;
+
+/// Legacy colour palette
+///
+/// This exists only because you cannot easily set a !default variable
+/// conditionally (thanks to the way scope works in Sass) so we set
+/// `$govuk-colour-palette` using the `if` function.
+///
+/// @access private
+
+$_govuk-colour-palette-legacy: (
+  "purple": #2e358b,
+  "light-purple": #6f72af,
+  "bright-purple": #912b88,
+  "pink": #d53880,
+  "light-pink": #f499be,
+  "red": #b10e1e,
+  "bright-red": #df3034,
+  "orange": #f47738,
+  "brown": #b58840,
+  "yellow": #ffbf47,
+  "light-green": #85994b,
+  "green": #006435,
+  "turquoise": #28a197,
+  "light-blue": #2b8cc4,
+  "blue": #005ea5,
+
+  "black": #0b0c0c,
+  "grey-1": #6f777b,
+  "grey-2": #bfc1c3,
+  "grey-3": #dee0e2,
+  "grey-4": #f8f8f8,
+  "white": #ffffff
+);
+
+/// Modern colour palette
+///
+/// This exists only because you cannot easily set a !default variable
+/// conditionally (thanks to the way scope works in Sass) so we set
+/// `$govuk-colour-palette` using the `if` function.
+///
+/// @access private
+
+$_govuk-colour-palette-modern: (
+  "red": #d4351c,
+  "yellow": #ffdd00,
+  "green": #00703c,
+  "blue": #1d70b8,
+  "dark-blue": #003078,
+  "light-blue": #5694ca,
+  "purple": #4c2c92,
+
+  "black": #0b0c0c,
+  "dark-grey": #6f777b,
+  "mid-grey": #b1b4b6,
+  "light-grey": #f3f2f1,
+  "white": #ffffff,
+
+  "light-purple": #6f72af,
+  "bright-purple": #912b88,
+  "pink": #d53880,
+  "light-pink": #f499be,
+  "orange": #f47738,
+  "brown": #b58840,
+  "light-green": #85994b,
+  "turquoise": #28a197
+);
+
+/// Colour palette
+///
+/// @type Map
+///
+/// @prop $colour - Representation for the given $colour, where $colour is the
+///   friendly name for the colour (e.g. "red": #ff0000);
+///
+/// @access public
+
+$govuk-colours: if(
+  $govuk-use-legacy-palette,
+  $_govuk-colour-palette-legacy,
+  $_govuk-colour-palette-modern
+) !default;

data/node_modules/govuk-frontend/govuk/settings/_compatibility.scss

@@ -0,0 +1,75 @@
+////
+/// 'Compatibility Mode'
+///
+/// Enabling these flags improves compatibility if you are using GOV.UK Frontend
+/// in an application that also uses govuk_elements, govuk_frontend_toolkit or
+/// govuk_template (the 'legacy repos').
+///
+/// Enabling any of these settings will, by default:
+///
+/// - switch GOV.UK Frontend to using the same colour palette as the legacy
+///   repos, by setting `$govuk-use-legacy-palette` to true.
+///
+/// - prevent GOV.UK Frontend from using rem for font sizing, by setting
+///   `$govuk-typography-use-rem` to false.
+///
+/// @group settings/compatibility
+////
+
+
+/// Compatibility Mode: alphagov/govuk_frontend_toolkit
+///
+/// Set this to true if you are also including alphagov/govuk_frontend_toolkit
+/// in your application.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-compatibility-govukfrontendtoolkit: false !default;
+
+/// Compatibility Mode: alphagov/govuk_template
+///
+/// Enabling this will:
+///
+/// - prevent GOV.UK Frontend from including the New Transport typeface, as
+///   it'll use the version of New Transport included with GOV.UK Template.
+///
+/// - alter some of the CSS outputted by GOV.UK Frontend to 'counter'
+///   specific CSS rules in GOV.UK Template.
+///
+/// Set this to true if you are also including alphagov/govuk_template in your
+/// application.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-compatibility-govuktemplate: false !default;
+
+/// Compatibility Mode: alphagov/govuk_elements
+///
+/// Enabling this will:
+///
+/// - alter some of the CSS outputted by GOV.UK Frontend to 'counter'
+///   specific CSS rules in GOV.UK Elements.
+///
+/// Set this to true if you are also including alphagov/govuk_elements in your
+/// application.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-compatibility-govukelements: false !default;
+
+/// Compatibility Product Map
+///
+/// Maps product names to their settings that we can use to lookup states from
+/// within the `@govuk-compatibility` mixin.
+///
+/// @type Map
+/// @access private
+
+$_govuk-compatibility: (
+  govuk_frontend_toolkit: $govuk-compatibility-govukfrontendtoolkit,
+  govuk_template: $govuk-compatibility-govuktemplate,
+  govuk_elements: $govuk-compatibility-govukelements,
+);

data/node_modules/govuk-frontend/{settings → govuk/settings}/_measurements.scss

@@ -63,12 +63,12 @@ $govuk-border-width: 5px !default;
 
 $govuk-border-width-wide: 10px !default;
 
-/// Border width on mobile
+/// Narrow border width
 ///
 /// @type Number
 /// @access public
 
-$govuk-border-width-mobile: 4px !default;
+$govuk-border-width-narrow: 4px !default;
 
 /// Form control border width
 ///

data/node_modules/govuk-frontend/{settings → govuk/settings}/_typography-font-families.scss

@@ -2,11 +2,20 @@
 /// @group settings/typography
 ////
 
-/// List of font families to use if using NTA (the default font 'stack' for
+/// List of font families to use if using GDS Transport (the default font
+/// 'stack' for GOV.UK)
+///
+/// @type List
+/// @access public
+
+$govuk-font-family-gds-transport: "GDS Transport", Arial, sans-serif;
+
+/// List of font families to use if using NTA (old font 'stack' for
 /// GOV.UK)
 ///
 /// @type List
 /// @access public
+/// @deprecated To be removed once support for compatibility mode is dropped
 
 $govuk-font-family-nta: "nta", Arial, sans-serif;
 
@@ -18,5 +27,6 @@ $govuk-font-family-nta: "nta", Arial, sans-serif;
 ///
 /// @type List
 /// @access public
+/// @deprecated To be removed once support for compatibility mode is dropped
 
 $govuk-font-family-nta-tabular: "ntatabularnumbers", $govuk-font-family-nta;

data/node_modules/govuk-frontend/{settings → govuk/settings}/_typography-font.scss

@@ -1,8 +1,24 @@
+@import "compatibility";
+@import "typography-font-families";
+
 ////
 /// @group settings/typography
 ////
 
+/// Use 'legacy' fonts
+///
+/// Whether or not to use v1 nta font from GOV.UK Elements / Frontend
+/// Toolkit, for teams that are migrating to GOV.UK Frontend and may be using
+/// components from both places in a single application.
+///
+/// @type Boolean
+/// @access public
 
+$govuk-use-legacy-font: if((
+    $govuk-compatibility-govukfrontendtoolkit or
+    $govuk-compatibility-govuktemplate or
+    $govuk-compatibility-govukelements
+  ), true, false) !default;
 
 // =========================================================
 // Font families
@@ -13,14 +29,20 @@
 /// @type List
 /// @access public
 
-$govuk-font-family: $govuk-font-family-nta !default;
+$govuk-font-family: if($govuk-use-legacy-font,
+  $govuk-font-family-nta,
+  $govuk-font-family-gds-transport
+) !default;
 
 /// Font families to use when displaying tabular numbers
 ///
 /// @type List
 /// @access public
 
-$govuk-font-family-tabular: $govuk-font-family-nta-tabular !default;
+$govuk-font-family-tabular: if($govuk-use-legacy-font,
+  $govuk-font-family-nta-tabular,
+  false
+) !default;
 
 /// Font families to use for print media
 ///
@@ -31,16 +53,14 @@ $govuk-font-family-print: sans-serif !default;
 
 /// Include the default @font-face declarations
 ///
-/// If you have set $govuk-font-family to something other than $govuk-font-family-nta this option is disabled by default.
-///
-/// If you are using $govuk-compatibility-govuktemplate this option is disabled by default.
+/// If you have set $govuk-font-family to something other than
+/// `$govuk-font-family-gds-transport` this option is disabled by default.
 ///
 /// @type Boolean
 /// @access public
 
 $govuk-include-default-font-face: (
-  $govuk-font-family == $govuk-font-family-nta and
-  not($govuk-compatibility-govuktemplate)
+  $govuk-font-family == $govuk-font-family-gds-transport
  ) !default;
 
 // =========================================================