@graupl/graupl 1.0.0-alpha.12 → 1.0.0-alpha.13

package/src/scss/component/navigation/_variables.scss

@@ -0,0 +1,237 @@
+// @graupl/graupl navigation component variables.
+//
+// These values are to be used to directly style components and provide a
+// cleaner way to reference custom properties.
+
+@use "defaults";
+@use "../../defaults" as root-defaults;
+@use "../../variables" as root-variables;
+@use "../../theme/color/variables" as color;
+@use "../../theme/typography/variables" as typography;
+@use "sass:map";
+
+// Navigation colors.
+$navigation-background: var(
+  --#{root-defaults.$prefix}-navigation-background,
+  #{color.$root-background}
+);
+$navigation-color: var(
+  --#{root-defaults.$prefix}-navigation-color,
+  #{color.$root-color}
+);
+
+// Navigation toggle size.
+$navigation-toggle-min-width: var(
+  --#{root-defaults.$prefix}-navigation-toggle-min-width,
+  #{root-defaults.$interactive-min-width}
+);
+$navigation-toggle-min-height: var(
+  --#{root-defaults.$prefix}-navigation-toggle-min-height,
+  #{root-defaults.$interactive-min-height}
+);
+
+// Navigation toggle spacing.
+$navigation-toggle-padding-x: var(
+  --#{root-defaults.$prefix}-navigation-toggle-padding-x,
+  #{map.get(root-variables.$spacers, 5)}
+);
+$navigation-toggle-padding-y: var(
+  --#{root-defaults.$prefix}-navigation-toggle-padding-y,
+  #{map.get(root-variables.$spacers, 3)}
+);
+$navigation-toggle-padding: var(
+  --#{root-defaults.$prefix}-navigation-toggle-padding,
+  #{$navigation-toggle-padding-y} #{$navigation-toggle-padding-x}
+);
+
+// Navigation toggle colors.
+$navigation-toggle-background: var(
+  --#{root-defaults.$prefix}-navigation-toggle-background,
+  #{$navigation-background}
+);
+$navigation-toggle-color: var(
+  --#{root-defaults.$prefix}-navigation-toggle-color,
+  #{$navigation-color}
+);
+$navigation-toggle-hover-background: var(
+  --#{root-defaults.$prefix}-navigation-toggle-hover-background,
+  #{$navigation-color}
+);
+$navigation-toggle-hover-color: var(
+  --#{root-defaults.$prefix}-navigation-toggle-hover-color,
+  #{$navigation-background}
+);
+
+// Navigation toggle border properties.
+$navigation-toggle-border-width: var(
+  --#{root-defaults.$prefix}-navigation-toggle-border-width,
+  #{root-variables.$border-width}
+);
+$navigation-toggle-border-style: var(
+  --#{root-defaults.$prefix}-navigation-toggle-border-style,
+  #{root-variables.$border-style}
+);
+$navigation-toggle-border: var(
+  --#{root-defaults.$prefix}-navigation-toggle-border,
+  #{$navigation-toggle-border-width} #{$navigation-toggle-border-style}
+);
+$navigation-toggle-border-color: var(
+  --#{root-defaults.$prefix}-navigation-toggle-border-color,
+  #{$navigation-toggle-color}
+);
+$navigation-toggle-border-radius: var(
+  --#{root-defaults.$prefix}-navigation-toggle-border-radius,
+  #{root-variables.$border-radius}
+);
+
+// Navigation branding properties.
+$navigation-branding-font-size: var(
+  --#{root-defaults.$prefix}-navigation-branding-font-size,
+  #{map.get(typography.$font-sizes, "lg")}
+);
+$navigation-branding-font-weight: var(
+  --#{root-defaults.$prefix}-navigation-branding-font-weight,
+  #{typography.$font-weight-bold}
+);
+$navigation-branding-padding-x: var(
+  --#{root-defaults.$prefix}-navigation-branding-padding-x,
+  #{map.get(root-variables.$spacers, 3)}
+);
+$navigation-branding-padding-y: var(
+  --#{root-defaults.$prefix}-navigation-branding-padding-y,
+  #{map.get(root-variables.$spacers, 2)}
+);
+$navigation-branding-padding: var(
+  --#{root-defaults.$prefix}-navigation-branding-padding,
+  #{$navigation-branding-padding-y} #{$navigation-branding-padding-x}
+);
+
+// Navigation branding colors.
+$navigation-branding-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-color,
+  #{$navigation-color}
+);
+$navigation-branding-visited-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-visited-color,
+  #{$navigation-color}
+);
+$navigation-branding-focus-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-focus-color,
+  #{$navigation-color}
+);
+$navigation-branding-hover-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-hover-color,
+  #{$navigation-color}
+);
+$navigation-branding-active-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-active-color,
+  #{$navigation-color}
+);
+$navigation-branding-disabled-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-disabled-color,
+  #{$navigation-color}
+);
+
+// Navigation branding text decoration properties.
+$navigation-branding-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-text-decoration,
+  #{defaults.$navigation-branding-text-decoration}
+);
+$navigation-branding-visited-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-visited-text-decoration,
+  #{defaults.$navigation-branding-visited-text-decoration}
+);
+$navigation-branding-focus-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-focus-text-decoration,
+  #{defaults.$navigation-branding-focus-text-decoration}
+);
+$navigation-branding-hover-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-hover-text-decoration,
+  #{defaults.$navigation-branding-hover-text-decoration}
+);
+$navigation-branding-active-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-active-text-decoration,
+  #{defaults.$navigation-branding-active-text-decoration}
+);
+$navigation-branding-disabled-text-decoration: var(
+  --#{root-defaults.$prefix}-navigation-branding-disabled-text-decoration,
+  #{defaults.$navigation-branding-disabled-text-decoration}
+);
+$navigation-branding-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-text-decoration-style,
+  #{defaults.$navigation-branding-text-decoration-style}
+);
+$navigation-branding-visited-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-visited-text-decoration-style,
+  #{defaults.$navigation-branding-visited-text-decoration-style}
+);
+$navigation-branding-focus-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-focus-text-decoration-style,
+  #{defaults.$navigation-branding-focus-text-decoration-style}
+);
+$navigation-branding-hover-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-hover-text-decoration-style,
+  #{defaults.$navigation-branding-hover-text-decoration-style}
+);
+$navigation-branding-active-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-active-text-decoration-style,
+  #{defaults.$navigation-branding-active-text-decoration-style}
+);
+$navigation-branding-disabled-text-decoration-style: var(
+  --#{root-defaults.$prefix}-navigation-branding-disabled-text-decoration-style,
+  #{defaults.$navigation-branding-disabled-text-decoration-style}
+);
+$navigation-branding-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-visited-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-visited-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-focus-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-focus-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-hover-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-hover-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-active-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-active-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-disabled-text-decoration-thickness: var(
+  --#{root-defaults.$prefix}-navigation-branding-disabled-text-decoration-thickness,
+  #{root-variables.$border-width}
+);
+$navigation-branding-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-text-decoration-color,
+  #{$navigation-branding-color}
+);
+$navigation-branding-visited-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-visited-text-decoration-color,
+  #{$navigation-branding-visited-color}
+);
+$navigation-branding-focus-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-focus-text-decoration-color,
+  #{$navigation-branding-focus-color}
+);
+$navigation-branding-hover-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-hover-text-decoration-color,
+  #{$navigation-branding-hover-color}
+);
+$navigation-branding-active-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-active-text-decoration-color,
+  #{$navigation-branding-active-color}
+);
+$navigation-branding-disabled-text-decoration-color: var(
+  --#{root-defaults.$prefix}-navigation-branding-disabled-text-decoration-color,
+  #{$navigation-branding-disabled-color}
+);
+
+// Navigation toggle properties.
+$navigation-toggle-content: var(
+  --#{root-defaults.$prefix}-navigation-toggle-content,
+  #{defaults.$navigation-toggle-content}
+);

