@ulu/frontend 0.1.0-beta.12 → 0.1.0-beta.121

package/scss/components/_card.scss

@@ -10,6 +10,7 @@
 @use "../utils";
 @use "../selector";
 @use "../color";
+@use "../layout";
 
 // todo
 // sass color adjust for smooth transition. Add a comment for this if we can’t get to this
@@ -29,7 +30,7 @@
 /// @prop {Color} background-color [white] The background color of the card.
 /// @prop {Color} background-color-hover [rgb(242, 244, 246)] The background color of the card when hovered or focused.
 /// @prop {Dimension} max-width [28rem] The max-width of the card.
-/// @prop {Dimension} body-min-height [10rem] the min-height of the card body.
+/// @prop {Dimension} body-min-height [8rem] the min-height of the card body.
 /// @prop {CssValue} border [1px solid #ccc] The card border.
 /// @prop {CssValue} border-hover [2px solid #278cca] The card border when hovered or focused.
 /// @prop {Dimension} header-margin [0.75em] The margin for the card header.
@@ -49,6 +50,7 @@
 /// @prop {String} clickable-card-interact-selector [&:hover, &:focus-within] The selectors for the cards being interacted with.
 /// @prop {Dimension} footer-padding-y [0.25rem] The top and bottom padding for the footer.
 /// @prop {Dimension} footer-min-height [2.5rem] The min height for the footer
+/// @prop {Dimension} footer-justify [flex-end] Flex alignment of footer items (on end by default)
 /// @prop {String} prefix [card] The class name used to add card styling.
 /// @prop {Boolean} transition-enabled [true] Enable or disable transition for card.
 /// @prop {CssValue} transition-timing-function [ease-in-out] The timing function for the card animation.
@@ -57,11 +59,18 @@
 /// @prop {Boolean} image-transition-enabled [true] Enable or disable the image transition.
 /// @prop {Time} image-transition-duration [350ms] The duration of the image transition.
 /// @prop {CssValue} image-transition-timing-function [ease-in-out] The timing function for the image transition.
-/// @prop {List} image-icon-max-width [30rem] Max width for image when using the modifier on the .card__image--icon
+/// @prop {Number} image-fit-padding [1rem] Padding on inside of image when using image fit modifier
+/// @prop {CssValue} image-fit-filter [drop-shadow(0 0px 8px rgba(0, 0, 0, 0.2))] Filter to use on image when using image fit modifier
+/// @prop {List} image-icon-max-width [10rem] Max width for image when using the modifier on the .card__image--icon
 /// @prop {List} image-transition-properties [(transform, filter)] The properties for the image transitions.
 /// @prop {String} horizontal-breakpoint [small] The breakpoint used to change the card to vertical if using the card--horizontal styling. Uses ulu's breakpoint module.
+/// @prop {Unit} horizontal-min-height [10rem] Minimum height when horizontal
+/// @prop {Unit} horizontal-max-width [40rem] Maximum width when horizontal
 /// @prop {Unit} horizontal-body-max-width [80rem] The max-width of body when horizontal
