RubyGems - govuk_tech_docs - Versions diffs - 6.3.0.beta → 6.3.0 - Mend

govuk_tech_docs 6.3.0.beta → 6.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (441) hide show

data/node_modules/govuk-frontend/dist/govuk/objects/_main-wrapper.scss CHANGED Viewed

@@ -1,55 +1,5 @@
-@import "../base";
+@use "main-wrapper.mixin" as main-wrapper;
+@use "../custom-properties";
-////
-/// @group objects/layout
-////
+@include main-wrapper.styles;
-// Example usage with Breadcrumbs, phase banners, back links:
-// <div class="govuk-width-container">
-//   <!-- Breadcrumbs, phase banners, back links are placed in here. -->
-//   <div class="govuk-main-wrapper">
-//       <!-- Wrapper for the main content of your page which applies padding
-//            to the top / bottom -->
-//   </div>
-// </div>
-//
-// Example usage without Breadcrumbs, phase banners, back links:
-// <div class="govuk-width-container">
-//   <div class="govuk-main-wrapper govuk-main-wrapper--l">
-//       <!-- Wrapper for the main content of your page which applies padding
-//            to the top / bottom -->
-//   </div>
-// </div>
-@include govuk-exports("govuk/objects/main-wrapper") {
-  .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,
-    // so it uses CSS initial value, which is inline.
-    display: block;
-    padding-top: govuk-spacing(4);
-    padding-bottom: govuk-spacing(4);
-    @media #{govuk-from-breakpoint(tablet)} {
-      // This spacing is manually adjusted to replicate the margin of
-      // govuk-heading-xl (50px) minus the spacing of back link and
-      // breadcrumbs (10px)
-      padding-top: govuk-spacing(7);
-      padding-bottom: govuk-spacing(7);
-    }
-  }
-  // 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-responsive-padding(8, "top");
-  }
-}
-/*# sourceMappingURL=_main-wrapper.scss.map */

