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

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

@@ -1,4 +1,5 @@
-// @gruapl/graupl layout styles.
+// @graupl/graupl layout styles.
 
 @forward "container";
 @forward "columns";
+@forward "flex-columns";

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

@@ -1,4 +1,4 @@
-// @gruapl/graupl columns layout styles.
+// @graupl/graupl columns layout styles.
 
 @use "variables" as *;
 @use "defaults";
@@ -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/container/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl container layout styles.
+// @graupl/graupl container layout styles.
 
 @use "defaults";
 @use "variables" as *;

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 @@
+// @graupl/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/_layer.scss

@@ -6,9 +6,7 @@
 @use "../defaults" as root-defaults;
 
 @mixin layer($layer) {
-  @at-root {
-    @layer #{root-defaults.$prefix}.#{$layer} {
-      @content;
-    }
+  @layer #{root-defaults.$prefix}.#{$layer} {
+    @content;
   }
 }

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/mixins/_visually-hidden.scss

@@ -0,0 +1,20 @@
+// @graupl/graupl visually hidden mixins.
+
+@mixin apply() {
+  position: absolute !important;
+  width: 1px !important;
+  height: 1px !important;
+  margin: -1px !important;
+  padding: 0 !important;
+  overflow: hidden !important;
+  clip: rect(0, 0, 0, 0) !important;
+  border: 0 !important;
+  white-space: nowrap !important;
+  clip-path: inset(50%) !important;
+}
+
+@mixin focusable() {
+  &:not(:focus, :focus-within) {
+    @include apply;
+  }
+}

package/src/scss/state/_index.scss

@@ -1,3 +1,3 @@
-// @gruapl/graupl state styles.
+// @graupl/graupl state styles.
 
 @forward "focus";

package/src/scss/state/focus/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl focus state styles.
+// @graupl/graupl focus state styles.
 
 @use "variables" as *;
 @use "../../mixins/layer" as *;

package/src/scss/theme/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl theme styles.
+// @graupl/graupl theme styles.
 
 @forward "color";
 @forward "typography";

package/src/scss/theme/color/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl color theme styles.
+// @graupl/graupl color theme styles.
 
 @use "variables" as *;
 @use "../../mixins/layer" as *;

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/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl typography theme styles.
+// @graupl/graupl typography theme styles.
 
 @use "variables" as *;
 @use "../../mixins/layer" as *;

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

@@ -1,13 +1,17 @@
-// @gruapl/graupl utilities styles.
+// @graupl/graupl utilities styles.
 
 @forward "alignment";
 @forward "color";
 @forward "display";
 @forward "flex";
+@forward "height";
 @forward "inset";
 @forward "justification";
 @forward "list";
+@forward "order";
 @forward "position";
+@forward "ratio";
 @forward "spacing";
 @forward "typography";
 @forward "visibility";
+@forward "width";

package/src/scss/utilities/alignment/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl alignment utilities styles.
+// @graupl/graupl alignment utilities styles.
 
 @use "variables" as *;
 @use "defaults" as defaults;

package/src/scss/utilities/color/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl color utilities styles.
+// @graupl/graupl color utilities styles.
 
 @use "variables" as *;
 @use "defaults";

package/src/scss/utilities/display/_defaults.scss

@@ -27,3 +27,5 @@ $display-properties: map.merge(
   $base-display-properties,
   $custom-display-properties
 );
+$visually-hidden-selector: ".visually-hidden" !default;
+$visually-hidden-focusable-selector: ".visually-hidden-focusable" !default;

package/src/scss/utilities/display/_index.scss

@@ -1,9 +1,10 @@
-// @gruapl/graupl display utilities styles.
+// @graupl/graupl display utilities styles.
 
 @use "variables" as *;
 @use "defaults" as defaults;
 @use "../../mixins/layer" as *;
 @use "../../functions/important";
+@use "../../mixins/visually-hidden";
 
 @include layer(utilities) {
   // For each display property, create a utility class.
@@ -12,4 +13,13 @@
       display: important.insert($property);
     }
   }
+
+  // Visually hidden utility classes.
+  #{$visually-hidden-selector} {
+    @include visually-hidden.apply;
+  }
+
+  #{$visually-hidden-focusable-selector} {
+    @include visually-hidden.focusable;
+  }
 }

package/src/scss/utilities/flex/_index.scss

@@ -1,4 +1,4 @@
-// @gruapl/graupl flex utilities styles.
+// @graupl/graupl flex utilities styles.
 
 @use "variables" as *;
 @use "defaults" as defaults;

package/src/scss/utilities/height/_defaults.scss

@@ -0,0 +1,38 @@
+// @graupl/graupl height 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";
+
+// Height properties.
+$height-class-prefix: "h-" !default;
+$max-height-class-prefix: "max-h-" !default;
+$min-height-class-prefix: "min-h-" !default;
+
+// Height values.
+$base-height-values: (
+  auto: auto,
+  fit-content: fit-content,
+  max-content: max-content,
+  min-content: min-content,
+  stretch: stretch,
+  0: 0,
+  full: 100%,
+  quarter: 25%,
+  half: 50%,
+  three-quarters: 75%,
+  third: calc(100% / 3),
+  two-thirds: calc(100% / 1.5),
+  half-screen: 50vh,
+  third-screen: calc(100vh / 3),
+  two-thirds-screen: calc(100vh / 1.5),
+  quarter-screen: 25vh,
+  three-quarters-screen: 75vh,
+  full-screen: 100vh,
+);
+$custom-height-values: () !default;
+$height-values: map.merge($base-height-values, $custom-height-values);