@stihl-design-system/components 1.0.0-RC.1 → 1.0.0-RC.11

package/styles/scss/lib/_grid.scss

@@ -3,7 +3,6 @@
   --ds-grid-gap: 16px;
   gap: var(--ds-grid-gap);
   min-width: 320px;
-  box-sizing: content-box;
   grid-template-columns:
     [full-start extended-start] var(--ds-internal-grid-safe-zone)
     [main-start narrow-left-start narrow-center-start] repeat(4, minmax(0, 1fr))
@@ -11,14 +10,14 @@
       --ds-internal-grid-safe-zone
     )
     [extended-end full-end];
-  // The safe zone + gap equal to what is called "margin" in the designs 0+16 = 16
+  // The safe zone + gap equal to what is called "margin" in the figma designs 0+16 = 16
   --ds-internal-grid-safe-zone: 0;
   --ds-grid-span-one-half: span 4;
   --ds-grid-span-one-third: span 4;
   --ds-grid-span-two-thirds: span 4;
   --ds-grid-span-one-quarter: span 2;
 
-  @media (min-width: 768px) {
+  @include ds-media-query-min('m') {
     --ds-grid-gap: 24px;
     gap: var(--ds-grid-gap);
     grid-template-columns:
@@ -31,7 +30,7 @@
         --ds-internal-grid-safe-zone
       )
       [extended-end full-end];
-    // The safe zone + gap equal to what is called "margin" in the designs 9+24 = 33
+    // The safe zone + gap equal to what is called "margin" in the figma designs 9+24 = 33
     --ds-internal-grid-safe-zone: 9px;
     --ds-grid-span-one-half: span 3;
     --ds-grid-span-one-third: span 2;
@@ -39,7 +38,7 @@
     --ds-grid-span-one-quarter: span 3;
   }
 