data/node_modules/govuk-frontend/dist/govuk/objects/_template.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "template.mixin" as template;
+@import "../base";
+@include govuk-exports("govuk/objects/template") {
+  @include template.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/objects/_template.mixin.scss ADDED Viewed

@@ -0,0 +1,53 @@
+@use "../base";
+/// @access private
+@mixin styles {
+  // Applied to the <html> element
+  .govuk-template {
+    // Set the overall page background colour to the same colour as used by the
+    // footer to give the illusion of a long footer.
+    background-color: base.govuk-functional-colour(template-background);
+    // Prevent automatic text sizing, as we already cater for small devices and
+    // would like the browser to stay on 100% text zoom by default.
+    -webkit-text-size-adjust: 100%;
+       -moz-text-size-adjust: 100%;
+            text-size-adjust: 100%;
+    // Add scroll padding to the top of govuk-template but remove it if the
+    // exit this page component is present.
+    //
+    // This is a solution to exit this page potentially failing WCAG SC 2.4.12:
+    // Focus Not Obscured (https://www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum.html)
+    // due to it's sticky positioning.
+    //
+    // This will apply scroll-padding-top in any browsers that don't support :has
+    // (https://caniuse.com/css-has). This is part of the reason we do this in
+    // a "wrong way round" way as we hypothesise that the risks of having
+    // scroll-padding unnecessarily is better than risking not having scroll-padding
+    // and needing it to account for exit this page.
+    @supports ((position: -webkit-sticky) or (position: sticky)) {
+      scroll-padding-top: base.govuk-spacing(9);
+      &:not(:has(.govuk-exit-this-page)) {
+        scroll-padding-top: 0;
+      }
+    }
+    // Force the scrollbar to always display in IE, to prevent horizontal page
+    // jumps as content height changes (e.g. autocomplete results open).
+    @media screen {
+      overflow-y: scroll;
+    }
+  }
+  // Applied to the <body> element
+  .govuk-template__body {
+    // The default margins set by user-agents are not required since we have our
+    // own containers.
+    margin: 0;
+    // Set the overall body of the page back to the typical background colour.
+    background-color: base.govuk-functional-colour(body-background);
+  }
+}

data/node_modules/govuk-frontend/dist/govuk/objects/_template.scss CHANGED Viewed

@@ -1,53 +1,5 @@
-@import "../base";
+@use "template.mixin" as template;
+@use "../custom-properties";
-@include govuk-exports("govuk/objects/template") {
-  // Applied to the <html> element
-  .govuk-template {
-    // Set the overall page background colour to the same colour as used by the
-    // footer to give the illusion of a long footer.
-    background-color: govuk-functional-colour(template-background);
+@include template.styles;
-    // Prevent automatic text sizing, as we already cater for small devices and
-    // would like the browser to stay on 100% text zoom by default.
-    -webkit-text-size-adjust: 100%;
-       -moz-text-size-adjust: 100%;
-            text-size-adjust: 100%;
-    // Add scroll padding to the top of govuk-template but remove it if the
-    // exit this page component is present.
-    //
-    // This is a solution to exit this page potentially failing WCAG SC 2.4.12:
-    // Focus Not Obscured (https://www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum.html)
-    // due to it's sticky positioning.
-    //
-    // This will apply scroll-padding-top in any browsers that don't support :has
-    // (https://caniuse.com/css-has). This is part of the reason we do this in
-    // a "wrong way round" way as we hypothesise that the risks of having
-    // scroll-padding unnecessarily is better than risking not having scroll-padding
-    // and needing it to account for exit this page.
-    @supports ((position: -webkit-sticky) or (position: sticky)) {
-      scroll-padding-top: govuk-spacing(9);
-      &:not(:has(.govuk-exit-this-page)) {
-        scroll-padding-top: 0;
-      }
-    }
-    // Force the scrollbar to always display in IE, to prevent horizontal page
-    // jumps as content height changes (e.g. autocomplete results open).
-    @media screen {
-      overflow-y: scroll;
-    }
-  }
-  // Applied to the <body> element
-  .govuk-template__body {
-    // The default margins set by user-agents are not required since we have our
-    // own containers.
-    margin: 0;
-    // Set the overall body of the page back to the typical background colour.
-    background-color: govuk-functional-colour(body-background);
-  }
-}
-/*# sourceMappingURL=_template.scss.map */

data/node_modules/govuk-frontend/dist/govuk/objects/_width-container.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "width-container.mixin" as width-container;
+@import "../base";
+@include govuk-exports("govuk/objects/width-container") {
+  @include width-container.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/objects/_width-container.mixin.scss ADDED Viewed

@@ -0,0 +1,9 @@
+@use "../base";
+/// @access private
+@mixin styles {
+  .govuk-width-container {
+    @include base.govuk-width-container;
+  }
+}

data/node_modules/govuk-frontend/dist/govuk/objects/_width-container.scss CHANGED Viewed

@@ -1,78 +1,5 @@
-////
-/// @group objects/layout
-////
-@use "sass:string";
+@use "width-container.mixin" as width-container;
+@use "../custom-properties";
-@import "../base";
+@include width-container.styles;
-/// Width container mixin
-///
-/// Used to create page width and custom width container classes.
-///
-/// @param {String} $width [$govuk-page-width] - Width in pixels
-///
-/// @example scss - Creating a 1200px wide container class
-///  .app-width-container--wide {
-///    @include govuk-width-container(1200px);
-///  }
-///
-/// @access public
-@mixin govuk-width-container($width: $govuk-page-width) {
-  // By default, limit the width of the container to the page width
-  max-width: $width;
-  // On mobile, add half width gutters
-  margin-right: $govuk-gutter-half;
-  margin-left: $govuk-gutter-half;
-  // Respect 'display cutout' safe area (avoids notches and rounded corners)
-  @supports (margin: string.unquote("max(calc(0px))")) {
-    $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
-    $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
-    // Use max() to pick largest margin, default or with safe area
-    // Escaped due to Sass max() vs. CSS native max()
-    margin-right: string.unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-right})");
-    margin-left: string.unquote("max(#{$govuk-gutter-half}, #{$gutter-safe-area-left})");
-  }
-  // On tablet, add full width gutters
-  @media #{govuk-from-breakpoint(tablet)} {
-    margin-right: $govuk-gutter;
-    margin-left: $govuk-gutter;
-    // Respect 'display cutout' safe area (avoids notches and rounded corners)
-    @supports (margin: string.unquote("max(calc(0px))")) {
-      $gutter-safe-area-right: calc(#{$govuk-gutter-half} + env(safe-area-inset-right));
-      $gutter-safe-area-left: calc(#{$govuk-gutter-half} + env(safe-area-inset-left));
-      // Use max() to pick largest margin, default or with safe area
-      // Escaped due to Sass max() vs. CSS native max()
-      margin-right: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-right})");
-      margin-left: string.unquote("max(#{$govuk-gutter}, #{$gutter-safe-area-left})");
-    }
-  }
-  // As soon as the viewport is greater than the width of the page plus the
-  // gutters, just centre the content instead of adding gutters.
-  @media (min-width: #{($width + $govuk-gutter * 2)}) {
-    margin-right: auto;
-    margin-left: auto;
-    // Since a safe area may have previously been set above,
-    // we need to duplicate this margin that centers the page.
-    @supports (margin: string.unquote("max(calc(0px))")) {
-      margin-right: auto;
-      margin-left: auto;
-    }
-  }
-}
-@include govuk-exports("govuk/objects/width-container") {
-  .govuk-width-container {
-    @include govuk-width-container;
-  }
-}
-/*# sourceMappingURL=_width-container.scss.map */

