@ulu/frontend 0.1.0-beta.1 → 0.1.0-beta.100

package/scss/components/_skeleton.scss

@@ -0,0 +1,126 @@
+////
+/// @group skeleton
+/// Placeholder component for skeleton (ie. loading state
+////
+
+@use "sass:map";
+@use "sass:list";
+@use "sass:math";
+@use "sass:meta";
+
+@use "../selector";
+@use "../utils";
+@use "../color";
+@use "../element";
+
+
+// Used for function fallback
+$-fallbacks: (
+  "border-radius" : (
+    "function" : meta.get-function("get", false, "element"),
+    "property" : "border-radius"
+  )
+);
+
+/// Module Settings
+/// @type Map
+/// @prop {CssValue} animation [pulse 2s cubic-bezier(0.4,0,0.6,1) infinite] The animation applied to skeleton elements.
+/// @prop {Color} color [type-disabled] The base color for skeleton elements.
+/// @prop {Color} background-color [#cbcbcb] The primary background color for skeleton elements.
+/// @prop {Color} background-color-alt [#aeaeae] An alternative background color for skeleton elements, used for variations.
+/// @prop {Dimension} border-radius [true] The border-radius for skeleton blocks and text. If set to true, uses the element.scss property for "border-radius".
+/// @prop {Dimension} inline-margin [0.35em] The margin between inline skeleton text elements.
+/// @prop {Number} media-ratio [(4/3)] The aspect ratio for skeleton media blocks (width/height).
+/// @prop {Dimension} text-border-radius [3em] The border-radius for skeleton text lines.
+/// @prop {Map} widths [Map] A map defining various width percentages for skeleton text lines (or used to size blocks/etc)
+
+$config: (
+  "animation" : UluPulse 2s cubic-bezier(0.4,0,0.6,1) infinite,
+  "color" : "type-disabled",
+  "background-color" : #e2e2e2,
+  "background-color-alt" : #bababa,
+  "border-radius": true,
+  "inline-margin" : 0.35em,
+  "media-ratio" : list.slash(4, 3),
+  "media-font-size" : 2rem,
+  "text-border-radius" : 3em,
+  "widths": (
+    "small-xxx" : 10%,
+    "small-xx" : 20%,
+    "small-x" : 30%,
+    "small" : 40%,
+    "large" : 70%,
+    "large-x" : 85%,
+    "large-xx" : 100%
+  ),
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-skeleton-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-skeleton-get("property");
+
+@function get($name) {
+  $value: utils.require-map-get($config, $name, "skeleton [config]");
+  @return utils.function-fallback($name, $value, $-fallbacks);
+}
+
+/// Prints component styles
+/// @demo skeleton
+/// @example scss
+///  @include ulu.component-skeleton-styles();
+
+@mixin styles {
+  $prefix: selector.class("skeleton");
+
+  #{ $prefix } {
+    animation: get("animation");
+    color: color.get(get("color"));
+  }
+  #{ $prefix }--background {
+    background-color: color.get(get("background-color")) !important;
+  }
+  #{ $prefix }--block,
+  #{ $prefix }--text,
+  #{ $prefix }--media {
+    animation: get("animation");
+    color: color.get(get("color"));
+    background-color: color.get(get("background-color")) !important;
+    border-radius: get("border-radius");
+  }
+  #{ $prefix }--media {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    aspect-ratio: get("media-ratio");
+    font-size: get("media-font-size");
+  }
+  #{ $prefix }--text {
+    height: 1em;
+    width: 60%;
+    border-radius: get("text-border-radius");
+  }
+  #{ $prefix }--inline {
+    display: inline-block;
+  }
+  #{ $prefix }--inline + #{ $prefix }--inline {
+    margin-left: get("inline-margin");
+  }
+  #{ $prefix }--background-alt {
+    background-color: color.get(get("background-color-alt")) !important;
+  }
+  @each $name, $value in get("widths") {
+    #{ $prefix }--width-#{ $name } {
+      width: $value;
+    }
+  }
+}

package/scss/components/_skip-link.scss

