@ulu/frontend 0.0.3

package/trash/scss-old-230729/base/_normalize.scss

@@ -0,0 +1,315 @@
+////
+/// @group normalize
+////
+
+@use "../utils";
+@use "../button";
+
+
+/// Prints the normalize stylesheet. We are using modern-normalize 1.1.0
+/// @link https://www.npmjs.com/package/modern-normalize Modern Normalize (NPM)
+/// @example scss
+///  @include ulu.base-normalize-styles();
+
+@mixin styles {
+
+  @include utils.file-header('base', 'normalize');
+  
+  /*! modern-normalize v1.1.0 | MIT License | https://github.com/sindresorhus/modern-normalize */
+
+  /*
+  Document
+  ========
+  */
+
+  /**
+  Use a better box model (opinionated).
+  */
+
+  // *,
+  // ::before,
+  // ::after {
+  //   box-sizing: border-box;
+  // }
+
+  /**
+  Use a more readable tab size (opinionated).
+  */
+
+  html {
+    -moz-tab-size: 4;
+    tab-size: 4;
+  }
+
+  /**
+  1. Correct the line height in all browsers.
+  2. Prevent adjustments of font size after orientation changes in iOS.
+  */
+
+  // html {
+  //   line-height: 1.15; /* 1 */
+  //   -webkit-text-size-adjust: 100%; /* 2 */
+  // }
+
+  /*
+  Sections
+  ========
+  */
+
+  /**
+  Remove the margin in all browsers.
+  */
+
+  // body {
+  //   margin: 0;
+  // }
+
+  /**
+  Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3)
+  */
+
+  // body {
+  //   font-family:
+  //     system-ui,
+  //     -apple-system, /* Firefox supports this but not yet `system-ui` */
+  //     'Segoe UI',
+  //     Roboto,
+  //     Helvetica,
+  //     Arial,
+  //     sans-serif,
+  //     'Apple Color Emoji',
+  //     'Segoe UI Emoji';
+  // }
+
+  /*
+  Grouping content
+  ================
+  */
+
+  /**
+  1. Add the correct height in Firefox.
+  2. Correct the inheritance of border color in Firefox. (https://bugzilla.mozilla.org/show_bug.cgi?id=190655)
+  */
+
+  
+
+  /*
+  Text-level semantics
+  ====================
+  */
+
+  /**
+  Add the correct text decoration in Chrome, Edge, and Safari.
+  */
+
+  abbr[title] {
+    text-decoration: underline dotted;
+  }
+
+  /**
+  Add the correct font weight in Edge and Safari.
+  */
+
+  // b,
+  // strong {
+  //   font-weight: bolder;
+  // }
+
+  /**
+  1. Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3)
+  2. Correct the odd 'em' font sizing in all browsers.
+  */
+
+  // code,
+  // kbd,
+  // samp,
+  // pre {
+  //   font-family:
+  //     ui-monospace,
+  //     SFMono-Regular,
+  //     Consolas,
+  //     'Liberation Mono',
+  //     Menlo,
+  //     monospace; /* 1 */
+  //   font-size: 1em; /* 2 */
+  // }
+
+  /**
+  Add the correct font size in all browsers.
+  */
+
+  // small {
+  //   font-size: 80%;
+  // }
+
+  /**
+  Prevent 'sub' and 'sup' elements from affecting the line height in all browsers.
+  */
+
+  // sub,
+  // sup {
+  //   font-size: 75%;
+  //   line-height: 0;
+  //   position: relative;
+  //   vertical-align: baseline;
+  // }
+
+  // sub {
+  //   bottom: -0.25em;
+  // }
+
+  // sup {
+  //   top: -0.5em;
+  // }
+
+  /*
+  Tabular data
+  ============
+  */
+
+  /**
+  1. Remove text indentation from table contents in Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=999088, https://bugs.webkit.org/show_bug.cgi?id=201297)
+  2. Correct table border color inheritance in all Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=935729, https://bugs.webkit.org/show_bug.cgi?id=195016)
+  */
+
+  table {
+    text-indent: 0; /* 1 */
+    // border-color: inherit; /* 2 */
+  }
+
+  /*
+  Forms
+  =====
+  */
+
+  /**
+  1. Change the font styles in all browsers.
+  2. Remove the margin in Firefox and Safari.
+  */
+
+  button,
+  input,
+  optgroup,
+  select,
+  textarea {
+    font-family: inherit; /* 1 */
+    // font-size: 100%; /* 1 */
+    // line-height: 1.15; /* 1 */
+    line-height: inherit;
+    font-size: inherit;
+    margin: 0; /* 2 */
+  }
+
+  /**
+  Remove the inheritance of text transform in Edge and Firefox.
+  1. Remove the inheritance of text transform in Firefox.
+  */
+
+  button,
+  select { /* 1 */
+    text-transform: none;
+  }
+
+  /**
+  Correct the inability to style clickable types in iOS and Safari.
+  */
+
+  button,
+  [type='button'],
+  [type='reset'],
+  [type='submit'] {
+    @include button.reset();
+  }
+
+  /**
+  Remove the inner border and padding in Firefox.
+  */
+
+  ::-moz-focus-inner {
+    border-style: none;
+    padding: 0;
+  }
+
+  /**
+  Restore the focus styles unset by the previous rule.
+  */
+
+  :-moz-focusring {
+    outline: 1px dotted ButtonText;
+  }
+
+  /**
+  Remove the additional ':invalid' styles in Firefox.
+  See: https://github.com/mozilla/gecko-dev/blob/2f9eacd9d3d995c937b4251a5557d95d494c9be1/layout/style/res/forms.css#L728-L737
+  */
+
+  :-moz-ui-invalid {
+    box-shadow: none;
+  }
+
+  /**
+  Remove the padding so developers are not caught out when they zero out 'fieldset' elements in all browsers.
+  */
+
+  legend {
+    padding: 0;
+  }
+
+  /**
+  Add the correct vertical alignment in Chrome and Firefox.
+  */
+
+  progress {
+    vertical-align: baseline;
+  }
+
+  /**
+  Correct the cursor style of increment and decrement buttons in Safari.
+  */
+
+  ::-webkit-inner-spin-button,
+  ::-webkit-outer-spin-button {
+    height: auto;
+  }
+
+  /**
+  1. Correct the odd appearance in Chrome and Safari.
+  2. Correct the outline style in Safari.
+  */
+
+  [type='search'] {
+    -webkit-appearance: textfield; /* 1 */
+    outline-offset: -2px; /* 2 */
+  }
+
+  /**
+  Remove the inner padding in Chrome and Safari on macOS.
+  */
+
+  ::-webkit-search-decoration {
+    -webkit-appearance: none;
+  }
+
+  /**
+  1. Correct the inability to style clickable types in iOS and Safari.
+  2. Change font properties to 'inherit' in Safari.
+  */
+
+  ::-webkit-file-upload-button {
+    -webkit-appearance: button; /* 1 */
+    font: inherit; /* 2 */
+  }
+
+  /*
+  Interactive
+  ===========
+  */
+
+  /*
+  Add the correct display in Chrome and Safari.
+  */
+
+  summary {
+    display: list-item;
+  }
+}

