govuk_tech_docs 3.5.0 → 4.0.0

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

@@ -1,5 +1,5 @@
 ////
-/// @group settings/measurements
+/// @group settings/layout
 ////
 
 // =========================================================
@@ -19,11 +19,21 @@ $govuk-page-width: 960px !default;
 /// @access public
 
 $govuk-grid-widths: (
-  one-quarter: (100% / 4),
-  one-third: (100% / 3),
-  one-half: (100% / 2),
-  two-thirds: (200% / 3),
-  three-quarters: (300% / 4),
+  one-quarter: (
+    100% / 4
+  ),
+  one-third: (
+    100% / 3
+  ),
+  one-half: (
+    100% / 2
+  ),
+  two-thirds: (
+    200% / 3
+  ),
+  three-quarters: (
+    300% / 4
+  ),
   full: 100%
 ) !default;
 
@@ -93,3 +103,5 @@ $govuk-focus-width: 3px !default;
 /// @access public
 
 $govuk-hover-width: 10px !default;
+
+/*# sourceMappingURL=_measurements.scss.map */

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

@@ -1,5 +1,5 @@
 ////
-/// @group settings/media-queries
+/// @group settings/layout
 ////
 
 /// Breakpoint definitions
@@ -8,8 +8,8 @@
 /// @access public
 
 $govuk-breakpoints: (
-  mobile:  320px,
-  tablet:  641px,
+  mobile: 320px,
+  tablet: 641px,
   desktop: 769px
 ) !default;
 
@@ -21,3 +21,5 @@ $govuk-breakpoints: (
 /// @access public
 
 $govuk-show-breakpoints: false !default;
+
+/*# sourceMappingURL=_media-queries.scss.map */

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

@@ -74,3 +74,5 @@ $govuk-spacing-responsive-scale: (
     tablet: 60px
   )
 ) !default;
+
+/*# sourceMappingURL=_spacing.scss.map */

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

@@ -0,0 +1,52 @@
+////
+/// @group settings/typography
+////
+
+// =========================================================
+// Font families
+// =========================================================
+
+/// Font families to use for all typography on screen media
+///
+/// @type List
+/// @access public
+
+$govuk-font-family: "GDS Transport", arial, sans-serif !default;
+
+/// 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
+///
+/// Defaults to true if "GDS Transport" appears in the $govuk-font-family
+/// setting.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-include-default-font-face: if(index($govuk-font-family, "GDS Transport"), true, false) !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;
+
+/*# sourceMappingURL=_typography-font.scss.map */

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

@@ -0,0 +1,322 @@
+////
+/// @group settings/typography
+////
+
+/// 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.
+///
+/// @type Number
+/// @access public
+
+$govuk-root-font-size: 16px !default;
+
+/// Feature flag for new typography scale
+///
+/// When set to true, $govuk-typography-scale will use the new font map instead
+/// of the current/old one as well as apply changes in components to account
+/// for the updated scale.
+///
+/// Should be removed in 6.0.
+///
+/// @type Boolean
+/// @access public
+
+$govuk-new-typography-scale: false !default;
+
+/// The font map for the old typography scale
+///
+/// @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 private
+
+$_govuk-typography-scale-legacy: (
+  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
+    ),
+    deprecation: (
+      key: "govuk-typography-scale-14",
+      message: "14 on the type scale is deprecated and will be removed as " +
+        "a possible option in the next major version."
+    )
+  )
+);
+
+/// The font map for the new typography scale
+///
+/// @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 private
+
+$_govuk-typography-scale-modern: (
+  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: 27px,
+      line-height: 30px
+    ),
+    tablet: (
+      font-size: 36px,
+      line-height: 40px
+    ),
+    print: (
+      font-size: 24pt,
+      line-height: 1.05
+    )
+  ),
+  27: (
+    // Made same as 24 on mobile (consider deprecating this size)
+    null:
+      (
+        font-size: 21px,
+        line-height: 25px
+      ),
+    tablet: (
+      font-size: 27px,
+      line-height: 30px
+    ),
+    print: (
+      font-size: 18pt,
+      line-height: 1.15
+    )
+  ),
+  24: (
+    // Bump up mobile size from 18/20 to 21/25
+    null:
+      (
+        font-size: 21px,
+        line-height: 25px
+      ),
+    tablet: (
+      font-size: 24px,
+      line-height: 30px
+    ),
+    print: (
+      font-size: 18pt,
+      line-height: 1.15
+    )
+  ),
+  19: (
+    // Stay at 19/25 at all sizes
+    null:
+      (
+        font-size: 19px,
+        line-height: 25px
+      ),
+    print: (
+      font-size: 14pt,
+      line-height: 1.15
+    )
+  ),
+  16: (
+    // Stay at 16/20 at all sizes
+    null:
+      (
+        font-size: 16px,
+        line-height: 20px
+      ),
+    print: (
+      font-size: 14pt,
+      line-height: 1.2
+    )
+  ),
+  14: (
+    // Stay at 14/20 at all sizes (consider deprecating this size)
+    null:
+      (
+        font-size: 14px,
+        line-height: 20px
+      ),
+    print: (
+      font-size: 12pt,
+      line-height: 1.2
+    ),
+    deprecation: (
+      key: "govuk-typography-scale-14",
+      message: "14 on the type scale is deprecated and will be removed as " +
+        "a possible option in the next major version."
+    )
+  )
+);
+
+/// 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: if(
+  $govuk-new-typography-scale,
+  $_govuk-typography-scale-modern,
+  $_govuk-typography-scale-legacy
+) !default;
+
+/*# sourceMappingURL=_typography-responsive.scss.map */

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

