@ulu/frontend 0.1.0-beta.11 → 0.1.0-beta.110

package/scss/components/_breadcrumb.scss

@@ -0,0 +1,110 @@
+////
+/// @group breadcrumb
+/// Breadcrumb trail list layout
+////
+
+@use "sass:map";
+@use "sass:math";
+@use "sass:meta";
+
+@use "../selector";
+@use "../utils";
+@use "../color";
+@use "../typography";
+
+
+// Used for function fallback
+$-fallbacks: (
+  "line-height" : (
+    "function" : meta.get-function("get", false, "typography"),
+    "property" : "line-height-densest"
+  ),
+);
+
+/// Module Settings
+/// @type Map
+/// @prop {List} margin [(0 0 1.25em 0)] Margin for component
+/// @prop {CssUnit} row-gap [0.35em] Gap when breadcrumbs wrap
+/// @prop {Color} color ["type-tertiary"] Base color (links inherit this)
+/// @prop {Color} color-hover ["link-hover"] Color for link hover
+/// @prop {CssUnit} line-height [true] Line height, defaults to typography line-height-densest
+/// @prop {CssUnit} item-max-width [15em] Max length of item text
+/// @prop {Color} separator-color [null] Optional color to apply to separator
+/// @prop {Number} separator-opacity [0.7] Optional opacity for separator
+/// @prop {List} separator-margin [(0 0.5em)] Separator margin
+
+$config: (
+  "row-gap":              0.5em,
+  "margin" :              (0 0 1.25em 0),
+  "color":                 "type-tertiary",
+  "color-hover":           "link-hover",
+  "line-height":           true,
+  "item-max-width":        15em,
+  "separator-margin":      (0 0.5em),
+  "separator-color":       null,
+  "separator-opacity":     0.7,
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-breadcrumb-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-breadcrumb-get("property");
+
+@function get($name) {
+  $value: utils.require-map-get($config, $name, "breadcrumb [config]");
+  @return utils.function-fallback($name, $value, $-fallbacks);
+}
+
+/// Prints component styles
+/// @demo breadcrumb
+/// @example scss
+///  @include ulu.component-breadcrumb-styles();
+
+@mixin styles {
+  $prefix: selector.class("breadcrumb");
+  
+  #{ $prefix } {
+    color: color.get(get("color"));
+    margin: get("margin");
+    line-height: get("line-height");
+  }
+  #{ $prefix }__list {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: get("row-gap") 0;
+  }
+  #{ $prefix }__item {
+    display: flex;
+    align-items: center;
+  }
+  #{ $prefix }__link,
+  #{ $prefix }__current {
+    white-space: nowrap;
+    overflow: hidden;
+    max-width: get("item-max-width");
+    text-overflow: ellipsis;
+  }
+  #{ $prefix }__link {
+    color: inherit;
+    text-decoration: none;
+    &:hover,
+    &:focus {
+      color: color.get(get("color-hover"));
+    }
+  }
+  #{ $prefix }__separator {
+    margin: get("separator-margin");
+    color: color.get(get("separator-color"));
+    opacity: get("separator-opacity");
+  }
+}

package/scss/components/_button-group.scss

