@apolitical/component-library 0.0.4-beta.6 → 1.1.0-beta.1

package/styles/base/_text.scss

@@ -0,0 +1,84 @@
+@use 'sass:map';
+@import './../functions',
+        './../mixins',
+        './../variables';
+
+$default: ('font-size': 16, 'font-size_md': 18, 'line-height': 24, 'line-height_md': 28, 'margin-bottom': 20); // The default size is the 'large paragraph' in Figma
+$small: ('font-size': 12, 'font-size_md': 14, 'letter-spacing': 0.16, 'line-height': 16, 'margin-bottom': 16);
+$medium: ('font-size': 14, 'font-size_md': 16, 'line-height': 16, 'line-height_md': 20, 'margin-bottom': 18);
+$sup: ('font-size': 10);
+
+@layer base {
+  p, li, small {
+    color: map.get($theme, 'text');
+    font-weight: 500;
+
+    .error &, &.error { color: map.get($theme, 'text_error'); }
+  }
+
+  p, li, dt, dd {
+    font-size: px-to-rem(map.get($default, 'font-size'));
+    line-height: px-to-rem(map.get($default, 'line-height'));
+
+      .text-small & {
+        font-size: px-to-rem(map.get($small, 'font-size'));
+        line-height: px-to-rem(map.get($small, 'line-height'));
+        letter-spacing: px-to-rem(map.get($small, 'letter-spacing'));
+      }
+
+      .text-medium & {
+        font-size: px-to-rem(map.get($medium, 'font-size'));
+        line-height: px-to-rem(map.get($medium, 'line-height'));
+      }
+
+      @include breakpoint('min-width', 'md') {
+        font-size: px-to-rem(map.get($default, 'font-size_md'));
+        line-height: px-to-rem(map.get($default, 'line-height_md'));
+
+          .text-small & {
+            font-size: px-to-rem(map.get($small, 'font-size_md'));
+          }
+
+          .text-medium & {
+            font-size: px-to-rem(map.get($medium, 'font-size_md'));
+            line-height: px-to-rem(map.get($medium, 'line-height_md'));
+          }
+      }
+  }
+
+  p {
+    margin-bottom: px-to-rem(map.get($default, 'margin-bottom'));
+
+      .text-small & { margin-bottom: px-to-rem(map.get($small, 'margin-bottom')); }
+
+      .text-medium & { margin-bottom: px-to-rem(map.get($medium, 'margin-bottom')); }
+  }
+
+  small {
+    font-size: px-to-rem(map.get($small, 'font-size'));
+    line-height: px-to-rem(map.get($small, 'line-height'));
+
+      @include breakpoint('min-width', 'md') {
+        font-size: px-to-rem(map.get($small, 'font-size_md'));
+      }
+  }
+
+  strong { font-weight: 900; }
+  em, i { font-style: italic; }
+
+  sup, sub {
+    font-size: px-to-rem(map.get($sup, 'font-size'));
+    line-height: normal;
+  }
+
+  sup {
+    vertical-align: super;
+  }
+
+  sub {
+    vertical-align: sub;
+  }
+
+  address { font-style: normal; }
+
+}

package/styles/base/_titles.scss

