@graupl/graupl 1.0.0-beta.5 → 1.0.0-beta.6

package/src/scss/layout/container/_variables.scss

@@ -16,6 +16,10 @@ $container-content-max-width: var(
   --#{root-defaults.$prefix}container-content-max-width,
   #{root-variables.$content-max-width}
 );
+$container-sidebar-width: var(
+  --#{root-defaults.$prefix}container-sidebar-width,
+  #{defaults.$container-sidebar-width}
+);
 $container-breakout-max-width: var(
   --#{root-defaults.$prefix}container-breakout-max-width,
   calc(#{$container-content-max-width} + #{defaults.$container-breakout-width})
@@ -90,3 +94,21 @@ $container-content-section-width: var(
     #{$container-content-section-max-width}
   )
 );
+$container-sidebar-left-section-width: var(
+  --#{root-defaults.$prefix}container-sidebar-left-section-width,
+  $container-sidebar-width
+);
+$container-sidebar-right-section-width: var(
+  --#{root-defaults.$prefix}container-sidebar-right-section-width,
+  $container-sidebar-width
+);
+/* stylelint-disable scss/operator-no-newline-after -- Prettier wants to format it this way. */
+$container-inner-content-section-width: var(
+  --#{root-defaults.$prefix}container-inner-content-section-width,
+  calc(
+    #{$container-content-section-width} -
+      #{$container-sidebar-left-section-width} -
+      #{$container-sidebar-right-section-width}
+  )
+);
+/* stylelint-enable  scss/operator-no-newline-after */

package/src/scss/utilities/_index.scss

@@ -19,3 +19,4 @@
 @forward "visibility";
 @forward "visually-hidden";
 @forward "width";
+@forward "z-index";

package/src/scss/utilities/background/_defaults.scss

@@ -25,11 +25,6 @@ $base-background-attachment-properties: (
   scroll: scroll,
   fixed: fixed,
   local: local,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-attachment-properties: () !default;
 $background-attachment-properties: map.merge(
@@ -45,11 +40,6 @@ $base-background-clip-properties: (
   content-box: content-box,
   text: text,
   border-area: border-area,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-clip-properties: () !default;
 $background-clip-properties: map.merge(
@@ -61,11 +51,6 @@ $background-clip-properties: map.merge(
 $background-image-selector-prefix: "bg-image-" !default;
 $base-background-image-properties: (
   none: none,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-image-properties: () !default;
 $background-image-properties: map.merge(
@@ -79,11 +64,6 @@ $base-background-origin-properties: (
   border-box: border-box,
   padding-box: padding-box,
   content-box: content-box,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-origin-properties: () !default;
 $background-origin-properties: map.merge(
@@ -99,11 +79,6 @@ $base-background-position-properties: (
   bottom: bottom,
   left: left,
   center: center,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-position-properties: () !default;
 $background-position-properties: map.merge(
@@ -120,11 +95,6 @@ $base-background-repeat-properties: (
   space: space,
   round: round,
   no-repeat: no-repeat,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-repeat-properties: () !default;
 $background-repeat-properties: map.merge(
@@ -138,11 +108,6 @@ $base-background-size-properties: (
   auto: auto,
   cover: cover,
   contain: contain,
-  inherit: inherit,
-  initial: initial,
-  revert: revert,
-  revert-layer: revert-layer,
-  unset: unset,
 );
 $custom-background-size-properties: () !default;
 $background-size-properties: map.merge(

package/src/scss/utilities/background/_index.scss

@@ -6,64 +6,29 @@
 // - `.bg-attachment-scroll`: Sets the background attachment property to `scroll`.
 // - `.bg-attachment-fixed`: Sets the background attachment property to `fixed`.
 // - `.bg-attachment-local`: Sets the background attachment property to `local`.
-// - `.bg-attachment-inherit`: Sets the background attachment property to `inherit`.
-// - `.bg-attachment-initial`: Sets the background attachment property to `initial`.
-// - `.bg-attachment-revert`: Sets the background attachment property to `revert`.
-// - `.bg-attachment-revert-layer`: Sets the background attachment property to `revert-layer`.
-// - `.bg-attachment-unset`: Sets the background attachment property to `unset`.
 // - `.bg-clip-border-box`: Sets the background clip property to `border-box`.
 // - `.bg-clip-padding-box`: Sets the background clip property to `padding-box`.
 // - `.bg-clip-content-box`: Sets the background clip property to `content-box`.
 // - `.bg-clip-text`: Sets the background clip property to `text`.
 // - `.bg-clip-border-area`: Sets the background clip property to `border-area`.
-// - `.bg-clip-inherit`: Sets the background clip property to `inherit`.
-// - `.bg-clip-initial`: Sets the background clip property to `initial`.
-// - `.bg-clip-revert`: Sets the background clip property to `revert`.
-// - `.bg-clip-revert-layer`: Sets the background clip property to `revert-layer`.
-// - `.bg-clip-unset`: Sets the background clip property to `unset`.
 // - `.bg-image-none`: Sets the background image property to `none`.
-// - `.bg-image-inherit`: Sets the background image property to `inherit`.
-// - `.bg-image-initial`: Sets the background image property to `initial`.
-// - `.bg-image-revert`: Sets the background image property to `revert`.
-// - `.bg-image-revert-layer`: Sets the background image property to `revert-layer`.
-// - `.bg-image-unset`: Sets the background image property to `unset`.
 // - `.bg-origin-border-box`: Sets the background origin property to `border-box`.
 // - `.bg-origin-padding-box`: Sets the background origin property to `padding-box`.
 // - `.bg-origin-content-box`: Sets the background origin property to `content-box`.
-// - `.bg-origin-inherit`: Sets the background origin property to `inherit`.
-// - `.bg-origin-initial`: Sets the background origin property to `initial`.
-// - `.bg-origin-revert`: Sets the background origin property to `revert`.
-// - `.bg-origin-revert-layer`: Sets the background origin property to `revert-layer`.
-// - `.bg-origin-unset`: Sets the background origin property to `unset`.
 // - `.bg-position-top`: Sets the background position property to `top`.
 // - `.bg-position-right`: Sets the background position property to `right`.
 // - `.bg-position-bottom`: Sets the background position property to `bottom`.
 // - `.bg-position-left`: Sets the background position property to `left`.
 // - `.bg-position-center`: Sets the background position property to `center`.
-// - `.bg-position-inherit`: Sets the background position property to `inherit`.
-// - `.bg-position-initial`: Sets the background position property to `initial`.
-// - `.bg-position-revert`: Sets the background position property to `revert`.
-// - `.bg-position-revert-layer`: Sets the background position property to `revert-layer`.
-// - `.bg-position-unset`: Sets the background position property to `unset`.
 // - `.bg-repeat-repeat`: Sets the background repeat property to `repeat`.
 // - `.bg-repeat-repeat-x`: Sets the background repeat property to `repeat-x`.
 // - `.bg-repeat-repeat-y`: Sets the background repeat property to `repeat-y`.
 // - `.bg-repeat-space`: Sets the background repeat property to `space`.
 // - `.bg-repeat-round`: Sets the background repeat property to `round`.
 // - `.bg-repeat-no-repeat`: Sets the background repeat property to `no-repeat`.
-// - `.bg-repeat-inherit`: Sets the background repeat property to `inherit`.
-// - `.bg-repeat-initial`: Sets the background repeat property to `initial`.
-// - `.bg-repeat-revert`: Sets the background repeat property to `revert`.
-// - `.bg-repeat-revert-layer`: Sets the background repeat property to `revert-layer`.
-// - `.bg-repeat-unset`: Sets the background repeat property to `unset`.
 // - `.bg-size-auto`: Sets the background size property to `auto`.
 // - `.bg-size-cover`: Sets the background size property to `cover`.
 // - `.bg-size-contain`: Sets the background size property to `contain`.
-// - `.bg-size-inherit`: Sets the background size property to `inherit`.
-// - `.bg-size-initial`: Sets the background size property to `initial`.
-// - `.bg-size-revert`: Sets the background size property to `revert`.
-// - `.bg-size-revert-layer`: Sets the background size property to `revert-layer`.
-// - `.bg-size-unset`: Sets the background size property to `unset`.
 //
 // The following custom properties control the generated classes:
 // - N/A.

package/src/scss/utilities/z-index/_defaults.scss

@@ -0,0 +1,34 @@
+// @graupl/graupl z-index utilities default values.
+//
+// Generally, these should not be used directly when styling components unless a static value is needed.
+// They are mainly used to provide class selectors, fallbacks for custom properties, or loop values.
+//
+// They should not be used to define direct property values (i.e. font-size, color, etc.).
+// Those should be defined as custom properties in the `_variables.scss` file.
+
+@use "../../defaults" as root-defaults;
+@use "sass:map";
+
+// Utility modifiers.
+$selector-base: root-defaults.$utility-selector-base !default;
+$use-important: root-defaults.$use-important !default;
+$screen-aware: false !default;
+$theme-aware: false !default;
+$state-aware: false !default;
+$screen-aware-separator: root-defaults.$utility-screen-aware-separator !default;
+$theme-aware-separator: root-defaults.$utility-theme-aware-separator !default;
+$state-aware-separator: root-defaults.$utility-state-aware-separator !default;
+
+// Z-index properties.
+
+$z-index-selector-prefix: "z-" !default;
+$base-z-index-properties: (
+  "n1": -1,
+  0: 0,
+  1: 1,
+);
+$custom-z-index-properties: () !default;
+$z-index-properties: map.merge(
+  $base-z-index-properties,
+  $custom-z-index-properties
+);

package/src/scss/utilities/z-index/_index.scss

@@ -0,0 +1,140 @@
+// @graupl/graupl z-index utilities styles.
+//
+// This file generates the z-index utility classes provided by Graupl.
+//
+// The following classes are generated by default:
+// - `.z-n1`: Sets the z-index to -1.
+// - `.z-0`: Sets the z-index to 0.
+// - `.z-1`: Sets the z-index to 1.
+//
+// The following custom properties control the generated classes:
+// - N/A.
+//
+// The following variables control the generated classes:
+// - `$selector-base`: The base selector for the utility classes.
+// - `$use-important`: A flag to determine if the `!important` flag should be added to the utility classes.
+// - `$screen-aware`: A flag to generate screen-aware utility classes.
+// - `$theme-aware`: A flag to generate theme-aware utility classes.
+// - `$state-aware`: A flag to generate state-aware utility classes.
+// - `$screen-aware-separator`: The separator for screen-aware utility classes.
+// - `$theme-aware-separator`: The separator for theme-aware utility classes.
+// - `$state-aware-separator`: The separator for state-aware utility classes.
+// - `$z-index-selector-prefix`: The prefix for the utility classes.
+// - `$base-z-index-properties`: The base properties and values for the z-index utility classes.
+// - `$custom-z-index-properties`: The custom properties and values for the z-index utility classes.
+// - `$z-index-properties`: The merged properties and values for the z-index utility classes.
+//
+// Generating responsive utility classes can be done by setting `$screen-aware`, `$theme-aware`, or `$state-aware` to `true`.
+// By default, no responsive utility classes are generated.
+//
+// When set to true, screen-aware utility classes will be generated for each screen size in the following pattern:
+// - `.{screen-name}:{prefix}{value}`
+//
+// e.g. `.sm:z-0` will set the z-index property to 0 on screens equal to or larger than the `sm` breakpoint.
+//
+// When set to true, theme-aware utility classes will be generated for each theme in the following pattern:
+// - `.{theme-name}:{prefix}{value}`
+//
+// e.g. `.dark:z-0` will set the z-index property to 0 when the `dark` theme is active.
+//
+// When set to true, state-aware utility classes will be generated for each state in the following pattern:
+// - `.{state-name}:{prefix}{value}`
+//
+// e.g. `.hover:z-0` will set the z-index property to 0 when the element is hovered.
+//
+// @example
+//   <div class="z-0">This element has a z-index of 0.</div>
+
+@use "../../defaults" as root-defaults;
+@use "../../mixins/layer" as *;
+@use "../../mixins/utility";
+@use "../../theme/color/variables" as color;
+@use "defaults";
+@use "sass:map";
+@use "variables" as *;
+
+@include layer(utilities) {
+  // `.`
+  $selector-prefix: defaults.$selector-base;
+
+  // For each z-index property, create a utility class.
+  @each $name, $value in defaults.$z-index-properties {
+    // e.g. `.z-0`
+    $selector: #{$selector-prefix}#{defaults.$z-index-selector-prefix}#{$name};
+
+    @include utility.create(
+      $selector,
+      property,
+      $value,
+      $important: #{defaults.$use-important}
+    );
+  }
+
+  // Generate screen-aware utilities.
+  @if defaults.$screen-aware and root-defaults.$screen-aware-utilities {
+    @each $screen-name in map.keys(root-defaults.$screen-sizes) {
+      // e.g. `.md:` or `.lg:`
+      $selector-prefix: #{defaults.$selector-base}#{$screen-name}#{defaults.$screen-aware-separator};
+
+      // For each template property, create a utility class.
+      @each $name, $value in defaults.$z-index-properties {
+        // e.g. `.md:z-0`
+        $selector: #{$selector-prefix}#{defaults.$z-index-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          property,
+          $value,
+          $important: #{defaults.$use-important},
+          $screen: $screen-name
+        );
+      }
+    }
+  }
+
+  // Generate theme-aware utilities.
+  @if defaults.$theme-aware and root-defaults.$theme-aware-utilities {
+    @each $theme-name, $colors in color.$themes {
+      @if $theme-name != active {
+        // e.g. `.dark:` or `.light:`
+        $selector-prefix: #{defaults.$selector-base}#{$theme-name}#{defaults.$theme-aware-separator};
+
+        // For each template property, create a utility class.
+        @each $name, $value in defaults.$z-index-properties {
+          // e.g. `.dark:z-0` or `.light:z-n1`
+          $selector: #{$selector-prefix}#{defaults.$z-index-selector-prefix}#{$name};
+
+          @include utility.create(
+            $selector,
+            property,
+            $value,
+            $important: #{defaults.$use-important},
+            $theme: $theme-name
+          );
+        }
+      }
+    }
+  }
+
+  // Generate state-aware utilities.
+  @if defaults.$state-aware and root-defaults.$state-aware-utilities {
+    @each $state-name, $value in root-defaults.$state-selectors {
+      // e.g. `.hover:` or `.focus:`
+      $selector-prefix: #{defaults.$selector-base}#{$state-name}#{defaults.$state-aware-separator};
+
+      // For each template property, create a utility class.
+      @each $name, $value in defaults.$z-index-properties {
+        // e.g. `.hover:z-0` or `.focus:z-n1`
+        $selector: #{$selector-prefix}#{defaults.$z-index-selector-prefix}#{$name};
+
+        @include utility.create(
+          $selector,
+          property,
+          $value,
+          $important: #{defaults.$use-important},
+          $state: $state-name
+        );
+      }
+    }
+  }
+}

package/src/scss/utilities/z-index/_variables.scss

@@ -0,0 +1,6 @@
+// @graupl/graupl [_template] utilities variables.
+//
+// These values are to be used to directly style components and provide a
+// cleaner way to reference custom properties.
+
+@use "defaults";

package/dist/css/utilities/postion.css

@@ -1,2 +0,0 @@
-@layer graupl.utilities{.position-static{position:static!important}.position-fixed{position:fixed!important}.position-absolute{position:absolute!important}.position-relative{position:relative!important}.position-sticky{position:-webkit-sticky!important;position:sticky!important}@media screen and (0 <= width){.xs\:position-static{position:static!important}.xs\:position-fixed{position:fixed!important}.xs\:position-absolute{position:absolute!important}.xs\:position-relative{position:relative!important}.xs\:position-sticky{position:-webkit-sticky!important;position:sticky!important}}@media screen and (48ch <= width){.sm\:position-static{position:static!important}.sm\:position-fixed{position:fixed!important}.sm\:position-absolute{position:absolute!important}.sm\:position-relative{position:relative!important}.sm\:position-sticky{position:-webkit-sticky!important;position:sticky!important}}@media screen and (72ch <= width){.md\:position-static{position:static!important}.md\:position-fixed{position:fixed!important}.md\:position-absolute{position:absolute!important}.md\:position-relative{position:relative!important}.md\:position-sticky{position:-webkit-sticky!important;position:sticky!important}}@media screen and (108ch <= width){.lg\:position-static{position:static!important}.lg\:position-fixed{position:fixed!important}.lg\:position-absolute{position:absolute!important}.lg\:position-relative{position:relative!important}.lg\:position-sticky{position:-webkit-sticky!important;position:sticky!important}}@media screen and (156ch <= width){.xl\:position-static{position:static!important}.xl\:position-fixed{position:fixed!important}.xl\:position-absolute{position:absolute!important}.xl\:position-relative{position:relative!important}.xl\:position-sticky{position:-webkit-sticky!important;position:sticky!important}}}
-/*# sourceMappingURL=postion.css.map */

package/dist/css/utilities/postion.css.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/scss/mixins/_layer.scss","../../../src/scss/mixins/_utility.scss","postion.css","../../../src/scss/mixins/_screen.scss"],"names":[],"mappings":"AASI,wBC+HA,iBAlHE,yBCnBJ,CDqIE,gBAlHE,wBChBJ,CDkIE,mBAlHE,2BCbJ,CD+HE,mBAlHE,2BCVJ,CD4HE,iBAlHE,iCAAA,CAAA,yBCPJ,CCDA,+BF0HE,qBAlHE,yBCHF,CDqHA,oBAlHE,wBCEF,CDgHA,uBAlHE,2BCOF,CD2GA,uBAlHE,2BCYF,CDsGA,qBAlHE,iCAAA,CAAA,yBCiBF,CAnBF,CCNA,kCF0HE,qBAlHE,yBCsBF,CD4FA,oBAlHE,wBC2BF,CDuFA,uBAlHE,2BCgCF,CDkFA,uBAlHE,2BCqCF,CD6EA,qBAlHE,iCAAA,CAAA,yBC0CF,CAnBF,CC/BA,kCF0HE,qBAlHE,yBC+CF,CDmEA,oBAlHE,wBCoDF,CD8DA,uBAlHE,2BCyDF,CDyDA,uBAlHE,2BC8DF,CDoDA,qBAlHE,iCAAA,CAAA,yBCmEF,CAnBF,CCxDA,mCF0HE,qBAlHE,yBCwEF,CD0CA,oBAlHE,wBC6EF,CDqCA,uBAlHE,2BCkFF,CDgCA,uBAlHE,2BCuFF,CD2BA,qBAlHE,iCAAA,CAAA,yBC4FF,CAnBF,CCjFA,mCF0HE,qBAlHE,yBCiGF,CDiBA,oBAlHE,wBCsGF,CDYA,uBAlHE,2BC2GF,CDOA,uBAlHE,2BCgHF,CDEA,qBAlHE,iCAAA,CAAA,yBCqHF,CAnBF,CAqBF","file":"postion.css"}