govuk_tech_docs 3.5.0 → 4.0.0

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

@@ -1,100 +0,0 @@
-////
-/// '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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-compatibility-govukfrontendtoolkit: false !default;
-
-@if $govuk-compatibility-govukfrontendtoolkit == true {
-  @include _warning("compatibility-mode", "$govuk-compatibility-govukfrontendtoolkit " +
-  "is deprecated. From version 5.0, GOV.UK Frontend will remove compatibility " +
-  "with the legacy library govuk_frontend_toolkit.");
-}
-
-/// 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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-compatibility-govuktemplate: false !default;
-
-@if $govuk-compatibility-govuktemplate == true {
-  @include _warning("compatibility-mode", "$govuk-compatibility-govuktemplate " +
-  "is deprecated. From version 5.0, GOV.UK Frontend will remove " +
-  "compatibility with the legacy library govuk_template.");
-}
-
-/// 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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-compatibility-govukelements: false !default;
-
-@if $govuk-compatibility-govukelements == true {
-  @include _warning("compatibility-mode", "$govuk-compatibility-govukelements " +
-  "is deprecated. From version 5.0, GOV.UK Frontend will remove compatibility " +
-  "with the legacy library govuk_elements.");
-}
-
-/// 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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$_govuk-compatibility: (
-  govuk_frontend_toolkit: $govuk-compatibility-govukfrontendtoolkit,
-  govuk_template: $govuk-compatibility-govuktemplate,
-  govuk_elements: $govuk-compatibility-govukelements,
-);

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

@@ -1,34 +0,0 @@
-////
-/// @group settings/internet-explorer-8
-////
-
-/// Whether the stylesheet being built is targeting Internet Explorer 8.
-///
-/// @type Boolean
-/// @access public
-/// @deprecated Will be removed in v5.0
-
-$govuk-is-ie8: false !default;
-
-@if $govuk-is-ie8 == true {
-  @include _warning(
-    ie8,
-    "The $govuk-is-ie8 setting is deprecated and will be removed in v5.0."
-  );
-}
-
-/// The name of the breakpoint to use as the target when rasterizing media
-/// queries
-///
-/// @type String
-/// @access public
-/// @deprecated Will be removed in v5.0
-
-$govuk-ie8-breakpoint: desktop !default;
-
-@if not $govuk-ie8-breakpoint == desktop {
-  @include _warning(
-    ie8,
-    "The $govuk-ie8-breakpoint setting is deprecated and will be removed in v5.0."
-  );
-}

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

@@ -1,32 +0,0 @@
-////
-/// @group settings/typography
-////
-
-/// 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;
-
-/// List of font families to use if using the 'tabular numbers' subset of NTA
-/// (the default font 'stack' for GOV.UK)
-///
-/// Because ntatabularnumbers only includes the digits 0-10, all other glyphs
-/// will 'fall-through' the stack to NTA.
-///
-/// @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/govuk/settings/_typography-font.scss