@@ -0,0 +1,176 @@
+@use 'sass:map';
+@import './../functions',
+        './../mixins',
+        './../variables';
+
+$pre-title: ('font-size': 14, 'font-size_md': 16, 'letter-spacing': 1.28, 'line-height': 16, 'line-height_md': 20, 'margin-bottom': 24);
+$title: ('font-size': 32, 'font-size_md': 52, 'letter-spacing': -0.16, 'line-height': 40, 'line-height_md': 64, 'margin-bottom': 16, 'margin-bottom_md': 32);
+$h1: ('font-size': 28, 'font-size_md': 40, 'line-height': 32, 'line-height_md': 48, 'letter-spacing': -0.16, 'margin-bottom': 16);
+$h2: ('font-size': 24, 'font-size_md': 28, 'line-height': 32, 'line-height_md': 40, 'margin-top': 40, 'margin-bottom': 16);
+$h3: ('font-size': 20, 'font-size_md': 24, 'line-height': 28, 'line-height_md': 32, 'margin-top': 60, 'margin-bottom': 20);
+$h4: ('font-size': 18, 'font-size_md': 20, 'line-height': 24, 'line-height_md': 28, 'margin-top': 40, 'margin-bottom': 20);
+$h5: ('font-size': 12, 'font-size_md': 14, 'line-height': 16, 'margin-top': 16, 'margin-bottom': 16);
+$h6: ('font-size': 12, 'font-size_md': 11, 'line-height': 16);
+$subtitle: ('font-size': 20, 'font-size_md': 24, 'line-height': 28, 'line-height_md': 32, 'margin-bottom': 20);
+
+@mixin pre-title {
+  margin-bottom: px-to-rem(map.get($pre-title, 'margin-bottom'));
+  font-size: px-to-rem(map.get($pre-title, 'font-size'));
+  color: map.get($theme, 'title');
+  font-weight: 700;
+  line-height: px-to-rem(map.get($pre-title, 'line-height'));
+  letter-spacing: px-to-rem(map.get($pre-title, 'letter-spacing'));
+  text-transform: uppercase;
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($pre-title, 'font-size_md'));
+      line-height: px-to-rem(map.get($pre-title, 'line-height_md'));
+    }
+}
+
+@mixin title {
+  margin-bottom: px-to-rem(map.get($title, 'margin-bottom'));
+  font-size: px-to-rem(map.get($title, 'font-size'));
+  color: map.get($theme, 'title');
+  font-weight: 900;
+  line-height: px-to-rem(map.get($title, 'line-height'));
+  letter-spacing: px-to-rem(map.get($title, 'letter-spacing'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($title, 'font-size_md'));
+      line-height: px-to-rem(map.get($title, 'line-height_md'));
+    }
+}
+
+@mixin h1 {
+  margin-bottom: px-to-rem(map.get($h1, 'margin-bottom'));
+  font-size: px-to-rem(map.get($h1, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: none;
+  font-weight: 900;
+  line-height: px-to-rem(map.get($h1, 'line-height'));
+  letter-spacing: px-to-rem(map.get($h1, 'letter-spacing'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h1, 'font-size_md'));
+      line-height: px-to-rem(map.get($h1, 'line-height_md'));
+    }
+}
+
+@mixin h2 {
+  margin: px-to-rem(map.get($h2, 'margin-top')) 0 px-to-rem(map.get($h2, 'margin-bottom')) 0;
+  font-size: px-to-rem(map.get($h2, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: none;
+  font-weight: 900;
+  line-height: px-to-rem(map.get($h2, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h2, 'font-size_md'));
+      line-height: px-to-rem(map.get($h2, 'line-height_md'));
+    }
+}
+
+@mixin h3 {
+  margin: px-to-rem(map.get($h3, 'margin-top')) 0 px-to-rem(map.get($h3, 'margin-bottom')) 0;
+  font-size: px-to-rem(map.get($h3, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: none;
+  font-weight: 900;
+  line-height: px-to-rem(map.get($h3, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h3, 'font-size_md'));
+      line-height: px-to-rem(map.get($h3, 'line-height_md'));
+    }
+}
+
+@mixin h4 {
+  margin: px-to-rem(map.get($h4, 'margin-top')) 0 px-to-rem(map.get($h4, 'margin-bottom')) 0;
+  font-size: px-to-rem(map.get($h4, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: none;
+  font-weight: 900;
+  line-height: px-to-rem(map.get($h4, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h4, 'font-size_md'));
+      line-height: px-to-rem(map.get($h4, 'line-height_md'));
+    }
+}
+
+@mixin h5 {
+  margin: px-to-rem(map.get($h5, 'margin-top')) 0 px-to-rem(map.get($h5, 'margin-bottom')) 0;
+  font-size: px-to-rem(map.get($h5, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: uppercase;
+  font-weight: 700;
+  line-height: px-to-rem(map.get($h5, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h5, 'font-size_md'));
+    }
+}
+
+@mixin h6 {
+  font-size: px-to-rem(map.get($h6, 'font-size'));
+  color: map.get($theme, 'title');
+  text-transform: uppercase;
+  font-weight: 700;
+  line-height: px-to-rem(map.get($h6, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($h6, 'font-size_md'));
+    }
+}
+
+@mixin subtitle {
+  margin-bottom: px-to-rem(map.get($subtitle, 'margin-bottom'));
+  font-size: px-to-rem(map.get($subtitle, 'font-size'));
+  color: map.get($theme, 'subtitle');
+  font-weight: 400;
+  line-height: px-to-rem(map.get($subtitle, 'line-height'));
+
+    @include breakpoint('min-width', 'md') {
+      font-size: px-to-rem(map.get($subtitle, 'font-size_md'));
+      line-height: px-to-rem(map.get($subtitle, 'line-height_md'));
+    }
+}
+
+@layer base {
+  .pre-title {
+    @include pre-title;
+  }
+
+  .title {
+    @include title;
+  }
+
+  h1 {
+    @include h1;
+  }
+
+  h2 {
+    @include h2;
+  }
+
+  h3 {
+    @include h3;
+  }
+
+  h4 {
+    @include h4;
+  }
+
+  h5 {
+    @include h5;
+  }
+
+  h6 {
+    @include h6;
+  }
+
+  .subtitle {
+    @include subtitle;
+  }
+}

package/styles/base/buttons/_buttons.scss

@@ -0,0 +1,250 @@
+@use 'sass:map';
+@use 'sass:meta';
+@import './../../functions',
+        './../../mixins',
+        './../../variables';
+@import './icons', './mixins', './sizes';
+
+@layer base {
+  button, .button {
+    background: map.get($theme, 'button_primary_bg');
+    padding: px-to-rem(map.get($medium, 'padding-top')) px-to-rem(map.get($medium, 'padding-horizontal'))
+          px-to-rem(map.get($medium, 'padding-bottom')) px-to-rem(map.get($medium, 'padding-horizontal'));
+    position: relative;
+    text-align: center;
+    font-size: px-to-rem(map.get($medium, 'font-size'));
+    font-weight: 700;
+    text-decoration: none;
+    border-radius: 360rem; // Completely round corners. This could be any large number but 360 evokes a circle well!
+    border: none;
+    cursor: pointer;
+    box-sizing: border-box;
+    display: inline-block;
+
+    &, &:hover, &:active, &:focus, &:focus-visible { color: map.get($theme, 'button_primary'); }
+
+    &:hover {
+      background: map.get($theme, 'button_primary_bg_hover');
+    }
+
+    &:active {
+      background: map.get($theme, 'button_primary_bg_active');
+    }
+
+    &:focus, &:focus-visible {
+      background: map.get($theme, 'button_primary_bg_focus');
+    }
+
+    @each $size, $styles in $sizes {
+      &.#{$size} {
+        padding: px-to-rem(map.get($styles, 'padding-top')) px-to-rem(map.get($styles, 'padding-horizontal'))
+          px-to-rem(map.get($styles, 'padding-bottom')) px-to-rem(map.get($styles, 'padding-horizontal'));
+        font-size: px-to-rem(map.get($styles, 'font-size'));
+
+          &.icon {
+            margin-top: px-to-rem(map.get($styles, 'icon-offset'));
+
+            &.left::before { margin-right: px-to-rem(map.get($styles, 'icon-gutter')); }
+            &.right::before { margin-left: px-to-rem(map.get($styles, 'icon-gutter')); }
+          }
+      }
+    }
+
+    &.full-width {
+      width: 100%;
+    }
+
+    &.destructive {
+        &, &:hover, &:active, &:focus, &:focus-visible {
+          background: map.get($theme, 'button_primary_destructive_bg');
+          color: map.get($theme, 'button_primary_destructive');
+        }
+
+        &:hover, &:active {
+          background: map.get($theme, 'button_primary_destructive_bg_hover');
+        }
+
+        &:focus, &:focus-visible {
+          box-shadow: $outline map.get($theme, 'button_primary_destructive_box-shadow');
+        }
+
+    }
+
+    &.secondary {
+      background: map.get($theme, 'button_secondary_bg');
+      border: px-to-rem(map.get($secondary, 'border')) solid map.get($theme, 'button_secondary_border');
+
+        &, &:hover { color: map.get($theme, 'button_secondary'); }
+
+        &:hover {
+          background: map.get($theme, 'button_secondary_bg_hover');
+        }
+
+        &:active, &:focus, &:focus-visible {
+          color: map.get($theme, 'button_secondary_focus');
+          border-color: map.get($theme, 'button_secondary_border_focus');
+        }
+
+        &:active {
+          background: map.get($theme, 'button_secondary_bg_active');
+        }
+
+        &:focus, &:focus-visible {
+          background: map.get($theme, 'button_secondary_bg_focus');
+        }
+
+        &.muted {
+          border-color: map.get($theme, 'button_secondary_border_muted');
+
+            &, &:hover, &:active, &:focus, &:focus-visible {
+              background: map.get($theme, 'button_secondary_bg_muted');
+              color: map.get($theme, 'button_secondary_muted');
+            }
+
+          &:hover, &:focus, &:focus-visible {
+            color: map.get($theme, 'button_secondary_muted_hover');
+          }
+        }
+
+        &.disabled {
+          &, &:hover, &:active, &:focus, &:focus-visible {
+            background: map.get($theme, 'button_secondary_bg_disabled');
+            color: map.get($theme, 'button_secondary_disabled');
+            border-color: map.get($theme, 'button_secondary_border_disabled');
+          }
+        }
+    }
+
+    &.tertiary {
+      @include transition(color text-decoration-color);
+
+      padding: px-to-rem(map.get($tertiary, 'padding-top')) px-to-rem(map.get($tertiary, 'padding-horizontal'))
+        px-to-rem(map.get($tertiary, 'padding-bottom')) px-to-rem(map.get($tertiary, 'padding-horizontal'));
+      bottom: px-to-rem(map.get($tertiary, 'padding-top'));
+      right: px-to-rem(map.get($tertiary, 'padding-horizontal'));
+      text-decoration: underline;
+      text-decoration-color: transparent;
+
+      &, &:focus, &:focus-visible {
+        background: map.get($theme, 'button_tertiary_bg');
+        color: map.get($theme, 'button_tertiary');
+        text-decoration-color: map.get($theme, 'button_tertiary_text-decoration');
+      }
+
+      &:hover, &:active {
+        text-decoration-color: currentcolor;
+      }
+
+      &:hover {
+        color: map.get($theme, 'button_tertiary_hover');
+      }
+
+      &:active {
+        color: map.get($theme, 'button_tertiary_active');
+      }
+
+      &.muted {
+        color: map.get($theme, 'button_tertiary_muted');
+
+          &:hover, &:focus, &:focus-visible {
+            color: map.get($theme, 'button_tertiary_muted_hover');
+          }
+      }
+
+      &.disabled {
+        &, &:hover, &:active, &:focus, &:focus-visible {
+          background: map.get($theme, 'button_tertiary_disabled_bg');
+          color: map.get($theme, 'button_tertiary_disabled');
+          text-decoration-color: map.get($theme, 'button_tertiary_disabled_text-decoration');
+        }
+      }
+
+    }
+
+    &.icon {
+      display: inline-flex;
+      flex-flow: row;
+      align-content: center;
+      justify-content: center;
+
+        &::before {
+          content: '';
+          background: currentcolor;
+          width: px-to-rem(map.get($medium, 'icon-width'));
+          height: px-to-rem(map.get($medium, 'icon-width'));
+          display: block;
+        }
+
+        &.left {
+            &::before { margin-right: px-to-rem(map.get($medium, 'icon-gutter')); }
+
+            &.no-text::before { margin-right: 0; }
+        }
+
+        &.right {
+          &::before {
+            margin-left: px-to-rem(map.get($medium, 'icon-gutter'));
+            order: 2;
+          }
+
+          &.no-text::before { margin-left: 0; }
+        }
+
+        @each $icon, $large-icon, $medium-icon, $small-icon in $icons {
+          $icon-sizes: ('large', $large-icon), ('medium', $medium-icon), ('small', $small-icon);
+
+          @at-root {
+            %icon-#{$icon} { @include icon-styling($icon, $icon-sizes); }
+          }
+
+          &.#{$icon} {
+            @extend %icon-#{$icon};
+          }
+
+          &.hover_#{$icon} {
+            &:hover, &:focus, &:focus-visible {
+              @extend %icon-#{$icon};
+            }
+          }
+
+        }
+
+        &.animate {
+          &::before {
+            @include transition(transform, #{map.get($animation, 'duration')}s, ease);
+
+            transform: none;
+          }
+
+          &.bounce {
+            @include animate {
+              @keyframes bounce {
+                0%, 100% { transform: scale(1); }
+
+                70% {
+                  transform: scale(#{map.get($animation-bounce, 'scale')});
+                }
+              }
+
+              &:focus, &:active, &.do-animation {
+                &::before { animation: bounce #{map.get($animation-bounce, 'duration')}s #{map.get($animation-bounce, 'iteration')}; }
+              }
+
+            }
+          }
+
+          &.rotate-180::before {
+            transform: rotate(180deg);
+          }
+
+        }
+    }
+
+    &.disabled {
+      cursor: not-allowed;
+      opacity: 0.3;
+    }
+
+  }
+}
+    

package/styles/base/buttons/_sizes.scss

@@ -0,0 +1,12 @@
+// The button defaults to the primary variant and medium styling so are not added as classes - they live on the default `button` styling
+$large: ('font-size': 18, 'padding-top': 14, 'padding-horizontal': 24, 'padding-bottom': 16, 'icon-width': 18, 'icon-offset': 2, 'icon-gutter': 12);
+$medium: ('font-size': 16, 'padding-top': 10, 'padding-horizontal': 24, 'padding-bottom': 12, 'icon-width': 16, 'icon-offset': 2, 'icon-gutter': 10);
+$small: ('font-size': 14, 'padding-top': 8, 'padding-horizontal': 16, 'padding-bottom': 10, 'icon-width': 12, 'icon-offset': 2, 'icon-gutter': 8);
+$sizes: ('large', $large), ('small', $small);
+$secondary: ('border': 1);
+
+// The tertiary styling has its own padding; regardless of size, we add a tiny amount of padding to accommodate
+// the focus outline and to ensure any icons are centered
+$tertiary: ('padding-top': 1.6, 'padding-horizontal': 8,'padding-bottom': 3.2);
+$animation: ('duration': 0.2);
+$animation-bounce: ('scale': 1.1, 'duration': 0.5, 'iteration': 1);

package/styles/base/form/_fields.scss

@@ -0,0 +1,60 @@
+@use 'sass:map';
+@import './../../functions',
+        './../../mixins',
+        './../../variables';
+
+$field: ('padding-vertical': 8, 'padding-horizontal': 16, 'font-size': 16, 'line-height': 24, 'border': 1, 'border-radius': 8);
+
+@mixin field-styling {
+  background: map.get($theme, 'form_input_bg');
+  border: px-to-rem(map.get($field, 'border')) solid map.get($theme, 'form_input_border');
+  border-radius: px-to-rem(map.get($field, 'border-radius'));
+  box-sizing: border-box;
+  outline: none;
+
+    &:focus, &:focus-visible {
+      box-shadow: $outline-width map.get($theme, 'form_input_focus_box-shadow');
+    }
+
+    &.error {
+      border-color: map.get($theme, 'form_input_error_border');
+    }
+}
+
+@layer base {
+  input, .input, textarea {
+    @include field-styling;
+
+    width: 100%;
+    padding: px-to-rem(map.get($field, 'padding-vertical')) px-to-rem(map.get($field, 'padding-horizontal'));
+    font-size: px-to-rem(map.get($field, 'font-size'));
+    color: map.get($theme, 'form_input');
+    line-height: px-to-rem(map.get($field, 'line-height'));
+
+      ::placeholder {
+        color: map.get($theme, 'form_input_placeholder');
+      }
+
+      // Remove default styling, for consistency
+      &[type='search'] {
+        &::-ms-clear {
+          width: 0;
+          height: 0;
+          display: none;
+        }
+
+        &::-ms-reveal {
+          width: 0;
+          height: 0;
+          display: none;
+        }
+
+        &::-webkit-search-decoration,
+        &::-webkit-search-cancel-button,
+        &::-webkit-search-results-button,
+        &::-webkit-search-results-decoration {
+          display: none;
+        }
+      }
+  }
+}

package/styles/base/form/_index.scss

@@ -0,0 +1,2 @@
+@import 'fields',
+        'search-button';

package/styles/base/form/_search-button.scss

@@ -0,0 +1,32 @@
+@use 'sass:map';
+@import './../../functions',
+        './../../mixins',
+        './../../variables';
+
+$search-icon: ('width': 24, 'height': 24);
+
+@layer base {
+  button.search {
+    width: px-to-rem(map.get($search-icon, 'width'));
+    height: px-to-rem(map.get($search-icon, 'height'));
+    background: transparent;
+    margin: 0;
+    padding: 0;
+    border: none;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+
+      &::before {
+        @include transition(background, 0.3s, ease);
+        @include image('icons/magnifying-glass.svg', true);
+
+        content: '';
+        width: px-to-rem(map.get($search-icon, 'width'));
+        height: px-to-rem(map.get($search-icon, 'height'));
+        background: map.get($theme, 'form_search-button_bg');
+        display: block;
+      }
+  }
+}

package/styles/functions/_size-conversions.scss

@@ -4,5 +4,7 @@
 // We want to use rem for accessibility, but Figma uses px (which is also a bit easier for us
 // to read and reason about). This mixin does the conversion for us.
 @function px-to-rem($size, $baseTextSize: 16) {
-    @return math.div($size, $baseTextSize) + rem;
+    $new-size: math.div($size, $baseTextSize);
+
+    @return $new-size + rem;
 }

package/styles/index.scss

@@ -1,6 +1,8 @@
 @import 'functions',
         'variables',
         'mixins',
-
         'reset',
-        'base-styles';
+        'base';
+
+/* We use CSS layers to handle specificity: https://css-tricks.com/css-cascade-layers/ */
+@layer reset, base, components, overrides;

package/styles/mixins/_backgrounds.scss

@@ -10,11 +10,7 @@
   @if string.index($image, 'http') {
     $image: $image;
   } @else {
-    @if $is-mask {
-      $image: $assets-bucket + $image;
-    } @else {
-      $image: $image-bucket + $image;
-    }
+    $image: $assets-bucket + $image;
   }
 
   @if $is-mask {

package/styles/mixins/_breakpoints.scss

@@ -1,7 +1,10 @@
 @use 'sass:map';
 
 $breakpoint-sizes: (
-  'md': 769
+  'sm': 580,
+  'md': 769,
+  'md-lg': 1024,
+  'lg': 1180,
 );
 
 // This mixin lets us use fast references for common breakpoints, using the map above,

package/styles/mixins/_browsers.scss

@@ -0,0 +1,3 @@
+@mixin target-safari() {
+  @media not all and (resolution >=.001dpcm) { @content; }
+}

package/styles/mixins/_index.scss

@@ -1,5 +1,7 @@
 @import 'animations',
         'backgrounds',
         'breakpoints',
+        'browsers',
         'selectors',
+        'styles',
         'transitions';