@@ -7,8 +7,8 @@
 /// This map is used to determine which deprecation warnings to **not** show
 /// to users when compiling sass. This is in place for codebases that do not
 /// have the necessary capacity to upgrade and remove the deprecation,
-/// particularly if the deprecation is significant. For example, removal of
-/// compatibility with legacy libraries such as govuk_elements.
+/// particularly if the deprecation is significant. For example, the removal of
+/// mixins and functions that were previously available to users of Frontend.
 ///
 /// You can add to this map and define which warnings to suppress by appending to
 /// it using the warning key, found in the warning message. For example:
@@ -37,17 +37,42 @@ $govuk-suppressed-warnings: () !default;
 /// - To format the passed warning `$message` with the warning key at the end
 /// - To prevent duplicate warnings by adding the passed `$key` to
 /// `$govuk-suppressed-warnings` after `@warn` is called to ensure it only runs
-/// once per sass compilation
+/// once per sass compilation (unless $silence-further-warnings is false)
 ///
 /// @param {String} $key - The key to be checked against `$govuk-suppressed-warnings`
 /// and then passed to it to prevent multiple of the same warning.
 /// @param {String} $message - The message to use when calling `@warn`
+/// @param {Boolean} $silence-further-warnings - Whether to silence future
+/// warnings that use the same $key
 /// @access private
 
-@mixin _warning($key, $message) {
-  @if not index($govuk-suppressed-warnings, $key) {
-    @warn $message + " To silence this warning, update $govuk-suppressed-warnings " +
-      "with key: \"#{$key}\"";
-    $govuk-suppressed-warnings: append($govuk-suppressed-warnings, $key) !global;
+@mixin _warning($key, $message, $silence-further-warnings: true) {
+  @if _should-warn($key) {
+    @warn _warning-text($key, $message);
+
+    @if $silence-further-warnings {
+      $govuk-suppressed-warnings: append($govuk-suppressed-warnings, $key) !global;
+    }
   }
 }
+
+/// Check whether a key is present in the suppressed warnings list.
+///
+/// @param {String} $key - The key to be checked against `$govuk-suppressed-warnings`.
+/// @access private
+
+@function _should-warn($key) {
+  @return index($govuk-suppressed-warnings, $key) == null;
+}
+
+/// Format a warning by appending information on how to suppress it.
+///
+/// @param {String} $key - The key needed to suppress the warning.
+/// @param {String} $message - The warning text.
+/// @access private
+
+@function _warning-text($key, $message) {
+  @return $message + " To silence this warning, update $govuk-suppressed-warnings " + 'with key: "#{$key}"';
+}
+
+/*# sourceMappingURL=_warnings.scss.map */

data/node_modules/govuk-frontend/dist/govuk/tools/_all.scss

@@ -0,0 +1,10 @@
+@import "../settings/warnings";
+@import "index";
+
+@include _warning(
+  "import-using-all",
+  "Importing using 'govuk/tools/all' is deprecated. Update your import statement to import 'govuk/tools/index'.",
+  $silence-further-warnings: false
+);
+
+/*# sourceMappingURL=_all.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/tools/_exports.scss

@@ -31,3 +31,5 @@ $_govuk-imported-modules: () !default;
   // The next time exports is called for the module of the same name, it will be
   // found in the list and so nothing will be outputted.
 }
+
+/*# sourceMappingURL=_exports.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/tools/_font-url.scss

@@ -13,6 +13,7 @@
 /// @access public
 
 @function govuk-font-url($filename) {
+  // prettier-ignore
   $use-custom-function: variable-exists("govuk-font-url-function")
     and $govuk-font-url-function
     and function-exists($govuk-font-url-function);
@@ -23,3 +24,5 @@
     @return url($govuk-fonts-path + $filename);
   }
 }
+
+/*# sourceMappingURL=_font-url.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/tools/_image-url.scss

@@ -13,6 +13,7 @@
 /// @access public
 
 @function govuk-image-url($filename) {
+  // prettier-ignore
   $use-custom-function: variable-exists("govuk-image-url-function")
     and $govuk-image-url-function
     and function-exists($govuk-image-url-function);
@@ -23,3 +24,5 @@
     @return url($govuk-images-path + $filename);
   }
 }
+
+/*# sourceMappingURL=_image-url.scss.map */

data/node_modules/govuk-frontend/{govuk/tools/_all.scss → dist/govuk/tools/_index.scss}

@@ -1,7 +1,7 @@
-@import "compatibility";
 @import "exports";
 @import "font-url";
-@import "ie8";
 @import "image-url";
 @import "px-to-em";
 @import "px-to-rem";
+
+/*# sourceMappingURL=_index.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/tools/_px-to-em.scss

@@ -18,3 +18,5 @@
   }
   @return $value / $context-font-size * 1em;
 }
+
+/*# sourceMappingURL=_px-to-em.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/tools/_px-to-rem.scss

@@ -18,3 +18,5 @@
 
   @return $value / $govuk-root-font-size * 1rem;
 }
+
+/*# sourceMappingURL=_px-to-rem.scss.map */

data/node_modules/govuk-frontend/dist/govuk/utilities/_all.scss

@@ -0,0 +1,10 @@
+@import "../settings/warnings";
+@import "index";
+
+@include _warning(
+  "import-using-all",
+  "Importing using 'govuk/utilities/all' is deprecated. Update your import statement to import 'govuk/utilities/index'.",
+  $silence-further-warnings: false
+);
+
+/*# sourceMappingURL=_all.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/utilities/_clearfix.scss

@@ -3,3 +3,5 @@
     @include govuk-clearfix;
   }
 }
+
+/*# sourceMappingURL=_clearfix.scss.map */

data/node_modules/govuk-frontend/{govuk/utilities/_all.scss → dist/govuk/utilities/_index.scss}

@@ -1,2 +1,4 @@
 @import "clearfix";
 @import "visually-hidden";
+
+/*# sourceMappingURL=_index.scss.map */

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

@@ -7,3 +7,5 @@
     @include govuk-visually-hidden-focusable;
   }
 }