package/src/scss/functions/_theme.scss

@@ -7,6 +7,22 @@
 
 // A function to get the specific theme shades.
 @function get($color, $shade) {
+  @if $shade == transparent or $color == transparent {
+    @return transparent;
+  }
+
+  @if $shade == none or $color == none {
+    @return none;
+  }
+
+  @if $shade == inherit or $color == inherit {
+    @return inherit;
+  }
+
+  @if $shade == initial or $color == initial {
+    @return initial;
+  }
+
   $color-map: map.get(color.$theme-active, $color);
   $value: map.get($color-map, $shade);
 

package/src/scss/layout/_index.scss

@@ -2,3 +2,4 @@
 
 @forward "container";
 @forward "columns";
+@forward "flex-columns";

package/src/scss/layout/columns/_index.scss

@@ -20,6 +20,14 @@
   @for $i from defaults.$columns-min-count through defaults.$columns-max-count {
     #{defaults.$columns-count-selector-prefix}#{$i} {
       --#{root-defaults.$prefix}-columns-count: #{$i};
+
+      // For span values bigger than the actual column count, set them to the
+      // maximum column count so they don't break the layout.
+      @for $j from $i + 1 through defaults.$columns-max-count {
+        #{defaults.$columns-span-selector-prefix}#{$j} {
+          --#{root-defaults.$prefix}-columns-span: #{$i};
+        }
+      }
     }
 
     #{defaults.$columns-span-selector-prefix}#{$i} {
