@graupl/graupl 1.0.0-beta.10 → 1.0.0-beta.11

package/packages/core/src/scss/utilities/typography/_variables.scss

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

package/packages/core/src/scss/utilities/visibility/_defaults.scss

@@ -1,39 +0,0 @@
-// @graupl/core visibility 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: true !default;
-$theme-aware: false !default;
-$state-aware: false !default;
-$container-aware: true !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;
-$container-aware-separator: root-defaults.$utility-container-aware-separator !default;
-$screen-aware-selector-prefix: root-defaults.$utility-screen-aware-selector-prefix !default;
-$theme-aware-selector-prefix: root-defaults.$utility-theme-aware-selector-prefix !default;
-$state-aware-selector-prefix: root-defaults.$utility-state-aware-selector-prefix !default;
-$container-aware-selector-prefix: root-defaults.$utility-container-aware-selector-prefix !default;
-
-// Visibility properties.
-$visibility-selector-prefix: "visibility-" !default;
-$base-visibility-properties: (
-  visible: visible,
-  hidden: hidden,
-  collapse: collapse,
-);
-$custom-visibility-properties: () !default;
-$visibility-properties: map.merge(
-  $base-visibility-properties,
-  $custom-visibility-properties
-);

package/packages/core/src/scss/utilities/visibility/_index.scss