@@ -7,6 +7,7 @@
 @use "sass:meta";
 
 @use "../element";
+@use "../color";
 @use "../layout";
 @use "../selector";
 @use "../utils";
@@ -83,7 +84,7 @@ $config: (
     left: 50%;
     transform: translateX(-50%);
     padding: get("padding");
-    background-color: get("background-color");
+    background-color: color.get(get("background-color"));
     font-weight: bold;
     box-shadow: get("box-shadow");
     border-bottom-left-radius: get("border-radius");

package/scss/components/_slider.scss

@@ -7,86 +7,55 @@
 
 @use "../color";
 @use "../utils";
-@use "../breakpoint";
 @use "../selector";
 
 /// Module Settings
 /// @type Map
 /// @prop {Color} background-color [transparent] Background color for the entire slider section.
-/// @prop {List} breakpoint ["small"] Currently commented out @joe-check
-/// @prop {Dimension} margin-bottom [3rem] Bottom margin color for the entire slider section.
-/// @prop {Dimension} margin-top [1rem] Top margin color for the entire slider section.
-/// @prop {Dimension} padding-bottom [0] Bottom padding for individual slides.
-/// @prop {Dimension} padding-bottom-small [0] Smaller option for bottom padding for individual slides. Currently commented out @joe-check
+/// @prop {Dimension} margin [(1rem 0 3rem 0)] Margin for slider container
 /// @prop {Dimension} padding-top [0] Top padding for individual slides.
-/// @prop {Dimension} padding-top-small [0] Smaller option for top padding for individual slides. Currently commented out @joe-check
-/// @prop {Color} button-background-color [transparent] Currently unused @joe-check
-/// @prop {Color} button-background-color-hover [color.get("link-hover")] Currently unused @joe-check
-/// @prop {CssValue} button-border [2px solid color.get("link")] Currently unused @joe-check
-/// @prop {Color} button-border-color-hover  [color.get("link-hover")] Currently unused @joe-check
-/// @prop {Dimension} button-border-radius [50%] Currently unused @joe-check
-/// @prop {Color} button-color [color.get("link")] Currently unused @joe-check
-/// @prop {Color} button-color-hover [white] Currently unused @joe-check
-/// @prop {Dimension} button-font-size [1.35rem] Currently unused @joe-check
-/// @prop {Dimension} button-font-size-small [false] Currently unused @joe-check
-/// @prop {Dimension} button-icon-offset-x [false] Offsets the control icons in from their respective sides. @joe-check
-/// @prop {Dimension} button-icon-offset-y [false] Offsets the control options down by adding a margin. 
+/// @prop {Dimension} button-offset-x [null] Offsets the control button in from their respective sides.
+/// @prop {Dimension} button-offset-y [null] Offsets the control button y
 /// @prop {Dimension} button-margin [0.75rem] The margin between the controls and the slide content when using .slider__slide-gap-for-controls
-/// @prop {Dimension} button-margin-small [0.75rem] Currently commented out @joe-check
-/// @prop {Dimension} button-size [3rem] Size of the button. Likely antiquated and replaced with button-width and button-height
-/// @prop {Dimension} button-size-small [false] Currently commented out @joe-check
-/// @prop {Color} dot-background-color [transparent] The color of the dot when unselected.
-/// @prop {Color} dot-background-color-hover [color.get("link")] The color of the dot when hovered.
-/// @prop {Color} dot-background-color-selected [color.get("link")] The color of the dot when selected.
-/// @prop {Dimension} dot-border-radius [50%] The border-radius of the dot.
-/// @prop {Color} dot-border-color [color.get("link")] The border color of the dot.
-/// @prop {Color} dot-border-color-hover [color.get("link")] The border color of the dot when hovered.
-/// @prop {Color} dot-border-color-selected [color.get("link")] The border color of the dot when selected.
-/// @prop {Dimension} dot-border-width [2px] The border width of the dot.
-/// @prop {Dimension} dot-size  [1rem] The height and width of the dot.
-/// @prop {Dimension} button-height  [1rem] The height of the button.
+/// @prop {Color} nav-margin [(0.5rem 0)] Margin for nav (dots)
+/// @prop {Color} nav-background-color [transparent] The color of the dot when unselected.
+/// @prop {Color} nav-background-color-hover [color.get("link")] The color of the dot when hovered.
+/// @prop {Color} nav-background-color-selected [color.get("link")] The color of the dot when selected.
+/// @prop {Dimension} nav-border-radius [50%] The border-radius of the dot.
+/// @prop {Color} nav-border-color [color.get("link")] The border color of the dot.
+/// @prop {Color} nav-border-color-hover [color.get("link")] The border color of the dot when hovered.
+/// @prop {Color} nav-border-color-selected [color.get("link")] The border color of the dot when selected.
+/// @prop {Dimension} nav-border-width [2px] The border width of the dot.
+/// @prop {Dimension} nav-size  [1rem] The height and width of the dot.
+/// @prop {Dimension} nav-gap  [0.2rem] Gap between nav items
 /// @prop {Dimension} button-width  [1rem] The width of the button.
 
 $config: (
   "background-color" : transparent,
-  "breakpoint" : "small",
-  "margin-bottom" : 3rem,
-  "margin-top" : 1rem,
-  "button-background-color" : transparent,
-  "button-border" : 2px solid color.get("link"),
-  "button-border-color-hover" :  color.get("link-hover"),
-  "button-border-radius" : 50%,
-  "button-color-hover" : white,
-  "button-background-color-hover" : color.get("link-hover"),
-  "button-color" : color.get("link"),
-  "button-font-size" : 1.35rem,
-  "button-icon-offset-x" : 2rem,
-  "button-icon-offset-y" : false,
-  "button-font-size-small" : false,
-  "button-margin" : 2rem,
-  "button-margin-small" : 0.75rem,
-  "button-size" : 3rem,
-  "button-size-small" : false,
-  "button-height": 2.5rem,
-  "button-width": 2.5rem,
-  "dot-background-color" : transparent,
-  "dot-background-color-hover" : color.get("link"),
-  "dot-background-color-selected" : color.get("link"),
-  "dot-border-color" : color.get("link"),
-  "dot-border-color-hover" : color.get("link"),
-  "dot-border-color-selected" : color.get("link"),
-  "dot-border-radius" : 50%,
-  "dot-border-width" : 2px,
-  "dot-size" :  1rem,
+  "margin" : (1rem 0 3rem 0),
   "padding-bottom" : 0,
-  "padding-bottom-small" : 0,
   "padding-top" : 0,
-  "padding-top-small" : 0,
+  "button-offset-x" : null,
+  "button-offset-y" : null,
+  "button-margin" : 2rem,
+  "button-width": 2.5rem,
+  "nav-background-color" : transparent,
+  "nav-background-color-hover" : "link",
+  "nav-background-color-selected" : "link",
+  "nav-border-color" : "link",
+  "nav-border-color-hover" : "link",
+  "nav-border-color-selected" : "link",
+  "nav-border-radius" : 50%,
+  "nav-gap" : 0.2rem,
+  "nav-border-width" : 2px,
+  "nav-size" :  1rem,
+  "nav-margin" : (0.5rem 0),
+  
   ) !default;
   
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example scss - General example
+/// @example scss 
 ///   @include ulu.component-slider-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -95,7 +64,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example scss - General example
+/// @example scss 
 ///   @include ulu.component-slider-get("property");
 
 @function get($name) {
@@ -112,8 +81,8 @@ $config: (
   $slide-padding-x: get("button-width") + get("button-margin");
   #{ $prefix } {
     position: relative; // for controls
-    background-color: get("background-color");
-    margin: get("margin-top") 0 get("margin-bottom") 0;
+    background-color: color.get(get("background-color"));
+    margin: get("margin");
   }
   #{ $prefix }__track,
   #{ $prefix-plugin }__controls,
@@ -126,34 +95,30 @@ $config: (
     top: 50%;
     transform: translateY(-50%);
     z-index: 10;
-  }
-  @if get("button-icon-offset-y") {
-    #{ $prefix-plugin }__control-icon {
-      margin-top: get("button-icon-offset-y");
-    }
+    margin-top: get("button-offset-y");
   }
   #{ $prefix-plugin }__nav {
     display: flex;
     justify-content: center;
-    li {
-      margin: 0.5rem 0.15rem;
-    }
+    margin: get("nav-margin");
+    gap: get("nav-gap");
   }
   #{ $prefix-plugin }__nav-button {
     display: block;