-  @media (min-width: 1024px) {
+  @include ds-media-query-min('l') {
     grid-template-columns:
       [full-start extended-start] var(--ds-internal-grid-safe-zone)
       [main-start narrow-left-start] repeat(2, minmax(0, 1fr))
@@ -48,14 +47,14 @@
       [narrow-center-end] repeat(2, minmax(0, 1fr))
       [main-end] var(--ds-internal-grid-safe-zone)
       [extended-end full-end];
-    // The safe zone + gap equal to what is called "margin" in the designs 26+24 = 50
+    // The safe zone + gap equal to what is called "margin" in the figma designs 26+24 = 50
     --ds-internal-grid-safe-zone: 26px;
     --ds-grid-span-one-half: span 6;
     --ds-grid-span-one-third: span 4;
     --ds-grid-span-two-thirds: span 8;
   }
 
-  @media (min-width: 1536px) {
+  @include ds-media-query-min('xl') {
     --ds-grid-gap: 32px;
     gap: var(--ds-grid-gap);
     grid-template-columns:
@@ -66,18 +65,21 @@
       [narrow-center-end] repeat(3, minmax(0, 1fr))
       [main-end] var(--ds-internal-grid-safe-zone)
       [extended-end full-end];
-    // The safe zone + gap equal to what is called "margin" in the designs 32+32 = 64
+    // The safe zone + gap equal to what is called "margin" in the figma designs 32+32 = 64
     --ds-internal-grid-safe-zone: 32px;
   }
 
-  @media (min-width: 1668px) {
+  @include ds-media-query-min('xxl') {
+    // the calculation here is based on the fact
+    // that we want the main area (main-start till main-end) maximum width to be exactly 1540px
+    // so we have to pick 1584px and divide that by 16
     grid-template-columns:
       [full-start] auto
       [extended-start] var(--ds-internal-grid-safe-zone)
-      [main-start narrow-left-start] repeat(3, minmax(0, calc(1668px / 16)))
-      [narrow-center-start] repeat(3, minmax(0, calc(1668px / 16)))
-      [narrow-left-end] repeat(3, minmax(0, calc(1668px / 16)))
-      [narrow-center-end] repeat(3, minmax(0, calc(1668px / 16)))
+      [main-start narrow-left-start] repeat(3, minmax(0, calc(1584px / 16)))
+      [narrow-center-start] repeat(3, minmax(0, calc(1584px / 16)))
+      [narrow-left-end] repeat(3, minmax(0, calc(1584px / 16)))
+      [narrow-center-end] repeat(3, minmax(0, calc(1584px / 16)))
       [main-end] var(--ds-internal-grid-safe-zone)
       [extended-end]
       auto [full-end];

package/styles/scss/lib/_heading.scss

@@ -1,7 +1,8 @@
 // Base mixin to define common styles
 @mixin base-heading($fontFamily, $fontSize, $lineHeight) {
   font-family: #{unquote(
-      $fontFamily + ', Arial Narrow, Arial, Heiti SC, sans-serif'
+      $fontFamily +
+        ', -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif'
     )};
   font-style: normal;
   font-variant: normal;
@@ -10,6 +11,21 @@
   line-height: $lineHeight;
 }
 
+// Mixin for bold title
+@mixin base-heading-bold($fontFamily, $fontSize, $lineHeight) {
+  @include base-heading($fontFamily, $fontSize, $lineHeight);
+
+  /* x-height 426 https://vertical-metrics.netlify.app/ */
+  font-size-adjust: 0.426;
+}
+
+// Mixin for display title text
+@mixin base-heading-display-title($fontFamily, $fontSize, $lineHeight) {
+  @include base-heading($fontFamily, $fontSize, $lineHeight);
+  /* cap-height 680 https://vertical-metrics.netlify.app/*/
+  font-size-adjust: cap-height 0.68;
+}
+
 @mixin responsive-heading($min, $fontSize, $lineHeight) {
   @include ds-media-query-min($min: $min) {
     font-size: $fontSize;
@@ -18,36 +34,74 @@
 }
 
 // Mixins for specific heading sizes
+// XL
 @mixin ds-heading-x-large {
-  @include base-heading(
+  @include base-heading-bold(
+    'STIHL Contraface Digital Text Bold',
+    1.625rem,
+    1.2
+  );
+  @include responsive-heading('l', 1.875rem, 1.25);
+}
+
+@mixin ds-heading-x-large-uppercase {
+  @include base-heading-display-title(
     'STIHL Contraface Digital Display Title',
     1.625rem,
     1.2
   );
+  text-transform: uppercase;
   @include responsive-heading('l', 1.875rem, 1.25);
 }
 
+// Large
 @mixin ds-heading-large {
-  @include base-heading(
+  @include base-heading-bold(
+    'STIHL Contraface Digital Text Bold',
+    1.375rem,
+    1.25
+  );
+  @include responsive-heading('l', 1.625rem, 1.2);
+}
+
+@mixin ds-heading-large-uppercase {
+  @include base-heading-display-title(
     'STIHL Contraface Digital Display Title',
     1.375rem,
     1.25
   );
+  text-transform: uppercase;
   @include responsive-heading('l', 1.625rem, 1.2);
 }
 
+// Medium
 @mixin ds-heading-medium {
-  @include base-heading('STIHL Contraface Digital Text Bold', 1.25rem, 1.2);
+  @include base-heading-bold(
+    'STIHL Contraface Digital Text Bold',
+    1.25rem,
+    1.2
+  );
 }
 
 @mixin ds-heading-medium-uppercase {
-  @include base-heading('STIHL Contraface Digital Display Title', 1.25rem, 1.2);
+  @include base-heading-display-title(
+    'STIHL Contraface Digital Display Title',
+    1.25rem,
+    1.2
+  );
+  text-transform: uppercase;
 }
 
+// Small
 @mixin ds-heading-small {
-  @include base-heading('STIHL Contraface Digital Text Bold', 1rem, 1.5);
+  @include base-heading-bold('STIHL Contraface Digital Text Bold', 1rem, 1.5);
 }
 
 @mixin ds-heading-small-uppercase {
-  @include base-heading('STIHL Contraface Digital Display Title', 1rem, 1.5);
+  @include base-heading-display-title(
+    'STIHL Contraface Digital Display Title',
+    1rem,
+    1.5
+  );
+  text-transform: uppercase;
 }

package/styles/scss/lib/_helpers.scss

@@ -1,3 +1,15 @@
 @function px-to-rem($pixels, $base-font-size: 16px) {
   @return #{calc($pixels / $base-font-size)}rem;
 }
+
+// Encode a color to be used in a data url.
+@function urlEncodeHexColor($string) {
+  @if type-of($string) == 'color' and str-index(#{$string}, '#') == 1 {
+    $hex: str-slice(ie-hex-str($string), 4);
+    $string: unquote('#{$hex}');
+
+    @return '%23' + $string;
+  }
+
+  @return $string;
+}

package/styles/scss/lib/_high-contrast.scss

@@ -0,0 +1,24 @@
+/**
+ * This mixin provides a utility to wrap styles within a media query specifically
+ * targeting devices that have forced-colors active and thus are in high-contrast mode.
+ *
+ * You can use the following keywords to set specific colors for elements in high contrast mode:
+ * @example
+ * ```markdown
+ * | Content                  | Keyword       |
+ * |--------------------------|---------------|
+ * | Text                     | CanvasText    |
+ * | Hyperlinks               | LinkText      |
+ * | Disabled Text            | GrayText      |
+ * | Selected Text, foreground| HighlightText |
+ * | Selected Text, background| Highlight     |
+ * | Buttons, foreground      | ButtonText    |
+ * | Buttons, background      | ButtonFace    |
+ * | Backgrounds              | Canvas        |
+ * ```
+ */
+@mixin high-contrast-media-query {
+  @media screen and (forced-colors: active) {
+    @content;
+  }
+}

package/styles/scss/lib/_link.scss

@@ -1,46 +1,60 @@
+@import '_helpers';
 @import '_hover';
 @import '_spacing';
+@import '_transition';
 
-// Encode a color to be used in a data url.
-@function urlEncodeHexColor($string) {
-  @if type-of($string) == 'color' and str-index(#{$string}, '#') == 1 {
-    $hex: str-slice(ie-hex-str($string), 4);
-    $string: unquote('#{$hex}');
-
-    @return '%23' + $string;
-  }
-
-  @return $string;
-}
+// IMPORTANT: DSLinkStandalone and ds-link mixin have same visual appearance
+// so if any changes are made to this component, they should be reflected in LinkStandalone as well.
 
 // Set the link variant colors
 @mixin link-variant(
   $content-color,
   $background-color-hover,
-  $content-color-hover
+  $content-color-hover,
+  $theme: 'light'
 ) {
-  color: $content-color;
+  & {
+    color: $content-color;
+  }
 
   &:link,
   &:visited {
     color: $content-color;
   }
 
+  &:active {
+    background-color: $background-color-hover;
+    color: $content-color-hover;
+  }
+
   @include hover-media-query {
     &:hover {
       background-color: $background-color-hover;
       color: $content-color-hover;
+      @include high-contrast-media-query {
+        background-color: Canvas;
+      }
     }
   }
 
-  &:active {
-    background-color: $background-color-hover;
-    color: $content-color-hover;
+  &[href^="http://"]::after,
+  &[href^="https://"]::after
+  {
+    content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='#{urlEncodeHexColor($content-color)}' viewBox='0 0 16 16' focusable='false' width='100%25' height='100%25'%3E%3Cpath fill-rule='evenodd' d='M9 2V0h7v7h-2V3.4L8.1 9.3 6.7 7.9 12.6 2H9Zm5 8h-2v4H2V4h4V2H0v14h14v-6Z' clip-rule='evenodd'/%3E%3C/svg%3E");
+  }
+
+  &[href^='#']::after {
+    content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='#{urlEncodeHexColor($content-color)}' viewBox='0 0 16 16' focusable='false' width='100%25' height='100%25'%3E%3Cpath d='M14.4 9.6 8 16 1.6 9.6 3 8.2l4 4V0h2v12.2l4-4 1.4 1.4Z'/%3E%3C/svg%3E");
   }
+
+  // The offset is set to 0 since Inline Links do not have a 2px
+  // outline offset like the Button component. See designs for reference.
+  @include ds-focus($theme, $offset: 0);
 }
 
 // Mixin for underlined links (inline link or active standalone link)
 @mixin link-underline {
+  text-decoration-skip-ink: auto;
   text-decoration-line: underline;
   text-underline-offset: 2px;
   text-decoration-thickness: 1px;
@@ -48,108 +62,68 @@
 }
 
 // Public Link mixin that can be used to style links.
-// Is also used to style the LinkStandalone component.
-// The $type variable is used to determine if the link is inline or standalone,
 // since there a few design differences between the two.
-@mixin ds-link($variant: 'neutral', $theme: 'light', $type: 'inline') {
-  // Default link color (neutral/light)
-  $link-color: $ds-theme-light-content-color-interaction-neutral;
-
-  // The offset is set to 0 since LinkStandalone does not have a 2px
-  // outline offset like the Button component. See designs for reference.
-  @include ds-focus($theme, $offset: 0);
+@mixin ds-link($variant: 'neutral', $theme: 'light') {
+  display: inline;
+  padding-inline-end: $ds-spacing-2;
+  padding-inline-start: $ds-spacing-2;
+  padding-block-start: 0;
+  padding-block-end: 0;
+  line-height: inherit;
+  font-size: inherit;
+
+  // Inline links are always underlined
+  @include link-underline;
+
+  // Inline links do have two predefined icons for external links and anchors.
+  // The icons are added via the ::after pseudo element as svg data urls to
+  // enable the change of the icon color via the fill property.
+  // Setting the icon & icon color is done in the link-variant mixin since
+  // it depends on the actual link color.
+  :where(&)[href^="http://"]::after,
+  :where(&)[href^="https://"]::after,
+  :where(&)[href^='#']::after {
+    display: inline-block;
+    margin-inline-start: 0.375em;
+    width: 0.75em;
+    height: 0.75em;
+  }
 
   // Variants & themes
   @if ($variant == 'neutral' and $theme == 'light') {
     @include link-variant(
-      $link-color,
+      $ds-theme-light-content-color-interaction-neutral,
       $ds-theme-light-background-color-transparent-hover,
-      $link-color
+      $ds-theme-light-content-color-interaction-neutral
     );
   }
 
   @if ($variant == 'highlight' and $theme == 'light') {
-    $link-color: $ds-theme-light-content-color-interaction-accent;
     @include link-variant(
-      $link-color,
+      $ds-theme-light-content-color-interaction-accent,
       $ds-theme-light-background-color-transparent-hover,
       $ds-theme-light-content-color-interaction-accent-hover
     );
   }
 
   @if ($variant == 'neutral' and $theme == 'dark') {
-    $link-color: $ds-theme-dark-content-color-interaction-neutral;
     @include link-variant(
-      $link-color,
+      $ds-theme-dark-content-color-interaction-neutral,
       $ds-theme-dark-background-color-transparent-hover,
-      $link-color
+      $ds-theme-dark-content-color-interaction-neutral,
+      $theme: 'dark'
     );
   }
 
   @if ($variant == 'highlight' and $theme == 'dark') {
-    $link-color: $ds-theme-dark-content-color-interaction-accent;
     @include link-variant(
-      $link-color,
+      $ds-theme-dark-content-color-interaction-accent,
       $ds-theme-dark-background-color-transparent-hover,
-      $link-color
+      $ds-theme-dark-content-color-interaction-accent,
+      $theme: 'dark'
     );
   }
 
-  // Type
-  @if ($type == 'inline') {
-    // Inline link
-    @include link-underline;
-
-    display: inline;
-    padding-right: $ds-spacing-2;
-    padding-left: $ds-spacing-2;
-    padding-top: 0;
-    padding-bottom: 0;
-    line-height: inherit;
-    font-size: inherit;
-
-    // Inline links do have two predefined icons for external links and anchors.
-    // The icons are added via the ::after pseudo element as svg data urls to
-    // enable the change of the icon color via the fill property.
-    :where(&)[href^="http://"]::after,
-    :where(&)[href^="https://"]::after,
-    :where(&)[href^='#']::after {
-      display: inline-block;
-      margin-left: 0.375em;
-      width: 0.75em;
-      height: 0.75em;
-    }
-
-    &[href^="http://"]::after,
-    &[href^="https://"]::after
-    {
-      content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='#{urlEncodeHexColor($link-color)}' viewBox='0 0 16 16' focusable='false' width='100%25' height='100%25'%3E%3Cpath fill-rule='evenodd' d='M9 2V0h7v7h-2V3.4L8.1 9.3 6.7 7.9 12.6 2H9Zm5 8h-2v4H2V4h4V2H0v14h14v-6Z' clip-rule='evenodd'/%3E%3C/svg%3E");
-    }
-
-    &[href^='#']::after {
-      content: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='#{urlEncodeHexColor($link-color)}' viewBox='0 0 16 16' focusable='false' width='100%25' height='100%25'%3E%3Cpath d='M14.4 9.6 8 16 1.6 9.6 3 8.2l4 4V0h2v12.2l4-4 1.4 1.4Z'/%3E%3C/svg%3E");
-    }
-  } @else {
-    // Standalone link
-    @include ds-utility-medium;
-
-    display: inline-flex;
-    align-items: center;
-    gap: $ds-spacing-6;
-    padding-right: $ds-spacing-4;
-    padding-left: $ds-spacing-4;
-    padding-top: $ds-spacing-2;
-    padding-bottom: $ds-spacing-2;
-    // Set color to transparent instead of text-decoration: none to support forced colors link decoration
-    text-decoration-color: transparent;
-
-    // The DSLinkStandalone component uses the DSIcon component to render a
-    // selectable icon. The icon is colored with the current text color.
-    svg {
-      fill: currentColor;
-    }
-  }
-
   // Transition
-  @include transition(background-color, border-color, color);
+  @include ds-transition((background-color, border-color, color));
 }

package/styles/scss/lib/_media-query.scss

@@ -6,7 +6,7 @@
       @content;
     }
   } @else {
-    @error "Passed #{$min} breakpoint is not available for used ds-media-query-min() mixin.";
+    @error "[STIHL Design System] - [ds-media-query-min()]: Passed '#{$min}' breakpoint is not available in ds-media-query-min() mixin.";
   }
 }
 
@@ -16,7 +16,7 @@
       @content;
     }
   } @else {
-    @error "Passed #{$max} breakpoint is not available for used ds-media-query-max() mixin.";
+    @error "[STIHL Design System] - [ds-media-query-max()]: Passed '#{$max}' breakpoint is not available in ds-media-query-max() mixin.";
   }
 }
 
@@ -27,6 +27,6 @@
       @content;
     }
   } @else {
-    @error "Passed #{$min} and/or #{$max} breakpoint is not available for used ds-media-query-min-max() mixin.";
+    @error "[STIHL Design System] - [ds-media-query-min-max()]: Passed '#{$min}' and/or '#{$max}' breakpoint is not available in ds-media-query-min-max() mixin.";
   }
 }