-
+/// @prop {Boolean} aside-rule [false] Whether or not to have a rule separating body and aside
+/// @prop {CssUnit} aside-rule-width [1px] Size of rule
+/// @prop {CssUnit} aside-rule-color ["rule-light"] Color of rule
+/// @prop {CssUnit} aside-rule-background-color [transparent] Color of aside background color
 
 $config: (
   "background-color" : white,
@@ -75,26 +84,32 @@ $config: (
   "clickable-card-enabled" : true,
   "clickable-card-selector" : "[data-ulu-proxy-click-init]",
   "clickable-card-interact-selector" : "&:hover, &:focus-within",
-  "color" : null,
+  "color" : "type",
   "color-hover" : null,
   "footer-padding-y" : 0.25rem,
   "footer-min-height" : 2.5rem,
+  "footer-justify" : flex-end,
   "horizontal-breakpoint" : "small",
-  "horizontal-image-width" : 33%,
-  "horizontal-body-max-width" : 80rem,
+  "horizontal-image-width" : min(33%, 20rem),
+  "horizontal-min-height" : 20rem,
+  "horizontal-max-width" : 80rem,
+  "horizontal-main-max-width" : 40rem,
+  "horizontal-aside-width" : 40%,
   "header-margin" : 0.75em,
   "image-ratio" : 56.25%,
   "image-aspect-ratio": list.slash(5, 3),
-  "image-background-color" : rgb(197, 197, 197),
+  "image-background-color" : rgb(238, 238, 238),
   "image-border" : null, // For when you have a margin
   "image-filter-hover" : null,
   "image-margin" : null,
-  "image-icon-max-width" : 30rem,
+  "image-icon-max-width" : 8rem,
   "image-transform-hover" : null,
   "image-transition-duration" :    350ms,
   "image-transition-enabled" : true,
   "image-transition-properties" : (transform, filter),
   "image-transition-timing-function" : ease-in-out,
+  "image-fit-padding" : 1rem,
+  "image-fit-filter" : drop-shadow(0 0px 8px rgba(0, 0, 0, 0.3)),
   "margin-y" : 3rem,
   "max-width" : 28rem,
   "padding" : 2rem,
@@ -114,6 +129,10 @@ $config: (
   "overlay-background-color": rgba(0, 0, 0, 0.6),
   "overlay-shading": true,
   "overlay-body-padding-y": 1rem,
+  "aside-rule" : false,
+  "aside-rule-width" : 1px,
+  "aside-background-color" : transparent,
+  "aside-rule-color": "rule-light",
 ) !default;
   
   /// Change modules $config
@@ -134,34 +153,6 @@ $config: (
   @return utils.require-map-get($config, $name, "card [config]");
 }
 
-/// Mixin styles for card when it has proxy click enabled and is being interacted with (hover/focus)
-/// @param {Boolean} $hover [false] Apply styles when the card is being hover/focused within, else applies styles to rest state of a clickable card (one who has a proxy click setup)
-/// Prints component styles
-/// @example scss
-///  @include ulu.component-card-styles();
-
-@mixin when-clickable($hover: false) {
-  $prefix: selector.class("card");
-  @if (get("clickable-card-enabled") and get("clickable-card-selector")) {
-    #{ $prefix } {
-      &#{ get("clickable-card-selector") } {
-        @if ($hover) {
-          #{ get("clickable-card-interact-selector") } {
-            @content;
-          }
-        } @else {
-          @content;
-        }
-      }
-    }
-  }
-}
-
-
-@mixin shared-transition-styles() {
-  transition-duration: get("transition-duration");
-  transition-timing-function: get("transition-timing-function");
-}
 /// Prints component styles
 /// @demo card
 /// @example scss
@@ -183,14 +174,11 @@ $config: (
     flex-direction: column;
     justify-content: flex-end;
     max-width: get("max-width");
+
     // Border is on pseudo so that it's on top of image/etc
-    &:after {
-      position: absolute;
+    &::after {
+      @include layout.absolute-fill();
       content: if(get("border"), "", null);
-      top: 0; 
-      bottom: 0; 
-      right: 0; 
-      left: 0;
       border: get("border");
       border-radius: get("border-radius");
       z-index: 4;
@@ -204,7 +192,7 @@ $config: (
     box-shadow: get("box-shadow-hover");
     
     @if (get("border-hover") or get("overlay-background-color-hover")) {
-      &:after {
+      &::after {
         content: "";
         border: get("border-hover");
         background-color: color.get(get("overlay-background-color-hover"));
@@ -218,7 +206,8 @@ $config: (
     #{ $prefix },
     #{ $prefix }::after,
     #{ $prefix }__title {
-      @include shared-transition-styles();
+      transition-duration: get("transition-duration");
+      transition-timing-function: get("transition-timing-function");
       transition-property: get("transition-properties");
     }
   } 
@@ -228,14 +217,15 @@ $config: (
     margin-bottom: get("title-margin");
     display: block;
     font-weight: get("title-font-weight");
-    @if get("title-color-hover") {
-      &:hover,
-      &:focus {
-        color: color.get(get("title-color-hover"));
-      }
-    }
     #{ $prefix }__title-link {
       all: unset;
+      cursor: pointer;
+      @if get("title-color-hover") {
+        &:hover,
+        &:focus {
+          color: color.get(get("title-color-hover"));
+        }
+      }
     }
   }
   @if get("title-color-hover") {
@@ -267,11 +257,7 @@ $config: (
   }
   #{ $prefix }__image img,
   #{ $prefix}__image-media {
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
+    @include layout.absolute-fill(true);
     border: 0;
     object-fit: cover;
     transform-origin: center center;
@@ -290,17 +276,24 @@ $config: (
       }
     }
   }
-  #{ $prefix }__body,
-  #{ $prefix }__footer,
-  #{ $prefix }__image--icon {
+
+  #{ $prefix }__footer {
+    padding: get("padding");
+  }
+  #{ $prefix }__main {
+    padding: get("padding");
+  }
+  #{ $prefix }__aside {
+    position: relative;
     padding: get("padding");
   }
 
   #{ $prefix }__image--icon {
-    background-color: transparent; 
+    // background-color: transparent; 
     display: flex;
     align-items: center;
     justify-content: center;
+    // padding: 2rem;
     img {
       position: static;
       display: block;
@@ -316,9 +309,25 @@ $config: (
     z-index: 2; // Above image
   }
   #{ $prefix }__body {
+    display: flex;
+    flex-direction: column;
     flex-grow: 1;
     min-height: get("body-min-height");
   }
+  @if(get("aside-rule")) {
+    #{ $prefix }__aside {
+      background-color: color.get(get("aside-background-color"));
+    }
+    #{ $prefix }__aside::after {
+      content: "";
+      position: absolute;
+      top: calc(0rem - get("aside-rule-width") / 2);
+      left: get("padding");
+      right: get("padding");
+      height: get("aside-rule-width");
+      background-color: color.get(get("aside-rule-color"));
+    }
+  }
   // For actions/messages
   // - Layout as flex with min height to support buttons 
   //   and text without relying so much on padding