@@ -0,0 +1,90 @@
+////
+/// @group button-group
+/// Groups a set of buttons
+////
+
+@use "sass:map";
+@use "sass:math";
+
+@use "../selector";
+@use "../utils";
+@use "../color";
+@use "../button";
+
+/// Module Settings
+/// @type Map
+/// @prop {Dimension}  gap  [0.45em] Gap between buttons
+/// @prop {Boolean}  no-min-width  [true] Buttons within the button group should have no min width
+
+$config: (
+  "gap": 0.45em,
+  "no-min-width" : true
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-button-group-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-button-group-get("property");
+
+@function get($name) {
+  @return utils.require-map-get($config, $name, "button-group [config]");
+}
+
+/// Prints component styles
+/// @demo button-group
+/// @example scss
+///  @include ulu.component-button-group-styles();
+
+@mixin styles {
+  $prefix: selector.class("button-group");
+  $prefix-button: selector.class("button");
+
+  $button-radius: button.get("border-radius");
+  
+  #{ $prefix } {
+    display: flex;
+    flex-wrap: wrap;
+    gap: get("gap");
+    #{ $prefix-button } {
+      margin: 0;
+    }
+  }
+  #{ $prefix }--joined {
+    flex-wrap: nowrap;
+    overflow-x: auto;
+    gap: 0;
+    // border-radius: button.get("border-radius");
+    #{ $prefix-button } {
+      position: relative; // To move to front when hover/active
+      border-radius: 0;
+      min-width: 0;
+      margin-left: -(button.get("border-width"));
+      &:first-child {
+        border-top-left-radius: $button-radius;
+        border-bottom-left-radius: $button-radius;
+        margin-left: 0;
+      }
+      &:last-child {
+        border-top-right-radius: $button-radius;
+        border-bottom-right-radius: $button-radius;
+      }
+      #{ button.get("active-selector") } {
+        z-index: 2;
+      }
+      &:hover,
+      &:focus {
+        z-index: 2;
+      }
+      
+    }
+  }
+}

package/scss/components/_button-verbose.scss

@@ -9,6 +9,8 @@
 @use "../utils";
 @use "../color";
 @use "../element";
