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

package/scss/components/_popover.scss

@@ -29,38 +29,41 @@ $-fallbacks: (
 
 /// Module Settings
 /// @type Map
-/// @prop {Dimension} arrow-size [16px]
-/// @prop {Color} background-color [white]
-/// @prop {Dimension} border-radius [6px]
-/// @prop {Color} color [inherit]
-/// @prop {Dimension} max-width [90vw]
-/// @prop {Dimension} max-height [25rem]
-/// @prop {Dimension} padding [1rem]
-/// @prop {Dimension} padding-large [2rem]
-/// @prop {Dimension} type-size [null]
-/// @prop {Number} z-index [true]
-/// @prop {CssValue} box-shadow [true]
-/// @prop {CssValue} box-shadow-footer [0 0 4px]
-/// @prop {String} box-shadow-footer-color ["box-shadow"]
-/// @prop {Color} header-background-color [#ccc]
-/// @prop {Color} header-color [null]
-/// @prop {Color} header-media-background-color [black]
-/// @prop {Dimension} header-padding-y [0.25rem]
-/// @prop {Color} footer-background-color [#ccc]
-/// @prop {Color} footer-color [null]
-/// @prop {Dimension} footer-padding-y [0.25rem]
-/// @prop {Dimension} footer-padding-y-large [0.5rem]
-/// @prop {Color} tooltip-background-color [white]
-/// @prop {Color} tooltip-color [null]
-/// @prop {Dimension} tooltip-max-width [20rem]
-/// @prop {Dimension} tooltip-padding [0.5rem]
-/// @prop {Dimension} tooltip-width [auto]
-/// @prop {Dimension} width [15rem]
-/// @prop {Dimension} width-large [30rem]
-/// @prop {Dimension} width-large-x [50rem]
+/// @prop {Dimension} arrow-size [16px] Size of the dropdown arrow.
+/// @prop {Boolean} arrow-box-shadow [true] When true the arrow will get the popover's box shadow. Note if the box shadow is not a list (for example custom property), the mask won't be calculated from the box-shadow (use arrow-box-shadow-extent to specify manually)
+/// @prop {Number} arrow-box-shadow-extent [null] If set will determine the amount of overlap added to the arrow mask, else it's calculated automatically by the box-shadow option (can be used if box-shadow is custom property)
+/// @prop {Color} background-color [white] Background color of the popover.
+/// @prop {Dimension} border-radius [6px] Border radius of the popover.
+/// @prop {Color} color [inherit] Text color of the popover.
+/// @prop {Dimension} max-width [90vw] Max width of the popover.
+/// @prop {Dimension} max-height [25rem] Max height of the popover.
+/// @prop {Dimension} padding [1rem] Padding of the popover.
+/// @prop {Dimension} padding-large [2rem] Padding of the popover if using "--large" or "--large-x" styling.
+/// @prop {Dimension} type-size [null] Font size of the popover.
+/// @prop {Number} z-index [true] z-index of the popover.
+/// @prop {CssValue} box-shadow [true] Box shadow of the popover.
+/// @prop {Color} header-background-color [#ccc] Background color of the popover header
+/// @prop {Color} header-color [null] Text color for the header.
+/// @prop {Color} header-media-background-color [black] background color for header media.
+/// @prop {Dimension} header-padding-y [0.25rem] Vertical padding of the header.
+/// @prop {Color} footer-background-color [#ccc] Background color of the footer.
+/// @prop {Color} footer-border-top [1px solid #dfdfdf] Optional border used to separate the content from footer
+/// @prop {Color} footer-color [null] Text color of the footer.
+/// @prop {Dimension} footer-padding-y [0.25rem] Vertical padding of the footer.
+/// @prop {Dimension} footer-padding-y-large [0.5rem] Vertical padding of the footer if using "--large" or "--large-x" styling.
+/// @prop {Color} tooltip-background-color [white] Background color of the tooltip.
+/// @prop {Color} tooltip-color [null] Font color of the tooltip.
+/// @prop {Dimension} tooltip-max-width [20rem] Max width of the tooltip.
+/// @prop {Dimension} tooltip-padding [0.5rem] Padding of the tooltip.
+/// @prop {Dimension} tooltip-width [auto] Width of the tooltip.
+/// @prop {Dimension} width [15rem] Width of the popover.
+/// @prop {Dimension} width-large [30rem] Width of the popover if using "--large".
+/// @prop {Dimension} width-large-x [50rem] Width of the popover if using "--large-x".
 
 $config: (
   "arrow-size"                   : 16px,
+  "arrow-box-shadow"             : true,
+  "arrow-box-shadow-extent"      : null,
   "background-color"             : white,
   "border-radius"                : 6px,
   "color"                        : inherit,
@@ -70,14 +73,12 @@ $config: (
   "padding-large"                : 2rem,
   "type-size"                    : null,
   "z-index"                      : true,
-  
   "box-shadow"                   : true,
-  "box-shadow-footer"            : 0 0 4px,
-  "box-shadow-footer-color"      : "box-shadow",
   "header-background-color"      : #ccc,
   "header-color"                 : null,
   "header-media-background-color": black,
   "header-padding-y"             : 0.25rem,
+  "footer-border-top"            : 1px solid #dfdfdf,  
   "footer-background-color"      : #ccc,
   "footer-color"                 : null,
   "footer-padding-y"             : 0.25rem,
@@ -94,7 +95,7 @@ $config: (
   
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example
+/// @example scss
 ///   @include ulu.component-popover-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -103,7 +104,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example
+/// @example scss
 ///   @include ulu.component-popover-get("property");
 
 @function get($name) {
@@ -117,47 +118,17 @@ $config: (
 
 @mixin styles {
   $prefix: selector.class("popover");
-  $arrow-size-half: math.div(get("arrow-size"), 2);
 
   @if (get("arrow-size")) {
-    #{ $prefix }__arrow {
-      display: block;
-      visibility: hidden;
-      z-index: 1;
-      &,
-      &:before {
-        position: absolute;
-        width: get("arrow-size");
-        height: get("arrow-size");
-        background: inherit;
-      }
-      &:before {
-        visibility: visible;
-        content: '';
-        transform: rotate(45deg);
-        // box-shadow: $box-shadow;
-      }
-      [data-placement^='top'] > & {
-        bottom: -($arrow-size-half);
-      }
-      [data-placement^='bottom'] > & {
-        top: -($arrow-size-half);
-      }
-      [data-placement^='left'] > & {
-        right: -($arrow-size-half);
-      }
-      [data-placement^='right'] > & {
-        left: -($arrow-size-half);
-      }
-    }
+    @include -arrow-styles();
   }
   // Default position is on the right of the container (Popper handles positioning)
   #{ $prefix } {
     display: none;
     position: absolute;
     z-index: get("z-index") + 1;
-    background-color: get("background-color");
-    color: get("color");
+    background-color: color.get(get("background-color"));
+    color: color.get(get("color"));
     width: get("width");
     max-width: get("max-width");
     box-shadow: get("box-shadow");
@@ -189,18 +160,18 @@ $config: (
   #{ $prefix }__header {
     overflow: hidden;
     padding: get("header-padding-y") get("padding");
-    color: get("header-color");
-    background-color: get("header-background-color");
+    color: color.get(get("header-color"));
+    background-color: color.get(get("header-background-color"));
   }
   #{ $prefix }__header--media {
     padding: 0;
-    background-color: get("header-media-background-color");
+    background-color: color.get(get("header-media-background-color"));
   }
   #{ $prefix }__footer {
-    box-shadow: get("box-shadow-footer") color.get(get("box-shadow-footer-color"));
+    border-top: get("footer-border-top");
     padding: get("footer-padding-y") get("padding");
-    color: get("footer-color");
-    background-color: get("footer-background-color");
+    color: color.get(get("footer-color"));
+    background-color: color.get(get("footer-background-color"));
     border-top-left-radius: 0;
     border-top-right-radius: 0;
   }
@@ -215,8 +186,8 @@ $config: (
   #{ $prefix }--tooltip {
     width: get("tooltip-width");
     max-width: min(get("max-width"), get("tooltip-max-width"));
-    color: get("tooltip-color");
-    background-color: get("tooltip-background-color");
+    color: color.get(get("tooltip-color"));
+    background-color: color.get(get("tooltip-background-color"));
     pointer-events: none;
     #{ $prefix }__inner {
       padding: get("tooltip-padding");
@@ -260,4 +231,134 @@ $config: (
       }
     }
   }
+}
+
+@mixin -arrow-styles() {
+  @if get("arrow-box-shadow") {
+    @include -arrow-styles-with-box-shadow();
+  } @else {
+    @include -arrow-styles-simple();
+  }
+}
+
+// Internal mixin for original arrow styles without box-shadow
+@mixin -arrow-styles-simple() {
+  $prefix: selector.class("popover");
+  $size: get("arrow-size");
+  $half: math.div($size, 2);
+
+  #{ $prefix }__arrow {
+    visibility: hidden;
+    z-index: 1;
+    &,
+    &::before {
+      display: block;
+      position: absolute;
+      width: $size;
+      height: $size;
+      background: inherit;
+    }
+    &::before {
+      visibility: visible;
+      content: '';
+      transform: rotate(45deg);
+    }
+    [data-placement^="top"] > & {
+      bottom: -($half);
+    }
+    [data-placement^="bottom"] > & {
+      top: -($half);
+    }
+    [data-placement^="left"] > & {
+      right: -($half);
+    }
+    [data-placement^="right"] > & {
+      left: -($half);
+    }
+  }
+  // Account for footer and change arrow color when positioned next to it
+  #{ $prefix }__footer ~ #{ $prefix }__arrow {
+    [data-placement^="top"] > & {
+      &::before {
+        background-color: get("footer-background-color");
+      }
+    }
+  }
+}
+
+// Internal mixin for arrow styles when using the mask (extra pseudo element)
+@mixin -arrow-styles-with-box-shadow() {
+  $prefix: selector.class("popover");
+  $box-shadow: get("box-shadow");
+  $size: get("arrow-size");
+  $half: math.div($size, 2);
+  $size-info: utils.number-info($size);
+  $unitless: map.get($size-info, "value");
+  $unit: map.get($size-info, "unit");
+  $hypotenuse: utils.hypotenuse($unitless, $unitless);
+  $hypotenuse-half: math.div($hypotenuse, 2);
+  $manual-extent: get("arrow-box-shadow-extent");
+  $shadow-extent: if(
+    $manual-extent,
+    $manual-extent,
+    if(utils.is-list($box-shadow), utils.box-shadow-extent($box-shadow), 5px)
+  );
+  $overlap: utils.strip-unit($shadow-extent);
+  $mask-height: utils.add-unit($hypotenuse-half + $overlap, $unit);
+  $mask-width: utils.add-unit($hypotenuse + $overlap, $unit);
+  
+  #{ $prefix }__arrow {
+    visibility: hidden;
+    z-index: 1;
+    &,
+    &::before,
+    &::after {
+      display: block;
+      position: absolute;
+      width: $size;
+      height: $size;
+      background: inherit;
+    }
+    &::before,
+    &::after {
+      visibility: visible;
+      content: '';
+    }
+    &::before {
+      box-shadow: get("box-shadow");
+      transform: rotate(45deg);
+    }
+    // Masking shape
+    &::after {
+      top: 50%;
+      left: 50%;
+      transform: translateX(-50%);
+      height: $mask-height;
+      width: $mask-width;
+    }
+    [data-placement^="top"] > & {
+      bottom: -($half);
+      transform: rotate(180deg); // Rotate w. mask
+    }
+    [data-placement^="bottom"] > & {
+      top: -($half);
+    }
+    [data-placement^="left"] > & {
+      right: -($half);
+      transform: rotate(90deg); // Rotate w. mask
+    }
+    [data-placement^="right"] > & {
+      left: -($half);
+      transform: rotate(-90deg); // Rotate w. mask
+    }
+  }
+  // Account for footer and change arrow color when positioned next to it
+  #{ $prefix }__footer ~ #{ $prefix }__arrow {
+    [data-placement^="top"] > & {
+      &::before,
+      &::after {
+        background-color: get("footer-background-color");
+      }
+    }
+  }
 }