@@ -31,6 +39,20 @@
   @include screen(xs) {
     #{defaults.$columns-selector} {
       --#{root-defaults.$prefix}-columns-min-width: #{defaults.$columns-max-width};
+
+      > * {
+        --#{root-defaults.$prefix}-columns-span: 1;
+      }
+
+      // All spans should be set to 1 to avoid adding columns.
+      @for $i
+        from defaults.$columns-min-count
+        through defaults.$columns-max-count
+      {
+        #{defaults.$columns-span-selector-prefix}#{$i} {
+          --#{root-defaults.$prefix}-columns-span: 1;
+        }
+      }
     }
   }
 }

package/src/scss/layout/flex-columns/_defaults.scss

@@ -0,0 +1,18 @@
+// @graupl/graupl flex columns layout 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.
+
+// Flex columns selectors.
+$flex-columns-selector: ".flex-columns" !default;
+$flex-columns-column-selector-prefix: ".col-" !default;
+$flex-columns-fill-selector: ".fill" !default;
+
+// Flex columns properties.
+$flex-columns-min-count: 1 !default;
+$flex-columns-max-count: 12 !default;
+$flex-columns-size: auto !default;
+$flex-columns-max-width: unset !default;

package/src/scss/layout/flex-columns/_index.scss

@@ -0,0 +1,77 @@
+// @gruapl/graupl flex columns layout styles.
+
+@use "variables" as *;
+@use "defaults";
+@use "../../defaults" as root-defaults;
+@use "../../mixins/layer" as *;
+@use "../../mixins/media-queries" as *;
+
+@include layer(layout) {
+  // Flex columns.
+  #{defaults.$flex-columns-selector} {
+    display: flex;
+    flex-wrap: wrap;
+    gap: $flex-columns-row-gap $flex-columns-column-gap;
+
+    > * {
+      flex: 1 1 $flex-columns-size;
+      max-width: $flex-columns-max-width;
+    }
+
+    #{defaults.$flex-columns-fill-selector} {
+      --#{root-defaults.$prefix}-flex-columns-max-width: unset;
+    }
+  }
+
+  @for $i
+    from defaults.$flex-columns-min-count
+    through defaults.$flex-columns-max-count
+  {
+    #{defaults.$flex-columns-column-selector-prefix}#{$i} {
+      /* stylelint-disable scss/operator-no-newline-after -- Prettier wants to format it this way. */
+      --#{root-defaults.$prefix}-flex-columns-size: calc(
+        (100% / #{defaults.$flex-columns-max-count} * #{$i}) -
+          #{$flex-columns-column-gap}
+      );
+      --#{root-defaults.$prefix}-flex-columns-max-width: calc(
+        100% / #{defaults.$flex-columns-max-count} * #{$i}
+      );
+      /* stylelint-enable  scss/operator-no-newline-after */
+    }
+
+    @include screen(xs) {
+      #{defaults.$flex-columns-column-selector-prefix}#{$i} {
+        --#{root-defaults.$prefix}-flex-columns-size: 100%;
+        --#{root-defaults.$prefix}-flex-columns-max-width: auto;
+      }
+    }
+  }
+
+  @each $screen, $query in root-defaults.$screen-sizes {
+    @for $i
+      from defaults.$flex-columns-min-count
+      through defaults.$flex-columns-max-count
+    {
+      // For the screen-specific sizes, we can't use custom properties.
+      // It appears that custom properties that are already set, cannot be overwritten
+      // inside of a media query.
+      //
+      // If you do something like `.col-6 .col-lg-3`, the custom properties will only ever
+      // be set to the `.col-6` value.
+      @include screen($screen) {
+        #{defaults.$flex-columns-column-selector-prefix}#{$screen}-#{$i} {
+          --#{root-defaults.$prefix}-flex-columns-size: calc(
+            (100% / #{defaults.$flex-columns-max-count} * #{$i}) - #{$flex-columns-column-gap}
+          );
+          --#{root-defaults.$prefix}-flex-columns-max-width: calc(
+            100% / #{defaults.$flex-columns-max-count} * #{$i}
+          );
+
+          &#{defaults.$flex-columns-fill-selector} {
+            --#{root-defaults.$prefix}-flex-columns-max-width: unset;
+          }
+        }
+      }
+    }
+  }
+}