package/styles/scss/lib/_shadow.scss

@@ -0,0 +1,10 @@
+@mixin ds-shadow-m {
+  box-shadow:
+    0px 2px 12px 0px rgba(0, 0, 0, 0.08),
+    0px 1px 2px 0px rgba(0, 0, 0, 0.16);
+}
+@mixin ds-shadow-l {
+  box-shadow:
+    0px 8px 48px 0px rgba(0, 0, 0, 0.1),
+    0px 2px 4px 0px rgba(0, 0, 0, 0.04);
+}

package/styles/scss/lib/_spacing-dynamic.scss

@@ -0,0 +1,61 @@
+@import '_media-query';
+
+// Spacing values updated for breakpoints
+$spacing-dynamic-values: (
+  'xs': (
+    'base': $ds-spacing-16,
+    's': $ds-spacing-16,
+    'm': $ds-spacing-24,
+    'l': $ds-spacing-24,
+    'xl': $ds-spacing-32,
+    'xxl': $ds-spacing-32,
+  ),
+  's': (
+    'base': $ds-spacing-24,
+    's': $ds-spacing-24,
+    'm': $ds-spacing-32,
+    'l': $ds-spacing-32,
+    'xl': $ds-spacing-40,
+    'xxl': $ds-spacing-40,
+  ),
+  'm': (
+    'base': $ds-spacing-32,
+    's': $ds-spacing-32,
+    'm': $ds-spacing-40,
+    'l': $ds-spacing-40,
+    'xl': $ds-spacing-48,
+    'xxl': $ds-spacing-48,
+  ),
+  'l': (
+    'base': $ds-spacing-40,
+    's': $ds-spacing-40,
+    'm': $ds-spacing-48,
+    'l': $ds-spacing-48,
+    'xl': $ds-spacing-56,
+    'xxl': $ds-spacing-56,
+  ),
+  'xl': (
+    'base': $ds-spacing-56,
+    's': $ds-spacing-56,
+    'm': $ds-spacing-64,
+    'l': $ds-spacing-64,
+    'xl': $ds-spacing-80,
+    'xxl': $ds-spacing-80,
+  ),
+  'xxl': (
+    'base': $ds-spacing-80,
+    's': $ds-spacing-80,
+    'm': $ds-spacing-96,
+    'l': $ds-spacing-96,
+    'xl': $ds-spacing-128,
+    'xxl': $ds-spacing-128,
+  ),
+);
+
+// Assign dynamic spacing variables
+$ds-spacing-dynamic-xs: var(--ds-spacing-dynamic-xs);
+$ds-spacing-dynamic-s: var(--ds-spacing-dynamic-s);
+$ds-spacing-dynamic-m: var(--ds-spacing-dynamic-m);
+$ds-spacing-dynamic-l: var(--ds-spacing-dynamic-l);
+$ds-spacing-dynamic-xl: var(--ds-spacing-dynamic-xl);
+$ds-spacing-dynamic-xxl: var(--ds-spacing-dynamic-xxl);

package/styles/scss/lib/_spacing.scss

@@ -1,9 +1,11 @@
+$ds-spacing-0: 0px;
 $ds-spacing-1: 1px;
 $ds-spacing-2: 2px;
 $ds-spacing-4: 4px;
 $ds-spacing-6: 6px;
 $ds-spacing-8: 8px;
 $ds-spacing-12: 12px;
+$ds-spacing-14: 14px;
 $ds-spacing-16: 16px;
 $ds-spacing-20: 20px;
 $ds-spacing-24: 24px;
@@ -16,3 +18,15 @@ $ds-spacing-80: 80px;
 $ds-spacing-96: 96px;
 $ds-spacing-128: 128px;
 $ds-spacing-160: 160px;
+
+// Functions to adjust spacing to account for the inner border of an element  as designed in Figma.
+// This is necessary to ensure that the spacing matches the design specifications
+// where the border is included inside the element, causing an effective reduction
+// in the available space by the width of the border.
+@function adjust-spacing-for-border-1($spacing) {
+  @return #{calc($spacing - $ds-spacing-1)};
+}
+
+@function adjust-spacing-for-border-2($spacing) {
+  @return #{calc($spacing - $ds-spacing-2)};
+}