@@ -1,173 +0,0 @@
-// @graupl/core visibility utilities styles.
-//
-// This file generates the visibility utility classes provided by Graupl.
-//
-// The following classes are generated by default:
-// - `.visibility-visible`: Sets the visibility property to `visible`.
-// - `.visibility-hidden`: Sets the visibility property to `hidden`.
-// - `.visibility-collapse`: Sets the visibility property to `collapse`.
-//
-// 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.
-// - `$container-aware`: A flag to generate container-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.
-// - `$container-aware-separator`: The separator for container-aware utility classes.
-// - `$screen-aware-selector-prefix`: The prefix for screen-aware utility classes.
-// - `$theme-aware-selector-prefix`: The prefix for theme-aware utility classes.
-// - `$state-aware-selector-prefix`: The prefix for state-aware utility classes.
-// - `$container-aware-selector-prefix`: The prefix for container-aware utility classes.
-// - `$visibility-selector-prefix`: The prefix for the visibility utility classes.
-// - `$base-visibility-properties`: The base properties and values for the visibility utility classes.
-// - `$custom-visibility-properties`: The custom properties and values for the visibility utility classes.
-// - `$visibility-properties`: The combined properties and values for the visibility utility classes.
-//
-// When set to true, screen-aware utility classes will be generated for each screen size in the following pattern:
-// - `.{screen-prefix}{screen-name}:{prefix}{value}`
-//
-// e.g. `.md:visibility-visible` will set the `visibility` property to `visible` on screens equal to or larger than the `md` breakpoint.
-//
-// When set to true, theme-aware utility classes will be generated for each theme in the following pattern:
-// - `.{theme-prefix}{theme-name}:{prefix}{value}`
-//
-// e.g. `.dark:visibility-visible` will set the `visibility` property to `visible` 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-prefix}{state-name}:{prefix}{value}`
-//
-// e.g. `.hover:visibility-visible` will set the `visibility` property to `visible` when the element is hovered.
-//
-// When set to true, container-aware utility classes will be generated for each container in the following pattern:
-// - `.{container-prefix}{container-name}:{prefix}{value}`
-//
-// e.g. `.cq:md:visibility-visible` will set the `visibility` property to `visible` when the parent container is larger than the `md` breakpoint.
-//
-// @example
-//   <div class="visibility-hidden">This is a hidden element.</div>
-//
-// @example
-//   <div class="visibility-visible md:visibility-hidden">This element will be visible unless the screen size is `md` or larger.
-
-@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 visibility property, create a utility class.
-  @each $name, $value in defaults.$visibility-properties {
-    // e.g. `.visibility-visible` or `.visibility-hidden`
-    $selector: #{$selector-prefix}#{defaults.$visibility-selector-prefix}#{$name};
-
-    @include utility.create(
-      $selector,
-      visibility,
-      $value,
-      $important: defaults.$use-important
-    );
-  }
-
-  // Generate screen-aware utilities.
-  @if defaults.$screen-aware {
-    @each $screen-name in map.keys(root-defaults.$screen-sizes) {
-      // e.g. `.md:` or `.lg:`
-      $selector-prefix: #{defaults.$selector-base}#{defaults.$screen-aware-selector-prefix}#{$screen-name}#{defaults.$screen-aware-separator};
-
-      // For each visibility property, create a utility class.
-      @each $name, $value in defaults.$visibility-properties {
-        // e.g. `.md:visibility-visible` or `.lg:visibility-hidden`
-        $selector: #{$selector-prefix}#{defaults.$visibility-selector-prefix}#{$name};
-
-        @include utility.create(
-          $selector,
-          visibility,
-          $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}#{defaults.$theme-aware-selector-prefix}#{$theme-name}#{defaults.$theme-aware-separator};
-
-        // For each visibility property, create a utility class.
-        @each $name, $value in defaults.$visibility-properties {
-          // e.g. `.dark:visibility-visible` or `.light:visibility-hidden`
-          $selector: #{$selector-prefix}#{defaults.$visibility-selector-prefix}#{$name};
-
-          @include utility.create(
-            $selector,
-            visibility,
-            $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}#{defaults.$state-aware-selector-prefix}#{$state-name}#{defaults.$state-aware-separator};
-
-      // For each visibility property, create a utility class.
-      @each $name, $value in defaults.$visibility-properties {
-        // e.g. `.hover:visibility-visible` or `.focus:visibility-hidden`
-        $selector: #{$selector-prefix}#{defaults.$visibility-selector-prefix}#{$name};
-
-        @include utility.create(
-          $selector,
-          visibility,
-          $value,
-          $important: defaults.$use-important,
-          $state: $state-name
-        );
-      }
-    }
-  }
-
-  // Generate container-aware utilities.
-  @if defaults.$container-aware {
-    @each $container-name in map.keys(root-defaults.$container-sizes) {
-      // e.g. `.md:` or `.lg:`
-      $selector-prefix: #{defaults.$selector-base}#{defaults.$container-aware-selector-prefix}#{$container-name}#{defaults.$container-aware-separator};
-
-      // For each visibility property, create a utility class.
-      @each $name, $value in defaults.$visibility-properties {
-        // e.g. `.md:visibility-visible` or `.lg:visibility-hidden`
-        $selector: #{$selector-prefix}#{defaults.$visibility-selector-prefix}#{$name};
-
-        @include utility.create(
-          $selector,
-          visibility,
-          $value,
-          $important: defaults.$use-important,
-          $container: $container-name
-        );
-      }
-    }
-  }
-}

package/packages/core/src/scss/utilities/visibility/_variables.scss

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

package/packages/core/src/scss/utilities/visually-hidden/_defaults.scss

@@ -1,29 +0,0 @@
-// @graupl/core visually-hidden 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;
-
-// 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;
-$container-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;
-$container-aware-separator: root-defaults.$utility-container-aware-separator !default;
-$screen-aware-selector-prefix: root-defaults.$utility-screen-aware-selector-prefix !default;
-$theme-aware-selector-prefix: root-defaults.$utility-theme-aware-selector-prefix !default;
-$state-aware-selector-prefix: root-defaults.$utility-state-aware-selector-prefix !default;
-$container-aware-selector-prefix: root-defaults.$utility-container-aware-selector-prefix !default;
-
-// Visually hidden properties.
-$visually-hidden-selector: "visually-hidden" !default;
-$visually-hidden-focusable-selector: "focusable" !default;

package/packages/core/src/scss/utilities/visually-hidden/_index.scss

@@ -1,189 +0,0 @@
-// @graupl/core visually-hidden utilities styles.
-//
-// This file generates the visually-hidden utility classes provided by Graupl.
-//
-// The following classes are generated by default:
-// - `.visually-hidden`: Hides an element visually but leaves it accessible to screen readers.
-// - `.focusable`: When applied to a visually hidden element, it makes the element accessible to keyboard navigation.
-//
-// 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.
-// - `$container-aware`: A flag to generate container-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.
-// - `$container-aware-separator`: The separator for container-aware utility classes.
-// - `$screen-aware-selector-prefix`: The prefix for screen-aware utility classes.
-// - `$theme-aware-selector-prefix`: The prefix for theme-aware utility classes.
-// - `$state-aware-selector-prefix`: The prefix for state-aware utility classes.
-// - `$container-aware-selector-prefix`: The prefix for container-aware utility classes.
-// - `$visually-hidden-selector`: The selector for the visually-hidden utility class.
-// - `$visually-hidden-focusable-selector`: The selector for the focusable utility class.
-//
-// 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}:visually-hidden`
-//
-// e.g. `.sm:visually-hidden` will visually hide elements 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}:visually-hidden`
-//
-// e.g. `.dark:visually-hidden` will visually hide elements 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}:visually-hidden`
-//
-// e.g. `.hover:visually-hidden` will visually hide elements when the element is hovered.
-//
-// When set to true, container-aware utility classes will be generated for each container in the following pattern:
-// - `.{container-prefix}{container-name}:{prefix}{value}`
-//
-// e.g. `.cq:md:visually-hidden` will set the `visibility` property to `hidden` when the parent container is larger than the `md` breakpoint.
-//
-// Note: The `.focusable` class will never have screen-aware, theme-aware, or state-aware classes generated.
-//
-// @example
-//   <div class="visually-hidden">This is visually hidden.</div>
-//
-// @example
-//   <a href="#main-content" class="visually-hidden focusable">Skip to main content</a>
-
-@use "../../defaults" as root-defaults;
-@use "../../mixins/container";
-@use "../../mixins/layer" as *;
-@use "../../mixins/screen";
-@use "../../mixins/state";
-@use "../../mixins/theme";
-@use "../../mixins/visually-hidden";
-@use "../../theme/color/variables" as color;
-@use "defaults";
-@use "sass:map";
-@use "variables" as *;
-
-@include layer(utilities) {
-  // `.`
-  $selector-prefix: defaults.$selector-base;
-
-  // `.visually-hidden`
-  #{$selector-prefix}#{defaults.$visually-hidden-selector} {
-    // `&:not(.focusable)`
-    &:not(#{$selector-prefix}#{defaults.$visually-hidden-focusable-selector}) {
-      @include visually-hidden.apply(defaults.$use-important);
-    }
-
-    // `&.focusable`
-    &#{$selector-prefix}#{defaults.$visually-hidden-focusable-selector} {
-      @include visually-hidden.focusable(defaults.$use-important);
-    }
-  }
-
-  // Create 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}#{defaults.$screen-aware-selector-prefix}#{$screen-name}#{defaults.$screen-aware-separator};
-
-      @include screen.up($screen-name) {
-        // e.g. `.md:visually-hidden`
-        #{$selector-prefix}#{defaults.$visually-hidden-selector} {
-          // `&:not(.focusable)`
-          &:not(
-              #{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector}
-            ) {
-            @include visually-hidden.apply(defaults.$use-important);
-          }
-
-          // `&.focusable`
-          &#{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector} {
-            @include visually-hidden.focusable(defaults.$use-important);
-          }
-        }
-      }
-    }
-  }
-
-  // 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 {
-        $selector-prefix: #{defaults.$selector-base}#{defaults.$theme-aware-selector-prefix}#{$theme-name}#{defaults.$theme-aware-separator};
-
-        @include theme.theme($theme-name) {
-          // e.g. `.dark:visually-hidden`
-          #{$selector-prefix}#{defaults.$visually-hidden-selector} {
-            // `&:not(.focusable)`
-            &:not(
-                #{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector}
-              ) {
-              @include visually-hidden.apply(defaults.$use-important);
-            }
-
-            // `&.focusable`
-            &#{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector} {
-              @include visually-hidden.focusable(defaults.$use-important);
-            }
-          }
-        }
-      }
-    }
-  }
-
-  // Generate state-aware utilities.
-  @if defaults.$state-aware and root-defaults.$state-aware-utilities {
-    @each $state-name, $value in root-defaults.$state-selectors {
-      $selector-prefix: #{defaults.$selector-base}#{defaults.$state-aware-selector-prefix}#{$state-name}#{defaults.$state-aware-separator};
-
-      @include state.state($state-name) {
-        // e.g. `.hover:visually-hidden`
-        #{$selector-prefix}#{defaults.$visually-hidden-selector} {
-          // `&:not(.focusable)`
-          &:not(
-              #{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector}
-            ) {
-            @include visually-hidden.apply(defaults.$use-important);
-          }
-
-          // `&.focusable`
-          &#{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector} {
-            @include visually-hidden.focusable(defaults.$use-important);
-          }
-        }
-      }
-    }
-  }
-
-  // Create container aware utilities.
-  @if defaults.$container-aware and root-defaults.$container-aware-utilities {
-    @each $container-name in map.keys(root-defaults.$container-sizes) {
-      // e.g. `.md:` or `.lg:`
-      $selector-prefix: #{defaults.$selector-base}#{defaults.$container-aware-selector-prefix}#{$container-name}#{defaults.$container-aware-separator};
-
-      @include container.up($container-name) {
-        // e.g. `.md:visually-hidden`
-        #{$selector-prefix}#{defaults.$visually-hidden-selector} {
-          // `&:not(.focusable)`
-          &:not(
-              #{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector}
-            ) {
-            @include visually-hidden.apply(defaults.$use-important);
-          }
-
-          // `&.focusable`
-          &#{defaults.$selector-base}#{defaults.$visually-hidden-focusable-selector} {
-            @include visually-hidden.focusable(defaults.$use-important);
-          }
-        }
-      }
-    }
-  }
-}