package/src/scss/layout/flex-columns/_variables.scss

@@ -0,0 +1,26 @@
+// @graupl/graupl flex columns layout variables.
+//
+// These values are to be used to directly style components and provide a
+// cleaner way to reference custom properties.
+
+@use "defaults";
+@use "../../defaults" as root-defaults;
+@use "../columns/variables" as columns-variables;
+
+// Flex columns properties.
+$flex-columns-row-gap: var(
+  --#{root-defaults.$prefix}-flex-columns-row-gap,
+  #{columns-variables.$columns-row-gap}
+);
+$flex-columns-column-gap: var(
+  --#{root-defaults.$prefix}-flex-columns-column-gap,
+  #{columns-variables.$columns-column-gap}
+);
+$flex-columns-size: var(
+  --#{root-defaults.$prefix}-flex-columns-size,
+  #{defaults.$flex-columns-size}
+);
+$flex-columns-max-width: var(
+  --#{root-defaults.$prefix}-flex-columns-max-width,
+  #{defaults.$flex-columns-max-width}
+);

package/src/scss/mixins/_media-queries.scss

@@ -25,3 +25,11 @@
     @content;
   }
 }
+
+@mixin screen-trigger($size) {
+  $screen-size-trigger: map.get(root-defaults.$screen-size-triggers, $size);
+
+  @media screen and #{$screen-size-trigger} {
+    @content;
+  }
+}

package/src/scss/theme/typography/_defaults.scss

@@ -9,7 +9,7 @@
 @use "sass:map";
 
 // font properties.
-$font-size: 1rem !default;
+$font-size-base: 1rem !default;
 $root-font-size: clamp(0.85rem, calc(0.8rem + 0.5vw), 1.25rem) !default;
 $line-height: 1.2em !default;
 

package/src/scss/theme/typography/_variables.scss

@@ -9,7 +9,10 @@
 @use "sass:map";
 
 // Font properties.