data/node_modules/govuk-frontend/dist/govuk/overrides/_display.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "display.mixin" as mixin;
+@import "../tools/exports";
+@include govuk-exports("govuk/overrides/display") {
+  @include mixin.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_display.mixin.scss ADDED Viewed

@@ -0,0 +1,26 @@
+// stylelint-disable declaration-no-important
+/// @access private
+@mixin styles {
+  .govuk-\!-display-inline {
+    display: inline !important;
+  }
+  .govuk-\!-display-inline-block {
+    display: inline-block !important;
+  }
+  .govuk-\!-display-block {
+    display: block !important;
+  }
+  .govuk-\!-display-none {
+    display: none !important;
+  }
+  @media print {
+    .govuk-\!-display-none-print {
+      display: none !important;
+    }
+  }
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_display.scss CHANGED Viewed

@@ -1,28 +1,4 @@
-@import "../tools/exports";
+@use "display.mixin" as display;
-// stylelint-disable declaration-no-important
-@include govuk-exports("govuk/overrides/display") {
-  .govuk-\!-display-inline {
-    display: inline !important;
-  }
+@include display.styles;
-  .govuk-\!-display-inline-block {
-    display: inline-block !important;
-  }
-  .govuk-\!-display-block {
-    display: block !important;
-  }
-  .govuk-\!-display-none {
-    display: none !important;
-  }
-  @media print {
-    .govuk-\!-display-none-print {
-      display: none !important;
-    }
-  }
-}
-/*# sourceMappingURL=_display.scss.map */

data/node_modules/govuk-frontend/dist/govuk/overrides/_index.import.scss ADDED Viewed

@@ -0,0 +1,6 @@
+@import "display";
+@import "spacing";
+@import "text-align";
+@import "typography";
+@import "width";

data/node_modules/govuk-frontend/dist/govuk/overrides/_index.scss CHANGED Viewed

@@ -1,10 +1,6 @@
-@import "../settings/spacing";
-@import "../tools/exports";
-@import "../helpers/spacing";
-@import "display";
-@import "spacing";
-@import "text-align";
-@import "typography";
-@import "width";
+@use "display";
+@use "spacing";
+@use "text-align";
+@use "typography";
+@use "width";
-/*# sourceMappingURL=_index.scss.map */

data/node_modules/govuk-frontend/dist/govuk/overrides/_spacing.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "spacing.mixin" as mixin;
+@import "../tools/exports";
+@include govuk-exports("govuk/overrides/spacing") {
+  @include mixin.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_spacing.mixin.scss ADDED Viewed

@@ -0,0 +1,89 @@
+////
+/// @group overrides
+////
+@use "sass:map";
+@use "../base";
+@use "../helpers/spacing--internal";
+// stylelint-disable declaration-no-important
+/// Directions for spacing
+///
+/// @type Map
+/// @access private
+$_spacing-directions: ("top", "right", "bottom", "left") !default;
+/// Generate responsive spacing override classes
+///
+/// Generate spacing override classes for the given property (e.g. margin)
+/// for each point in the responsive spacing scale.
+///
+/// @param {String} $property - Property to add spacing to (e.g. 'margin')
+///
+/// @example css
+///  .govuk-\!-margin-4 {
+///    margin: 15px !important;
+///  }
+///
+///  @media (min-width: 40.0625em) {
+///    .govuk-\!-margin-4 {
+///      margin: 20px !important;
+///    }
+///  }
+///
+/// @access private
+@mixin _govuk-generate-responsive-spacing-overrides($property) {
+  // For each point in the spacing scale (defined in settings), create an
+  // override that affects all directions...
+  @each $scale-point, $scale-map in base.$govuk-spacing-responsive-scale {
+    .govuk-\!-#{$property}-#{$scale-point} {
+      @include spacing--internal.responsive-spacing($scale-point, $property, "all", true);
+    }
+    // ... and then an override for each individual direction
+    @each $direction in $_spacing-directions {
+      .govuk-\!-#{$property}-#{$direction}-#{$scale-point} {
+        @include spacing--internal.responsive-spacing($scale-point, $property, $direction, true);
+      }
+    }
+  }
+}
+/// Generate static spacing override classes
+///
+/// Generate spacing override classes for the given property (e.g. margin)
+/// for each point in the non-responsive spacing scale.
+///
+/// @param {String} $property - Property to add spacing to (e.g. 'margin')
+///
+/// @example css
+///   .govuk-\!-static-margin-4 {
+///      margin: 20px !important;
+///   }
+///
+/// @access private
+@mixin _govuk-generate-static-spacing-overrides($property) {
+  @each $spacing-point in map.keys(base.$govuk-spacing-points) {
+    .govuk-\!-static-#{$property}-#{$spacing-point} {
+      #{$property}: base.govuk-spacing($spacing-point) !important;
+    }
+    @each $direction in $_spacing-directions {
+      .govuk-\!-static-#{$property}-#{$direction}-#{$spacing-point} {
+        #{$property}-#{$direction}: base.govuk-spacing($spacing-point) !important;
+      }
+    }
+  }
+}
+/// @access private
+@mixin styles {
+  @include _govuk-generate-responsive-spacing-overrides("margin");
+  @include _govuk-generate-responsive-spacing-overrides("padding");
+  @include _govuk-generate-static-spacing-overrides("margin");
+  @include _govuk-generate-static-spacing-overrides("padding");
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_spacing.scss CHANGED Viewed

@@ -1,90 +1,4 @@
-////
-/// @group overrides
-////
-@use "sass:map";
-@import "../settings/spacing";
-@import "../tools/exports";
-@import "../helpers/spacing";
+@use "spacing.mixin" as spacing;
-// stylelint-disable declaration-no-important
+@include spacing.styles;
-/// Directions for spacing
-///
-/// @type Map
-/// @access private
-$_spacing-directions: ("top", "right", "bottom", "left") !default;
-/// Generate responsive spacing override classes
-///
-/// Generate spacing override classes for the given property (e.g. margin)
-/// for each point in the responsive spacing scale.
-///
-/// @param {String} $property - Property to add spacing to (e.g. 'margin')
-///
-/// @example css
-///  .govuk-\!-margin-4 {
-///    margin: 15px !important;
-///  }
-///
-///  @media (min-width: 40.0625em) {
-///    .govuk-\!-margin-4 {
-///      margin: 20px !important;
-///    }
-///  }
-///
-/// @access private
-@mixin _govuk-generate-responsive-spacing-overrides($property) {
-  // For each point in the spacing scale (defined in settings), create an
-  // override that affects all directions...
-  @each $scale-point, $scale-map in $govuk-spacing-responsive-scale {
-    .govuk-\!-#{$property}-#{$scale-point} {
-      @include _govuk-responsive-spacing($scale-point, $property, "all", true);
-    }
-    // ... and then an override for each individual direction
-    @each $direction in $_spacing-directions {
-      .govuk-\!-#{$property}-#{$direction}-#{$scale-point} {
-        @include _govuk-responsive-spacing($scale-point, $property, $direction, true);
-      }
-    }
-  }
-}
-/// Generate static spacing override classes
-///
-/// Generate spacing override classes for the given property (e.g. margin)
-/// for each point in the non-responsive spacing scale.
-///
-/// @param {String} $property - Property to add spacing to (e.g. 'margin')
-///
-/// @example css
-///   .govuk-\!-static-margin-4 {
-///      margin: 20px !important;
-///   }
-///
-/// @access private
-@mixin _govuk-generate-static-spacing-overrides($property) {
-  @each $spacing-point in map.keys($govuk-spacing-points) {
-    .govuk-\!-static-#{$property}-#{$spacing-point} {
-      #{$property}: govuk-spacing($spacing-point) !important;
-    }
-    @each $direction in $_spacing-directions {
-      .govuk-\!-static-#{$property}-#{$direction}-#{$spacing-point} {
-        #{$property}-#{$direction}: govuk-spacing($spacing-point) !important;
-      }
-    }
-  }
-}
-@include govuk-exports("govuk/overrides/spacing") {
-  @include _govuk-generate-responsive-spacing-overrides("margin");
-  @include _govuk-generate-responsive-spacing-overrides("padding");
-  @include _govuk-generate-static-spacing-overrides("margin");
-  @include _govuk-generate-static-spacing-overrides("padding");
-}
-/*# sourceMappingURL=_spacing.scss.map */

