@graupl/graupl 1.0.0-alpha.5 → 1.0.0-alpha.7

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

@@ -0,0 +1,47 @@
+// Variables referencing custom properties.
+
+@use "defaults";
+@use "../../variables" as root-variables;
+@use "../../defaults" as root-defaults;
+@use "sass:map";
+
+$columns-row-gap: var(
+  --#{root-defaults.$prefix}-columns-row-gap,
+  #{map.get(root-variables.$spacers, 5)}
+);
+$columns-column-gap: var(
+  --#{root-defaults.$prefix}-columns-column-gap,
+  #{map.get(root-variables.$spacers, 5)}
+);
+$columns-count: var(
+  --#{root-defaults.$prefix}-columns-count,
+  #{defaults.$columns-count}
+);
+
+// Calculate the min-width of each column based on the content-max-width and column-gap.
+// We take the maximum width of the page and subtract the gap width multiplied by the number of
+// columns minus one (to account for the gaps between columns).
+// We then divide this by the number of columns to get the min-width of each column.
+/* stylelint-disable scss/operator-no-newline-after -- Prettier wants to format it this way. */
+$columns-min-width: var(
+  --#{root-defaults.$prefix}-columns-min-width,
+  calc(
+    (
+        #{root-variables.$content-max-width} - #{$columns-column-gap} *
+          (#{$columns-count} - 1)
+      ) / #{$columns-count}
+  )
+);
+/* stylelint-enable  scss/operator-no-newline-after */
+$columns-max-width: var(
+  --#{root-defaults.$prefix}-columns-max-width,
+  #{defaults.$columns-max-width}
+);
+$columns-grid-template-columns: var(
+  --#{root-defaults.$prefix}-columns-grid-template-columns,
+  repeat(auto-fit, minmax(#{$columns-min-width}, #{$columns-max-width}))
+);
+$columns-span: var(
+  --#{root-defaults.$prefix}-columns-span,
+  #{defaults.$columns-span}
+);

package/src/scss/layout/container/_index.scss

@@ -0,0 +1,36 @@
+// Graupl Container layout.
+
+@use "variables" as *;
+@use "../../mixins/layer" as *;
+
+@include layer(layout) {
+  .container,
+  .container > .full-width {
+    display: grid;
+    grid-template-columns:
+      [full-width-start] $container-full-width-section-width
+      [feature-start] $container-feature-section-width
+      [breakout-start] $container-breakout-section-width
+      [content-start] $container-content-section-width
+      [content-end]
+      $container-breakout-section-width [breakout-end]
+      $container-feature-section-width [feature-end]
+      $container-full-width-section-width [full-width-end];
+
+    > :not(.breakout, .full-width, .feature) {
+      grid-column: content;
+    }
+
+    .breakout {
+      grid-column: breakout;
+    }
+
+    .feature {
+      grid-column: feature;
+    }
+
+    .full-width {
+      grid-column: full-width;
+    }
+  }
+}

package/{scss → src/scss}/layout/container/_variables.scss

@@ -3,10 +3,11 @@
 @use "defaults";
 @use "../../variables" as root-variables;
 @use "../../defaults" as root-defaults;
+@use "sass:map";
 
 $container-gap: var(
   --#{root-defaults.$prefix}-container-gap,
-  #{root-variables.$gap}
+  #{map.get(root-variables.$spacers, 5)}
 );
 $container-content-max-width: var(
   --#{root-defaults.$prefix}-container-content-max-width,
@@ -28,3 +29,19 @@ $container-feature-width: var(
   --#{root-defaults.$prefix}-container-feature-width,
   calc((#{$container-feature-max-width} - #{$container-breakout-max-width}) / 2)
 );
+$container-content-section-width: var(
+  --#{root-defaults.$prefix}-container-content-section-width,
+  min(#{$container-content-max-width}, calc(100% - #{$container-gap} * 2))
+);
+$container-full-width-section-width: var(
+  --#{root-defaults.$prefix}-container-full-width-section-width,
+  minmax(#{$container-gap}, 1fr)
+);
+$container-breakout-section-width: var(
+  --#{root-defaults.$prefix}-container-breakout-section-width,
+  minmax(0, #{$container-breakout-width})
+);
+$container-feature-section-width: var(
+  --#{root-defaults.$prefix}-container-feature-section-width,
+  minmax(0, #{$container-feature-width})
+);

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

@@ -0,0 +1,43 @@
+// Media query mixins.
+
+@use "../defaults" as root-defaults;
+@use "sass:map";
+
+// A media query for targetting users who have not requested reduced motion.
+@mixin animation-on {
+  @media (prefers-reduced-motion: no-preference) {
+    @content;
+  }
+}
+
+// A media query for targetting users who have requested reduced motion.
+@mixin animation-off {
+  @media (prefers-reduced-motion: reduce) {
+    @content;
+  }
+}
+
+@mixin screen($size) {
+  $screen-size: map.get(root-defaults.$screen-sizes, $size);
+
+  @media screen and (min-width: $screen-size) {
+    @content;
+  }
+}
+
+@mixin screen-under($size) {
+  $screen-size: map.get(root-defaults.$screen-sizes, $size);
+
+  @media screen and (max-width: #{$screen-size - 1}) {
+    @content;
+  }
+}
+
+@mixin screen-between($min-size, $max-size) {
+  $min-screen-size: map.get(root-defaults.$screen-sizes, $min-size);
+  $max-screen-size: map.get(root-defaults.$screen-sizes, $max-size);
+
+  @media screen and (min-width: $min-screen-size) and (max-width: #{$max-screen-size - 1}) {
+    @content;
+  }
+}

package/src/scss/theme/_index.scss

@@ -0,0 +1,4 @@
+// Graupl theme.
+
+@forward "color";
+@forward "typography";

package/{scss/theme → src/scss/theme/color}/_defaults.scss

@@ -57,16 +57,3 @@ $dark-map: (
   800: 200,
   900: 100,
 ) !default;
-
-// Font properties.
-/* stylelint-disable-next-line scss/dollar-variable-colon-space-after */
-$global-font-family:
-  system-ui,
-  -apple-system,
-  blinkmacsystemfont,
-  "Segoe UI",
-  roboto,
-  "Helvetica Neue",
-  arial,
-  sans-serif !default;
-$global-font-size: clamp(0.85rem, calc(0.8rem + 0.5vw), 1.25rem);

package/{scss/theme → src/scss/theme/color}/_index.scss

@@ -1,17 +1,15 @@
-// Graupl Theme.
+// Color theme styles.
 
 @use "variables" as *;
-@use "../mixins/layer" as *;
-@use "../defaults" as root-defaults;
+@use "../../mixins/layer" as *;
+@use "../../defaults" as root-defaults;
 @use "sass:map";
-@use "../functions/theme";
+@use "../../functions/theme";
 
 @include layer(theme) {
   :root {
-    background: $global-background;
-    color: $global-font-color;
-    font-family: $global-font-family;
-    font-size: $global-font-size;
+    background: $root-background;
+    color: $root-font-color;
 
     @each $color, $map in $theme-light {
       @each $shade, $value in $map {

package/{scss/theme → src/scss/theme/color}/_variables.scss

@@ -1,7 +1,7 @@
 // Variables referencing custom properties.
 
 @use "defaults";
-@use "../defaults" as root-defaults;
+@use "../../defaults" as root-defaults;
 @use "sass:map";
 
 // A colour map of base colours and their shades.
@@ -110,22 +110,12 @@ $theme-active: ();
   );
 }
 
-// Font properties.
-$global-font-family: var(
-  --#{root-defaults.$prefix}-global-font-family,
-  #{defaults.$global-font-family}
-);
-$global-font-size: var(
-  --#{root-defaults.$prefix}-global-font-size,
-  #{defaults.$global-font-size}
-);
-
 // Colour properties.
-$global-font-color: var(
-  --#{root-defaults.$prefix}-global-font-color,
+$root-font-color: var(
+  --#{root-defaults.$prefix}-root-font-color,
   #{map.get(map.get($theme-active, primary), 900)}
 );
-$global-background: var(
-  --#{root-defaults.$prefix}-global-background,
+$root-background: var(
+  --#{root-defaults.$prefix}-root-background,
   #{map.get(map.get($theme-active, primary), 100)}
 );

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

@@ -0,0 +1,52 @@
+// 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.
+
+@use "sass:map";
+
+// font properties.
+$font-size: 1rem !default;
+$root-font-size: clamp(0.85rem, calc(0.8rem + 0.5vw), 1.25rem) !default;
+$line-height: 1.2em !default;
+
+// Multipliers for font sizes.
+// This uses a minor third scale.
+// See: https://typescale.com/?size=16&scale=1.250&text=A%20Visual%20Type%20Scale&font=Lato&fontweight=400&bodyfont=body_font_default&bodyfontweight=400&lineheight=1.75&backgroundcolor=%23ffffff&fontcolor=%23000000
+$base-font-size-multipliers: (
+  xs: 0.694,
+  sm: 0.833,
+  base: 1,
+  lg: 1.2,
+  xl: 1.44,
+  2xl: 1.728,
+  3xl: 2.074,
+  4xl: 2.488,
+  5xl: 2.986,
+) !default;
+$custom-font-size-multipliers: () !default;
+$font-size-multipliers: map.merge(
+  $base-font-size-multipliers,
+  $custom-font-size-multipliers
+) !default;
+
+// Weights.
+$base-font-weights: (
+  light: 300,
+  normal: 400,
+  bold: 700,
+) !default;
+$custom-font-weights: () !default;
+$font-weights: map.merge($base-font-weights, $custom-font-weights) !default;
+
+/* stylelint-disable-next-line scss/dollar-variable-colon-space-after */
+$root-font-family:
+  system-ui,
+  -apple-system,
+  blinkmacsystemfont,
+  "Segoe UI",
+  roboto,
+  "Helvetica Neue",
+  arial,
+  sans-serif !default;

package/src/scss/theme/typography/_index.scss

@@ -0,0 +1,111 @@
+// Typography theme styles.
+
+@use "variables" as *;
+@use "../../mixins/layer" as *;
+@use "sass:map";
+
+@include layer(base) {
+  p {
+    margin: $paragraph-margin;
+  }
+
+  small {
+    margin: $small-margin;
+  }
+
+  h1 {
+    margin: $h1-margin;
+  }
+
+  h2 {
+    margin: $h2-margin;
+  }
+
+  h3 {
+    margin: $h3-margin;
+  }
+
+  h4 {
+    margin: $h4-margin;
+  }
+
+  h5 {
+    margin: $h5-margin;
+  }
+
+  h6 {
+    margin: $h6-margin;
+  }
+}
+
+@include layer(theme) {
+  :root {
+    font-family: $root-font-family;
+    font-size: $root-font-size;
+  }
+
+  b,
+  strong {
+    font-weight: $font-weight-bold;
+  }
+
+  body {
+    font-size: $body-font-size;
+    font-weight: $body-font-weight;
+    line-height: $body-line-height;
+  }
+
+  p {
+    font-size: $paragraph-font-size;
+    font-weight: $paragraph-font-weight;
+    line-height: $paragraph-line-height;
+  }
+
+  small {
+    font-size: $small-font-size;
+    font-weight: $small-font-weight;
+    line-height: $small-line-height;
+  }
+
+  h1 {
+    font-family: $h1-font-family;
+    font-size: $h1-font-size;
+    font-weight: $h1-font-weight;
+    line-height: $h1-line-height;
+  }
+
+  h2 {
+    font-family: $h2-font-family;
+    font-size: $h2-font-size;
+    font-weight: $h2-font-weight;
+    line-height: $h2-line-height;
+  }
+
+  h3 {
+    font-family: $h3-font-family;
+    font-size: $h3-font-size;
+    font-weight: $h3-font-weight;
+    line-height: $h3-line-height;
+  }
+
+  h4 {
+    font-family: $h4-font-family;
+    font-size: $h4-font-size;
+    font-weight: $h4-font-weight;
+    line-height: $h4-line-height;
+  }
+
+  h5 {
+    font-family: $h5-font-family;
+    font-size: $h5-font-size;
+    font-weight: $h5-font-weight;
+    line-height: $h5-line-height;
+  }
+
+  h6 {
+    font-family: $h6-font-family;
+    font-size: $h6-font-size;
+    font-weight: $h6-font-weight;
+    line-height: $h6-line-height;
+  }
+}

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

@@ -0,0 +1,227 @@
+// Variables referencing custom properties.
+
+@use "defaults";
+@use "../../defaults" as root-defaults;
+@use "../../variables" as root-variables;
+@use "sass:map";
+
+// Font properties.
+$font-size: var(--#{root-defaults.$prefix}-font-base, #{defaults.$font-size});
+$line-height: var(
+  --#{root-defaults.$prefix}-line-height,
+  #{defaults.$line-height}
+);
+
+// Generate all of the font-size-x custom properties.
+$font-sizes: ();
+
+@each $key, $value in defaults.$font-size-multipliers {
+  $size: var(
+    --#{root-defaults.$prefix}-font-#{$key},
+    calc(#{$value} * #{$font-size})
+  );
+  $font-sizes: map.set($font-sizes, $key, $size);
+}
+
+$font-weights: ();
+
+@each $key, $value in defaults.$font-weights {
+  $weight: var(--#{root-defaults.$prefix}-font-weight-#{$key}, $value);
+  $font-weights: map.set($font-weights, $key, $weight);
+}
+
+$font-weight-bold: var(
+  --#{root-defaults.$prefix}-font-weight-bold,
+  #{map.get($font-weights, bold)}
+);
+
+// Root properties.
+$root-font-family: var(
+  --#{root-defaults.$prefix}-root-font-family,
+  #{defaults.$root-font-family}
+);
+$root-font-size: var(
+  --#{root-defaults.$prefix}-root-font-size,
+  #{defaults.$root-font-size}
+);
+
+// Typography properties.
+$body-font-size: var(
+  --#{root-defaults.$prefix}-body-font-size,
+  #{map.get($font-sizes, base)}
+);
+$body-line-height: var(
+  --#{root-defaults.$prefix}-body-line-height,
+  #{$line-height}
+);
+$body-font-weight: var(
+  --#{root-defaults.$prefix}-body-font-weight,
+  #{map.get($font-weights, normal)}
+);
+$paragraph-font-size: var(
+  --#{root-defaults.$prefix}-paragraph-font-size,
+  #{$body-font-size}
+);
+$paragraph-line-height: var(
+  --#{root-defaults.$prefix}-paragraph-line-height,
+  #{$body-line-height}
+);
+$paragraph-margin: var(
+  --#{root-defaults.$prefix}-paragraph-margin,
+  0 0 #{map.get(root-variables.$spacers, 2)} 0
+);
+$paragraph-font-weight: var(
+  --#{root-defaults.$prefix}-paragraph-font-weight,
+  #{$body-font-weight}
+);
+$small-font-size: var(
+  --#{root-defaults.$prefix}-small-font-size,
+  #{map.get($font-sizes, sm)}
+);
+$small-line-height: var(
+  --#{root-defaults.$prefix}-small-line-height,
+  #{$line-height}
+);
+$small-margin: var(
+  --#{root-defaults.$prefix}-small-margin,
+  0 0 #{map.get(root-variables.$spacers, 2)} 0
+);
+$small-font-weight: var(
+  --#{root-defaults.$prefix}-small-font-weight,
+  #{$body-font-weight}
+);
+
+// Headings properties.
+$heading-font-family: var(
+  --#{root-defaults.$prefix}-heading-font-family,
+  $root-font-family
+);
+$heading-line-height: var(
+  --#{root-defaults.$prefix}-heading-line-height,
+  #{$line-height}
+);
+$heading-margin: var(
+  --#{root-defaults.$prefix}-heading-margin,
+  #{map.get(root-variables.$spacers, 5)} 0 #{map.get(
+      root-variables.$spacers,
+      2
+    )} 0
+);
+$heading-font-weight: var(
+  --#{root-defaults.$prefix}-heading-font-weight,
+  #{$font-weight-bold}
+);
+
+// H1 properties.
+$h1-font-size: var(
+  --#{root-defaults.$prefix}-h1-font-size,
+  #{map.get($font-sizes, 5xl)}
+);
+$h1-line-height: var(
+  --#{root-defaults.$prefix}-h1-line-height,
+  #{$heading-line-height}
+);
+$h1-margin: var(--#{root-defaults.$prefix}-h1-margin, #{$heading-margin});
+$h1-font-family: var(
+  --#{root-defaults.$prefix}-h1-font-family,
+  $heading-font-family
+);
+$h1-font-weight: var(
+  --#{root-defaults.$prefix}-h1-font-weight,
+  $heading-font-weight
+);
+
+// H2 properties.
+$h2-font-size: var(
+  --#{root-defaults.$prefix}-h2-font-size,
+  #{map.get($font-sizes, 4xl)}
+);
+$h2-line-height: var(
+  --#{root-defaults.$prefix}-h2-line-height,
+  #{$heading-line-height}
+);
+$h2-margin: var(--#{root-defaults.$prefix}-h2-margin, #{$heading-margin});
+$h2-font-family: var(
+  --#{root-defaults.$prefix}-h2-font-family,
+  $heading-font-family
+);
+$h2-font-weight: var(
+  --#{root-defaults.$prefix}-h2-font-weight,
+  $heading-font-weight
+);
+
+// H3 properties.
+$h3-font-size: var(
+  --#{root-defaults.$prefix}-h3-font-size,
+  #{map.get($font-sizes, 3xl)}
+);
+$h3-line-height: var(
+  --#{root-defaults.$prefix}-h3-line-height,
+  #{$heading-line-height}
+);
+$h3-margin: var(--#{root-defaults.$prefix}-h3-margin, #{$heading-margin});
+$h3-font-family: var(
+  --#{root-defaults.$prefix}-h3-font-family,
+  $heading-font-family
+);
+$h3-font-weight: var(
+  --#{root-defaults.$prefix}-h3-font-weight,
+  $heading-font-weight
+);
+
+// H4 properties.
+$h4-font-size: var(
+  --#{root-defaults.$prefix}-h4-font-size,
+  #{map.get($font-sizes, 2xl)}
+);
+$h4-line-height: var(
+  --#{root-defaults.$prefix}-h4-line-height,
+  #{$heading-line-height}
+);
+$h4-margin: var(--#{root-defaults.$prefix}-h4-margin, #{$heading-margin});
+$h4-font-family: var(
+  --#{root-defaults.$prefix}-h4-font-family,
+  $heading-font-family
+);
+$h4-font-weight: var(
+  --#{root-defaults.$prefix}-h4-font-weight,
+  $heading-font-weight
+);
+
+// H5 properties.
+$h5-font-size: var(
+  --#{root-defaults.$prefix}-h5-font-size,
+  #{map.get($font-sizes, xl)}
+);
+$h5-line-height: var(
+  --#{root-defaults.$prefix}-h5-line-height,
+  #{$heading-line-height}
+);
+$h5-margin: var(--#{root-defaults.$prefix}-h5-margin, #{$heading-margin});
+$h5-font-family: var(
+  --#{root-defaults.$prefix}-h5-font-family,
+  $heading-font-family
+);
+$h5-font-weight: var(
+  --#{root-defaults.$prefix}-h5-font-weight,
+  $heading-font-weight
+);
+
+// H6 properties.
+$h6-font-size: var(
+  --#{root-defaults.$prefix}-h6-font-size,
+  #{map.get($font-sizes, lg)}
+);
+$h6-line-height: var(
+  --#{root-defaults.$prefix}-h6-line-height,
+  #{$heading-line-height}
+);
+$h6-margin: var(--#{root-defaults.$prefix}-h6-margin, #{$heading-margin});
+$h6-font-family: var(
+  --#{root-defaults.$prefix}-h6-font-family,
+  $heading-font-family
+);
+$h6-font-weight: var(
+  --#{root-defaults.$prefix}-h6-font-weight,
+  $heading-font-weight
+);

package/src/scss/utilities/_index.scss

@@ -0,0 +1,5 @@
+// Graupl utilities.
+
+@forward "colors";
+@forward "spacing";
+@forward "typography";

package/src/scss/utilities/colors/_defaults.scss

@@ -0,0 +1,5 @@
+// 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.

package/{scss → src/scss}/utilities/colors/_index.scss

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