@graupl/core 1.0.0-beta.10

package/src/scss/utilities/border/_defaults.scss

@@ -0,0 +1,73 @@
+// @graupl/core border utilities default values.
+//
+// Generally, these should not be used directly when styling components unless a static value is needed.
+// They are mainly used to provide class selectors, fallbacks for custom properties, or loop values.
+//
+// They should not be used to define direct property values (i.e. font-size, color, etc.).
+// Those should be defined as custom properties in the `_variables.scss` file.
+
+@use "../../defaults" as root-defaults;
+@use "sass:map";
+
+// Utility modifiers.
+$selector-base: root-defaults.$utility-selector-base !default;
+$use-important: root-defaults.$use-important !default;
+$screen-aware: false !default;
+$theme-aware: false !default;
+$state-aware: false !default;
+$container-aware: false !default;
+$screen-aware-separator: root-defaults.$utility-screen-aware-separator !default;
+$theme-aware-separator: root-defaults.$utility-theme-aware-separator !default;
+$state-aware-separator: root-defaults.$utility-state-aware-separator !default;
+$container-aware-separator: root-defaults.$utility-container-aware-separator !default;
+$screen-aware-selector-prefix: root-defaults.$utility-screen-aware-selector-prefix !default;
+$theme-aware-selector-prefix: root-defaults.$utility-theme-aware-selector-prefix !default;
+$state-aware-selector-prefix: root-defaults.$utility-state-aware-selector-prefix !default;
+$container-aware-selector-prefix: root-defaults.$utility-container-aware-selector-prefix !default;
+
+// Default border properties.
+$default-border-selector: "bordered" !default;
+
+// Border width properties.
+$border-width-selector-prefix: "border-" !default;
+$base-border-width-properties: (
+  thick: thick,
+  thin: thin,
+  medium: medium,
+  none: none,
+);
+$custom-border-width-properties: () !default;
+$border-width-properties: map.merge(
+  $base-border-width-properties,
+  $custom-border-width-properties
+);
+
+// Border color properties.
+$border-color-selector-prefix: "border-" !default;
+$base-border-color-properties: (
+  transparent: transparent,
+);
+$custom-border-color-properties: () !default;
+$border-color-properties: map.merge(
+  $base-border-color-properties,
+  $custom-border-color-properties
+);
+
+// Border style properties.
+$border-style-selector-prefix: "border-" !default;
+$base-border-style-properties: (
+  solid: solid,
+  dashed: dashed,
+  dotted: dotted,
+  double: double,
+  groove: groove,
+  ridge: ridge,
+  inset: inset,
+  outset: outset,
+  none: none,
+);
+$custom-border-style-properties: () !default;
+$border-style-properties: map.merge(
+  $base-border-style-properties,
+  $custom-border-style-properties
+);

package/src/scss/utilities/border/_index.scss