package/trash/scss-old-230729/base/_typography.scss

@@ -0,0 +1,41 @@
+////
+/// @group typography
+////
+
+@use "sass:map";
+@use "../typography";
+@use "../selector";
+@use "../utils";
+
+/// Prints elements base styles
+/// @example scss
+///  @include ulu.base-typography-styles();
+/// @example raw Example of type size as base unprefixed
+///  <span class="h1">A</span>
+///  <span class="h2">A</span>
+///  <span class="h3">A</span>
+///  <span class="h4">A</span>
+///  <span class="h5">A</span>
+///  <span class="h6">A</span>
+
+@mixin styles {
+
+  @include utils.file-header('base', 'typography');
+
+  $prefix: selector.class("type");
+
+  // Print base typographic sizes
+  @each $size, $values in typography.$sizes {
+    @if (map.get($values, "base-class")) {
+      @if (map.get($values, "base-class-prefixed")) {
+        #{ $prefix }-#{$size} {
+          @include typography.size($size);
+        }
+      } @else {
+        .#{$size} {
+          @include typography.size($size);
+        }
+      }
+    }
+  }
+}

package/trash/scss-old-230729/components/README.md

@@ -0,0 +1,5 @@
+# About Components
+
+- Won't always offer the ability to rename styles 
+- Components are reusable elements 
+- They contain styles (unlike libraries)

package/trash/scss-old-230729/components/README.todos

