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

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

@@ -0,0 +1,258 @@
+// @graupl/core inset utilities styles.
+//
+// This file generates the inset utility classes provided by Graupl.
+//
+// The following classes are generated by default:
+// - `.inset-0`: Sets the inset property to `0`.
+// - `.inset-auto`: Sets the inset property to `auto`.
+// - `.inset-full`: Sets the inset property to `100%`.
+// - `.inset-quarter`: Sets the inset property to `25%`.
+// - `.inset-half`: Sets the inset property to `50%`.
+// - `.inset-three-quarters`: Sets the inset property to `75%`.
+// - `.inset-third`: Sets the inset property to `calc(100% / 3)`.
+// - `.inset-two-thirds`: Sets the inset property to `calc(100% / 1.5)`.
+// - `.inset-x-0`: Sets the left and right inset properties to `0`.
+// - `.inset-x-auto`: Sets the left and right inset properties to `auto`.
+// - `.inset-x-full`: Sets the left and right inset properties to `100%`.
+// - `.inset-x-quarter`: Sets the left and right inset properties to `25%`.
+// - `.inset-x-half`: Sets the left and right inset properties to `50%`.
+// - `.inset-x-three-quarters`: Sets the left and right inset properties to `75%`.
+// - `.inset-x-third`: Sets the left and right inset properties to `calc(100% / 3)`.
+// - `.inset-x-two-thirds`: Sets the left and right inset properties to `calc(100% / 1.5)`.
+// - `.inset-y-0`: Sets the top and bottom inset properties to `0`.
+// - `.inset-y-auto`: Sets the top and bottom inset properties to `auto`.
+// - `.inset-y-full`: Sets the top and bottom inset properties to `100%`.
+// - `.inset-y-quarter`: Sets the top and bottom inset properties to `25%`.
+// - `.inset-y-half`: Sets the top and bottom inset properties to `50%`.
+// - `.inset-y-three-quarters`: Sets the top and bottom inset properties to `75%`.
+// - `.inset-y-third`: Sets the top and bottom inset properties to `calc(100% / 3)`.
+// - `.inset-y-two-thirds`: Sets the top and bottom inset properties to `calc(100% / 1.5)`.
+// - `.inset-start-0`: Sets the inline-start inset property to `0`.
+// - `.inset-start-auto`: Sets the inline-start inset property to `auto`.
+// - `.inset-start-full`: Sets the inline-start inset property to `100%`.
+// - `.inset-start-quarter`: Sets the inline-start inset property to `25%`.
+// - `.inset-start-half`: Sets the inline-start inset property to `50%`.
+// - `.inset-start-three-quarters`: Sets the inline-start inset property to `75%`.
+// - `.inset-start-third`: Sets the inline-start inset property to `calc(100% / 3)`.
+// - `.inset-start-two-thirds`: Sets the inline-start inset property to `calc(100% / 1.5)`.
+// - `.inset-end-0`: Sets the inline-end inset property to `0`.
+// - `.inset-end-auto`: Sets the inline-end inset property to `auto`.
+// - `.inset-end-full`: Sets the inline-end inset property to `100%`.
+// - `.inset-end-quarter`: Sets the inline-end inset property to `25%`.
+// - `.inset-end-half`: Sets the inline-end inset property to `50%`.
+// - `.inset-end-three-quarters`: Sets the inline-end inset property to `75%`.
+// - `.inset-end-third`: Sets the inline-end inset property to `calc(100% / 3)`.
+// - `.inset-end-two-thirds`: Sets the inline-end inset property to `calc(100% / 1.5)`.
+// - `.top-0`: Sets the top inset property to `0`.
+// - `.top-auto`: Sets the top inset property to `auto`.
+// - `.top-full`: Sets the top inset property to `100%`.
+// - `.top-quarter`: Sets the top inset property to `25%`.
+// - `.top-half`: Sets the top inset property to `50%`.
+// - `.top-three-quarters`: Sets the top inset property to `75%`.
+// - `.top-third`: Sets the top inset property to `calc(100% / 3)`.
+// - `.top-two-thirds`: Sets the top inset property to `calc(100% / 1.5)`.
+// - `.right-0`: Sets the right inset property to `0`.
+// - `.right-auto`: Sets the right inset property to `auto`.
+// - `.right-full`: Sets the right inset property to `100%`.
+// - `.right-quarter`: Sets the right inset property to `25%`.
+// - `.right-half`: Sets the right inset property to `50%`.
+// - `.right-three-quarters`: Sets the right inset property to `75%`.
+// - `.right-third`: Sets the right inset property to `calc(100% / 3)`.
+// - `.right-two-thirds`: Sets the right inset property to `calc(100% / 1.5)`.
+// - `.bottom-0`: Sets the bottom inset property to `0`.
+// - `.bottom-auto`: Sets the bottom inset property to `auto`.
+// - `.bottom-full`: Sets the bottom inset property to `100%`.
+// - `.bottom-quarter`: Sets the bottom inset property to `25%`.
+// - `.bottom-half`: Sets the bottom inset property to `50%`.
+// - `.bottom-three-quarters`: Sets the bottom inset property to `75%`.
+// - `.bottom-third`: Sets the bottom inset property to `calc(100% / 3)`.
+// - `.bottom-two-thirds`: Sets the bottom inset property to `calc(100% / 1.5)`.
+// - `.left-0`: Sets the left inset property to `0`.
+// - `.left-auto`: Sets the left inset property to `auto`.
+// - `.left-full`: Sets the left inset property to `100%`.
+// - `.left-quarter`: Sets the left inset property to `25%`.
+// - `.left-half`: Sets the left inset property to `50%`.
+// - `.left-three-quarters`: Sets the left inset property to `75%`.
+// - `.left-third`: Sets the left inset property to `calc(100% / 3)`.
+// - `.left-two-thirds`: Sets the left inset property to `calc(100% / 1.5)`.
+//
+// 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.
+// - `$base-inset-properties`: The base properties and values for the inset utility classes.
+// - `$custom-inset-properties`: Additional properties and values for the inset utility classes.
+// - `$inset-properties`: The combined properties and values for the inset utility classes.
+// - `$base-inset-values`: The base inset values.
+// - `$custom-inset-values`: Additional inset values.
+// - `$inset-values`: The combined inset values.
+//
+// Generating responsive utility classes can be done by setting `$screen-aware`, `$theme-aware`, or `$state-aware` to `true`.
+// By default, only screen-aware 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:inset-0` will set the `inset` property to `0` 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:inset-0` will set the `inset` property to `0` 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:inset-0` will set the `inset` property to `0` 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:inset-0` will set the `inset` property to `0` when the parent container is larger than the `md` breakpoint.
+//
+// @example
+//   <div class="inset-0">This element has no inset.</div>
+//
+// @example
+//   <div class="inset-x-auto md:inset-x-0">This element will have auto horizontal inset unless the screen size is `md` or larger.</div>
+
+@use "../../defaults" as root-defaults;
+@use "../../functions/important";
+@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 inset property, create a utility class.
+  @each $type, $property in defaults.$inset-properties {
+    @each $name, $value in defaults.$inset-values {
+      // e.g. `.inset-0` or `.inset-x-full`
+      $selector: #{$selector-prefix}#{$type}-#{$name};
+
+      @include utility.create(
+        $selector,
+        $property,
+        $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 inset property, create a utility class.
+      @each $type, $property in defaults.$inset-properties {
+        @each $name, $value in defaults.$inset-values {
+          // e.g. `.md:inset-0` or `.lg:inset-x-full`
+          $selector: #{$selector-prefix}#{$type}-#{$name};
+
+          @include utility.create(
+            $selector,
+            $property,
+            $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 inset property, create a utility class.
+        @each $type, $property in defaults.$inset-properties {
+          @each $name, $value in defaults.$inset-values {
+            // e.g. `.dark:inset-0` or `.light:inset-x-full`
+            $selector: #{$selector-prefix}#{$type}-#{$name};
+
+            @include utility.create(
+              $selector,
+              $property,
+              $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 inset property, create a utility class.
+      @each $type, $property in defaults.$inset-properties {
+        @each $name, $value in defaults.$inset-values {
+          // e.g. `.hover:inset-0` or `.focus:inset-x-full`
+          $selector: #{$selector-prefix}#{$type}-#{$name};
+
+          @include utility.create(
+            $selector,
+            $property,
+            $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 inset property, create a utility class.
+      @each $type, $property in defaults.$inset-properties {
+        @each $name, $value in defaults.$inset-values {
+          // e.g. `.md:inset-0` or `.lg:inset-x-full`
+          $selector: #{$selector-prefix}#{$type}-#{$name};
+
+          @include utility.create(
+            $selector,
+            $property,
+            $value,
+            $important: defaults.$use-important,
+            $container: $container-name
+          );
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,6 @@
+// @graupl/core inset 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 → packages/core/src}/scss/utilities/justification/_defaults.scss

@@ -1,4 +1,4 @@
-// @graupl/graupl justification utilities default values.
+// @graupl/core justification 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.
@@ -6,10 +6,27 @@
 // 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;
+
 // Justify content properties.
-$justify-content-class-prefix: "justify-content-" !default;
+$justify-content-selector-prefix: "justify-content-" !default;
 $base-justify-content-properties: (
   normal: normal,
   start: flex-start,
@@ -27,7 +44,7 @@ $justify-content-properties: map.merge(
 );
 
 // Justify items properties.
-$justify-items-class-prefix: "justify-items-" !default;
+$justify-items-selector-prefix: "justify-items-" !default;
 $base-justify-items-properties: (
   start: start,
   end: end,
@@ -41,7 +58,7 @@ $justify-items-properties: map.merge(
 );
 
 // Justify self properties.
-$justify-self-class-prefix: "justify-self-" !default;
+$justify-self-selector-prefix: "justify-self-" !default;
 $base-justify-self-properties: (
   auto: auto,
   start: start,
@@ -54,6 +71,3 @@ $justify-self-properties: map.merge(
   $base-justify-self-properties,
   $custom-justify-self-properties
 );
-
-// Responsive utility flag.
-$responsive: false !default;

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

@@ -0,0 +1,333 @@
+// @graupl/core justification utilities styles.
+//
+// This file generates the justification utility classes provided by Graupl.
+//
+// The following classes are generated by default:
+// - `.justify-content-normal`: Sets the justify-content property to `normal`.
+// - `.justify-content-start`: Sets the justify-content property to `flex-start`.
+// - `.justify-content-end`: Sets the justify-content property to `flex-end`.
+// - `.justify-content-center`: Sets the justify-content property to `center`.
+// - `.justify-content-between`: Sets the justify-content property to `space-between`.
+// - `.justify-content-around`: Sets the justify-content property to `space-around`.
+// - `.justify-content-evenly`: Sets the justify-content property to `space-evenly`.
+// - `.justify-content-stretch`: Sets the justify-content property to `stretch`.
+// - `.justify-items-start`: Sets the justify-items property to `start`.
+// - `.justify-items-end`: Sets the justify-items property to `end`.
+// - `.justify-items-center`: Sets the justify-items property to `center`.
+// - `.justify-items-stretch`: Sets the justify-items property to `stretch`.
+// - `.justify-self-auto`: Sets the justify-self property to `auto`.
+// - `.justify-self-start`: Sets the justify-self property to `start`.
+// - `.justify-self-end`: Sets the justify-self property to `end`.
+// - `.justify-self-center`: Sets the justify-self property to `center`.
+// - `.justify-self-stretch`: Sets the justify-self property to `stretch`.
+//
+// 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.
+// - `$justify-content-selector-prefix`: The prefix for the justify-content utility classes.
+// - `$base-justify-content-properties`: The base properties and values for justify-content.
+// - `$custom-justify-content-properties`: The custom properties and values for justify-content.
+// - `$justify-content-properties`: The combined properties and values for justify-content.
+// - `$justify-items-selector-prefix`: The prefix for the justify-items utility classes.
+// - `$base-justify-items-properties`: The base properties and values for justify-items.
+// - `$custom-justify-items-properties`: The custom properties and values for justify-items.
+// - `$justify-items-properties`: The combined properties and values for justify-items.
+// - `$justify-self-selector-prefix`: The prefix for the justify-self utility classes.
+// - `$base-justify-self-properties`: The base properties and values for justify-self.
+// - `$custom-justify-self-properties`: The custom properties and values for justify-self.
+// - `$justify-self-properties`: The combined properties and values for justify-self.
+//
+// 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. `.md:justify-content-normal` will set the `justify-content` property to `normal` on screens equal to or larger than the `md` 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:justify-content-normal` will set the `justify-content` property to `normal` 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:justify-content-normal` will set the `justify-content` property to `normal` 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:justify-content-normal` will set the `justify-content` property to `normal` when the parent container is larger than the `md` breakpoint.
+//
+// @example
+//   <div class="justify-content-normal">This is a normal justify-content element.</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 justify content property, create a utility class.
+  @each $name, $value in defaults.$justify-content-properties {
+    // e.g. `.justify-content-normal` or `.justify-content-center`
+    $selector: #{$selector-prefix}#{defaults.$justify-content-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      justify-content,
+      $value,
+      $important: defaults.$use-important
+    );
+  }
+
+  // For each justify items property, create a utility class.
+  @each $name, $value in defaults.$justify-items-properties {
+    // e.g. `.justify-items-start` or `.justify-items-center`
+    $selector: #{$selector-prefix}#{defaults.$justify-items-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      justify-items,
+      $value,
+      $important: defaults.$use-important
+    );
+  }
+
+  // For each justify self property, create a utility class.
+  @each $name, $value in defaults.$justify-self-properties {
+    // e.g. `.justify-self-auto` or `.justify-self-center`
+    $selector: #{$selector-prefix}#{defaults.$justify-self-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      justify-self,
+      $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 justify content property, create a utility class.
+      @each $name, $value in defaults.$justify-content-properties {
+        // e.g. `.md:justify-content-normal` or `.lg:justify-content-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-content-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-content,
+          $value,
+          $important: defaults.$use-important,
+          $screen: $screen-name
+        );
+      }
+
+      // For each justify items property, create a utility class.
+      @each $name, $value in defaults.$justify-items-properties {
+        // e.g. `.md:justify-items-start` or `.lg:justify-items-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-items-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-items,
+          $value,
+          $important: defaults.$use-important,
+          $screen: $screen-name
+        );
+      }
+
+      // For each justify self property, create a utility class.
+      @each $name, $value in defaults.$justify-self-properties {
+        // e.g. `.md:justify-self-auto` or `.lg:justify-self-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-self-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-self,
+          $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 justify content property, create a utility class.
+        @each $name, $value in defaults.$justify-content-properties {
+          // e.g. `.dark:justify-content-normal` or `.light:justify-content-center`
+          $selector: #{$selector-prefix}#{defaults.$justify-content-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            justify-content,
+            $value,
+            $important: defaults.$use-important,
+            $theme: $theme-name
+          );
+        }
+
+        // For each justify items property, create a utility class.
+        @each $name, $value in defaults.$justify-items-properties {
+          // e.g. `.dark:justify-items-start` or `.light:justify-items-center`
+          $selector: #{$selector-prefix}#{defaults.$justify-items-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            justify-items,
+            $value,
+            $important: defaults.$use-important,
+            $theme: $theme-name
+          );
+        }
+
+        // For each justify self property, create a utility class.
+        @each $name, $value in defaults.$justify-self-properties {
+          // e.g. `.dark:justify-self-auto` or `.light:justify-self-center`
+          $selector: #{$selector-prefix}#{defaults.$justify-self-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            justify-self,
+            $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 justify content property, create a utility class.
+      @each $name, $value in defaults.$justify-content-properties {
+        // e.g. `.hover:justify-content-normal` or `.focus:justify-content-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-content-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-content,
+          $value,
+          $important: defaults.$use-important,
+          $state: $state-name
+        );
+      }
+
+      // For each justify items property, create a utility class.
+      @each $name, $value in defaults.$justify-items-properties {
+        // e.g. `.hover:justify-items-start` or `.focus:justify-items-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-items-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-items,
+          $value,
+          $important: defaults.$use-important,
+          $state: $state-name
+        );
+      }
+
+      // For each justify self property, create a utility class.
+      @each $name, $value in defaults.$justify-self-properties {
+        // e.g. `.hover:justify-self-auto` or `.focus:justify-self-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-self-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-self,
+          $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 justify content property, create a utility class.
+      @each $name, $value in defaults.$justify-content-properties {
+        // e.g. `.md:justify-content-normal` or `.lg:justify-content-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-content-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-content,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+
+      // For each justify items property, create a utility class.
+      @each $name, $value in defaults.$justify-items-properties {
+        // e.g. `.md:justify-items-start` or `.lg:justify-items-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-items-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-items,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+
+      // For each justify self property, create a utility class.
+      @each $name, $value in defaults.$justify-self-properties {
+        // e.g. `.md:justify-self-auto` or `.lg:justify-self-center`
+        $selector: #{$selector-prefix}#{defaults.$justify-self-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          justify-self,
+          $value,
+          $important: defaults.$use-important,
+          $container: $container-name
+        );
+      }
+    }
+  }
+}

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

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