-$font-size: var(--#{root-defaults.$prefix}-font-base, #{defaults.$font-size});
+$font-size-base: var(
+  --#{root-defaults.$prefix}-font-size-base,
+  #{defaults.$font-size-base}
+);
 $line-height: var(
   --#{root-defaults.$prefix}-line-height,
   #{defaults.$line-height}
@@ -21,7 +24,7 @@ $font-sizes: ();
 @each $key, $value in defaults.$font-size-multipliers {
   $size: var(
     --#{root-defaults.$prefix}-font-#{$key},
-    calc(#{$value} * #{$font-size})
+    calc(#{$value} * #{$font-size-base})
   );
   $font-sizes: map.set($font-sizes, $key, $size);
 }

package/src/scss/utilities/_index.scss

@@ -7,7 +7,9 @@
 @forward "inset";
 @forward "justification";
 @forward "list";
+@forward "order";
 @forward "position";
+@forward "ratio";
 @forward "spacing";
 @forward "typography";
 @forward "visibility";

package/src/scss/utilities/order/_defaults.scss

@@ -0,0 +1,19 @@
+// @graupl/graupl order 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 "sass:map";
+
+// Order properties.
+$order-class-prefix: "order-" !default;
+$base-order-properties: (
+  "none": 0,
+  "first": -9999,
+  "last": 9999,
+);
+$custom-order-properties: () !default;
+$order-properties: map.merge($base-order-properties, $custom-order-properties);

package/src/scss/utilities/order/_index.scss

@@ -0,0 +1,35 @@
+// @gruapl/graupl order utilities styles.
+
+@use "variables" as *;
+@use "defaults" as defaults;
+@use "../../layout/columns/defaults" as columns-defaults;
+@use "../../layout/flex-columns/defaults" as flex-columns-defaults;
+@use "../../mixins/layer" as *;
+@use "../../functions/important";
+
+@include layer(utilities) {
+  @each $order-property, $order-value in $order-properties {
+    .#{$order-class-prefix}#{$order-property} {
+      order: $order-value;
+    }
+  }
+
+  $order-max-count: 0;
+
+  /* stylelint-disable scss/operator-no-newline-after -- Prettier wants to format it this way. */
+  @if (
+    columns-defaults.$columns-max-count >
+      flex-columns-defaults.$flex-columns-max-count
+  ) {
+    $order-max-count: columns-defaults.$columns-max-count;
+  } @else {
+    $order-max-count: flex-columns-defaults.$flex-columns-max-count;
+  }
+  /* stylelint-enable  scss/operator-no-newline-after */
+
+  @for $i from 1 through $order-max-count {
+    .#{$order-class-prefix}#{$i} {
+      order: $i;
+    }
+  }
+}

package/src/scss/utilities/order/_variables.scss

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

package/src/scss/utilities/ratio/_defaults.scss

@@ -0,0 +1,24 @@
+// @graupl/graupl ratio 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 "sass:map";
+
+// Ratio utilities.
+$ratio-selector: ".ratio" !default;
+$ratio-variant-selector-prefix: "." !default;
+$base-ratios: (
+  "one-by-one": 100%,
+  "two-by-one": 50%,
+  "four-by-three": 75%,
+  "four-by-one": 25%,
+  "sixteen-by-nine": calc(9 / 16 * 100%),
+  "three-by-two": calc(2 / 3 * 100%),
+  "eight-by-five": calc(5 / 8 * 100%),
+);
+$custom-ratios: () !default;
+$ratios: map.merge($base-ratios, $custom-ratios);

package/src/scss/utilities/ratio/_index.scss

@@ -0,0 +1,26 @@
+// @gruapl/graupl ratio utilities styles.
+
+@use "variables" as *;
+@use "defaults" as defaults;
+@use "../../defaults" as root-defaults;
+@use "../../mixins/layer" as *;
+@use "../../functions/important";
+
+@include layer(utilities) {
+  #{defaults.$ratio-selector} {
+    position: relative;
+    width: 100%;
+
+    &::before {
+      content: "";
+      display: block;
+      padding-top: $ratio;
+    }
+  }
+
+  @each $ratio-selector, $value in defaults.$ratios {
+    #{defaults.$ratio-variant-selector-prefix}#{$ratio-selector} {
+      --#{root-defaults.$prefix}-ratio: #{$value};
+    }
+  }
+}

package/src/scss/utilities/ratio/_variables.scss

@@ -0,0 +1,9 @@
+// @graupl/graupl ratio utilities variables.
+//
+// These values are to be used to directly style components and provide a
+// cleaner way to reference custom properties.
+
+@use "defaults";
+@use "../../defaults" as root-defaults;
+
+$ratio: var(--#{root-defaults.$prefix}-ratio);