@@ -0,0 +1,15 @@
+Todos:
+  ☐ Need to move links and buttons and rules to base
+    ☐ Leave components for complicated selectors, that shouldn't need to be as systemtized or configured. If they need to be configured or altered users can copy the pattern in their own styles
+
+  ☐ Could consider changing helpers and base to  @important
+    - styles
+      * all base and helper styles (configurable, usually needed in all sites)
+      * Maybe user chooses where these end up
+      * Configuration (base vs override)
+    - components 
+      * More complicated components
+      * 
+      * May override base styles
+      * May contain layouts
+      * May wrap or contain base (button vs button-group)

package/trash/scss-old-230729/components/_button.scss

@@ -0,0 +1,95 @@
+////
+/// @group button
+////
+
+@use "sass:map";
+// @use "sass:selector" as sassSelector;
+@use "../typography";
+@use "../selector";
+@use "../utils";
+@use "../button";
+
+$config: (
+  "icon-margin" : 1em
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+///   @include module-name.set(( "property" : value ));
+
+@mixin set($changes) {
+  $config: map.merge($config, $changes) !global;
+}
+
+/// Get a config option
+/// @param {Map} $name Name of property
+///   @include module-name.get("property");
+
+@function get($name) {
+  @return utils.require-map-get($config, $name, "component-button [config]");
+}
+
+/// Prints button component styles
+/// @example scss
+///  @include ulu.component-button-styles();
+/// @example raw
+///  <a class="button" href="#">Button Default</a>
+
+@mixin styles {
+  @include utils.file-header('component', 'button');
+
+  $prefix: selector.class("button");
+  // $printContextual: get("contextual-classes");
+  // $classContextual: "#{ selector.class("button-inside") } ;
+  $icon-selector: "#{ $prefix }--icon";
+  $printDescendant: "#{ $prefix }--icon";
+
+  #{ $prefix } {
+    @include button.default();
+  }
+  #{ $prefix }__icon {
+    &:first-child {
+      margin-right: get("icon-margin");
+    }
+    &:last-child {
+      margin-left: get("icon-margin");
+    }
+  }
+  
+  @each $size, $values in button.$sizes {
+    #{ $prefix }--#{$size} {
+      @include button.size($size);
+    }
+  }
+
+  @each $style, $values in button.$styles {
+    #{ $prefix }--#{$style} {
+      @include button.style($style);
+    }
+  }
+
+  #{ $icon-selector } {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 0;
+    max-width: none;
+    border-radius: button.get("icon-border-radius");
+    font-size: button.get("icon-font-size");
+    width: button.get("icon-size");
+    height: button.get("icon-size");
+    padding: 0 !important;
+  }
+
+  @each $size, $values in button.$sizes {
+    $icon-size: map.get($values, "icon-size");
+    $icon-font-size: map.get($values, "icon-font-size");
+    @if ($icon-size or $icon-font-size) {
+      #{ $prefix }--#{$size}#{ $icon-selector } {
+        width: $icon-size;
+        height: $icon-size;
+        font-size: $icon-font-size;
+      }
+    }
+  }
+}

package/trash/scss-old-230729/components/_index.scss

@@ -0,0 +1,63 @@
+////
+/// @group all
+////
+
+@forward "links" as links-*;
+@forward "button" as button-*;
+@forward "rule" as rule-*;
+@forward "list-lines" as list-lines-*;
+@forward "list-unordered" as list-unordered-*;
+@forward "list-ordered" as list-ordered-*;
+
+@use "sass:map";
+
+@use "../utils";
+@use "links";
+@use "button";
+@use "rule";
+@use "list-lines";
+@use "list-unordered";
+@use "list-ordered";
+
+// Used to check against user's includes
+
+$-all-includes: (
+  "links" : true,
+  "button" : true,
+  "rule" : true,
+  "list-lines" : true,
+  "list-unordered" : true,
+  "list-ordered" : true
+);
+
+/// Prints all Components styles
+/// @name component-styles
+/// @param {List} $includes A list of changes to module includes
+/// @example scss
+///  @include ulu.component-styles();
+
+@mixin styles($includes: null) {
+  @include utils.file-header("components");
+  @if $includes {
+    @include utils.require-list-contains($-all-includes, $includes);
+    $-all-includes: map.merge($-all-includes, $includes) !global;
+  }
+  @if (map.get($-all-includes, "links")) {
+    @include links.styles;
+  }
+  @if (map.get($-all-includes, "button")) {
+    @include button.styles;
+  }
+  @if (map.get($-all-includes, "rule")) {
+    @include rule.styles;
+  }
+  @if (map.get($-all-includes, "list-lines")) {
+    @include list-lines.styles;
+  }
+  @if (map.get($-all-includes, "list-unordered")) {
+    @include list-unordered.styles;
+  }
+  @if (map.get($-all-includes, "list-ordered")) {
+    @include list-unordered.styles;
+  }
+}