@@ -1,112 +0,0 @@
-@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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-use-legacy-font: if(
-  (
-    $govuk-compatibility-govukfrontendtoolkit or
-    $govuk-compatibility-govuktemplate or
-    $govuk-compatibility-govukelements
-  ),
-  true,
-  false
-) !default;
-
-// Only show the deprecation warning if user is setting $govuk-use-legacy-font
-// manually instead of automatically via compatibility variables
-@if $govuk-use-legacy-font == true and
-  $govuk-compatibility-govukfrontendtoolkit == false and
-  $govuk-compatibility-govuktemplate == false and
-  $govuk-compatibility-govukelements == false {
-  @include _warning(legacy-font, "$govuk-use-legacy-font is deprecated. " +
-  "From version 5.0, GOV.UK Frontend will only support the included version " +
-  "of GDS Transport.");
-}
-
-// =========================================================
-// Font families
-// =========================================================
-
-/// Font families to use for all typography on screen media
-///
-/// @type List
-/// @access public
-
-$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
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-font-family-tabular: if(
-  $govuk-use-legacy-font,
-  $govuk-font-family-nta-tabular,
-  false
-) !default;
-
-// Only show the deprecation warning if user is setting $govuk-font-family-tabular
-// manually instead of automatically via $govuk-use-legacy-font
-@if $govuk-font-family-tabular != false and $govuk-use-legacy-font == false {
-  @include _warning(tabular-font-face, "$govuk-font-family-tabular is deprecated. " +
-  "From version 5.0, GOV.UK Frontend will not support using a separate " +
-  "font-face for tabular numbers.");
-}
-
-/// Font families to use for print media
-///
-/// We recommend that you use system fonts when printing. This will avoid issues
-/// with some printer drivers and operating systems.
-///
-/// @type List
-/// @access public
-
-$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-gds-transport` this option is disabled by default.
-///
-/// @type Boolean
-/// @access public
-
-$govuk-include-default-font-face: (
-  $govuk-font-family == $govuk-font-family-gds-transport
-) !default;
-
-// =========================================================
-// Font weights
-// =========================================================
-
-/// Font weight for regular typography
-///
-/// @type Number
-/// @access public
-$govuk-font-weight-regular: 400 !default;
-
-/// Font weight for bold typography
-///
-/// @type Number
-/// @access public
-$govuk-font-weight-bold: 700 !default;

data/node_modules/govuk-frontend/govuk/settings/_typography-responsive.scss

@@ -1,195 +0,0 @@
-@import "compatibility";
-
-////
-/// @group settings/typography
-////
-
-/// Whether or not to define font sizes in rem, improving accessibility by
-/// allowing users to adjust the base font-size. This is enabled by default,
-/// unless any of the compatibility mode settings are enabled.
-///
-/// You should make sure that $govuk-root-font-size is set correctly for your
-/// project.
-///
-/// @type Boolean
-/// @access public
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-$govuk-typography-use-rem: if(
-  (
-    $govuk-compatibility-govukfrontendtoolkit or
-    $govuk-compatibility-govuktemplate or
-    $govuk-compatibility-govukelements
-  ),
-  false,
-  true
-) !default;
-
-// Only show the deprecation warning if user is setting $govuk-typography-use-rem
-// manually instead of automatically via compatibility variables
-@if $govuk-typography-use-rem == false and
-  $govuk-compatibility-govukfrontendtoolkit == false and
-  $govuk-compatibility-govuktemplate == false and
-  $govuk-compatibility-govukelements == false {
-  @include _warning(allow-not-using-rem, "$govuk-typography-use-rem is deprecated. " +
-  "From version 5.0, GOV.UK Frontend will not support disabling rem font sizes.");
-}
-
-/// Root font size
-///
-/// This is used to calculate rem sizes for the typography, and should match the
-/// _effective_ font-size of your root (or html) element.
-///
-/// Ideally you should not be setting the font-size on the html or root element
-/// in order to allow it to scale with user-preference, in which case this
-/// should be set to 16px.
-///
-/// If you are integrating Frontend into an existing project that also uses
-/// alphagov/govuk_template and you wish to enable `$govuk-typography-use-rem`
-/// then you should set this to 10px to match the 62.5% (10px) base font size
-/// that govuk_template sets on the <html> element.
-///
-/// @type Number
-/// @access public
-
-$govuk-root-font-size: 16px !default;
-
-/// Responsive typography font map
-///
-/// This is used to generate responsive typography that adapts according to the
-/// breakpoints.
-///
-/// Font size and font weight can be defined for each breakpoint. You can define
-/// different behaviour on tablet and desktop. The 'null' breakpoint is for
-/// mobile.
-///
-/// Line-heights will automatically be converted from pixel measurements into
-/// relative values. For example, with a font-size of 16px and a line-height of
-/// 24px, the line-height will be converted to 1.5 before output.
-///
-/// You can also specify a separate font size and line height for print media.
-///
-/// @type Map
-///
-/// @prop {Number} $point.$breakpoint.font-size - Font size for `$point` at `$breakpoint`
-/// @prop {Number} $point.$breakpoint.line-height - Line height for `$point` at `$breakpoint`
-/// @prop {Number} $point.print.font-size - Font size for `$point` when printing
-/// @prop {Number} $point.print.line-height - Line height for `$point` when printing
-///
-/// @access public
-
-$govuk-typography-scale: (
-  80: (
-    null: (
-      font-size: 53px,
-      line-height: 55px
-    ),
-    tablet: (
-      font-size: 80px,
-      line-height: 80px
-    ),
-    print: (
-      font-size: 53pt,
-      line-height: 1.1
-    )
-  ),
-  48: (
-    null: (
-      font-size: 32px,
-      line-height: 35px
-    ),
-    tablet: (
-      font-size: 48px,
-      line-height: 50px
-    ),
-    print: (
-      font-size: 32pt,
-      line-height: 1.15
-    )
-  ),
-  36: (
-    null: (
-      font-size: 24px,
-      line-height: 25px
-    ),
-    tablet: (
-      font-size: 36px,
-      line-height: 40px
-    ),
-    print: (
-      font-size: 24pt,
-      line-height: 1.05
-    )
-  ),
-  27: (
-    null: (
-      font-size: 18px,
-      line-height: 20px
-    ),
-    tablet: (
-      font-size: 27px,
-      line-height: 30px
-    ),
-    print: (
-      font-size: 18pt,
-      line-height: 1.15
-    )
-  ),
-  24: (
-    null: (
-      font-size: 18px,
-      line-height: 20px
-    ),
-    tablet: (
-      font-size: 24px,
-      line-height: 30px
-    ),
-    print: (
-      font-size: 18pt,
-      line-height: 1.15
-    )
-  ),
-  19: (
-    null: (
-      font-size: 16px,
-      line-height: 20px
-    ),
-    tablet: (
-      font-size: 19px,
-      line-height: 25px
-    ),
-    print: (
-      font-size: 14pt,
-      line-height: 1.15
-    )
-  ),
-  16: (
-    null: (
-      font-size: 14px,
-      line-height: 16px
-    ),
-    tablet: (
-      font-size: 16px,
-      line-height: 20px
-    ),
-    print: (
-      font-size: 14pt,
-      line-height: 1.2
-    )
-  ),
-  14: (
-    null: (
-      font-size: 12px,
-      line-height: 15px
-    ),
-    tablet: (
-      font-size: 14px,
-      line-height: 20px
-    ),
-    print: (
-      font-size: 12pt,
-      line-height: 1.2
-    )
-  )
-) !default;

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

@@ -1,50 +0,0 @@
-////
-/// @group tools/compatibility-mode
-////
-
-/// Temporary private version of govuk-compatibility to avoid deprecation warnings
-///
-/// @access private
-
-@mixin _govuk-compatibility($product) {
-  @if map-has-key($_govuk-compatibility, $product) {
-    @if map-get($_govuk-compatibility, $product) == true {
-      @content;
-    }
-  } @else {
-    @error "Non existent product '#{$product}'";
-  }
-}
-
-/// Conditional Compatibility Mixin
-///
-/// Selectively output a block (available to the mixin as @content) if a given
-/// $product is also identified as being used in the project.
-///
-/// This can then be used to include styles that are only needed to override
-/// styles provided by those other products (e.g. where govuk_template has a
-/// very specific link selector that otherwise affects buttons).
-///
-/// @example scss
-///   // Override .my-class if GOV.UK Template is also being used
-///   @include govuk-compatibility(govuk_template) {
-///     .my-class {
-///       color: inherit;
-///     }
-///   }
-///
-/// @param {String} $product - Name of product that we are 'defending' against.
-/// @content Passed content is outputted only if Frontend is being used with
-///   this product
-/// @throw Errors if product name is not recognised
-/// @access public
-/// @deprecated Will be removed in v5.0 with the rest of the compatibility mode
-/// suite of tools and settings
-
-@mixin govuk-compatibility($product) {
-  @include _warning(compatibility-helper, "govuk-compatibility is deprecated. " +
-  "From version 5.0, GOV.UK Frontend will not support compatibility mode.");
-  @include _govuk-compatibility($product) {
-    @content;
-  }
-}

data/node_modules/govuk-frontend/govuk/tools/_ie8.scss

@@ -1,87 +0,0 @@
-@import "../settings/warnings";
-
-////
-/// @group tools/internet-explorer-8
-////
-
-/// A private version of the govuk-if-ie8 mixin to avoid deprecation
-/// warnings where we use it internally
-///
-/// @access private
-
-@mixin _govuk-if-ie8 {
-  @if $govuk-is-ie8 {
-    @content;
-  }
-}
-
-/// Conditionally include rules only for IE8
-///
-/// @content Passed content is only outputted if we're compiling a stylesheet
-///   that targets IE8 (if `$govuk-is-ie8` is true)
-///
-/// @example scss - Usage
-///
-///   .foo {
-///     min-width: 100px;
-///     // Specify width for IE8 only
-///     @include govuk-if-ie8 {
-///       width: 100px;
-///     }
-///   }
-///
-/// @access public
-/// @deprecated Will be removed in v5.0
-
-@mixin govuk-if-ie8 {
-  @include _warning(
-    ie8,
-    "The govuk-if-ie8 mixin is deprecated and will be removed in v5.0."
-  );
-
-  @include _govuk-if-ie8 {
-    @content;
-  }
-}
-
-/// A private version of the govuk-not-ie8 mixin to avoid deprecation
-/// warnings where we use it internally
-///
-/// @access private
-
-@mixin _govuk-not-ie8 {
-  @if not $govuk-is-ie8 {
-    @content;
-  }
-}
-
-/// Conditionally exclude rules for IE8
-///
-/// @content Passed content is only outputted if we're not compiling a
-///   stylesheet that targets IE8 (if `$govuk-is-ie8` is false)
-///
-/// @example scss - Usage
-///
-///   .foo {
-///     font-weight: bold;
-///
-///     // Enhance foo only for modern browsers (not IE8)
-///     @include govuk-not-ie8 {
-///       font-family: "Comic Sans MS", "Curlz MT" cursive, sans-serif;
-///       color: #FF69B4;
-///     }
-///   }
-///
-/// @access public
-/// @deprecated Will be removed in v5.0
-
-@mixin govuk-not-ie8 {
-  @include _warning(
-    ie8,
-    "The govuk-not-ie8 mixin is deprecated and will be removed in v5.0."
-  );
-
-  @include _govuk-not-ie8 {
-    @content;
-  }
-}