package/scss/components/_pull-quote.scss

@@ -21,18 +21,18 @@ $-fallbacks: (
 
 /// Module Settings
 /// @type Map
-/// @prop {} body-line-height [true]
-/// @prop {} image-margin-bottom [1rem]
-/// @prop {} image-margin-top [2.5rem]
-/// @prop {} name-margin-bottom [1rem]
-/// @prop {} padding-y [2em]
-/// @prop {} title-font-style [italic]
-/// @prop {} quote-mark-character ["\201c"]
-/// @prop {} quote-mark-color [null]
-/// @prop {} quote-mark-font-family ["Georgia"]
-/// @prop {} quote-mark-font-size [3.75em]
-/// @prop {} quote-mark-enabled [true]
-/// @prop {} quote-mark-line-height [0.35]
+/// @prop {Number} body-line-height [true]
+/// @prop {Dimension} image-margin-bottom [1rem]
+/// @prop {Dimension} image-margin-top [2.5rem]
+/// @prop {Dimension} name-margin-bottom [1rem]
+/// @prop {Dimension} padding-y [2em]
+/// @prop {CssValue} title-font-style [italic]
+/// @prop {String} quote-mark-character ["\201c"]
+/// @prop {Color} quote-mark-color [null]
+/// @prop {String} quote-mark-font-family ["Georgia"]
+/// @prop {Dimension} quote-mark-font-size [3.75em]
+/// @prop {Boolean} quote-mark-enabled [true]
+/// @prop {Number} quote-mark-line-height [0.35]
 
 $config: (
   "body-line-height" : true,
@@ -52,7 +52,7 @@ $config: (
 
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example
+/// @example scss
 ///   @include ulu.component-pull-quote-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -61,7 +61,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example
+/// @example scss
 ///   @include ulu.component-pull-quote-get("property");
 
 @function get($name) {
@@ -83,7 +83,7 @@ $config: (
   #{ $prefix }__body {
     line-height: get("body-line-height");
     @if (get("quote-mark-enabled")) {
-      &:before {
+      &::before {
         display: block;
         position: relative;
         // content: open-quote;

package/scss/components/_rail.scss

@@ -0,0 +1,127 @@
+////
+/// @group rail
+////
+/// A horizontal, flexible container for arranging diverse inline elements.
+/// It provides a consistent layout for icons, labels, buttons, or other
+/// modular components, aligning content to either end or centering it.
+/// Item spacing is controlled via margins, allowing for individual item gap adjustments.
+
+@use "sass:map";
+@use "sass:meta";
+@use "sass:math";
+
+@use "../utils";
+@use "../color";
+@use "../selector";
+@use "../layout";
+@use "../element"; 
+
+// Used for function fallback
+$-fallbacks: (
+  "separator" : (
+    "function" : meta.get-function("get-rule-style", false, "element"),
+    "arguments" : ("light",)
+  ),
+);
+
+
+/// Module Settings
+/// @type Map
+/// @prop {Dimension} gap [1em] The default space between items in the rail
+/// @prop {Map} gap-modifiers [("small" : 0.5em, "large" : 2em )] Alternate gaps (use child modifiers .rail__item--gap-[name], these apply gap changes between the item and the item before it
+/// @prop {Dimension} margin-bottom [1em] The default space after rail
+/// @prop {CssValue} separator [true] Pass border property for separator, defaults to element rule style light
+
+$config: (
+  "gap" : 1em,
+  "margin-bottom" : 1.5em,
+  "separator" : true,
+  "gap-modifiers": (
+    "small" : 0.5em,
+    "none" : 0,
+    "large" : 2em
+  ),
+  "rule-size" : 1px,
+  "rule-color" : "rule",
+  "rule-margin" : 1em
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+/// @example scss
+///   @include ulu.component-rail-set(( "gap" : 1.5em ));
+
+@mixin set($changes) {
+  $config: map.merge($config, $changes) !global;
+}
+
+/// Get a config option
+/// @param {Map} $name Name of property
+/// @example scss
+///   @include ulu.component-rail-get("gap");
+
+@function get($name) {
+  $value: utils.require-map-get($config, $name, "rail [config]");
+  @return utils.function-fallback($name, $value, $-fallbacks);
+}
+
+/// Prints component styles
+/// @example scss
+///   @include ulu.component-rail-styles();
+
+@mixin styles {
+  $prefix: selector.class("rail"); 
+  $gap: get("gap");
+
+  #{ $prefix } {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: $gap;
+    margin-bottom: get("margin-bottom");
+    max-width: 100%;
+  }
+  #{ $prefix }--rule {
+    border-bottom: get("rule-size") solid color.get(get("rule-color"));
+    padding-bottom: get("rule-margin");
+  }
+
+  // Modifiers
+  // - Note: Originally had mods for each type of flexbox layout
+  //   simplified to just agnostic naming and only what is currently needed
+  //   can update this in the future to add more alignment options if 
+  //   use cases come up
+
+  #{ $prefix }--justified { 
+    justify-content: space-between;
+  }
+  #{ $prefix }--baseline {
+    align-items: baseline;
+  }
+  #{ $prefix }--nowrap {
+    flex-wrap: nowrap;
+    overflow-x: auto;
+  }
+
+  // Item level modifiers
+  #{ $prefix }__item--pull {
+    margin-inline-start: auto;
+  }
+  #{ $prefix }__item--separator {
+    border-inline-start: get("separator");
+    padding-inline-start: $gap;
+  }
+
+  @each $name, $value in get("gap-modifiers") {
+
+    $calc-gap: $value - $gap;
+    
+    #{ $prefix }__item--gap-#{ $name } {
+      margin-inline-start: $calc-gap;
+
+      &#{ $prefix }__item--separator {
+        padding-inline-start: $value;
+      }
+    }
+  }
+}

