@graupl/graupl 1.0.0-beta.1 → 1.0.0-beta.10

package/packages/core/src/scss/utilities/background/_index.scss

@@ -0,0 +1,634 @@
+// @graupl/core background utilities styles.
+//
+// This file generates the background utility classes provided by Graupl.
+//
+// The following classes are generated by default:
+// - `.bg-attachment-scroll`: Sets the background attachment property to `scroll`.
+// - `.bg-attachment-fixed`: Sets the background attachment property to `fixed`.
+// - `.bg-attachment-local`: Sets the background attachment property to `local`.
+// - `.bg-clip-border-box`: Sets the background clip property to `border-box`.
+// - `.bg-clip-padding-box`: Sets the background clip property to `padding-box`.
+// - `.bg-clip-content-box`: Sets the background clip property to `content-box`.
+// - `.bg-clip-text`: Sets the background clip property to `text`.
+// - `.bg-clip-border-area`: Sets the background clip property to `border-area`.
+// - `.bg-image-none`: Sets the background image property to `none`.
+// - `.bg-origin-border-box`: Sets the background origin property to `border-box`.
+// - `.bg-origin-padding-box`: Sets the background origin property to `padding-box`.
+// - `.bg-origin-content-box`: Sets the background origin property to `content-box`.
+// - `.bg-position-top`: Sets the background position property to `top`.
+// - `.bg-position-right`: Sets the background position property to `right`.
+// - `.bg-position-bottom`: Sets the background position property to `bottom`.
+// - `.bg-position-left`: Sets the background position property to `left`.
+// - `.bg-position-center`: Sets the background position property to `center`.
+// - `.bg-repeat-repeat`: Sets the background repeat property to `repeat`.
+// - `.bg-repeat-repeat-x`: Sets the background repeat property to `repeat-x`.
+// - `.bg-repeat-repeat-y`: Sets the background repeat property to `repeat-y`.
+// - `.bg-repeat-space`: Sets the background repeat property to `space`.
+// - `.bg-repeat-round`: Sets the background repeat property to `round`.
+// - `.bg-repeat-no-repeat`: Sets the background repeat property to `no-repeat`.
+// - `.bg-size-auto`: Sets the background size property to `auto`.
+// - `.bg-size-cover`: Sets the background size property to `cover`.
+// - `.bg-size-contain`: Sets the background size property to `contain`.
+//
+// The following custom properties control the generated classes:
+// - N/A.
+//
+// The following variables control the generated classes:
+// - `$selector-base`: The base selector for the utility classes.
+// - `$use-important`: A flag to determine if the `!important` flag should be added to the utility classes.
+// - `$screen-aware`: A flag to generate screen-aware utility classes.
+// - `$theme-aware`: A flag to generate theme-aware utility classes.
+// - `$state-aware`: A flag to generate state-aware utility classes.
+// - `$container-aware`: A flag to generate container-aware utility classes.
+// - `$screen-aware-separator`: The separator for screen-aware utility classes.
+// - `$theme-aware-separator`: The separator for theme-aware utility classes.
+// - `$state-aware-separator`: The separator for state-aware utility classes.
+// - `$container-aware-separator`: The separator for container-aware utility classes.
+// - `$screen-aware-selector-prefix`: The prefix for screen-aware utility classes.
+// - `$theme-aware-selector-prefix`: The prefix for theme-aware utility classes.
+// - `$state-aware-selector-prefix`: The prefix for state-aware utility classes.
+// - `$container-aware-selector-prefix`: The prefix for container-aware utility classes.
+// - `$background-attachment-selector-prefix`: The prefix for the background attachment utility classes.
+// - `$base-background-attachment-properties`: The base properties and values for the background attachment utility classes.
+// - `$custom-background-attachment-properties`: The custom properties and values for the background attachment utility classes.
+// - `$background-attachment-properties`: The combined properties and values for the background attachment utility classes.
+// - `$background-clip-selector-prefix`: The prefix for the background clip utility classes.
+// - `$base-background-clip-properties`: The base properties and values for the background clip utility classes.
+// - `$custom-background-clip-properties`: The custom properties and values for the background clip utility classes.
+// - `$background-clip-properties`: The combined properties and values for the background clip utility classes.
+// - `$background-image-selector-prefix`: The prefix for the background image utility classes.
+// - `$base-background-image-properties`: The base properties and values for the background image utility classes.
+// - `$custom-background-image-properties`: The custom properties and values for the background image utility classes.
+// - `$background-image-properties`: The combined properties and values for the background image utility classes.
+// - `$background-origin-selector-prefix`: The prefix for the background origin utility classes.
+// - `$base-background-origin-properties`: The base properties and values for the background origin utility classes.
+// - `$custom-background-origin-properties`: The custom properties and values for the background origin utility classes.
+// - `$background-origin-properties`: The combined properties and values for the background origin utility classes.
+// - `$background-position-selector-prefix`: The prefix for the background position utility classes.
+// - `$base-background-position-properties`: The base properties and values for the background position utility classes.
+// - `$custom-background-position-properties`: The custom properties and values for the background position utility classes.
+// - `$background-position-properties`: The combined properties and values for the background position utility classes.
+// - `$background-repeat-selector-prefix`: The prefix for the background repeat utility classes.
+// - `$base-background-repeat-properties`: The base properties and values for the background repeat utility classes.
+// - `$custom-background-repeat-properties`: The custom properties and values for the background repeat utility classes.
+// - `$background-repeat-properties`: The combined properties and values for the background repeat utility classes.
+// - `$background-size-selector-prefix`: The prefix for the background size utility classes.
+// - `$base-background-size-properties`: The base properties and values for the background size utility classes.
+// - `$custom-background-size-properties`: The custom properties and values for the background size utility classes.
+// - `$background-size-properties`: The combined properties and values for the background size utility classes.
+//
+// Generating responsive utility classes can be done by setting `$screen-aware`, `$theme-aware`, or `$state-aware` to `true`.
+// By default, no responsive utility classes are generated.
+//
+// When set to true, screen-aware utility classes will be generated for each screen size in the following pattern:
+// - `.{screen-prefix}{screen-name}:{prefix}{value}`
+//
+// e.g. `.sm:bg-attachment-scroll` will set the `background-attachment` property to `scroll` on screens equal to or larger than the `sm` breakpoint.
+//
+// When set to true, theme-aware utility classes will be generated for each theme in the following pattern:
+// - `.{theme-prefix}{theme-name}:{prefix}{value}`
+//
+// e.g. `.dark:bg-attachment-scroll` will set the `background-attachment` property to `scroll` when the `dark` theme is active.
+//
+// When set to true, state-aware utility classes will be generated for each state in the following pattern:
+// - `.{state-prefix}{state-name}:{prefix}{value}`
+//
+// e.g. `.hover:bg-attachment-scroll` will set the `background-attachment` property to `scroll` when the element is hovered.
+//
+// When set to true, container-aware utility classes will be generated for each container in the following pattern:
+// - `.{container-prefix}{container-name}:{prefix}{value}`
+//
+// e.g. `.cq:md:bg-attachment-scroll` will set the `background-attachment` property to `scroll` when the parent container is larger than the `md` breakpoint.
+//
+// @example
+//   <div class="bg-attachment-scroll">This element has a scrollable background.</div>
+
+@use "../../defaults" as root-defaults;
+@use "../../mixins/layer" as *;
+@use "../../mixins/utility";
+@use "../../theme/color/variables" as color;
+@use "defaults";
+@use "sass:map";
+@use "variables" as *;
+
+@include layer(utilities) {
+  // `.`
+  $selector-prefix: defaults.$selector-base;
+
+  // For each background attachment property, create a utility class.
+  @each $name, $value in defaults.$background-attachment-properties {
+    // e.g. `.bg-attachment-scroll` or `.bg-attachment-fixed`
+    $selector: #{$selector-prefix}#{defaults.$background-attachment-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-attachment,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background clip property, create a utility class.
+  @each $name, $value in defaults.$background-clip-properties {
+    // e.g. `.bg-clip-border-box` or `.bg-clip-padding-box`
+    $selector: #{$selector-prefix}#{defaults.$background-clip-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-clip,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background image property, create a utility class.
+  @each $name, $value in defaults.$background-image-properties {
+    // e.g. `.bg-image-none` or `.bg-image-inherit`
+    $selector: #{$selector-prefix}#{defaults.$background-image-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-image,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background origin property, create a utility class.
+  @each $name, $value in defaults.$background-origin-properties {
+    // e.g. `.bg-origin-border-box` or `.bg-origin-padding-box`
+    $selector: #{$selector-prefix}#{defaults.$background-origin-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-origin,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background position property, create a utility class.
+  @each $name, $value in defaults.$background-position-properties {
+    // e.g. `.bg-position-top` or `.bg-position-center`
+    $selector: #{$selector-prefix}#{defaults.$background-position-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-position,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background repeat property, create a utility class.
+  @each $name, $value in defaults.$background-repeat-properties {
+    // e.g. `.bg-repeat-repeat` or `.bg-repeat-no-repeat`
+    $selector: #{$selector-prefix}#{defaults.$background-repeat-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-repeat,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // For each background size property, create a utility class.
+  @each $name, $value in defaults.$background-size-properties {
+    // e.g. `.bg-size-auto` or `.bg-size-cover`
+    $selector: #{$selector-prefix}#{defaults.$background-size-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      background-size,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // Generate screen-aware utilities.
+  @if defaults.$screen-aware and root-defaults.$screen-aware-utilities {
+    @each $screen-name in map.keys(root-defaults.$screen-sizes) {
+      // e.g. `.md:` or `.lg:`
+      $selector-prefix: #{defaults.$selector-base}#{defaults.$screen-aware-selector-prefix}#{$screen-name}#{defaults.$screen-aware-separator};
+
+      // For each background attachment property, create a utility class.
+      @each $name, $value in defaults.$background-attachment-properties {
+        // e.g. `.md:bg-attachment-scroll` or `.lg:bg-attachment-fixed`
+        $selector: #{$selector-prefix}#{defaults.$background-attachment-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-attachment,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background clip property, create a utility class.
+      @each $name, $value in defaults.$background-clip-properties {
+        // e.g. `.md:bg-clip-border-box` or `.lg:bg-clip-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-clip-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-clip,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background image property, create a utility class.
+      @each $name, $value in defaults.$background-image-properties {
+        // e.g. `.md:bg-image-none` or `.lg:bg-image-inherit`
+        $selector: #{$selector-prefix}#{defaults.$background-image-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-image,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background origin property, create a utility class.
+      @each $name, $value in defaults.$background-origin-properties {
+        // e.g. `.md:bg-origin-border-box` or `.lg:bg-origin-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-origin-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-origin,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background position property, create a utility class.
+      @each $name, $value in defaults.$background-position-properties {
+        // e.g. `.md:bg-position-top` or `.lg:bg-position-center`
+        $selector: #{$selector-prefix}#{defaults.$background-position-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-position,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background repeat property, create a utility class.
+      @each $name, $value in defaults.$background-repeat-properties {
+        // e.g. `.md:bg-repeat-repeat` or `.lg:bg-repeat-no-repeat`
+        $selector: #{$selector-prefix}#{defaults.$background-repeat-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-repeat,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+
+      // For each background size property, create a utility class.
+      @each $name, $value in defaults.$background-size-properties {
+        // e.g. `.md:bg-size-auto` or `.lg:bg-size-cover`
+        $selector: #{$selector-prefix}#{defaults.$background-size-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-size,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+    }
+  }
+
+  // Generate theme-aware utilities.
+  @if defaults.$theme-aware and root-defaults.$theme-aware-utilities {
+    @each $theme-name, $colors in color.$themes {
+      @if $theme-name != active {
+        // e.g. `.dark:` or `.light:`
+        $selector-prefix: #{defaults.$selector-base}#{defaults.$theme-aware-selector-prefix}#{$theme-name}#{defaults.$theme-aware-separator};
+
+        // For each background attachment property, create a utility class.
+        @each $name, $value in defaults.$background-attachment-properties {
+          // e.g. `.dark:bg-attachment-scroll` or `.light:bg-attachment-fixed`
+          $selector: #{$selector-prefix}#{defaults.$background-attachment-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-attachment,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background clip property, create a utility class.
+        @each $name, $value in defaults.$background-clip-properties {
+          // e.g. `.dark:bg-clip-border-box` or `.light:bg-clip-padding-box`
+          $selector: #{$selector-prefix}#{defaults.$background-clip-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-clip,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background image property, create a utility class.
+        @each $name, $value in defaults.$background-image-properties {
+          // e.g. `.dark:bg-image-none` or `.light:bg-image-inherit`
+          $selector: #{$selector-prefix}#{defaults.$background-image-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-image,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background origin property, create a utility class.
+        @each $name, $value in defaults.$background-origin-properties {
+          // e.g. `.dark:bg-origin-border-box` or `.light:bg-origin-padding-box`
+          $selector: #{$selector-prefix}#{defaults.$background-origin-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-origin,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background position property, create a utility class.
+        @each $name, $value in defaults.$background-position-properties {
+          // e.g. `.dark:bg-position-top` or `.light:bg-position-center`
+          $selector: #{$selector-prefix}#{defaults.$background-position-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-position,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background repeat property, create a utility class.
+        @each $name, $value in defaults.$background-repeat-properties {
+          // e.g. `.dark:bg-repeat-repeat` or `.light:bg-repeat-no-repeat`
+          $selector: #{$selector-prefix}#{defaults.$background-repeat-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-repeat,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+
+        // For each background size property, create a utility class.
+        @each $name, $value in defaults.$background-size-properties {
+          // e.g. `.dark:bg-size-auto` or `.light:bg-size-cover`
+          $selector: #{$selector-prefix}#{defaults.$background-size-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            background-size,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+      }
+    }
+  }
+
+  // Generate state-aware utilities.
+  @if defaults.$state-aware and root-defaults.$state-aware-utilities {
+    @each $state-name, $value in root-defaults.$state-selectors {
+      // e.g. `.hover:` or `.focus:`
+      $selector-prefix: #{defaults.$selector-base}#{defaults.$state-aware-selector-prefix}#{$state-name}#{defaults.$state-aware-separator};
+
+      // For each background attachment property, create a utility class.
+      @each $name, $value in defaults.$background-attachment-properties {
+        // e.g. `.hover:bg-attachment-scroll` or `.focus:bg-attachment-fixed`
+        $selector: #{$selector-prefix}#{defaults.$background-attachment-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-attachment,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background clip property, create a utility class.
+      @each $name, $value in defaults.$background-clip-properties {
+        // e.g. `.hover:bg-clip-border-box` or `.focus:bg-clip-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-clip-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-clip,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background image property, create a utility class.
+      @each $name, $value in defaults.$background-image-properties {
+        // e.g. `.hover:bg-image-none` or `.focus:bg-image-inherit`
+        $selector: #{$selector-prefix}#{defaults.$background-image-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-image,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background origin property, create a utility class.
+      @each $name, $value in defaults.$background-origin-properties {
+        // e.g. `.hover:bg-origin-border-box` or `.focus:bg-origin-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-origin-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-origin,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background position property, create a utility class.
+      @each $name, $value in defaults.$background-position-properties {
+        // e.g. `.hover:bg-position-top` or `.focus:bg-position-center`
+        $selector: #{$selector-prefix}#{defaults.$background-position-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-position,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background repeat property, create a utility class.
+      @each $name, $value in defaults.$background-repeat-properties {
+        // e.g. `.hover:bg-repeat-repeat` or `.focus:bg-repeat-no-repeat`
+        $selector: #{$selector-prefix}#{defaults.$background-repeat-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-repeat,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+
+      // For each background size property, create a utility class.
+      @each $name, $value in defaults.$background-size-properties {
+        // e.g. `.hover:bg-size-auto` or `.focus:bg-size-cover`
+        $selector: #{$selector-prefix}#{defaults.$background-size-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-size,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+    }
+  }
+
+  // Generate container-aware utilities.
+  @if defaults.$container-aware and root-defaults.$container-aware-utilities {
+    @each $container-name in map.keys(root-defaults.$container-sizes) {
+      // e.g. `.md:` or `.lg:`
+      $selector-prefix: #{defaults.$selector-base}#{defaults.$container-aware-selector-prefix}#{$container-name}#{defaults.$container-aware-separator};
+
+      // For each background attachment property, create a utility class.
+      @each $name, $value in defaults.$background-attachment-properties {
+        // e.g. `.md:bg-attachment-scroll` or `.lg:bg-attachment-fixed`
+        $selector: #{$selector-prefix}#{defaults.$background-attachment-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-attachment,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background clip property, create a utility class.
+      @each $name, $value in defaults.$background-clip-properties {
+        // e.g. `.md:bg-clip-border-box` or `.lg:bg-clip-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-clip-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-clip,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background image property, create a utility class.
+      @each $name, $value in defaults.$background-image-properties {
+        // e.g. `.md:bg-image-none` or `.lg:bg-image-inherit`
+        $selector: #{$selector-prefix}#{defaults.$background-image-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-image,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background origin property, create a utility class.
+      @each $name, $value in defaults.$background-origin-properties {
+        // e.g. `.md:bg-origin-border-box` or `.lg:bg-origin-padding-box`
+        $selector: #{$selector-prefix}#{defaults.$background-origin-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-origin,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background position property, create a utility class.
+      @each $name, $value in defaults.$background-position-properties {
+        // e.g. `.md:bg-position-top` or `.lg:bg-position-center`
+        $selector: #{$selector-prefix}#{defaults.$background-position-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-position,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background repeat property, create a utility class.
+      @each $name, $value in defaults.$background-repeat-properties {
+        // e.g. `.md:bg-repeat-repeat` or `.lg:bg-repeat-no-repeat`
+        $selector: #{$selector-prefix}#{defaults.$background-repeat-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-repeat,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+
+      // For each background size property, create a utility class.
+      @each $name, $value in defaults.$background-size-properties {
+        // e.g. `.md:bg-size-auto` or `.lg:bg-size-cover`
+        $selector: #{$selector-prefix}#{defaults.$background-size-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          background-size,
+          $value,
+          $important: #{defaults.$use-important},
+          $container: $container-name
+        );
+      }
+    }
+  }
+}

package/packages/core/src/scss/utilities/background/_variables.scss

@@ -0,0 +1,6 @@
+// @graupl/core background utilities variables.
+//
+// These values are to be used to directly style components and provide a
+// cleaner way to reference custom properties.
+
+@use "defaults";