@graupl/graupl 1.0.0-alpha.1 → 1.0.0-alpha.3

package/scss/state/focus/_variables.scss

@@ -1,13 +1,13 @@
 // Variables referencing custom properties.
 
 @use "../../variables" as base;
-@use "../../theme/variables" as theme;
 @use "defaults";
+@use "../../functions/theme";
 
 $focus-width: var(--#{defaults.$prefix}-focus-width, #{base.$border-width});
 $focus-outline-color: var(
   --#{defaults.$prefix}-focus-outline-color,
-  #{theme.$theme-active--dark}
+  #{theme.get(primary, 900)}
 );
 $focus-outline-width: var(
   --#{defaults.$prefix}-focus-outline-width,
@@ -23,7 +23,7 @@ $focus-outline-offset: var(
 );
 $focus-box-shadow-color: var(
   --#{defaults.$prefix}-focus-box-shadow-color,
-  #{theme.$theme-active--light}
+  #{theme.get(primary, 100)}
 );
 $focus-box-shadow-style: var(
   --#{defaults.$prefix}-focus-box-shadow-style,

package/scss/theme/_defaults.scss

@@ -8,38 +8,55 @@
 @forward "../defaults";
 
 // Colours.
-$primary: (
-  100: hsl(219deg 100% 95%),
-  200: hsl(219deg 90% 80%),
-  300: hsl(219deg 80% 65%),
-  400: hsl(219deg 75% 55%),
-  500: hsl(219deg 75% 50%),
-  600: hsl(219deg 75% 45%),
-  700: hsl(219deg 80% 35%),
-  800: hsl(219deg 90% 20%),
-  900: hsl(219deg 100% 10%),
+$default-colors: (
+  primary: (
+    100: hsl(219deg 100% 95%),
+    200: hsl(219deg 90% 80%),
+    300: hsl(219deg 80% 65%),
+    400: hsl(219deg 75% 55%),
+    500: hsl(219deg 75% 50%),
+    600: hsl(219deg 75% 45%),
+    700: hsl(219deg 80% 35%),
+    800: hsl(219deg 90% 20%),
+    900: hsl(219deg 100% 10%),
+  ),
+  secondary: (
+    100: hsl(235deg 40% 95%),
+    200: hsl(235deg 30% 80%),
+    300: hsl(235deg 20% 65%),
+    400: hsl(235deg 15% 55%),
+    500: hsl(235deg 15% 50%),
+    600: hsl(235deg 15% 45%),
+    700: hsl(235deg 20% 35%),
+    800: hsl(235deg 30% 20%),
+    900: hsl(235deg 40% 10%),
+  ),
+  tertiary: (
+    100: hsl(340deg 85% 95%),
+    200: hsl(340deg 75% 80%),
+    300: hsl(340deg 65% 65%),
+    400: hsl(340deg 60% 55%),
+    500: hsl(340deg 60% 50%),
+    600: hsl(340deg 60% 45%),
+    700: hsl(340deg 65% 35%),
+    800: hsl(340deg 75% 20%),
+    900: hsl(340deg 85% 10%),
+  ),
 ) !default;
-$secondary: (
-  100: hsl(235deg 40% 95%),
-  200: hsl(235deg 30% 80%),
-  300: hsl(235deg 20% 65%),
-  400: hsl(235deg 15% 55%),
-  500: hsl(235deg 15% 50%),
-  600: hsl(235deg 15% 45%),
-  700: hsl(235deg 20% 35%),
-  800: hsl(235deg 30% 20%),
-  900: hsl(235deg 40% 10%),
-) !default;
-$tertiary: (
-  100: hsl(340deg 85% 95%),
-  200: hsl(340deg 75% 80%),
-  300: hsl(340deg 65% 65%),
-  400: hsl(340deg 60% 55%),
-  500: hsl(340deg 60% 50%),
-  600: hsl(340deg 60% 45%),
-  700: hsl(340deg 65% 35%),
-  800: hsl(340deg 75% 20%),
-  900: hsl(340deg 85% 10%),
+$custom-colors: () !default;
+$colors: map.merge($default-colors, $custom-colors) !default;
+
+// A map for reversing the shade values of the dark theme.
+$dark-map: (
+  100: 900,
+  200: 800,
+  300: 700,
+  400: 600,
+  500: 500,
+  600: 400,
+  700: 300,
+  800: 200,
+  900: 100,
 ) !default;
 
 // Font properties.

package/scss/theme/_index.scss

@@ -4,49 +4,34 @@
 @use "../mixins/layer" as *;
 @use "defaults";
 @use "sass:map";
+@use "../functions/theme";
 
 @include layer(theme) {
   :root {
-    background: $theme-active--light;
-    color: $theme-active--dark;
+    background: theme.get(primary, 100);
+    color: theme.get(primary, 900);
     font-family: $font-family;
     font-size: $font-size;
   }
 
   // Set the active theme for dark mode.
   .dark-mode {
-    --#{defaults.$prefix}-theme-active--primary: #{$theme-dark--primary};
-    --#{defaults.$prefix}-theme-active--primary--dark: #{$theme-dark--primary--dark};
-    --#{defaults.$prefix}-theme-active--primary--light: #{$theme-dark--primary--light};
-    --#{defaults.$prefix}-theme-active--secondary: #{$theme-dark--secondary};
-    --#{defaults.$prefix}-theme-active--secondary--dark: #{$theme-dark--secondary--dark};
-    --#{defaults.$prefix}-theme-active--secondary--light: #{$theme-dark--secondary--light};
-    --#{defaults.$prefix}-theme-active--tertiary: #{$theme-dark--tertiary};
-    --#{defaults.$prefix}-theme-active--tertiary--dark: #{$theme-dark--tertiary--dark};
-    --#{defaults.$prefix}-theme-active--tertiary--light: #{$theme-dark--tertiary--light};
-    --#{defaults.$prefix}-theme-active--light: #{$theme-dark--light};
-    --#{defaults.$prefix}-theme-active--dark: #{$theme-dark--dark};
-    --#{defaults.$prefix}-theme-active--shade--light: #{$theme-dark--shade--light};
-    --#{defaults.$prefix}-theme-active--shade--dark: #{$theme-dark--shade--dark};
+    @each $color, $map in $theme-dark {
+      @each $shade, $value in $map {
+        --#{defaults.$prefix}-theme-active--#{$color}--#{$shade}: #{$value};
+      }
+    }
 
     color-scheme: dark;
   }
 
   // Set the active theme for light mode.
   .light-mode {
-    --#{defaults.$prefix}-theme-active--primary: #{$theme-light--primary};
-    --#{defaults.$prefix}-theme-active--primary--dark: #{$theme-light--primary--dark};
-    --#{defaults.$prefix}-theme-active--primary--light: #{$theme-light--primary--light};
-    --#{defaults.$prefix}-theme-active--secondary: #{$theme-light--secondary};
-    --#{defaults.$prefix}-theme-active--secondary--dark: #{$theme-light--secondary--dark};
-    --#{defaults.$prefix}-theme-active--secondary--light: #{$theme-light--secondary--light};
-    --#{defaults.$prefix}-theme-active--tertiary: #{$theme-light--tertiary};
-    --#{defaults.$prefix}-theme-active--tertiary--dark: #{$theme-light--tertiary--dark};
-    --#{defaults.$prefix}-theme-active--tertiary--light: #{$theme-light--tertiary--light};
-    --#{defaults.$prefix}-theme-active--light: #{$theme-light--light};
-    --#{defaults.$prefix}-theme-active--dark: #{$theme-light--dark};
-    --#{defaults.$prefix}-theme-active--shade--light: #{$theme-light--shade--light};
-    --#{defaults.$prefix}-theme-active--shade--dark: #{$theme-light--shade--dark};
+    @each $color, $map in $theme-light {
+      @each $shade, $value in $map {
+        --#{defaults.$prefix}-theme-active--#{$color}--#{$shade}: #{$value};
+      }
+    }
 
     color-scheme: light;
   }

package/scss/theme/_variables.scss

@@ -3,294 +3,108 @@
 @use "defaults";
 @use "sass:map";
 
-// Primary theme colours.
-$primary: (
-  100:
-    var(--#{defaults.$prefix}-primary--100, #{map.get(defaults.$primary, 100)}),
-  200:
-    var(--#{defaults.$prefix}-primary--200, #{map.get(defaults.$primary, 200)}),
-  300:
-    var(--#{defaults.$prefix}-primary--300, #{map.get(defaults.$primary, 300)}),
-  400:
-    var(--#{defaults.$prefix}-primary--400, #{map.get(defaults.$primary, 400)}),
-  500:
-    var(--#{defaults.$prefix}-primary--500, #{map.get(defaults.$primary, 500)}),
-  600:
-    var(--#{defaults.$prefix}-primary--600, #{map.get(defaults.$primary, 600)}),
-  700:
-    var(--#{defaults.$prefix}-primary--700, #{map.get(defaults.$primary, 700)}),
-  800:
-    var(--#{defaults.$prefix}-primary--800, #{map.get(defaults.$primary, 800)}),
-  900:
-    var(--#{defaults.$prefix}-primary--900, #{map.get(defaults.$primary, 900)}),
-);
+// A colour map of base colours and their shades.
+$colors: ();
 
-// Secondary theme colours.
-$secondary: (
-  100:
-    var(
-      --#{defaults.$prefix}-secondary--100,
-      #{map.get(defaults.$secondary, 100)}
-    ),
-  200:
-    var(
-      --#{defaults.$prefix}-secondary--200,
-      #{map.get(defaults.$secondary, 200)}
-    ),
-  300:
-    var(
-      --#{defaults.$prefix}-secondary--300,
-      #{map.get(defaults.$secondary, 300)}
-    ),
-  400:
-    var(
-      --#{defaults.$prefix}-secondary--400,
-      #{map.get(defaults.$secondary, 400)}
-    ),
-  500:
-    var(
-      --#{defaults.$prefix}-secondary--500,
-      #{map.get(defaults.$secondary, 500)}
-    ),
-  600:
-    var(
-      --#{defaults.$prefix}-secondary--600,
-      #{map.get(defaults.$secondary, 600)}
-    ),
-  700:
-    var(
-      --#{defaults.$prefix}-secondary--700,
-      #{map.get(defaults.$secondary, 700)}
-    ),
-  800:
-    var(
-      --#{defaults.$prefix}-secondary--800,
-      #{map.get(defaults.$secondary, 800)}
-    ),
-  900:
-    var(
-      --#{defaults.$prefix}-secondary--900,
-      #{map.get(defaults.$secondary, 900)}
-    ),
-);
+// Create a map for each colour.
+@each $color, $map in defaults.$colors {
+  // A map for the current colour.
+  $color-map: ();
 
-// Tertiary theme colours.
-$tertiary: (
-  100:
-    var(
-      --#{defaults.$prefix}-tertiary--100,
-      #{map.get(defaults.$tertiary, 100)}
-    ),
-  200:
-    var(
-      --#{defaults.$prefix}-tertiary--200,
-      #{map.get(defaults.$tertiary, 200)}
-    ),
-  300:
-    var(
-      --#{defaults.$prefix}-tertiary--300,
-      #{map.get(defaults.$tertiary, 300)}
-    ),
-  400:
-    var(
-      --#{defaults.$prefix}-tertiary--400,
-      #{map.get(defaults.$tertiary, 400)}
-    ),
-  500:
-    var(
-      --#{defaults.$prefix}-tertiary--500,
-      #{map.get(defaults.$tertiary, 500)}
-    ),
-  600:
-    var(
-      --#{defaults.$prefix}-tertiary--600,
-      #{map.get(defaults.$tertiary, 600)}
-    ),
-  700:
-    var(
-      --#{defaults.$prefix}-tertiary--700,
-      #{map.get(defaults.$tertiary, 700)}
-    ),
-  800:
-    var(
-      --#{defaults.$prefix}-tertiary--800,
-      #{map.get(defaults.$tertiary, 800)}
-    ),
-  900:
-    var(
-      --#{defaults.$prefix}-tertiary--900,
-      #{map.get(defaults.$tertiary, 900)}
-    ),
-);
+  @each $shade, $value in $map {
+    // Set the custom prop name and fallback value.
+    $color-property: var(--#{defaults.$prefix}-#{$color}--#{$shade}, $value);
 
-// Theme colours.
-// Colour primary.
-$theme-light--primary: var(
-  --#{defaults.$prefix}-theme-light--primary,
-  #{map.get($primary, 700)}
-);
-$theme-light--primary--dark: var(
-  --#{defaults.$prefix}-theme-light--primary--dark,
-  #{map.get($primary, 800)}
-);
-$theme-light--primary--light: var(
-  --#{defaults.$prefix}-theme-light--primary--light,
-  #{map.get($primary, 600)}
-);
-$theme-dark--primary: var(
-  --#{defaults.$prefix}-theme-dark--primary,
-  #{map.get($primary, 300)}
-);
-$theme-dark--primary--dark: var(
-  --#{defaults.$prefix}-theme-dark--primary--dark,
-  #{map.get($primary, 200)}
-);
-$theme-dark--primary--light: var(
-  --#{defaults.$prefix}-theme-dark--primary--light,
-  #{map.get($primary, 400)}
-);
-$theme-active--primary: var(
-  --#{defaults.$prefix}-theme-active--primary,
-  #{$theme-light--primary}
-);
-$theme-active--primary--dark: var(
-  --#{defaults.$prefix}-theme-active--primary--dark,
-  #{$theme-light--primary--dark}
-);
-$theme-active--primary--light: var(
-  --#{defaults.$prefix}-theme-active--primary--light,
-  #{$theme-light--primary--light}
-);
+    // Add the custom prop to the map.
+    $color-map: map.merge(
+      $color-map,
+      (
+        $shade: $color-property,
+      )
+    );
+  }
 
-// Color secondary.
-$theme-light--secondary: var(
-  --#{defaults.$prefix}-theme-light--secondary,
-  #{map.get($secondary, 700)}
-);
-$theme-light--secondary--dark: var(
-  --#{defaults.$prefix}-theme-light--secondary--dark,
-  #{map.get($secondary, 800)}
-);
-$theme-light--secondary--light: var(
-  --#{defaults.$prefix}-theme-light--secondary--light,
-  #{map.get($secondary, 600)}
-);
-$theme-dark--secondary: var(
-  --#{defaults.$prefix}-theme-dark--secondary,
-  #{map.get($secondary, 300)}
-);
-$theme-dark--secondary--dark: var(
-  --#{defaults.$prefix}-theme-dark--secondary--dark,
-  #{map.get($secondary, 200)}
-);
-$theme-dark--secondary--light: var(
-  --#{defaults.$prefix}-theme-dark--secondary--light,
-  #{map.get($secondary, 400)}
-);
-$theme-active--secondary: var(
-  --#{defaults.$prefix}-theme-active--secondary,
-  #{$theme-light--secondary}
-);
-$theme-active--secondary--dark: var(
-  --#{defaults.$prefix}-theme-active--secondary--dark,
-  #{$theme-light--secondary--dark}
-);
-$theme-active--secondary--light: var(
-  --#{defaults.$prefix}-theme-active--secondary--light,
-  #{$theme-light--secondary--light}
-);
+  // Merge the colour map with the existing colours.
+  $colors: map.merge(
+    $colors,
+    (
+      $color: $color-map,
+    )
+  );
+}
 
-// Colour tertiary.
-$theme-light--tertiary: var(
-  --#{defaults.$prefix}-theme-light--tertiary,
-  #{map.get($tertiary, 700)}
-);
-$theme-light--tertiary--dark: var(
-  --#{defaults.$prefix}-theme-light--tertiary--dark,
-  #{map.get($tertiary, 800)}
-);
-$theme-light--tertiary--light: var(
-  --#{defaults.$prefix}-theme-light--tertiary--light,
-  #{map.get($tertiary, 600)}
-);
-$theme-dark--tertiary: var(
-  --#{defaults.$prefix}-theme-dark--tertiary,
-  #{map.get($tertiary, 300)}
-);
-$theme-dark--tertiary--dark: var(
-  --#{defaults.$prefix}-theme-dark--tertiary--dark,
-  #{map.get($tertiary, 200)}
-);
-$theme-dark--tertiary--light: var(
-  --#{defaults.$prefix}-theme-dark--tertiary--light,
-  #{map.get($tertiary, 400)}
-);
-$theme-active--tertiary: var(
-  --#{defaults.$prefix}-theme-active--tertiary,
-  #{$theme-light--tertiary}
-);
-$theme-active--tertiary--dark: var(
-  --#{defaults.$prefix}-theme-active--tertiary--dark,
-  #{$theme-light--tertiary--dark}
-);
-$theme-active--tertiary--light: var(
-  --#{defaults.$prefix}-theme-active--tertiary--light,
-  #{$theme-light--tertiary--light}
-);
+// Theme properties.
+$theme-light: ();
+$theme-dark: ();
+$theme-active: ();
 
-// Colour light.
-$theme-light--light: var(
-  --#{defaults.$prefix}-theme-light--light,
-  #{map.get($primary, 100)}
-);
-$theme-dark--light: var(
-  --#{defaults.$prefix}-theme-dark--light,
-  #{map.get($primary, 900)}
-);
-$theme-active--light: var(
-  --#{defaults.$prefix}-theme-active--light,
-  #{$theme-light--light}
-);
+// Create a map for each colour theme.
+@each $color, $map in $colors {
+  // Maps for the current colour theme variants.
+  $light-map: ();
+  $dark-map: ();
+  $active-map: ();
 
-// Colour dark.
-$theme-light--dark: var(
-  --#{defaults.$prefix}-theme-light--dark,
-  #{map.get($primary, 900)}
-);
-$theme-dark--dark: var(
-  --#{defaults.$prefix}-theme-dark--dark,
-  #{map.get($primary, 100)}
-);
-$theme-active--dark: var(
-  --#{defaults.$prefix}-theme-active--dark,
-  #{$theme-light--dark}
-);
+  @each $shade, $value in $map {
+    // Get the dark shade and value.
+    $dark-shade: map.get(defaults.$dark-map, $shade);
+    $dark-value: map.get($map, $dark-shade);
 
-// Colour shade.
-$theme-light--shade--light: var(
-  --#{defaults.$prefix}-theme-light--shade--light,
-  #{map.get($primary, 200)}
-);
-$theme-light--shade--dark: var(
-  --#{defaults.$prefix}-theme-light--shade--dark,
-  #{map.get($primary, 300)}
-);
-$theme-dark--shade--light: var(
-  --#{defaults.$prefix}-theme-dark--shade--light,
-  #{map.get($primary, 800)}
-);
-$theme-dark--shade--dark: var(
-  --#{defaults.$prefix}-theme-dark--shade--dark,
-  #{map.get($primary, 700)}
-);
-$theme-active--shade--light: var(
-  --#{defaults.$prefix}-theme-active--shade--light,
-  #{$theme-light--shade--light}
-);
-$theme-active--shade--dark: var(
-  --#{defaults.$prefix}-theme-active--shade--dark,
-  #{$theme-light--shade--dark}
-);
+    // Set the custom prop names and fallback values.
+    $light-property: var(
+      --#{defaults.$prefix}-theme-light--#{$color}--#{$shade},
+      $value
+    );
+    $dark-property: var(
+      --#{defaults.$prefix}-theme-dark--#{$color}--#{$shade},
+      $dark-value
+    );
+    $active-property: var(
+      --#{defaults.$prefix}-theme-active--#{$color}--#{$shade},
+      $light-property
+    );
+
+    // Add the custom props to the maps.
+    $light-map: map.merge(
+      $light-map,
+      (
+        $shade: $light-property,
+      )
+    );
+    $dark-map: map.merge(
+      $dark-map,
+      (
+        $shade: $dark-property,
+      )
+    );
+    $active-map: map.merge(
+      $active-map,
+      (
+        $shade: $active-property,
+      )
+    );
+  }
+
+  // Merge the theme maps with the existing themes.
+  $theme-light: map.merge(
+    $theme-light,
+    (
+      $color: $light-map,
+    )
+  );
+  $theme-dark: map.merge(
+    $theme-dark,
+    (
+      $color: $dark-map,
+    )
+  );
+  $theme-active: map.merge(
+    $theme-active,
+    (
+      $color: $active-map,
+    )
+  );
+}
 
 // Font properties.
 $font-family: var(--#{defaults.$prefix}-font-family, #{defaults.$font-family});

package/scss/utilities/_index.scss

@@ -0,0 +1,3 @@
+// Graupl utilities.
+
+@forward "colors";

package/scss/utilities/colors/_defaults.scss

@@ -0,0 +1,7 @@
+// Default values for Graupl.
+//
+// Generally, these should not be used directly when styling components.
+// They are mainly used to provide default fallbacks for custom properties
+// which can be found in the `variables.scss` file.
+
+@forward "../../defaults";

package/scss/utilities/colors/_index.scss

@@ -0,0 +1,22 @@
+// Graupl color utilities.
+
+@use "variables" as *;
+@use "../../mixins/layer" as *;
+@use "../../functions/important";
+@use "../../theme/variables" as theme;
+
+@include layer(utilities) {
+  @each $color, $map in theme.$theme-active {
+    @each $shade, $value in $map {
+      $name: #{$color}-#{$shade};
+
+      .background-#{$name} {
+        background: important.insert($value);
+      }
+
+      .color-#{$name} {
+        color: important.insert($value);
+      }
+    }
+  }
+}

package/scss/utilities/colors/_variables.scss

@@ -0,0 +1,3 @@
+// Variables referencing custom properties.
+
+@forward "defaults";

package/scss/utilities/colors/colors.scss

@@ -0,0 +1,3 @@
+// Graupl color utilities.
+
+@forward "index";