@ulu/frontend 0.1.0-beta.5 → 0.1.0-beta.50

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"));
+}

package/scss/components/_tabs.scss

@@ -9,6 +9,7 @@
 @use "../color";
 @use "../selector";
 @use "../breakpoint";
+@use "../layout";
 @use "../typography";
 @use "../element";
 @use "../utils";
@@ -55,7 +56,7 @@ $-fallbacks: (
 /// @prop {Boolean} horizontal-tab-wrap [false] Set to true to allow line wrapping when the tabs are in horizontal orientation, vertical is always allowed to wrap
 
 $config: (
-  "margin" : (2rem, 0),
+  "margin" : (2rem 0),
   "print-margin" : 1.5em,
   "tablist-divider" : true,
   "tablist-divider-width" : 1px,
@@ -118,6 +119,7 @@ $config: (
       overflow-x: auto;
       border-bottom: get("tablist-divider");
       border-bottom-width: get("tablist-divider-width");
+      @include layout.remove-scrollbar();
     }
     [role="tab"] {
       display: block;
@@ -157,7 +159,7 @@ $config: (
       z-index: 1;
       padding: get("tabpanel-padding");
       overflow: hidden;
-      background-color: get("tabpanel-background-color");
+      background-color: color.get(get("tabpanel-background-color"));
     }
   }
   // For images, etc that should fill tabpanel

package/scss/components/_tag.scss

@@ -144,7 +144,7 @@ $styles: (
       border: map.get($style, "border"); 
       border-radius: map.get($style, "border-radius"); 
       border-color: color.get(map.get($style, "border-color")); 
-      border-width: color.get(map.get($style, "border-width")); 
+      border-width: map.get($style, "border-width"); 
       box-shadow: map.get($style, "box-shadow"); 
       padding: map.get($style, "padding");  
       @if (typography.has-size($type-size)) {

package/scss/components/_vignette.scss

@@ -8,10 +8,12 @@
 @use "sass:map";
 @use "../utils";
 @use "../selector";
+@use "../layout";
 
 /// Module Settings
 /// @type Map
 /// @prop {Color} background-color [rgb(0,0,0)] Color used for the fade-in of the vignette. Must be actual color not color module palette name
+/// @prop {CssValue} image-filter [saturate(85%)] Filter value placed over image.
 
 $config: (
   "background-color" : rgb(0,0,0),
@@ -48,11 +50,7 @@ $config: (
     &::after {
       content: "";
       display: block;
-      position: absolute;
-      top: 0;
-      bottom: 0;
-      left: 0;
-      right: 0;
+      @include layout.absolute-fill();
       background: linear-gradient(0deg,color.change(get("background-color"), $alpha: 0.8),color.change(get("background-color"), $alpha: 0) 45%);
       pointer-events: none;
     }

package/scss/helpers/_display.scss

@@ -20,53 +20,50 @@
 
   @include utils.file-header('helpers', 'display');
 
-  $hiddenVisuallyPrefix: selector.class("hidden-visually");
+  $prefix-hidden-visually: selector.class("hidden-visually");
+  $prefix-display: selector.class("display");
+  $prefix-hidden: selector.class("hidden");
 
-  #{ $hiddenVisuallyPrefix } {
+  #{ $prefix-hidden-visually } {
     @include element.hidden-visually();
   }
-  #{ $hiddenVisuallyPrefix }-focusable {
+  #{ $prefix-hidden-visually }-focusable {
     &:not(:active):not(:focus) {
       @include element.hidden-visually();
     }
   }
-  // Consider removing
-  .clearfix,
-  .cf { 
-    @include layout.clearfix();
-  }
-  .display-block {
+  #{ $prefix-display }-block {
     display: block;
   }
-  .display-flex {
+  #{ $prefix-display }-flex {
     display: flex;
   }
-  .display-inline-flex {
+  #{ $prefix-display }-inline-flex {
     display: inline-flex;
   }
-  .display-inline {
+  #{ $prefix-display }-inline {
     display: inline;
   }
-  .display-inline-all * {
+  #{ $prefix-display }-inline-all * {
     display: inline;
   }
-  .display-inline-block {
+  #{ $prefix-display }-inline-block {
     display: inline-block;
   }
-  .hidden,
-  .display-none {
+  #{ $prefix-hidden },
+  #{ $prefix-display }-none {
     display: none !important;
   }
 
   // Display none per breakpoint
   @each $name in map.keys(breakpoint.$sizes) {
     @include breakpoint.min($name) {
-      .hidden-min-#{ $name } {
+      #{ $prefix-hidden }-min-#{ $name } {
         display: none !important;
       }
     }
     @include breakpoint.max($name) {
-      .hidden-max-#{ $name } {
+      #{ $prefix-hidden }-max-#{ $name } {
         display: none !important;
       }
     }

package/scss/helpers/_print.scss

@@ -8,18 +8,23 @@
 /// @example scss
 ///  @include ulu.helper-print-styles();
 
+@use "../selector";
+
 @mixin styles {
+  $prefix-print: selector.class("print");
+  $prefix-no-print: selector.class("no-print");
   
-  .print-exact {
-    print-color-adjust: exact;
-    -webkit-print-color-adjust: exact;
-  }
-  .no-print {
+  #{ $prefix-no-print } {
     @media print {
       display: none !important;
     }
   }
-  .print-only {
+
+  #{ $prefix-print }-exact {
+    print-color-adjust: exact;
+    -webkit-print-color-adjust: exact;
+  }
+  #{ $prefix-print }-only {
     @media screen {
       display: none !important;
     }
@@ -27,7 +32,7 @@
   // Utility for making dark backgrounds print "ok"
   // - Grayscale added because colors are flipped
   // - Rotating colors doesn't really work
-  .print-invert {
+  #{ $prefix-print }-invert {
     @media print {
       filter: invert(1) saturate(0);
     }

package/scss/helpers/_utilities.scss

@@ -5,6 +5,7 @@
 
 @use "../utils";
 @use "../layout";
+@use "../selector";
 
 /// Print utilities helper styles
 /// - Includes classes like (.crop-margins, .no-scroll-y, .image-full-width, etc)
@@ -13,99 +14,108 @@
 
 @mixin styles {
 
+  $prefix-no-scroll: selector.class("no-scroll");
+  $prefix-image: selector.class("image");
+  $prefix-margin: selector.class("margin");
+  $prefix-no-margin: selector.class("no-margin");
+  $prefix-crop-margins: selector.class("crop-margins");
+  $prefix-no-padding: selector.class("no-padding");
+  $prefix-align-self: selector.class("align-self");
+
+
   @include utils.file-header('helpers', 'utilities');
   
   // Consider removing
-  .no-scroll-y { 
+  #{ $prefix-no-scroll }-y { 
     overflow-y: hidden; 
   }
-  .no-scroll-x { 
+  #{ $prefix-no-scroll }-x { 
     overflow-x: hidden; 
   }
-  .full-height {
+  #{ selector.class("full-height") } {
     height: 100%;
   }
-  .full-width {
+  #{ selector.class("full-width") } {
     width: 100%;
   }
-  .flex-basis-full {
+  #{ selector.class("flex-basis-full") } {
     flex-basis: 100%;
   }
-  .full-min-height {
+  #{ selector.class("full-min-height") } {
     min-height: 100%;
   }
-  .image-fill {
+  #{ $prefix-image }-fill {
     width: 100%;
     height: 100%;
     object-fit: cover;
   }
-  .image-full-width img,
-  .image-full-width {
+  #{ $prefix-image }-full-width img,
+  #{ $prefix-image }-full-width {
     width: 100%;
     height: auto;
   }
-  .margin-auto,
-  .center {
+  #{ $prefix-margin }-auto,
+  #{ selector.class("center") } {
     margin-left: auto;
     margin-right: auto;
   }
-  .margin-left-auto {
-    margin-left: auto;
+  #{ $prefix-margin }-left-auto {
+        margin-left: auto;
   }
-  .margin-right-auto {
+  #{ $prefix-margin }-right-auto {
     margin-right: auto;
   }
-  .no-margin {
+  #{ $prefix-no-margin } {
     margin: 0;
   }
-  .no-margin-top {
+  #{ $prefix-no-margin }-top {
     margin-top: 0;
   }
-  .no-margin-bottom {
+  #{ $prefix-no-margin }-bottom {
     margin-bottom: 0;
   }
-  .no-margin-left {
+  #{ $prefix-no-margin }-left {
     margin-left: 0;
   }
-  .no-margin-right {
+  #{ $prefix-no-margin }-right {
     margin-right: 0;
   }
-  .crop-margins {
-    &:not(.crop-margins--last) >:first-child {
+  #{ $prefix-crop-margins } {
+    &:not( #{ $prefix-crop-margins }--last) >:first-child {
       margin-top: 0;
     }
-    &:not(.crop-margins--first) >:last-child {
+    &:not( #{ $prefix-crop-margins }--first) >:last-child {
       margin-bottom: 0;
     }
   }
-  .no-padding {
+  #{ $prefix-no-padding } {
     padding: 0;
   }
-  .no-padding-top {
+  #{ $prefix-no-padding }-top {
     padding-top: 0;
   }
-  .no-padding-bottom {
+  #{ $prefix-no-padding }-bottom {
     padding-bottom: 0;
   }
-  .no-padding-left {
+  #{ $prefix-no-padding }-left {
     padding-left: 0;
   }
-  .no-padding-right {
+  #{ $prefix-no-padding }-right {
     padding-right: 0;
   }
-  .align-self-start {
+  #{ $prefix-align-self }-start {
     align-self: start;
   }
-  .align-self-center {
+  #{ $prefix-align-self }-center {
     align-self: center;
   }
-  .align-self-end {
+  #{ $prefix-align-self }-end {
     align-self: end;
   }
-  .align-self-baseline {
+  #{ $prefix-align-self }-baseline {
     align-self: baseline;
   }
-  .overflow-hidden {
+  #{ selector.class("overflow-hidden") } {
     overflow: hidden;
   }
   // .justify-self-center {

package/types/index.d.ts

@@ -1,3 +1,4 @@
+export * as settings from "./settings.js";
 export * as events from "./events/index.js";
 export * as ui from "./ui/index.js";
 export * as utils from "./utils/index.js";

package/types/settings.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Retrieves a copy of the default settings.
+ * @returns {object} A copy of the default settings object.
+ */
+export function getDefaultSettings(): object;
+/**
+ * Updates multiple configuration settings.
+ * @param {object} changes An object containing the settings to update.
+ */
+export function updateSettings(changes: object): void;
+/**
+ * Retrieves a copy of the current configuration settings.
+ * @returns {object} A copy of the current settings object.
+ */
+export function getSettings(): object;
+/**
+ * Retrieves a specific configuration setting by key.
+ * @param {string} key The key of the setting to retrieve.
+ * @returns {*} The value of the setting, or undefined if not found.
+ */
+export function getSetting(key: string): any;
+/**
+ * Updates a specific configuration setting.
+ * @param {string} key The key of the setting to update.
+ * @param {*} value The new value for the setting.
+ */
+export function updateSetting(key: string, value: any): void;
+/**
+ * Creates a wrapped string representation of a configuration setting.
+ * This function returns an object with a `toString()` method that, when called,
+ * retrieves the current value of the specified setting. This allows the setting
+ * to be used as a string literal, dynamically retrieving its value.
+ *
+ * @param {String} key The key of the setting to wrap.
+ * @param {Function} transform Optional function to transform the setting's
+ * value when its string representation is requested.
+ * @returns {Object} An object with a `toString()` method that returns the
+ * (optionally transformed) setting value as a string.
+ */
+export function wrapSettingString(key: string, transform: Function): any;
+/**
+ * Default settings
+ */
+export type Defaults = {
+    /**
+     * - The CSS class string for the close icon
+     */
+    iconClassClose: string;
+    /**
+     * - The CSS class string for the drag X icon
+     */
+    iconClassDragX: string;
+    /**
+     * - The CSS class string for the previous icon
+     */
+    iconClassPrevious: string;
+    /**
+     * - The CSS class string for the next icon
+     */
+    iconClassNext: string;
+    /**
+     * - The prefix to use for CSS custom properties
+     */
+    cssvarPrefix: string;
+};
+//# sourceMappingURL=settings.d.ts.map

package/types/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../js/settings.js"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,sCAFa,MAAM,CAIlB;AAED;;;GAGG;AACH,wCAFW,MAAM,QAIhB;AAED;;;GAGG;AACH,+BAFa,MAAM,CAIlB;AAED;;;;GAIG;AACH,gCAHW,MAAM,OAShB;AAED;;;;GAIG;AACH,mCAHW,MAAM,oBAKhB;AAED;;;;;;;;;;;GAWG;AACH,yEAOC;;;;;;;;oBAtFa,MAAM;;;;oBACN,MAAM;;;;uBACN,MAAM;;;;mBACN,MAAM;;;;kBACN,MAAM"}

package/types/ui/breakpoints.d.ts

@@ -1,32 +1,32 @@
 /**
  * @class
  * Class that provides method for retrieving and acting on breakpoints passed
- * from CSS (using element psuedo content prop)
+ * from CSS (using element pseudo content prop)
  */
 export class BreakpointManager {
     static instances: any[];
     static defaults: {
         element: HTMLElement;
-        valueFromPsuedo: boolean;
-        customProperty: string;
-        psuedoSelector: string;
+        valueFromPseudo: boolean;
+        customProperty: any;
+        pseudoSelector: string;
         order: string[];
         debug: boolean;
     };
     /**
-     * @param {Object} config Configruation object
+     * @param {Object} config Configuration object
      * @param {Array} config.order Array of strings that correspond to the breakpoints setup in the styles, Breakpoints from smallest to largest, defaults to [small, medium, large]
      * @param {Array} config.customProperty Property to grab breakpoint from (default is --breakpoint)
-     * @param {Array} config.valueFromPsuedo Use the legacy method of grabbing breakpoint from psuedo element, default uses custom property
-     * @param {Node} config.element The element to retrieve active breakpoint from stylesheet. (default is html) For using the old psuedo method, adjust this to document.body
-     * @param {String} config.psuedoSelector Change psuedo selector used to get the breakpoint from the psuedo's content property
+     * @param {Array} config.valueFromPseudo Use the legacy method of grabbing breakpoint from pseudo element, default uses custom property
+     * @param {Node} config.element The element to retrieve active breakpoint from stylesheet. (default is html) For using the old pseudo method, adjust this to document.body
+     * @param {String} config.pseudoSelector Change pseudo selector used to get the breakpoint from the pseudo's content property
      */
     constructor(config: {
         order: any[];
         customProperty: any[];
-        valueFromPsuedo: any[];
+        valueFromPseudo: any[];
         element: Node;
-        psuedoSelector: string;
+        pseudoSelector: string;
     });
     active: any;
     previous: any;
@@ -36,9 +36,9 @@ export class BreakpointManager {
     breakpoints: {};
     onChangeCallbacks: any[];
     /**
-     * Add a callback for everytime a breakpoint changes
+     * Add a callback for every time a breakpoint changes
      * - Not recommended, possibly use to watch for changes, etc
-     * - For more control use intance.at(name) with breakpoint methods
+     * - For more control use instance.at(name) with breakpoint methods
      * @param {Function} callback Function to call, passed one argument current instance which can be used to get information about breakpoints
      */
     onChange(callback: Function): void;
@@ -48,9 +48,9 @@ export class BreakpointManager {
      */
     removeOnChange(callback: Function): void;
     /**
-     * Get breakpoint from a psuedo element
+     * Get breakpoint from a pseudo element
      */
-    getBreakpointInPsuedo(): string;
+    getBreakpointInPseudo(): string;
     /**
      * Get breakpoint from a custom property
      */