-    width: get("dot-size");
-    height: get("dot-size");
-    background-color: get("dot-background-color");
-    border: get("dot-border-width") solid get("dot-border-color");
-    border-radius: get("dot-border-radius");
+    width: get("nav-size");
+    height: get("nav-size");
+    background-color: color.get(get("nav-background-color"));
+    border: get("nav-border-width") solid color.get(get("nav-border-color"));
+    border-radius: get("nav-border-radius");
     &:hover {
-      background-color: get("dot-background-color-hover");
+      background-color: color.get(get("nav-background-color-hover"));
+      border-color: color.get(get("nav-border-color-hover"));
     }
   }
   #{ $prefix-plugin }__nav-button--active,
   #{ $prefix-plugin }__nav-button--active:hover {
-    background-color: get("dot-background-color-selected");
-    border-color: get("dot-border-color-selected");
+    background-color: color.get(get("nav-background-color-selected"));
+    border-color: color.get(get("nav-border-color-selected"));
   }
   #{ $prefix-plugin }__control-button,
   #{ $prefix-plugin }__nav-button {
@@ -180,14 +145,7 @@ $config: (
   }
   #{ $prefix }__slide {
     margin: 0;
-    // @if (get("button-size-small")) {
-    //   @include breakpoint.max(get("breakpoint")) {
-    //     $bp-slide-padding: get("button-size-small") + get("button-margin-small");
-    //     padding: get("padding-top-small") $bp-slide-padding get("padding-bottom-small") $bp-slide-padding;
-    //   }
-    // }
-  }
-  // @joe-check should we remove this modifier for universal slide padding in favor of the individualized modifiers below?
+  }
   #{ $prefix }--slide-control-margins {
     #{ $prefix }__slide {
       padding: get("padding-top") $slide-padding-x get("padding-bottom") $slide-padding-x;