@@ -330,7 +339,7 @@ $config: (
     min-height: get("footer-min-height");
     display: flex;
     align-items: center;
-    justify-content: flex-end;
+    justify-content: get("footer-justify");
   }
   // body + footer {
   // means body keeps before pseudo element while footer loses it
@@ -347,10 +356,12 @@ $config: (
       min-height: 0;
       padding-top: get("overlay-body-padding-y");
       padding-bottom: get("overlay-body-padding-y");
+      
       &:not(:has(~ #{ $prefix }__footer)) {
         border-bottom-left-radius: get("border-radius");
         border-bottom-right-radius: get("border-radius");
       }
+
       @if (get("overlay-shading")) {
         margin-top: 4rem;
         &::before {
@@ -381,11 +392,7 @@ $config: (
       color: color.get(get("color-overlay"));
     }
     #{ $prefix }__image {
-      position: absolute;
-      top: 0;
-      left: 0;
-      bottom: 0;
-      right: 0;
+      @include layout.absolute-fill();
       overflow: hidden;
       padding-top: 0;
       background-color: color.get(rgb(255, 255, 255));
@@ -399,40 +406,162 @@ $config: (
         border: 0;
         object-fit: cover;
         &::before {
-          position: absolute;
+          @include layout.absolute-fill(true);
           display: block;
-          top: 0;
-          bottom: 0;
-          left: 0;
-          right: 0;
           background-image: linear-gradient(to bottom, rgba(255, 255, 255, 0), rgba(0, 0, 0, 0.9));
         }
       }
     }
   }
 
+  // Incase this modifier is being used to hide the image
+  // not just to tell the component how to layout without image
+  // - Use case is hiding image when you can't control the output 
+  //   of the inside of the card (printed no matter what). We had
+  //   this happen in HHRC, including this extra CSS for that
+  #{ $prefix }--no-image {
+    #{ $prefix }__image {
+      display: none;
+    }
+  }
+  #{ $prefix }--image-fit {
+    #{ $prefix }__image {
+      img {
+        padding: get("image-fit-padding");
+        object-fit: contain;
+        object-position: top center;
+        filter: get("image-fit-filter");
+      }
+    }
+  }
+  #{ $prefix }--fill {
+    max-width: none;
+    height: 100%;
+    margin: 0;
+  }
+
   @if (get("horizontal-breakpoint")) {
     @include breakpoint.min(get("horizontal-breakpoint")) {
-      #{ $prefix }--horizontal {
-        display: flex;
-        justify-content: center;
-        align-items: center;
-        #{ $prefix }__image {
-          width: get("horizontal-image-width");
-          flex: 0 1 get("horizontal-image-width");
-          // max-width: 30rem;
-          min-height: 28rem;
-          // padding-top: 0;
+      @include -horizontal-card-styles();
+    }
+  } @else {
+    @include -horizontal-card-styles();
+  }
+}
+
+@mixin -horizontal-card-styles() {
+  $prefix: selector.class("card");
+
+  #{ $prefix }--horizontal {
+    display: grid;
+    grid-template-columns: get("horizontal-image-width") 1fr;
+    // Creating the two rows (body and footer), if one is missing it's height will be 0
+    // Cannot use gap with the grid as it will create space when a row isn't needed
+    grid-template-rows: auto auto;
+    min-height: get("horizontal-min-height");
+    max-width: get("horizontal-max-width");
+
+    // When no footer remove extra row
+    &:not(:has(> #{ $prefix }__footer)) {
+      grid-template-rows: auto;
+    }
+    #{ $prefix }__image {
+      grid-column: 1 / 2;
+      grid-row: 1 / -1;
+      aspect-ratio: auto;
+      border-top-right-radius: 0;
+      border-bottom-left-radius: get("border-radius");
+    }
+    #{ $prefix }__body,
+    #{ $prefix }__footer {
+      grid-column: 2 / 3;
+    }
+    #{ $prefix }__body {
+      flex-direction: row;
+      justify-content: space-between;
+    }
+    #{ $prefix }__main {
+      flex-grow: 1;
+      max-width: get("horizontal-main-max-width");
+    }
+    #{ $prefix }__aside {
+      flex: 0 0 get("horizontal-aside-width");
+      height: 100%;
+    }
+    @if(get("aside-rule")) {
+      #{ $prefix }__aside::after {
+        content: "";
+        position: absolute;
+        top: get("padding");
+        left: calc(0rem - get("aside-rule-width") / 2);
+        height: calc(100% - get("padding") - get("padding"));
+        width: get("aside-rule-width");
+        background-color: get("aside-rule-color");
+      }
+    }
+
+    // For modern browsers
+    // Optionally use no-image modifier for older browser support
+    &:not(:has(#{ $prefix }__image)) {
+      @include -card-horizontal-no-image-styles();
+    }
+    &#{ $prefix }--no-image {
+      @include -card-horizontal-no-image-styles();
+    }
+  }
+  #{ $prefix }--horizontal-center {
+    #{ $prefix }__body {
+      align-self: center;
+    }
+  }
+}
+
+
+/// Mixin styles for card when it has proxy click enabled and is being interacted with (hover/focus)
+/// @param {Boolean} $hover [false] Apply styles when the card is being hover/focused within, else applies styles to rest state of a clickable card (one who has a proxy click setup)
+/// Prints component styles
+/// @example scss
+///  @include ulu.component-card-styles();
+
+@mixin when-clickable($hover: false) {
+  $prefix: selector.class("card");
+  // When proxy click enabled
+  @if (get("clickable-card-enabled") and get("clickable-card-selector")) {
+    #{ $prefix }#{ get("clickable-card-selector") },
+    a#{ $prefix },
+    button#{ $prefix },
+    #{ $prefix }--clickable {
+      @if ($hover) {
+        #{ get("clickable-card-interact-selector") } {
+          @content;
         }
-        #{ $prefix }__body {
-          display: flex;
-          flex: 1;
-          flex-direction: column;
-          justify-content: center;
-          max-width: get("horizontal-body-max-width");
+      } @else {
+        @content;
+      }
+    }
+  // Without proxy click (only if interactive)
+  } @else {
+    a#{ $prefix },
+    button#{ $prefix },
+    #{ $prefix }--clickable {
+      @if ($hover) {
+        #{ get("clickable-card-interact-selector") } {
+          @content;
         }
+      } @else {
+        @content;
       }
     }