data/node_modules/govuk-frontend/dist/govuk/overrides/_text-align.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "text-align.mixin" as mixin;
+@import "../tools/exports";
+@include govuk-exports("govuk/overrides/text-align") {
+  @include mixin.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_text-align.mixin.scss ADDED Viewed

@@ -0,0 +1,16 @@
+// stylelint-disable declaration-no-important
+/// @access private
+@mixin styles {
+  .govuk-\!-text-align-left {
+    text-align: left !important;
+  }
+  .govuk-\!-text-align-centre {
+    text-align: center !important;
+  }
+  .govuk-\!-text-align-right {
+    text-align: right !important;
+  }
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_text-align.scss CHANGED Viewed

@@ -1,18 +1,4 @@
-@import "../tools/exports";
+@use "text-align.mixin" as text-align;
-// stylelint-disable declaration-no-important
-@include govuk-exports("govuk/overrides/text-align") {
-  .govuk-\!-text-align-left {
-    text-align: left !important;
-  }
+@include text-align.styles;
-  .govuk-\!-text-align-centre {
-    text-align: center !important;
-  }
-  .govuk-\!-text-align-right {
-    text-align: right !important;
-  }
-}
-/*# sourceMappingURL=_text-align.scss.map */

data/node_modules/govuk-frontend/dist/govuk/overrides/_typography.import.scss ADDED Viewed

@@ -0,0 +1,8 @@
+@use "typography.mixin" as mixin;
+@import "../tools/exports";
+@include govuk-exports("govuk/overrides/typography") {
+  @include mixin.styles;
+}

data/node_modules/govuk-frontend/dist/govuk/overrides/_typography.mixin.scss ADDED Viewed

@@ -0,0 +1,43 @@
+@use "sass:map";
+@use "../base";
+/// @access private
+@mixin styles {
+  // Font size and line height
+  // Generate typography override classes for each responsive font map in the
+  // typography scale eg .govuk-\!-font-size-80
+  @each $size, $font-map in base.$govuk-typography-scale {
+    .govuk-\!-font-size-#{$size} {
+      $font-map: map.get(base.$govuk-typography-scale, $size);
+      // Add underscore to deprecated typography scale keys
+      @if map.has-key($font-map, "deprecation") {
+        $size: _#{$size};
+      }
+      @include base.govuk-font-size($size, $important: true);
+    }
+  }
+  // Weights
+  .govuk-\!-font-weight-regular {
+    @include base.govuk-typography-weight-regular($important: true);
+  }
+  .govuk-\!-font-weight-bold {
+    @include base.govuk-typography-weight-bold($important: true);
+  }
+  // Typography helpers
+  .govuk-\!-font-tabular-numbers {
+    @include base.govuk-font-tabular-numbers($important: true);
+  }
+  .govuk-\!-text-break-word {
+    @include base.govuk-text-break-word($important: true);
+  }
+}