@@ -200,42 +158,25 @@ $config: (
   }
   #{ $prefix-plugin }__control-button--previous {
     left: 0;
-    @if get("button-icon-offset-x")  {
-      #{ $prefix-plugin }__control-icon {
-        margin-left: get("button-icon-offset-x");
-      }
-    }
+    margin-left: get("button-offset-x");
   }
   #{ $prefix-plugin }__control-button--next {
     right: 0;
-    @if get("button-icon-offset-x")  {
-      #{ $prefix-plugin }__control-icon {
-        margin-right: get("button-icon-offset-x");
-      }
-    }
+    margin-right: get("button-offset-x");
   }
   #{ $prefix }--inset-controls {
     #{ $prefix }__slide-gap-for-controls {
-      $padding: get("button-width") + get("button-margin") + get("button-icon-offset-x");
+      $padding: get("button-width") + get("button-margin") + get("button-offset-x");
       padding-left: $padding;
       padding-right: $padding;
     }
     #{ $prefix-plugin }__control-button--previous {
       left: 0;
-      @if get("button-icon-offset-x")  {
-        &#{ $prefix-plugin }__control-icon {
-          margin-left: get("button-icon-offset-x");
-          
-        }
-      }
+      margin-left: get("button-offset-x");
     }
     #{ $prefix-plugin }__control-button--next {
       right: 0;
-      @if get("button-icon-offset-x")  {
-        &#{ $prefix-plugin }__control-icon {
-          margin-right: get("button-icon-offset-x");
-        }
-      }
+      margin-right: get("button-offset-x");
     }
   }
 }

package/scss/components/_spoke-spinner.scss