-  }
+  } 
 }
 
+
+// Internal mixin for DRY
+@mixin -card-horizontal-no-image-styles() {
+  $prefix: selector.class("card");
+  grid-template-columns: 1fr;
+  #{ $prefix }__body,
+  #{ $prefix }__footer {
+    grid-column: 1 / 2;
+  }
+}

package/scss/components/_counter-list.scss

@@ -0,0 +1,151 @@
+////
+/// @group counter-list
+/// Outputs a styled list with counters
+
+@use "sass:map";
+@use "sass:selector" as sassSelector;
+
+@use "../utils";
+@use "../selector";
+@use "../color";
+@use "../breakpoint";
+
+/// Module Settings
+/// @type Map
+/// @prop {List|CssUnit} margin [(2rem 0)] The top and bottom margin of the list.
+/// @prop {List|CssUnit} item-margin [((0 0 1rem 0))] The margin applied to each list item.
+/// @prop {Keyword} align-items [baseline] How to align the counter (flexbox align-items values)
+/// @prop {CssUnit} counter-width [2.4em] The width and height (if height is falsy)
+/// @prop {CssUnit} counter-height [null] The height (optional)
+/// @prop {CssUnit} counter-gap [1em] The gap between the counter and the list item content.
+/// @prop {String} counter-style [numeric] The list-style-type used for the counter.
+/// @prop {Keyword|Percentage} counter-border-radius [50%] The border-radius of the counter element.
+/// @prop {CssUnit} counter-font-size [1.2em] The font-size of the counter text.
+/// @prop {Color|String} counter-color [white] The text color of the counter. Accepts color names or hex codes.
+/// @prop {Color|String} counter-background-color ["accent"] The background color of the counter. Refers to a color in the color module.
+/// @prop {String} extra-selector [null] Additional selectors to include table styling.
+
+$config: (
+  "margin" : (2rem 0),
+  "item-margin" : (0 0 1rem 0),
+  "align-items" : baseline, 
+  "counter-width" : 2.4em,
+  "counter-height" : null,
+  "counter-gap" : 1em,
+  "counter-style" : numeric,
+  "counter-border-radius" : 50%,
+  "counter-font-size" : 1.2em,
+  "counter-font-weight" : null,
+  "counter-font-family" : null,
+  "counter-color" : white,
+  "counter-background-color" : "accent",
+  "extra-selector" : null
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-counter-list-set(( "property" : value ));
+
+@mixin set($changes) {
+  $config: map.merge($config, $changes) !global;
+}
+
+/// Get a config option
+/// @param {Map} $name Name of property
+/// @example scss
+///   @include ulu.component-counter-list-get("property");
+
+@function get($name) {
+  @return utils.require-map-get($config, $name, "counter-list [config]");
+}
+
+/// Output counter-list component styles
+/// @demo counter-list
+/// @example html {preview}
+///   <ol class="counter-list">
+///     <li class="counter-list__item">This is a item that will get counted</li>
+///     <li class="counter-list__item">Another item that has more content to show line wrapping. Lorem ipsum et depsi anu. Dolor et anu.</li>
+///     <li class="counter-list__item">Small Amount of Text</li>
+///   </ol>
+
+@mixin styles {
+  $prefix: selector.class("counter-list");
+  $prefix-item: sassSelector.parse("#{ $prefix }__item");
+  $extra-selector: get("extra-selector");
+
+  $selector: $prefix;
+  $selector-item: sassSelector.parse("#{ $prefix } > li, #{ $prefix-item }");
+
+  @if ($extra-selector) {
+    $selector: sassSelector.parse("#{ $prefix }, #{ $extra-selector }");
+    $selector-item: sassSelector.parse("#{ $selector-item }, #{ $extra-selector } > li");
+  }
+
+  #{ $selector } {
+    margin: get("margin");
+    counter-reset: ulu-counter-list;
+  }
+
+  #{ $selector-item } {
+    $width: get("counter-width");
+    $height: utils.fallback(get("counter-height"), $width);
+
+    display: flex;
+    gap: get("counter-gap");
+    align-items: get("align-items");
+    margin: get("item-margin");
+    min-height: $height;
+    &::before {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      width: $width;
+      height: $height;
+      flex: 0 0 $width;
+      counter-increment: ulu-counter-list;
+      content: counter(ulu-counter-list, get("counter-style"));
+      font-size: get("counter-font-size");
+      font-family: get("counter-font-family");
+      font-weight: get("counter-font-weight");
+      color: color.get(get("counter-color"));
+      background-color: color.get(get("counter-background-color"));
+      border-radius: get("counter-border-radius");
+    }
+
+    // Keeping this could be useful
+    // but we need to think about how its setup
+    // - Probably should be a modifier (choice)
+    // - May need either option for how align-items is set (flex-start vs center)
+    // - This could be useful when used in grid
+    // - May need to be pervasive and not linked to a breakpoint (alternate style)
+    // - It's also just useful to know you could override the layout like this 
+    //   to get useful variations (maybe we don't need to include it but users 
+    //   can do specific)
+    // @if ( get("counter-mobile-toggle") ) {
+    //   @include breakpoint.max("small") {
+    //     padding-left: 0;
+    //     padding-top: calc(get("counter-width") + get("counter-gap-mobile"));
+    //     flex-direction: column;
+    //     align-items: center;
+    //   }
+    // }
+  }
+
+  // Modifiers
+  #{ $prefix }--alphabetical {
+    & > li::before,
+    & > #{ $prefix-item }::before {
+      content: counter(ulu-counter-list, upper-alpha);
+    }
+  }
+  #{ $prefix }--numeric {
+    & > li::before,
+    & > #{ $prefix-item }::before {
+      content: counter(ulu-counter-list, numeric);
+    }
+  }
+  #{ $prefix }--no-reset {
+    counter-reset: none;
+  }
+}