defra_ruby_template 5.11.1 → 6.4.0

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

@@ -29,20 +29,30 @@ $govuk-fonts-path: "#{$govuk-assets-path}fonts/" !default;
 
 /// Custom image URL function
 ///
-/// If the built-in image URL helper does not meet your needs, you can specify
-/// the name of a custom handler – either built in or by writing your own
-/// function.
+/// If you need more control than $govuk-images-path provides, you can use a
+/// function to resolve image filenames to URLs.
 ///
-/// If you are writing your own handler, ensure that it returns a string wrapped
-/// with `url()`
+/// The function should accept a filename and return the URL as a string,
+/// wrapped with `url()`.
 ///
-/// @type String
+/// Passing the name of a function as a string is deprecated.
+///
+/// @type Function | String | null
+///
+/// @example scss - Passing a function
 ///
-/// @example scss - Rails asset handling
-///   $govuk-image-url-function: 'image-url';
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
 ///
-/// @example scss - Custom asset handling
+///   // Then pass the handler function using `meta.get-function`
+///   @use "node_modules/govuk-frontend/dist/govuk" as * with (
+///     $govuk-image-url-function: meta.get-function("image-url", $module: "url-handlers")
+///   )
 ///
+/// @example scss - Passing the name of a function (deprecated)
+///
+///   // This is only available if you still use `@import`
 ///   @function my-url-handler($filename) {
 ///     // Some custom URL handling
 ///     @return url('example.jpg');
@@ -50,26 +60,41 @@ $govuk-fonts-path: "#{$govuk-assets-path}fonts/" !default;
 ///
 ///   $govuk-image-url-function: 'my-url-handler';
 ///
+///   @import "node_modules/govuk-frontend/dist/govuk";
+///
+/// @see $govuk-images-path
+/// @see {function} govuk-image-url
+///
 /// @access public
 
-$govuk-image-url-function: false !default;
+$govuk-image-url-function: null !default;
 
 /// Custom font URL function
 ///
-/// If the built-in font URL helper does not meet your needs, you can specify
-/// the name of a custom handler – either built in or by writing your own
-/// function.
+/// If you need more control than $govuk-fonts-path provides, you can use a
+/// function to resolve font filenames to URLs.
 ///
-/// If you are writing your own handler, ensure that it returns a string wrapped
-/// with `url()`
+/// The function should accept a filename and return the URL as a string,
+/// wrapped with `url()`.
 ///
-/// @type String
+/// Passing the name of a function as a string is deprecated.
+///
+/// @type Function | String | null
+///
+/// @example scss - Passing a function
 ///
-/// @example scss - Rails asset handling
-///   $govuk-font-url-function: 'font-url';
+///   @use "sass:meta";
+///   // Include the module containing the handler function
+///   @use "url-handlers";
 ///
-/// @example scss - Custom asset handling
+///   // Then pass the handler function using `meta.get-function`
+///   @use "node_modules/govuk-frontend/dist/govuk" as * with (
+///     $govuk-font-url-function: meta.get-function("font-url", $module: "url-handlers")
+///   )
 ///
+/// @example scss - Passing the name of a function (deprecated)
+///
+///   // This is only available if you still use `@import`
 ///   @function my-url-handler($filename) {
 ///     // Some custom URL handling
 ///     @return url('example.woff');
@@ -77,8 +102,12 @@ $govuk-image-url-function: false !default;
 ///
 ///   $govuk-font-url-function: 'my-url-handler';
 ///
+///   @import "node_modules/govuk-frontend/dist/govuk";
+///
+/// @see $govuk-fonts-path
+/// @see {function} govuk-font-url
+///
 /// @access public
 
-$govuk-font-url-function: false !default;
+$govuk-font-url-function: null !default;
 
-/*# sourceMappingURL=_assets.scss.map */

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

@@ -0,0 +1,13 @@
+////
+/// @group settings/colours
+////
+@use "warnings--internal";
+
+@forward "colours-functional";
+
+@include warnings--internal.warning(
+  "colours-applied",
+  "The '_colours-applied' file is deprecated. Please import '_colours-functional' instead. " +
+    "See https://github.com/alphagov/govuk-frontend/releases/tag/v6.0.0 for more details."
+);
+

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

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

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