@@ -96,7 +96,7 @@ $styles: () !default;
     transform-origin: $sizeHalf $sizeHalf;
     animation: UluFadeOut get("duration") linear infinite;
   }
-  #{ $prefix }__spinner div:after {
+  #{ $prefix }__spinner div::after {
     content: " ";
     display: block;
     position: absolute;
@@ -181,7 +181,7 @@ $styles: () !default;
         transform-origin: $sizeHalf $sizeHalf;
         animation-duration: map.get($merged, "duration");
       }
-      #{ $prefix }__spinner div:after {
+      #{ $prefix }__spinner div::after {
         left: $sizeHalf - $spoke-widthHalf;
         width: $spoke-width;
         height: map.get($merged, "spoke-height");

package/scss/components/_sticky-list.scss

@@ -0,0 +1,206 @@
+
+////
+/// @group sticky-list
+////
+/// Sticky first column, sticky elements inside adjacent columns to first. (Sticky list with header)
+
+@use "sass:map";
+@use "sass:meta";
+@use "sass:color" as sassColor;
+
+@use "../color";
+@use "../element";
+@use "../breakpoint";
+@use "../typography";
+@use "../utils";
+@use "../selector";
+
+// Used for function fallback
+$-fallbacks: (
+  "margin" : (
+    "function" : meta.get-function("get", false, "element"),
+    "property" : "margin"
+  ),
+);
+
+/// Module Settings
+/// @type Map
+/// @prop {Color} background-color [transparent] Background color for the entire slider section.
+/// @prop {Number} margin [true] Margin on ends of component (defaults to element margin)
+/// @prop {Number} mask-offset-bottom [55vh] The offset for the mask (on bottom)
+/// @prop {Number} mask-offset-top [5rem] The offset for the mask (on top)
+/// @prop {Number} sticky-top [45vh] When to stick
+/// @prop {String} breakpoint ["medium"] The upward breakpoint that this is allowed to be sticky 
+/// @prop {String} type-size ["medium"] The typography size to use for title
+/// @prop {Number} title-width [40%] The width of the title when this is displayed in columns
+/// @prop {Number} title-min-width [8em] The min width for title when displayed in columns
+/// @prop {CssValue} title-text-align [right] Text alignment for title when displayed in columns
+/// @prop {Number} item-padding-x [0] Optional padding on the left/right for items
+/// @prop {Number} gap [2rem] The gap between title and items when displayed in columns
+/// @prop {Color} background-color [white] The background color used for the mask
+/// @prop {List} background-contexts Adjust the background mask color by contextual selectors. Pass List of Maps with ("selector" [parent/contextual selector], "background-color", "item-padding-x" [optional])  
+
+$config: (
+  "margin" : true,
+  "mask-offset-bottom" : 55vh,
+  "mask-offset-top" : 5rem,
+  "sticky-top" : 45vh,
+  "breakpoint" : "medium",
+  "type-size" : "large",
+  "title-width" : 40%,
+  "title-min-width" : 8em,
+  "title-text-align" : right,
+  "item-padding-x" : 0,
+  "gap" : 2rem,
+  "background-color" : white,
+  "background-contexts" : (
+    (
+      "selector" : ".background-dark",
+      "background-color" : black,
+      "item-padding-x" : 1em
+    ),
+  )
+);
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-sticky-list-set(( "property" : value ));
+
+@mixin set($changes) {
+  $config: map.merge($config, $changes) !global;
+}
+
+/// Set sizes map
+/// @param {Map} $changes Map of changes
+/// @param {String} $merge-mode Merge mode see utils.map-merge() [null|"deep"|"overwrite"]
+
+@mixin set-sizes($changes, $merge-mode: null) {
+  $sizes: utils.map-merge($sizes, $changes, $merge-mode) !global;
+}
+
+/// Get a config option
+/// @param {Map} $name Name of property
+/// @example scss
+///   @include ulu.component-sticky-list-get("property");
+
+@function get($name) {
+  $value: utils.require-map-get($config, $name, "sticky-list [config]");
+  @return utils.function-fallback($name, $value, $-fallbacks);
+}
+
+/// Prints component styles
+/// @demo sticky-list
+/// @example scss
+///   @include ulu.component-sticky-list-styles();
+/// @example html {preview}
+/// <div class="sticky-list">
+///   <strong class="sticky-list__title">Example:</strong>
+///   <ul class="sticky-list__list">
+///     <li class="sticky-list__item">
+///       Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras nec nisl magna
+///     </li>
+///     <li class="sticky-list__item">
+///       Aenean sollicitudin mauris lectus, blandit suscipit lectus fringilla sed
+///     </li>
+///     <li class="sticky-list__item">
+///       Suspendisse sollicitudin, justo sed efficitur tempor, risus
+///     </li>
+///     <li class="sticky-list__item">
+///       Suspendisse sollicitudin, justo sed efficitur tempor, risus
+///     </li>
+///     <li class="sticky-list__item">
+///       Suspendisse sollicitudin, justo sed efficitur tempor, risus
+///     </li>
+///   </ul>
+/// </div>
+
+@mixin styles {
+  $prefix: selector.class("sticky-list");
+  $mask-offset-top: get("mask-offset-top");
+  $mask-offset-bottom: get("mask-offset-bottom");
+  $type-size: get("type-size");
+  $sticky-top: get("sticky-top");
+
+  #{ $prefix } {
+    padding: get("margin") 0;
+  }
+  @include breakpoint.min(get("breakpoint")) {
+    #{ $prefix } {
+      display: flex;
+      align-items: flex-start;
+      gap: get("gap");
+      position: relative;
+      @if ($type-size and typography.has-size($type-size)) {
+        @include typography.size($type-size, $only-font-size: true);
+      } @else if ($type-size) {
+        @warn "Unable to find '#{$type-size}' typography size for title";
+      }
+    }
+    #{ $prefix }__title,
+    #{ $prefix } > :not(ul) {
+      display: block;
+      position: sticky;
+      top: $sticky-top;
+      flex-basis: get("title-width");
+      min-width: get("title-min-width");
+      padding-top: $mask-offset-top;
+      padding-bottom: $mask-offset-bottom;
+      text-align: get("title-text-align");
+    }
+    #{ $prefix }__list,
+    #{ $prefix } > ul {
+      list-style: none;
+      margin: 0;
+      display: flex;
+      flex-direction: column;
+      justify-content: space-between;
+      align-self: stretch;
+    }
+    #{ $prefix }__item,
+    #{ $prefix } > ul > li {
+      display: block;
+      position: sticky;
+      top: $sticky-top;
+      margin: 0 !important; // If in editor (to complicated for :not())
+      padding: $mask-offset-top get("item-padding-x") $mask-offset-bottom get("item-padding-x");
+      @include set-background(get("background-color"));
+    }
+    #{ $prefix }__item:first-child,
+    #{ $prefix } > ul > li:first-child {
+      margin-top: 0;
+    }
+    #{ $prefix }__item:last-child,
+    #{ $prefix } > ul > li:last-child {
+      margin-bottom: 0;
+    }
+  }
+
+  // Print out any contextual background styles
+  @each $props in get("background-contexts") {
+    $selector: map.get($props, "selector");
+    $item-padding-x: map.get($props, "item-padding-x");
+    @include breakpoint.min(get("breakpoint")) {
+      #{ $selector } {
+        #{ $prefix }__item,
+        #{ $prefix } > ul > li {
+          @if ($item-padding-x) {
+            padding-left: $item-padding-x;
+            padding-right: $item-padding-x;
+          }
+          @include set-background(map.get($props, "background-color"));
+        }
+      }
+    }
+  }
+}
+
+/// Outputs background color mask CSS (gradient from transparent to original color)
+/// @param {Color} $color The color to create the CSS for
+
+@mixin set-background($color) {
+  $color: color.get($color);
+  $color-transparent: sassColor.change($color, $alpha: 0);
+  background-color: $color;
+  background: linear-gradient(180deg, $color-transparent 0%, $color get("mask-offset-top"));
+}