package/trash/scss-old-230729/components/_links.scss

@@ -0,0 +1,34 @@
+////
+/// @group links
+////
+
+@use "../element";
+@use "../selector";
+
+/// Link compontent styles (.link)
+/// - Contextual link styling
+/// - Styles all links within as normal text hyperlinks (hover, visited)
+/// @example scss
+///  @include ulu.component-links-styles();
+
+@mixin styles {
+  $selector: selector.class("links");
+  $selectorSingle: selector.class("link");
+  $selectorNot: "#{ $selector }--no-visited";
+  $selectorSingleNot: "#{ $selectorSingle }--no-visited";
+  // Using not to avoid duplicating css
+  // There shouldn't be to many reasons to need to override these styles
+  #{ $selector }:not(#{ $selectorNot }) a,
+  #{ $selectorSingle }:not(#{ $selectorSingleNot }) {
+      @include element.link(true, true);
+    }
+  #{ $selector }--no-visited a,
+  #{ $selectorSingle }--no-visited {
+      @include element.link();
+    }
+  // Chained to match not() specifity
+  #{ $selector }#{ $selector }--no-underline a,
+  #{ $selectorSingle }#{ $selectorSingle }--no-underline {
+    text-decoration: none;
+  }
+}

package/trash/scss-old-230729/components/_list-lines.scss

@@ -0,0 +1,73 @@
+////
+/// @group list-lines
+////
+
+@use "sass:map";
+
+@use "../element";
+@use "../color";
+@use "../typography";
+@use "../utils";
+
+/// Module Config
+
+$config: (
+  "border-first" : true,
+  "border-last" : true,
+  "margin-top": 0,
+  "margin-bottom": 1em,
+  "padding-between" : 1em
+) !default;
+
+/// Change modules $config
+/// @param {Map} $changes Map of changes
+///   @include module-name.set(( "property" : value ));
+
+@mixin set($changes) {
+  $config: map.merge($config, $changes) !global;
+}
+
+/// Get a config option
+/// @param {Map} $name Name of property
+///   @include module-name.get("property");
+
+@function get($name) {
+  @return utils.require-map-get($config, $name, "grid [config]");
+}
+
+/// Output component styles
+
+@mixin inner-styles {
+  $border: element.get-rule-style("light") !default;
+  list-style: none;
+  margin: get("margin-top") 0 get("margin-bottom") 0;
+  padding: 0;
+  @if (get("border-first")) {
+    border-top: $border;
+  }
+  >li {
+    border-bottom: $border;
+    padding: get("padding-between") 0;
+    >*:last-child {
+      margin-bottom: 0;
+    }
+    @if (not get("border-last")) {
+      &:last-child {
+        border-bottom-width: 0;
+      }
+    }
+  }
+}
+
+@mixin styles {
+  
+  .list-lines {
+    @include inner-styles;
+  }
+  .list-lines--dense {
+    >li {
+      padding: 0.5em 0;
+      line-height: typography.get("line-height-dense");
+    }
+  }
+}

package/trash/scss-old-230729/components/_list-ordered.scss

@@ -0,0 +1,16 @@
+////
+/// @group list-ordered
+////
+
+@use "../element";
+@use "../color";
+@use "../selector";
+
+/// Output styles
+
+@mixin styles {
+  $prefix: selector.class("list-ordered");
+  #{ $prefix } {
+    @include element.styles-ordered-list();
+  }
+}

package/trash/scss-old-230729/components/_list-unordered.scss

@@ -0,0 +1,21 @@
+////
+/// @group list-unordered
+////
+
+@use "../element";
+@use "../color";
+@use "../selector";
+
+/// Output styles
+
+@mixin styles {
+  $prefix: selector.class("list-unordered");
+  #{ $prefix } {
+    @include element.styles-unordered-list();
+    li {
+      &::marker {
+        color: color.get("bullet");
+      }
+    }
+  }
+}