package/scss/components/_ratio-box.scss

@@ -5,6 +5,7 @@
 
 @use "sass:map";
 @use "../utils";
+@use "../layout";
 
 /// Module Settings
 /// @type Map
@@ -22,7 +23,7 @@ $config: (
 
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example
+/// @example scss
 ///   @include ulu.component-ratio-box-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -31,7 +32,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example
+/// @example scss
 ///   @include ulu.component-ratio-box-get("property");
 
 @function get($name) {
@@ -49,11 +50,7 @@ $config: (
     padding: get("size") 0 0 0; 
   }
   .ratio-box__content {
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
+    @include layout.absolute-fill(true);
     border: 0;
   }
   @each $name, $size in get("sizes") {

package/scss/components/_rule.scss

@@ -5,14 +5,13 @@
 @use "sass:map";
 @use "../utils";
 @use "../element";
-@use "../color";
 @use "../selector";
 
 /// Module Settings
 /// @type Map
-/// @prop {Number} short-border-width [4px] Short rule width of border
-/// @prop {Number} short-modifiers [false] @joe-check
-/// @prop {Number} short-width [2.75rem] Short rule width (like an inline rule, normally used above headings), Setting this to false will disable output
+/// @prop {Dimension} short-border-width [4px] Short rule width of border
+/// @prop {Object} short-modifiers [false] Objects to adjust the styles of different short rule styles.
+/// @prop {Dimension} short-width [2.75rem] Short rule width (like an inline rule, normally used above headings), Setting this to false will disable output
 
 $config: (
   "short-border-width" : 4px,
@@ -22,7 +21,7 @@ $config: (
 
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example
+/// @example scss
 ///   @include ulu.component-rule-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -31,7 +30,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example
+/// @example scss
 ///   @include ulu.component-rule-get("property");
 
 @function get($name) {
@@ -83,6 +82,7 @@ $config: (
       width: $short-width;
       max-width: 100%;
       border-bottom-width: get("short-border-width");
+      display: inline-block;
     }
     @if get("short-modifiers") {
       @each $mod, $opts in get("short-modifiers") {

package/scss/components/_scroll-slider.scss

@@ -22,8 +22,6 @@
 /// @prop {Dimension} padding-bottom  [0]
 /// @prop {Dimension} padding-top  [0]
 /// @prop {String} prefix ["scroll-slide"]
-/// @prop {Color} button-background-color  [white]
-/// @prop {Color} button-background-color-hover  [white]
 /// @prop {CssValue} button-border  [2px solid white]
 /// @prop {Color} button-border-color-hover  [white]
 /// @prop {Dimension} button-border-radius  [50%]
@@ -46,8 +44,6 @@ $config: (
   "padding-bottom" : 0,
   "padding-top" : 0,
   "prefix": "scroll-slider",
-  "button-background-color" : white,
-  "button-background-color-hover" : white,
   "button-border" : 2px solid white,
   "button-border-color-hover" : white,
   "button-border-radius" : 50%,
@@ -64,7 +60,7 @@ $config: (
 
 /// Change modules $config
 /// @param {Map} $changes Map of changes
-/// @example scss - General example
+/// @example scss 
 ///   @include ulu.component-scroll-slider-set(( "property" : value ));
 
 @mixin set($changes) {
@@ -73,7 +69,7 @@ $config: (
 
 /// Get a config option
 /// @param {Map} $name Name of property
-/// @example scss - General example
+/// @example scss 
 ///   @include ulu.component-scroll-slider-get("property");
 
 @function get($name) {
@@ -89,7 +85,7 @@ $config: (
   
   #{ $prefix } {
     position: relative; // for controls
-    background-color: get("background-color");
+    background-color: color.get(get("background-color"));
     margin: get("margin-top") 0 get("margin-bottom") 0;
   }
   #{ $prefix }--cards {
@@ -124,7 +120,7 @@ $config: (
     @include layout.match-container-margin("scroll-padding-left", get("container"));
     // padding: 1rem;
     // Add space to end of list
-    // &:after {
+    // &::after {
     //   content: "\00a0";
     //   display: block;
     //   width: 1rem;