@@ -0,0 +1,168 @@
+////
+/// @group settings/colours
+////
+@use "sass:list";
+@use "sass:map";
+@use "sass:meta";
+
+/// Default definitions of the functional colours
+///
+/// @type Map
+///
+/// @see {variable} $govuk-functional-colours
+///
+/// @access public
+$govuk-default-functional-colours: (
+  (
+    "brand": (
+      name: "blue"
+    ),
+    "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.
+    "template-background": (
+        name: "blue",
+        variant: "tint-95"
+      ),
+    "body-background": (
+      name: "white"
+    ),
+    // Use 'true black' to avoid printers using colour ink to print body text
+    "print-text": #000000,
+    // Used in for example 'muted' text and help text.
+    "secondary-text": (
+        name: "black",
+        variant: "tint-25"
+      ),
+    // Used for outline (and background, where appropriate) when interactive
+    // elements (links, form controls) have keyboard focus.
+    "focus": (
+        name: "yellow"
+      ),
+    // Ensure that the contrast between the text and background colour passes
+    // WCAG Level AA contrast requirements.
+    "focus-text": (
+        name: "black"
+      ),
+    // Used to highlight error messages and form controls in an error state
+    "error": (
+        name: "red"
+      ),
+    // Used to highlight success messages and banners
+    "success": (
+        name: "green"
+      ),
+    // Used in for example borders, separators, rules and keylines.
+    "border": (
+        name: "black",
+        variant: "tint-80"
+      ),
+    // Used for form inputs and controls
+    "input-border": (
+        name: "black"
+      ),
+    // Used for hover states on form controls
+    "hover": (
+        name: "black",
+        variant: "tint-80"
+      ),
+    // Standard links (on white)
+    "link": (
+        name: "blue",
+        variant: "shade-10"
+      ),
+    "link-visited": (
+      name: "purple"
+    ),
+    "link-hover": (
+      name: "blue",
+      variant: "shade-50"
+    ),
+    "link-active": (
+      name: "black"
+    ),
+    // 'Surfaces' are our name for components that have different colour
+    // palettes to typical page content. This is the generic surface.
+    "surface-background": (
+        name: "blue",
+        variant: "tint-95"
+      ),
+    "surface-text": (
+      name: "black"
+    ),
+    "surface-border": (
+      name: "blue",
+      variant: "tint-50"
+    )
+  )
+);
+
+/// Validates and merges functional colour overrides with defaults.
+///
+/// Throws an error if any provided colour name does not exist in the default
+/// functional colours map.
+///
+/// @param {Map} $colours Functional colour overrides.
+/// @param {Map} $defaults Default functional colours.
+/// @return {Map} Merged functional colours.
+/// @access private
+@function _govuk-define-functional-colours($colours, $defaults) {
+  $existing-colours: map.keys($defaults);
+
+  @each $colour-name, $colour in $colours {
+    @if not list.index($existing-colours, $colour-name) {
+      @error 'Unknown colour `#{$colour-name}` (available colours: #{$existing-colours})';
+    }
+  }
+
+  @return map.merge($defaults, $colours);
+}
+
+/// Functional colours for the GOV.UK palette.
+///
+/// Each functional colour is represented by a name (for example `'brand'`) to
+/// which the map associates either:
+///
+///   - a Sass colour (like `#1d70b8`)
+///   - a Sass map with a `name` and an optional `variant` properties, referring
+///     to one of the colours in the colour palette (like `(name: 'blue',
+///     variant: 'primary')`). `variant` defaults to `'primary'` if omitted.
+///
+/// Use the `govuk-functional-colour` function to access these colours.
+///
+/// Customise functional colours by defining $govuk-functional-colours with a
+/// map of the colours that you want to change before importing GOV.UK Frontend.
+/// These will then be merged with the default colours. You can only redefine
+/// existing colours.
+///
+/// @example scss – Redefining functional colours by setting them before import
+///
+///   @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
+///
+/// @type Map
+///
+/// @access public
+$govuk-functional-colours: $govuk-default-functional-colours !default;
+$govuk-functional-colours: _govuk-define-functional-colours(
+  $govuk-functional-colours,
+  $defaults: $govuk-default-functional-colours
+);
+

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";
+