+@use "../selector";
+@use "../button";
 
 // Used for function fallback
 $-fallbacks: (
@@ -23,6 +25,14 @@ $-fallbacks: (
   "box-shadow-hover" : (
     "function" : meta.get-function("get", false, "element"),
     "property" : "box-shadow-hover"
+  ),
+  "border-color" : (
+    "function" : meta.get-function("get", false, "button"),
+    "property" : "border-color"
+  ),
+  "border-width" : (
+    "function" : meta.get-function("get", false, "button"),
+    "property" : "border-width"
   )
 );
 
@@ -31,11 +41,14 @@ $-fallbacks: (
 /// @prop {Color} background-color [white] Background color for the button.
 /// @prop {Color} background-color-hover [link] Background color for the button when hovered or focused.
 /// @prop {String} border-radius [border-radius] Border radius of the button.
+/// @prop {String} border-width [null] Border width (or set to true to inherit button border width default)
+/// @prop {String} border-color [null] Border color (or set to true to inherit button border width default)
 /// @prop {CssValue} box-shadow [true] Box shadow for the button. If set to true, uses default box-shadow.
 /// @prop {CssValue} box-shadow-hover [true] Box shadow for the button when hovered or focused. If set to true, uses default box-shadow-hover.
 /// @prop {String} color [type] Text color for the button.
 /// @prop {String} color-hover [type] Text color for the button when hovered or focused.
 /// @prop {Color} icon-color [gray] Color for button icons.
+/// @prop {Color} icon-color-hover [null] Optional color for icon when hovered
 /// @prop {Dimension} icon-font-size [1.25rem] Font size for the button.
 /// @prop {Number} line-height [1.2] Line height for button text.
 /// @prop {Dimension} margin [1em] Margin for the button.
@@ -46,26 +59,44 @@ $-fallbacks: (
 /// @prop {String} title-color [link] Color of the title of the button.
 /// @prop {String} title-color-hover [link-hover] Color of the title of the button when hovered or focused.
 /// @prop {Dimension} title-margin [0.5em] Margin for the button's title.
+/// @prop {Boolean} cap [false] Enable left cap style 
+/// @prop {Color} cap-side ["left"] The side that gets the cap
+/// @prop {Number} cap-match-radius [true] The cap should have be rounded to match the parent's border radius
+/// @prop {Map} cap-options The options for cap (see element.cap for options)
+/// @prop {Map} cap-options-hover The options for cap when hovered
 
 $config: (
   "background-color" : white,
-  "background-color-hover" : "link",
-  "border-radius" : "border-radius",
+  "background-color-hover" : #F7F8F7,
+  "border-radius" : true,
+  "border-color" : null,
+  "border-width" : null,
   "box-shadow" : true,
   "box-shadow-hover" : true,
   "color" : "type",
   "color-hover" : "type",
   "icon-color": gray,
+  "icon-color-hover": null,
   "icon-font-size" : 1.25rem,
   "line-height" : 1.2,
   "margin" : 1em,
   "margin-inline" : 0.75em,
   "min-width": 20rem,
-  "padding-x": 0.65em,
+  "padding-x": 0.75em,
   "padding-y": 1em,
   "title-color": "link",
   "title-margin" : 0.5em,
   "title-color-hover" : "link-hover",
+  "cap" : false,
+  "cap-side" : "left",
+  "cap-match-radius" : true,
+  "cap-options" : (
+    "color" : "link",
+    "size" : 0.5rem,
+  ),
+  "cap-options-hover" : (
+    "color" : "link-hover"
+  ),
 ) !default;
 
 /// Change modules $config
@@ -89,50 +120,101 @@ $config: (
 
 /// Prints component styles
 /// @example scss
-///  @include ulu.component-button-verbose-styles();
+///   @include ulu.component-button-verbose-styles();
+/// @example html {preview} - Basic Example
+///   <a href="#" class="button-verbose">
+///     <strong class="button-verbose__title">Example Link</strong>
+///     <span class="button-verbose__body">This is the body</span>
+///     <span class="button-verbose__icon fas fa-arrow-right" aria-hidden="true"></span>
+///   </a>
 
 @mixin styles {
-  .button-verbose {
+  $prefix: selector.class("button-verbose");
+  $padding-x: get("padding-x");
+  $padding-y: get("padding-y");
+  $padding-right: ($padding-x * 2) + 1em;
+  $cap-side: get("cap-side");
+  $cap-defaults: (
+    "offset" : utils.if-type("number", get("border-width"), 0),
+    "border-radius" : if(get("cap-match-radius"), get("border-radius"), 0),
+    "padding-adjust" : if(utils.is-side($cap-side), $padding-x, $padding-y)
+  );
+  
+  #{ $prefix } {
+    position: relative; // For cap and icon
+    display: block;
     text-decoration: none;
-    border-radius: element.get(get("border-radius"));
+    border-radius: get("border-radius");
+    @if (get("border-width")) {
+      border: get("border-width") solid color.get(get("border-color"));
+    }
     box-shadow: get("box-shadow");
     line-height: get("line-height");
-    position: relative;
-    display: block;
     margin-bottom: get("margin");
     max-width: 100%;
     width: get("min-width");
     background-color: color.get(get("background-color"));
-    padding: get("padding-y") get("padding-x");
-    padding-right: (get("padding-x") * 2) + 1em;
+    padding: $padding-y $padding-right $padding-y $padding-x;
     color: color.get(get("color"));
+    text-align: left;
+
     &:hover {
       color: color.get(get("color-hover"));
       background-color: color.get(get("background-color-hover"));
       box-shadow: get("box-shadow-hover");
-      .button-verbose__title  {
-        color: color.get(get("title-color-hover"));
+      @if get("title-color-hover") {
+        #{ $prefix }__title  {
+          color: color.get(get("title-color-hover"));
+        }
+      }
+      @if get("icon-color-hover") {
+        #{ $prefix }__icon  {
+          color: color.get(get("icon-color-hover"));
+        }
+      }
+    }
+    @if get("cap") {
+      @include element.cap(
+        $side: $cap-side,
+        $options: map.merge($cap-defaults, get("cap-options"))
+      );
+      @if get("cap-options-hover") {
+        &:hover,
+        &:focus {
+          @include element.cap-appearance(
+            $side: $cap-side,
+            $options: get("cap-options-hover")
+          );
+        }
       }
     }
   }
-  .button-verbose__title {
+  #{ $prefix }__title,
+  #{ $prefix }__body {
     display: block;
-    margin-bottom: get("title-margin");
+    &:first-child {
+      margin-bottom: get("title-margin");
+    }
+  }
+  #{ $prefix }__title {
     color: color.get(get("title-color"));
   }
-  .button-verbose__icon {
+  #{ $prefix }__icon {
     position: absolute;
     top: 50%;
-    right: get("padding-x");
+    right: $padding-x;
     transform: translateY(-50%);
     font-size: get("icon-font-size");
     color: color.get(get("icon-color"));
   }
-  .button-verbose--inline {
+  #{ $prefix }--inline {
     display: inline-block;
     margin-right: get("margin-inline");
+    &:last-child {
+      margin-right: 0;
+    }
   }
-  .button-verbose--full-width {
+  #{ $prefix }--full-width {
     width: 100%;
   }
 }

package/scss/components/_callout.scss

@@ -27,48 +27,51 @@ $-fallbacks: (
 /// @prop {Boolean} border-radius [true] The border radius of the Callout.
 /// @prop {Dimension} border-width [1px] The border width of the Callout.
 /// @prop {CssValue} box-shadow [none] The box-shadow of the Callout.
-/// @prop {Boolean} left-cap [false] Toggles the use of left caps in styled callouts.
-/// @prop {Color} left-cap-color [green] Color of the left cap.
-/// @prop {Dimension} left-cap-width [0.5rem] Width of the left cap.
+/// @prop {Boolean} caps-disabled [false] If set will not output any cap styles for both base and styles
+/// @prop {Boolean} cap [false] Toggles the use of caps on default callout
+/// @prop {Boolean} cap-side ["left"] The side that gets the cap
+/// @prop {Number} cap-match-radius [true] The cap should have be rounded to match the parent's border radius
+/// @prop {Map} cap-options The options for cap (see element.cap for options)
 /// @prop {Dimension} margin [2rem] Bottom margin of the Callout.
 /// @prop {Dimension} padding [1.5rem] Padding of the Callout.
 
 $config: (
   "background-color" : rgb(240, 240, 240),
   "border-color" : "rule-light",
-  "border-radius" :  true,
+  "border-radius" :  6px,
   "border-width" : 1px,
   "box-shadow" : none,
-  "left-cap" : true,
-  "left-cap-color" : rgb(160, 160, 160),
-  "left-cap-width" : 0.5rem,
+  "caps-disabled" : false,
+  "cap" : false,
+  "cap-side" : "left",
+  "cap-match-radius" : false,
+  "cap-options" : (
+    "color" : rgb(160, 160, 160),
+    "size" : 0.5rem,
+  ),
   "margin" : 2rem,
   "padding" : 1.5rem,
 ) !default;
 
+/// Styles Map (for unique variations/modifiers)
+/// - Adjust this with set-styles
+/// @type Map
+
 $styles: (
   "outline" : (
     "background-color": transparent
   ),
   "info" : (
     "background-color" : "info-background",
-    "left-cap-color" : "info",
-    "left-cap" : true,
   ),
   "warning" : (
     "background-color" : "info-background",
-    "left-cap-color" : "info",
-    "left-cap" : true,
   ),
   "success" : (
     "background-color" : "success-background",
-    "left-cap-color" : "success",
-    "left-cap" : true,
   ),
   "danger" : (
     "background-color" : "danger-background",
-    "left-cap-color" : "danger",
-    "left-cap" : true,
   ),
 ) !default;
 
@@ -92,34 +95,30 @@ $styles: (
 }
 
 /// Set callout style variations
-/// @param {Map} $changes Map of changes (options for style include [background-color, color, border, border-radius, border-color, box-shadow, padding, left-cap, left-cap-width, left-cap-color]
+/// - Styles that modify padding when using mix-match caps on/off should be included last
+/// @param {Map} $changes Map of changes (options for style include [background-color, color, border-color, border-radius, border-width, box-shadow, padding, cap, cap-options]
 /// @param {String} $merge-mode Merge mode see utils.map-merge() [null|"deep"|"overwrite"]
 
 @mixin set-styles($changes, $merge-mode: null) {
   $styles: utils.map-merge($styles, $changes, $merge-mode) !global;
 }
 
-@mixin -left-cap($color: get("left-cap-color")) {
-  $left-padding: get-spacing-left(get("padding"));
-  position: relative; 
-  border-top-left-radius: 0;
-  border-bottom-left-radius: 0;
-  padding-left: get("left-cap-width") + $left-padding;
-  &::before {
-    content: "";
-  }
-}
-
 /// Output component stylesheet
 /// @example scss
 ///  @include ulu.component-callout-styles();
 
 @mixin styles {
-  $prefix: selector.class("callout");
-  
+  $prefix: selector.class("callout");  
+  $padding: get("padding");
+  $padding-info: utils.get-spacing($padding);
+  $cap-options: get("cap-options");
+  $cap-size: map.get($cap-options, "size");
+  $cap-side: get("cap-side");
+
   #{ $prefix } {
+    position: relative; // For cap
     background-color: color.get(get("background-color"));
-    padding: get("padding");
+    padding: $padding;
     border: get("border-width") solid color.get(get("border-color"));
     margin-bottom: get("margin");
     box-shadow: get("box-shadow");
@@ -127,36 +126,96 @@ $styles: (
     & >:first-child {
       margin-top: 0;
     }
-    &::before {
-      position: absolute;
-      left: 0 - get("border-width");
-      top: 0 - get("border-width");
-      bottom: 0 - get("border-width");
-      width: get("left-cap-width");
-      background-color: color.get(get("left-cap-color"));
+
+    // If we have left cap on default we reuse this for all
+    // Else we will print it out manually for each unique style
+    @if (not get("caps-disabled")) {   
+      $cap-defaults: (
+        "offset" : get("border-width"),
+        "border-radius" : if(get("cap-match-radius"), get("border-radius"), null),
+        // "padding-adjust" : map.get($padding-info, $cap-side)
+      );
+      @include element.cap(
+        $side: $cap-side,
+        $options: map.merge($cap-defaults, $cap-options)
+      );
     }
-    @if get("left-cap") {
-      @include -left-cap();
+      
+    // If the left cap is disabled we still include it's CSS but we hide it
+    // so that other styles of callouts can use it
+    @if (not get("cap")) {
       &::before {
-        content: "";
+        content: none;
       }
+    // Since this is hidden and reused we need to not use padding adjust unless it
+    // was visible
+    } @else if ($cap-size) {
+      padding-#{ $cap-side }: calc(map.get($padding-info, $cap-side) + $cap-size);
     }
   }
+
+  @include -output-style-modifiers();
+}
+
+// Output Each Style Modifier
+// - Note if cap is not disabled this will just update appearance values of cap styling
+@mixin -output-style-modifiers() {
+  $prefix: selector.class("callout");  
+  $caps-enabled: not get("caps-disabled");
+  $cap-side: get("cap-side");
+
   @each $name, $style in $styles {
+    $cap: map.get($style, "cap");
+    $padding: map.get($style, "padding");
+    $border-radius: map.get($style, "border-radius");
+    $background-color: map.get($style, "background-color");
+    $color: map.get($style, "color");
+    $border-color: map.get($style, "border-color");
+    $border-width: map.get($style, "border-width");
+    $box-shadow: map.get($style, "box-shadow");
+    $cap-match-radius: map.get($style, "cap-match-radius");
+
     #{ $prefix }--#{ $name } {
-      background-color: color.get(map.get($style, "background-color")); 
-      color: color.get(map.get($style, "color")); 
-      border: map.get($style, "border"); 
-      border-radius: map.get($style, "border-radius"); 
-      border-color: color.get(map.get($style, "border-color")); 
-      box-shadow: map.get($style, "box-shadow"); 
-      padding: map.get($style, "padding"); 
-      &::before {
-        background-color: color.get(map.get($style, "left-cap-color"));
-      }
-      @if map.get($style, "left-cap") {
-        @if not get("left-cap") {
-          @include -left-cap();
+      background-color: color.get($background-color); 
+      color: color.get($color); 
+      border-radius: $border-radius; 
+      border-color: color.get($border-color); 
+      border-width: $border-width; 
+      box-shadow: $box-shadow; 
+      padding: $padding; 
+
+      @if ($cap and $caps-enabled) {
+        $match-radius: utils.if-type("bool", $cap-match-radius, get("cap-match-radius"));
+        // Padding adjust always has to be set (since size could change or padding)
+        $padding-info: utils.get-spacing(if($padding, $padding, get("padding")));
+        $cap-radius: utils.if-type("number", $border-radius, get("border-radius"));
+        $cap-options: utils.ensure-map(map.get($style, "cap-options"));
+        $cap-defaults: (
+          "size" : map.get(get("cap-options"), "size"),
+          "padding-adjust" : map.get($padding-info, $cap-side),
+          "offset" : $border-width,
+          "border-radius" : if($match-radius, $cap-radius, null)
+        );
+
+        @include element.cap-appearance(
+          $side: $cap-side,
+          $options: map.merge($cap-defaults, $cap-options),
+          $before: true
+        );
+
+        // Because the main callout's cap may not be visible
+        &::before {
+          content: "";
+        }
+      // If set to false remove the cap (if enabled) and reset default cap padding adjust
+      } @else if ($cap == false and $caps-enabled) {
+        // if this style doesn't set padding
+        @if (not $padding) {
+          $padding-info: utils.get-spacing(get("padding"));
+          padding-#{ $cap-side }: map.get($padding-info, $cap-side);
+        }
+        &::before {
+          content: none;
         }
       }
     }

package/scss/components/_captioned-figure.scss

@@ -30,6 +30,23 @@ $-fallbacks: (
 
 /// Module Settings
 /// @type Map
+/// @prop {Boolean} text-alignment-matches [false] Toggles matching alignment.
+/// @prop {Boolean} text-alignment-matches-center-only [true] Toggles matching alignment, but only if center.
+/// @prop {Color} background-color [white] Background color of the component.
+/// @prop {CssValue} box-shadow [true] Box shadow the captioned figure.
+/// @prop {Dimension} margin-bottom [true] Bottom margin of the captioned figure.
+/// @prop {Number} line-height [true] Line height of the captioned figure caption.
+/// @prop {Dimension} caption-padding [0.5em] Padding of the captioned figure caption. 
+/// @prop {Color} color [null] Font color of the captioned figure caption. 
+/// @prop {String} type-size ["small"] Font size of the captioned figure caption. 
+/// @prop {Dimension} caption-max-width [min(100%, 15em)] Max width of the captioned figure caption. 
+/// @prop {Color} caption-background-color [rgba(255,255,255,0.7)] background color of the captioned figure caption. 
+/// @prop {CssValue} caption-backdrop-filter [blur(2px)] Filter of the backdrop of the captioned figure.
+/// @prop {Color} traditional-caption-color [null] Traditional style for font color.
+/// @prop {Color} traditional-caption-background-color [transparent] Traditional style for caption background color.
+/// @prop {Dimension} traditional-caption-padding [0.5em] Traditional style for caption padding.
+/// @prop {Dimension} traditional-caption-max-width [35em] Traditional style for caption max width.
+/// @prop {CssValue} traditional-caption-text-align [right] Traditional style for caption text-align.
 
 $config: (
   "text-alignment-matches" : false,