package/packages/core/src/scss/utilities/visually-hidden/_variables.scss

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

package/packages/core/src/scss/utilities/width/_defaults.scss

@@ -1,54 +0,0 @@
-// @graupl/core width 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;
-$container-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;
-$container-aware-separator: root-defaults.$utility-container-aware-separator !default;
-$screen-aware-selector-prefix: root-defaults.$utility-screen-aware-selector-prefix !default;
-$theme-aware-selector-prefix: root-defaults.$utility-theme-aware-selector-prefix !default;
-$state-aware-selector-prefix: root-defaults.$utility-state-aware-selector-prefix !default;
-$container-aware-selector-prefix: root-defaults.$utility-container-aware-selector-prefix !default;
-
-// Width properties.
-$width-selector-prefix: "w-" !default;
-$max-width-selector-prefix: "max-w-" !default;
-$min-width-selector-prefix: "min-w-" !default;
-
-// Width values.
-$base-width-values: (
-  auto: auto,
-  fit-content: fit-content,
-  max-content: max-content,
-  min-content: min-content,
-  stretch: stretch,
-  full: 100%,
-  quarter: 25%,
-  half: 50%,
-  three-quarters: 75%,
-  third: calc(100% / 3),
-  two-thirds: calc(100% / 1.5),
-  half-screen: 50vw,
-  third-screen: calc(100vw / 3),
-  two-thirds-screen: calc(100vw / 1.5),
-  quarter-screen: 25vw,
-  three-quarters-screen: 75vw,
-  full-screen: 100vw,
-);
-$custom-width-values: () !default;
-$width-values: map.merge($base-width-values, $custom-width-values);