+
+/*# sourceMappingURL=_visually-hidden.scss.map */

data/node_modules/govuk-frontend/{govuk → dist/govuk}/vendor/_sass-mq.scss

@@ -319,7 +319,7 @@ $mq-media-type: all !default;
 ///  // Show breakpoints using custom settings
 ///  @include mq-show-breakpoints((L, XL), (S: 300px, L: 800px, XL: 1200px));
 @mixin mq-show-breakpoints($show-breakpoints: $mq-show-breakpoints, $breakpoints: $mq-breakpoints) {
-    body:before {
+    body::before {
         background-color: #FCF8E3;
         border-bottom: 1px solid #FBEED5;
         border-left: 1px solid #FBEED5;
@@ -345,3 +345,5 @@ $mq-media-type: all !default;
 @if length($mq-show-breakpoints) > 0 {
     @include mq-show-breakpoints;
 }
+
+/*# sourceMappingURL=_sass-mq.scss.map */

data/node_modules/govuk-frontend/dist/govuk-prototype-kit/init.js

@@ -0,0 +1,15 @@
+// @ts-nocheck
+import * as GOVUKFrontend from '../govuk/govuk-frontend.min.js'
+
+// Maintain window global for compatibility
+window.GOVUKFrontend = GOVUKFrontend
+
+if (
+  window.GOVUKPrototypeKit &&
+  window.GOVUKPrototypeKit.documentReady &&
+  window.GOVUKPrototypeKit.majorVersion >= 13
+) {
+  window.GOVUKPrototypeKit.documentReady(() => {
+    window.GOVUKFrontend.initAll()
+  })
+}

data/node_modules/govuk-frontend/{govuk-prototype-kit → dist/govuk-prototype-kit}/init.scss

@@ -2,11 +2,12 @@ $govuk-prototype-kit-major-version: 0 !default;
 
 $govuk-assets-path: if(
   $govuk-prototype-kit-major-version > 12,
-  $govuk-extensions-url-context + "/govuk-frontend/govuk/assets/",
+  $govuk-extensions-url-context + "/govuk-frontend/dist/govuk/assets/",
   "/govuk/assets/"
 ) !default;
 
 $govuk-global-styles: true !default;
-$govuk-new-link-styles: true !default;
 
 @import "../govuk/all";
+
+/*# sourceMappingURL=init.scss.map */