@@ -0,0 +1,558 @@
+// @graupl/core border utilities styles.
+//
+// This file generates the border utility classes provided by Graupl.
+//
+// The following classes are generated by default:
+// - `.bordered`: Applies the default border styling.
+// - `.border-thick`: Sets the border width to `thick`.
+// - `.border-thin`: Sets the border width to `thin`.
+// - `.border-medium`: Sets the border width to `medium`.
+// - `.border-none`: Sets the border width to `none`.
+// - `.border-primary-100`: Sets the border color to Graupl's primary 100 color.
+// - `.border-primary-200`: Sets the border color to Graupl's primary 200 color.
+// - `.border-primary-300`: Sets the border color to Graupl's primary 300 color.
+// - `.border-primary-400`: Sets the border color to Graupl's primary 400 color.
+// - `.border-primary-500`: Sets the border color to Graupl's primary 500 color.
+// - `.border-primary-600`: Sets the border color to Graupl's primary 600 color.
+// - `.border-primary-700`: Sets the border color to Graupl's primary 700 color.
+// - `.border-primary-800`: Sets the border color to Graupl's primary 800 color.
+// - `.border-primary-900`: Sets the border color to Graupl's primary 900 color.
+// - `.border-secondary-100`: Sets the border color to Graupl's secondary 100 color.
+// - `.border-secondary-200`: Sets the border color to Graupl's secondary 200 color.
+// - `.border-secondary-300`: Sets the border color to Graupl's secondary 300 color.
+// - `.border-secondary-400`: Sets the border color to Graupl's secondary 400 color.
+// - `.border-secondary-500`: Sets the border color to Graupl's secondary 500 color.
+// - `.border-secondary-600`: Sets the border color to Graupl's secondary 600 color.
+// - `.border-secondary-700`: Sets the border color to Graupl's secondary 700 color.
+// - `.border-secondary-800`: Sets the border color to Graupl's secondary 800 color.
+// - `.border-secondary-900`: Sets the border color to Graupl's secondary 900 color.
+// - `.border-tertiary-100`: Sets the border color to Graupl's tertiary 100 color.
+// - `.border-tertiary-200`: Sets the border color to Graupl's tertiary 200 color.
+// - `.border-tertiary-300`: Sets the border color to Graupl's tertiary 300 color.
+// - `.border-tertiary-400`: Sets the border color to Graupl's tertiary 400 color.
+// - `.border-tertiary-500`: Sets the border color to Graupl's tertiary 500 color.
+// - `.border-tertiary-600`: Sets the border color to Graupl's tertiary 600 color.
+// - `.border-tertiary-700`: Sets the border color to Graupl's tertiary 700 color.
+// - `.border-tertiary-800`: Sets the border color to Graupl's tertiary 800 color.
+// - `.border-tertiary-900`: Sets the border color to Graupl's tertiary 900 color.
+// - `.border-transparent`: Sets the border color to `transparent`.
+// - `.border-solid`: Sets the border style to `solid`.
+// - `.border-dashed`: Sets the border style to `dashed`.
+// - `.border-dotted`: Sets the border style to `dotted`.
+// - `.border-double`: Sets the border style to `double`.
+// - `.border-groove`: Sets the border style to `groove`.
+// - `.border-ridge`: Sets the border style to `ridge`.
+// - `.border-inset`: Sets the border style to `inset`.
+// - `.border-outset`: Sets the border style to `outset`.
+// - `.border-none`: Sets the border style to `none`.
+//
+// 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.
+// - `$default-border-selector`: The selector for the default border utility class.
+// - `$border-width-selector-prefix`: The prefix for the border width utility classes.
+// - `$base-border-width-properties`: The base properties and values for the border width utility classes.
+// - `$custom-border-width-properties`: The custom properties and values for the border width utility classes.
+// - `$border-width-properties`: The combined properties and values for the border width utility classes.
+// - `$border-color-selector-prefix`: The prefix for the border color utility classes.
+// - `$base-border-color-properties`: The base properties and values for the border color utility classes.
+// - `$custom-border-color-properties`: The custom properties and values for the border color utility classes.
+// - `$border-color-properties`: The combined properties and values for the border color utility classes.
+// - `$border-style-selector-prefix`: The prefix for the border style utility classes.
+// - `$base-border-style-properties`: The base properties and values for the border style utility classes.
+// - `$custom-border-style-properties`: The custom properties and values for the border style utility classes.
+// - `$border-style-properties`: The combined properties and values for the border style 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:border-thick` will set the `border-width` property to `thick` 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:border-thick` will set the `border-width` property to `thick` 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:border-thick` will set the `border-width` property to `thick` 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:border-thick` will set the `border-width` property to `thick` when the parent container is larger than the `md` breakpoint.
+//
+// @example
+//   <div class="bordered">This element has a border.</div>
+
+@use "../../defaults" as root-defaults;
+@use "../../functions/important";
+@use "../../mixins/layer" as *;
+@use "../../mixins/screen";
+@use "../../mixins/utility";
+@use "../../theme/color/variables" as color;
+@use "../../variables" as root-variables;
+@use "defaults";
+@use "sass:map";
+@use "variables" as *;
+
+@include layer(utilities) {
+  // `.`
+  $selector-prefix: defaults.$selector-base;
+
+  // `.bordered`
+  $selector: #{$selector-prefix}#{defaults.$default-border-selector};
+
+  // Create a class to apply the default border styling.
+  @include utility.create-mapped(
+    $selector,
+    (
+      border-width: root-variables.$border-top-width
+        root-variables.$border-right-width root-variables.$border-bottom-width
+        root-variables.$border-left-width,
+      border-radius: root-variables.$border-top-left-radius
+        root-variables.$border-top-right-radius
+        root-variables.$border-bottom-right-radius
+        root-variables.$border-bottom-left-radius,
+      border-style: root-variables.$border-top-style
+        root-variables.$border-right-style root-variables.$border-bottom-style
+        root-variables.$border-left-style,
+    ),
+    $important: defaults.$use-important
+  );
+
+  // For each border width, create a class to apply the border width.
+  @each $width, $value in defaults.$border-width-properties {
+    // e.g. `.border-thick` or `.border-thin`
+    $selector: #{$selector-prefix}#{defaults.$border-width-selector-prefix}#{$width};
+
+    @include utility.create(
+      $selector,
+      border-width,
+      $value,
+      $important: defaults.$use-important
+    );
+  }
+
+  // For each border style, create a class to apply the border style.
+  @each $border-style, $value in defaults.$border-style-properties {
+    // e.g. `.border-solid` or `.border-dashed`
+    $selector: #{$selector-prefix}#{defaults.$border-style-selector-prefix}#{$border-style};
+
+    @include utility.create(
+      $selector,
+      border-style,
+      $value,
+      $important: defaults.$use-important
+    );
+  }
+
+  // For each theme colour, create a utility class for border color.
+  @each $color, $map in map.get(color.$themes, active) {
+    @each $shade, $value in $map {
+      // e.g. `.border-primary-100` or `.border-secondary-900`
+      $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$color}-#{$shade};
+
+      @include utility.create(
+        $selector,
+        border-color,
+        $value,
+        $important: defaults.$use-important
+      );
+    }
+  }
+
+  // For each border color, create a utility class for border color.
+  @each $name, $value in defaults.$border-color-properties {
+    // e.g. `.border-transparent`
+    $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      border-color,
+      $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};
+
+      // e.g. `.md:bordered` or `.lg:bordered`
+      $selector: #{$selector-prefix}#{defaults.$default-border-selector};
+
+      // Create a class to apply the default border styling.
+      @include utility.create-mapped(
+        $selector,
+        (
+          border-width: root-variables.$border-top-width
+            root-variables.$border-right-width
+            root-variables.$border-bottom-width
+            root-variables.$border-left-width,
+          border-radius: root-variables.$border-top-left-radius
+            root-variables.$border-top-right-radius
+            root-variables.$border-bottom-right-radius
+            root-variables.$border-bottom-left-radius,
+          border-style: root-variables.$border-top-style
+            root-variables.$border-right-style
+            root-variables.$border-bottom-style
+            root-variables.$border-left-style,
+        ),
+        $important: defaults.$use-important,
+        $screen: $screen-name
+      );
+
+      // For each border width, create a class to apply the border width.
+      @each $width, $value in defaults.$border-width-properties {
+        // e.g. `.md:border-thick` or `.lg:border-thin`
+        $selector: #{$selector-prefix}#{defaults.$border-width-selector-prefix}#{$width};
+
+        @include utility.create(
+          $selector,
+          border-width,
+          $value,
+          $important: defaults.$use-important,
+          $screen: $screen-name
+        );
+      }
+
+      // For each border style, create a class to apply the border style.
+      @each $border-style, $value in defaults.$border-style-properties {
+        // e.g. `.md:border-solid` or `.lg:border-dashed`
+        $selector: #{$selector-prefix}#{defaults.$border-style-selector-prefix}#{$border-style};
+
+        @include utility.create(
+          $selector,
+          border-style,
+          $value,
+          $important: defaults.$use-important,
+          $screen: $screen-name
+        );
+      }
+
+      // For each theme colour, create a utility class for border color.
+      @each $color, $map in map.get(color.$themes, active) {
+        @each $shade, $value in $map {
+          // e.g. `.md:border-primary-100` or `.lg:border-secondary-900`
+          $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$color}-#{$shade};
+
+          @include utility.create(
+            $selector,
+            border-color,
+            $value,
+            $important: defaults.$use-important,
+            $screen: $screen-name
+          );
+        }
+      }
+
+      // For each border color, create a utility class for border color.
+      @each $name, $value in defaults.$border-color-properties {
+        // e.g. `.md:border-transparent` or `.lg:border-transparent`
+        $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          border-color,
+          $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};
+
+        // e.g. `.dark:bordered` or `.light:bordered`
+        $selector: #{$selector-prefix}#{defaults.$default-border-selector};
+
+        // Create a class to apply the default border styling.
+        @include utility.create-mapped(
+          $selector,
+          (
+            border-width: root-variables.$border-top-width
+              root-variables.$border-right-width
+              root-variables.$border-bottom-width
+              root-variables.$border-left-width,
+            border-radius: root-variables.$border-top-left-radius
+              root-variables.$border-top-right-radius
+              root-variables.$border-bottom-right-radius
+              root-variables.$border-bottom-left-radius,
+            border-style: root-variables.$border-top-style
+              root-variables.$border-right-style
+              root-variables.$border-bottom-style
+              root-variables.$border-left-style,
+          ),
+          $important: defaults.$use-important,
+          $theme: $theme-name
+        );
+
+        // For each border width, create a class to apply the border width.
+        @each $width, $value in defaults.$border-width-properties {
+          // e.g. `.dark:border-thick` or `.light:border-thin`
+          $selector: #{$selector-prefix}#{defaults.$border-width-selector-prefix}#{$width};
+
+          @include utility.create(
+            $selector,
+            border-width,
+            $value,
+            $important: defaults.$use-important,
+            $theme: $theme-name
+          );
+        }
+
+        // For each border style, create a class to apply the border style.
+        @each $border-style, $value in defaults.$border-style-properties {
+          // e.g. `.dark:border-solid` or `.light:border-dashed`
+          $selector: #{$selector-prefix}#{defaults.$border-style-selector-prefix}#{$border-style};
+
+          @include utility.create(
+            $selector,
+            border-style,
+            $value,
+            $important: defaults.$use-important,
+            $theme: $theme-name
+          );
+        }
+
+        // For each theme colour, create a utility class for border color.
+        @each $color, $map in map.get(color.$themes, active) {
+          @each $shade, $value in $map {
+            // e.g. `.dark:border-primary-100` or `.light:border-secondary-900`
+            $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$color}-#{$shade};
+
+            @include utility.create(
+              $selector,
+              border-color,
+              $value,
+              $important: defaults.$use-important,
+              $theme: $theme-name
+            );
+          }
+        }
+
+        // For each border color, create a utility class for border color.
+        @each $name, $value in defaults.$border-color-properties {
+          // e.g. `.dark:border-transparent` or `.light:border-transparent`
+          $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            border-color,
+            $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};
+
+      // e.g. `.hover:bordered` or `.focus:bordered`
+      $selector: #{$selector-prefix}#{defaults.$default-border-selector};
+
+      // Create a class to apply the default border styling.
+      @include utility.create-mapped(
+        $selector,
+        (
+          border-width: root-variables.$border-top-width
+            root-variables.$border-right-width
+            root-variables.$border-bottom-width
+            root-variables.$border-left-width,
+          border-radius: root-variables.$border-top-left-radius
+            root-variables.$border-top-right-radius
+            root-variables.$border-bottom-right-radius
+            root-variables.$border-bottom-left-radius,
+          border-style: root-variables.$border-top-style
+            root-variables.$border-right-style
+            root-variables.$border-bottom-style
+            root-variables.$border-left-style,
+        ),
+        $important: defaults.$use-important,
+        $state: $state-name
+      );
+
+      // For each border width, create a class to apply the border width.
+      @each $width, $value in defaults.$border-width-properties {
+        // e.g. `.hover:border-thick` or `.focus:border-thin`
+        $selector: #{$selector-prefix}#{defaults.$border-width-selector-prefix}#{$width};
+
+        @include utility.create(
+          $selector,
+          border-width,
+          $value,
+          $important: defaults.$use-important,
+          $state: $state-name
+        );
+      }
+
+      // For each border style, create a class to apply the border style.
+      @each $border-style, $value in defaults.$border-style-properties {
+        // e.g. `.hover:border-solid` or `.focus:border-dashed`
+        $selector: #{$selector-prefix}#{defaults.$border-style-selector-prefix}#{$border-style};
+
+        @include utility.create(
+          $selector,
+          border-style,
+          $value,
+          $important: defaults.$use-important,
+          $state: $state-name
+        );
+      }
+
+      // For each theme colour, create a utility class for border color.
+      @each $color, $map in map.get(color.$themes, active) {
+        @each $shade, $value in $map {
+          // e.g. `.hover:border-primary-100` or `.focus:border-secondary-900`
+          $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$color}-#{$shade};
+
+          @include utility.create(
+            $selector,
+            border-color,
+            $value,
+            $important: defaults.$use-important,
+            $state: $state-name
+          );
+        }
+      }
+
+      // For each border color, create a utility class for border color.
+      @each $name, $value in defaults.$border-color-properties {
+        // e.g. `.hover:border-transparent` or `.focus:border-transparent`
+        $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          border-color,
+          $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};
+
+      // e.g. `.md:bordered` or `.lg:bordered`
+      $selector: #{$selector-prefix}#{defaults.$default-border-selector};
+
+      // Create a class to apply the default border styling.
+      @include utility.create-mapped(
+        $selector,
+        (
+          border-width: root-variables.$border-top-width
+            root-variables.$border-right-width
+            root-variables.$border-bottom-width
+            root-variables.$border-left-width,
+          border-radius: root-variables.$border-top-left-radius
+            root-variables.$border-top-right-radius
+            root-variables.$border-bottom-right-radius
+            root-variables.$border-bottom-left-radius,
+          border-style: root-variables.$border-top-style
+            root-variables.$border-right-style
+            root-variables.$border-bottom-style
+            root-variables.$border-left-style,
+        ),
+        $important: defaults.$use-important,
+        $container: $container-name
+      );
+
+      // For each border width, create a class to apply the border width.
+      @each $width, $value in defaults.$border-width-properties {
+        // e.g. `.md:border-thick` or `.lg:border-thin`
+        $selector: #{$selector-prefix}#{defaults.$border-width-selector-prefix}#{$width};
+
+        @include utility.create(
+          $selector,
+          border-width,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+
+      // For each border style, create a class to apply the border style.
+      @each $border-style, $value in defaults.$border-style-properties {
+        // e.g. `.md:border-solid` or `.lg:border-dashed`
+        $selector: #{$selector-prefix}#{defaults.$border-style-selector-prefix}#{$border-style};
+
+        @include utility.create(
+          $selector,
+          border-style,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+
+      // For each theme colour, create a utility class for border color.
+      @each $color, $map in map.get(color.$themes, active) {
+        @each $shade, $value in $map {
+          // e.g. `.md:border-primary-100` or `.lg:border-secondary-900`
+          $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$color}-#{$shade};
+
+          @include utility.create(
+            $selector,
+            border-color,
+            $value,
+            $important: defaults.$use-important,
+            $container: $container-name
+          );
+        }
+      }
+
+      // For each border color, create a utility class for border color.
+      @each $name, $value in defaults.$border-color-properties {
+        // e.g. `.md:border-transparent` or `.lg:border-transparent`
+        $selector: #{$selector-prefix}#{defaults.$border-color-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          border-color,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+    }
+  }
+}

package/src/scss/utilities/border/_variables.scss

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

package/src/scss/utilities/color/_defaults.scss

@@ -0,0 +1,49 @@
+// @graupl/core color utilities default values.
+//
+// Generally, these should not be used directly when styling components unless a static value is needed.
+// They are mainly used to provide class selectors, fallbacks for custom properties, or loop values.
+//
+// They should not be used to define direct property values (i.e. font-size, color, etc.).
+// Those should be defined as custom properties in the `_variables.scss` file.
+
+@use "../../defaults" as root-defaults;
+@use "sass:map";
+
+// Utility modifiers.
+$selector-base: root-defaults.$utility-selector-base !default;
+$use-important: root-defaults.$use-important !default;
+$screen-aware: false !default;
+$theme-aware: true !default;
+$state-aware: true !default;
+$container-aware: false !default;
+$screen-aware-separator: root-defaults.$utility-screen-aware-separator !default;
+$theme-aware-separator: root-defaults.$utility-theme-aware-separator !default;
+$state-aware-separator: root-defaults.$utility-state-aware-separator !default;
+$container-aware-separator: root-defaults.$utility-container-aware-separator !default;
+$screen-aware-selector-prefix: root-defaults.$utility-screen-aware-selector-prefix !default;
+$theme-aware-selector-prefix: root-defaults.$utility-theme-aware-selector-prefix !default;
+$state-aware-selector-prefix: root-defaults.$utility-state-aware-selector-prefix !default;
+$container-aware-selector-prefix: root-defaults.$utility-container-aware-selector-prefix !default;
+
+// Background utility properties.
+$background-selector-prefix: "bg-" !default;
+$base-background-properties: (
+  inherit: inherit,
+  current: currentcolor,
+  transparent: transparent,
+);
+$custom-background-properties: () !default;
+$background-properties: map.merge(
+  $base-background-properties,
+  $custom-background-properties
+);
+
+// Text utility properties.
+$text-selector-prefix: "text-" !default;
+$base-text-properties: (
+  inherit: inherit,
+  current: currentcolor,
+  transparent: transparent,
+);
+$custom-text-properties: () !default;
+$text-properties: map.merge($base-text-properties, $custom-text-properties);