vanilla-framework 3.11.1 → 3.13.0

package/package.json

@@ -1,4 +1,6 @@
 {
+  "name": "vanilla-framework",
+  "version": "3.13.0",
   "author": {
     "email": "webteam@canonical.com",
     "name": "Canonical Webteam"
@@ -20,7 +22,6 @@
     "module"
   ],
   "license": "LGPL-3.0",
-  "name": "vanilla-framework",
   "repository": {
     "type": "git",
     "url": "https://github.com/canonical/vanilla-framework"
@@ -47,7 +48,6 @@
     "percy": "percy exec -- node snapshots.js",
     "icon-svgs-to-mixins": "node scripts/convert-svgs-to-icon-mixins.js icons"
   },
-  "version": "3.11.1",
   "files": [
     "_index.scss",
     "/scss",
@@ -61,19 +61,19 @@
     "postcss": "8.4.21",
     "postcss-cli": "9.1.0",
     "postcss-scss": "4.0.6",
-    "sass": "1.58.0",
+    "sass": "1.58.3",
     "yaml": "1.10.2"
   },
   "devDependencies": {
     "@percy/script": "1.1.0",
     "@testing-library/cypress": "9.0.0",
-    "cypress": "12.5.0",
+    "cypress": "12.7.0",
     "get-site-urls": "3.0.0",
     "markdown-spellcheck": "1.3.1",
     "parker": "0.0.10",
-    "prettier": "2.8.3",
+    "prettier": "2.8.4",
     "stylelint": "14.16.1",
-    "stylelint-config-prettier": "9.0.4",
+    "stylelint-config-prettier": "9.0.5",
     "stylelint-config-recommended-scss": "5.0.2",
     "stylelint-order": "5.0.0",
     "stylelint-prettier": "2.0.0",

package/scss/_base_icon-definitions.scss

@@ -485,3 +485,15 @@
 @mixin vf-icon-desktop($color) {
   background-image: url("data:image/svg+xml,%3Csvg width='16' height='16' viewBox='0 0 16 16' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cg id='desktop-2'%3E%3Crect width='16' height='16' /%3E%3Cpath id='Union' fill-rule='evenodd' clip-rule='evenodd' d='M2.5 3.5H13.5V10.5H2.5L2.5 3.5ZM1 3.5C1 2.67157 1.67157 2 2.5 2H13.5C14.3284 2 15 2.67157 15 3.5V10.5C15 11.3284 14.3284 12 13.5 12H8.75V13.25H11V14.75H5V13.25H7.25V12H2.5C1.67157 12 1 11.3284 1 10.5V3.5Z' fill='#{vf-url-friendly-color($color)}'/%3E%3C/g%3E%3C/svg%3E");
 }
+
+@mixin vf-icon-play($color) {
+  background-image: url("data:image/svg+xml,%3Csvg width='16' height='16' viewBox='0 0 16 16' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cg id='play'%3E%3Crect width='16' height='16' /%3E%3Cpath id='Triangle (Stroke)' fill-rule='evenodd' clip-rule='evenodd' d='M11.3844 7.98987L5.50005 3.87809L5.50005 12.1161L11.3844 7.98987ZM12.538 9.01296C13.2485 8.51475 13.2476 7.46192 12.5363 6.96488L5.96604 2.37377C5.13747 1.7948 4.00005 2.3876 4.00005 3.3984L4.00005 12.5968C4.00005 13.6085 5.13935 14.2011 5.96773 13.6202L12.538 9.01296Z' fill='#{vf-url-friendly-color($color)}'/%3E%3C/g%3E%3C/svg%3E");
+}
+
+@mixin vf-icon-pause($color) {
+  background-image: url("data:image/svg+xml,%3Csvg width='16' height='16' viewBox='0 0 16 16' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cg id='pause'%3E%3Crect width='16' height='16' /%3E%3Cpath id='Union' fill-rule='evenodd' clip-rule='evenodd' d='M5.5 3.02393H4V12.9917H5.5V3.02393ZM11.5 3.02393H10V12.9917H11.5V3.02393Z' fill='#{vf-url-friendly-color($color)}'/%3E%3C/g%3E%3C/svg%3E%0A");
+}
+
+@mixin vf-icon-stop($color) {
+  background-image: url("data:image/svg+xml,%3Csvg width='16' height='16' viewBox='0 0 16 16' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cg id='stop'%3E%3Crect width='16' height='16' /%3E%3Cpath id='Rectangle 13 (Stroke)' fill-rule='evenodd' clip-rule='evenodd' d='M12 3.5H4C3.72386 3.5 3.5 3.72386 3.5 4V12C3.5 12.2761 3.72386 12.5 4 12.5H12C12.2761 12.5 12.5 12.2761 12.5 12V4C12.5 3.72386 12.2761 3.5 12 3.5ZM4 2C2.89543 2 2 2.89543 2 4V12C2 13.1046 2.89543 14 4 14H12C13.1046 14 14 13.1046 14 12V4C14 2.89543 13.1046 2 12 2H4Z' fill='#{vf-url-friendly-color($color)}'/%3E%3C/g%3E%3C/svg%3E%0A");
+}

package/scss/_base_typography-definitions.scss

@@ -146,6 +146,8 @@
 
   %default-text {
     @extend %common-default-text-properties;
+    font-size: 1rem;
+    font-weight: $font-weight-regular-text;
 
     margin-bottom: map-get($sp-after, default-text) - map-get($nudges, p);
   }
@@ -204,10 +206,22 @@
   }
 
   %small-caps-text {
-    @extend %common-default-text-properties;
+    @extend %default-text;
     font-variant-caps: all-small-caps;
     letter-spacing: 0.05em;
     margin-bottom: map-get($sp-after, default-text) - map-get($nudges, p);
+
+    &.u-no-margin--bottom {
+      @extend %u-no-margin--bottom--small;
+    }
+
+    // deprecated: the use of .u-align-text--x-small-to-default on small caps text is deprecated
+    // previously small caps was implemented as x-small text variant requiring .u-align-text--x-small-to-default compensations
+    // but now it's implemented with default text size not requiring any compensations,
+    // so we need to reset the padding-top to the default value
+    &.u-align-text--x-small-to-default {
+      padding-top: map-get($nudges, p) + map-get($browser-rounding-compensations, p);
+    }
   }
 
   %table-header-label {
@@ -218,13 +232,9 @@
     text-transform: uppercase;
   }
 
+  // deprecated: %muted-text is deprecated, use %small-caps-text instead
   %muted-heading {
-    @extend %muted-text;
-    @extend %table-header-label;
-
-    &.u-no-margin--bottom {
-      @extend %u-no-margin--bottom--small;
-    }
+    @extend %small-caps-text;
   }
 
   %bold {

package/scss/_base_typography.scss

@@ -78,6 +78,8 @@
     @extend %x-small-text;
   }
 
+  .p-text--small-caps,
+  // deprecated: .p-text--x-small-capitalised is deprecated, use .p-text--small-caps instead
   .p-text--x-small-capitalised {
     @extend %small-caps-text;
   }

package/scss/_patterns_article-pagination.scss

@@ -2,11 +2,12 @@
 
 @mixin vf-p-article-pagination {
   %chevron-icon {
-    color: $color-mid-dark;
-    content: '\203A';
-    font-size: 2em;
+    @extend %icon;
+    @include vf-icon-chevron($color-mid-dark);
+
+    content: '';
     position: absolute;
-    top: 1rem;
+    top: calc($spv--large + $spv--x-small);
   }
 
   .p-article-pagination {
@@ -74,7 +75,7 @@
       @extend %chevron-icon;
 
       left: $sp-small;
-      transform: scaleX(-1);
+      transform: rotate(90deg);
     }
   }
 
@@ -96,6 +97,7 @@
       @extend %chevron-icon;
 
       right: $sp-small;
+      transform: rotate(-90deg);
     }
   }
 }

package/scss/_patterns_icons.scss

@@ -1550,3 +1550,39 @@
     }
   }
 }
+
+@mixin vf-p-icon-play {
+  .p-icon--play {
+    @extend %icon;
+    @include vf-icon-play($color-mid-dark);
+
+    [class*='--dark'] &,
+    &.is-light {
+      @include vf-icon-play($color-mid-x-light);
+    }
+  }
+}
+
+@mixin vf-p-icon-pause {
+  .p-icon--pause {
+    @extend %icon;
+    @include vf-icon-pause($color-mid-dark);
+
+    [class*='--dark'] &,
+    &.is-light {
+      @include vf-icon-pause($color-mid-x-light);
+    }
+  }
+}
+
+@mixin vf-p-icon-stop {
+  .p-icon--stop {
+    @extend %icon;
+    @include vf-icon-stop($color-mid-dark);
+
+    [class*='--dark'] &,
+    &.is-light {
+      @include vf-icon-stop($color-mid-x-light);
+    }
+  }
+}

package/scss/_patterns_lists.scss

@@ -1,6 +1,5 @@
 @import 'settings';
-$list-status-icon-height: 0.875rem; // 14px value from svg as rem so it can be used in calculations
-$list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that positions the icon correctly
+$list-status-icon-height: $default-icon-size;
 
 @mixin vf-p-list-placeholders {
   %numbered-step-container {
@@ -64,33 +63,59 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
 
   %vf-list-item-state-base {
     @extend %vf-list;
-
-    background-position-y: $spv--x-small + $list-status-icon-nudge;
     background-repeat: no-repeat;
     background-size: $list-status-icon-height;
-    padding-left: 2rem;
+    content: '';
+    display: inline-block;
+    height: $sph--large;
+    top: $spv--small;
+  }
+
+  %vf-list-item-ordered {
+    &::marker {
+      content: none;
+      display: none;
+    }
+
+    &::before {
+      color: $color-dark;
+      content: counters(list-item, '.') '. ';
+      display: inline-block;
+      text-align: right;
+    }
+  }
+
+  %vf-list-item-bullet {
+    &::before {
+      color: $color-dark;
+      content: '•';
+      display: inline-block;
+      text-align: right;
+    }
   }
 }
 
-@mixin vf-list-item-divided {
+@mixin vf-list-item-has-prefix {
+  padding-left: $sp-x-large;
   position: relative;
 
-  &::after {
-    border-bottom: 1px solid $color-mid-light;
-    bottom: 0;
-    content: '';
-    height: 1px;
+  > .p-list--divided,
+  > .p-list {
+    margin-left: 0;
+  }
+
+  &::before {
     left: 0;
     position: absolute;
-    right: 0;
+    width: $sp-medium;
   }
+}
 
-  &:last-of-type,
-  .last-item {
-    &::after {
-      border-bottom: 0;
-    }
-  }
+@mixin vf-list-item-divided {
+  box-shadow: inset 0px 1px 0px 0px $color-mid-x-light;
+  margin: 0;
+  padding-bottom: $sph--large;
+  padding-top: $sph--small;
 }
 
 // Mixin for inline list items
@@ -105,14 +130,6 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
   }
 }
 
-@function svg-tick($color) {
-  @if type-of($color) != 'color' {
-    @warn '#{$color} is not a color.';
-    @return false;
-  }
-  @return url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 14 14'%3E%3Ccircle fill='" + vf-url-friendly-color($color) + "' cx='7' cy='7' r='7'/%3E%3Cpath fill='%23fff' d='M6.1 10.813L2.41 8.105l1.184-1.613L5.9 8.187l4.393-4.394 1.414 1.414z' /%3E%3C/svg%3E");
-}
-
 // List styling using list class
 @mixin vf-p-list {
   .p-list {
@@ -133,24 +150,64 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
     .p-list__item {
       @extend %vf-list-item;
       @include vf-list-item-divided;
+
+      &.is-ticked::before,
+      &.is-crossed::before {
+        top: $spv--medium;
+      }
     }
 
     &.is-split .p-list__item:last-of-type {
       border-bottom: 1px solid $color-mid-light;
     }
+
+    & & {
+      margin-bottom: 0;
+      margin-left: $sp-x-large;
+      padding-top: $sph--large;
+
+      .p-list__item:last-child {
+        padding-bottom: 0;
+      }
+    }
   }
+
+  // stylelint-disable selector-max-type -- we want to target ordered lists
+  ol.p-list--divided {
+    list-style: none;
+
+    .p-list__item {
+      @extend %vf-list-item-ordered;
+      @include vf-list-item-has-prefix;
+    }
+  }
+  // stylelint-enable selector-max-type -- we want to target ordered lists
 }
 
 // Displays item with a state icon
 @mixin vf-p-list-item-state {
-  .is-ticked {
-    @extend %vf-list-item-state-base;
-    @include vf-icon-success;
+  .p-list__item.is-ticked {
+    @include vf-list-item-has-prefix;
+
+    &::before {
+      @extend %vf-list-item-state-base;
+      @include vf-icon-success;
+    }
   }
 
-  .is-crossed {
-    @extend %vf-list-item-state-base;
-    @include vf-icon-error;
+  .p-list__item.is-crossed {
+    @include vf-list-item-has-prefix;
+
+    &::before {
+      @extend %vf-list-item-state-base;
+      @include vf-icon-error;
+    }
+  }
+
+  // Displays item with a bullet
+  .p-list__item.has-bullet {
+    @extend %vf-list-item-bullet;
+    @include vf-list-item-has-prefix;
   }
 }
 
@@ -288,6 +345,10 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
         width: $bullet-width;
       }
     }
+    .p-strip--dark &::before {
+      background-color: $color-x-dark;
+      border: 1px solid $color-x-light;
+    }
   }
 
   .p-stepped-list__title + .p-stepped-list__content {
@@ -407,7 +468,6 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
         columns: 2;
 
         .p-list__item {
-          display: inline-block;
           width: 100%;
         }
       }

package/scss/_patterns_logo-section.scss

@@ -1,6 +1,6 @@
 @use 'sass:math';
 
-@mixin vf-p-set-logo-section-item-width($breakpoint: small) {
+@mixin vf-p-set-logo-section-item-width($breakpoint: small, $column-span: 1) {
   // This mixin calculates the width of an individual logo.
 
   $grid-column-count: $grid-columns-small;
@@ -26,7 +26,7 @@
     $gutter: map-get($grid-gutter-widths, default);
     $media-query-keyword: min-width;
     $media-query-width: $threshold-6-12-col;
-    $logo-column-span: 2;
+    $logo-column-span: $column-span;
   }
 
   @media ($media-query-keyword: #{$media-query-width}) {
@@ -141,7 +141,11 @@
 
     @include vf-p-set-logo-section-item-width($breakpoint: small);
     @include vf-p-set-logo-section-item-width($breakpoint: medium);
-    @include vf-p-set-logo-section-item-width($breakpoint: large);
+    @include vf-p-set-logo-section-item-width($breakpoint: large, $column-span: 2);
+
+    .p-logo-section--dense & {
+      @include vf-p-set-logo-section-item-width($breakpoint: large);
+    }
   }
 
   .p-logo-section__logo {

package/scss/_patterns_muted-heading.scss

@@ -1,5 +1,6 @@
+// deprecated: .p-muted-heading and vf-p-muted-heading is deprecated, use .p-text--small-caps instead
 @mixin vf-p-muted-heading {
   .p-muted-heading {
-    @extend %muted-heading;
+    @extend %small-caps-text;
   }
 }

package/scss/_patterns_navigation.scss

@@ -57,6 +57,7 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     $properties: #{background-color, color, opacity};
     @extend %navigation-link-responsive-padding-horizontal;
     @extend %navigation-link-responsive-padding-vertical;
+    @extend %vf-navigation-separator;
     @include vf-transition($properties, snap);
     @include vf-focus;
 
@@ -70,23 +71,19 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     line-height: map-get($line-heights, default-text);
     margin: 0;
     overflow: hidden;
+    padding-left: calc(#{map-get($grid-margin-widths, small)} + #{$sph--x-large}); // allow navigation align with tag logo text on small screens
     position: relative;
     text-align: left;
     text-overflow: ellipsis;
     white-space: nowrap;
     width: 100%;
 
-    &::before {
-      content: '';
-      height: 1px;
-      left: 0;
-      position: absolute;
-      right: 0;
-      top: 0;
+    @media (min-width: $threshold-4-6-col) {
+      padding-left: calc(#{map-get($grid-margin-widths, default)} + #{$sph--x-large});
+    }
 
-      @media (min-width: $breakpoint-navigation-threshold) {
-        content: none;
-      }
+    @media (min-width: $breakpoint-navigation-threshold) {
+      padding-left: $sph--large;
     }
 
     &:visited,
@@ -101,6 +98,25 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     padding-right: 0;
   }
 
+  %vf-navigation-separator {
+    &::before {
+      content: '';
+      height: 1px;
+      left: calc(#{map-get($grid-margin-widths, small)} + #{$sph--x-large});
+      position: absolute;
+      right: 0;
+      top: 0;
+
+      @media (min-width: $threshold-4-6-col) {
+        left: calc(#{map-get($grid-margin-widths, default)} + #{$sph--x-large});
+      }
+
+      @media (min-width: $breakpoint-navigation-threshold) {
+        content: none;
+      }
+    }
+  }
+
   .p-navigation {
     display: flex;
     flex-direction: column;
@@ -190,6 +206,17 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     justify-content: space-between;
     padding-right: 0;
 
+    .p-navigation__link {
+      // reset padding for navigation links in the navigation banner
+      @extend %navigation-link-responsive-padding-horizontal;
+      @extend %navigation-link-responsive-padding-vertical;
+
+      // remove navigation separator for navigation links in the navigation banner
+      &::before {
+        content: none;
+      }
+    }
+
     @media (min-width: $threshold-4-6-col) {
       padding-left: map-get($grid-margin-widths, default);
       padding-right: 0;
@@ -270,10 +297,18 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
 
   // navigation items
   .p-navigation__items {
+    @extend %vf-navigation-separator;
+
     display: none; // hidden by default on mobile (expands is a dropdown)
     list-style: none;
     margin: -1px 0 0 0;
     padding: 0;
+    position: relative;
+
+    // remove navigation separator for the first navigation items list
+    &:first-child::before {
+      content: none;
+    }
 
     @media (min-width: $breakpoint-navigation-threshold) {
       display: flex;
@@ -301,6 +336,11 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     flex-wrap: wrap;
     margin-top: 0; // prevents bottom border of nav from moving 1px
 
+    // remove separtion for navigation items in the navigation banner
+    &::before {
+      content: none;
+    }
+
     @media (min-width: $breakpoint-navigation-threshold) {
       display: none;
     }
@@ -544,6 +584,7 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
       right: map-get($grid-margin-widths, small);
       text-indent: calc(100% + 10rem);
       top: calc($spv--large + map-get($nudges, x-small));
+      transform: rotate(-90deg);
       width: map-get($icon-sizes, default);
 
       @media (min-width: $threshold-4-6-col) {
@@ -552,12 +593,17 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
 
       @media (min-width: $breakpoint-navigation-threshold) {
         right: calc($sph--small + 1px); // 1px for the border on selects. this aligns it with any selects underneath
+        transform: rotate(0deg);
       }
     }
 
     &.is-active {
       &::after {
-        transform: rotate(180deg);
+        transform: rotate(0deg);
+
+        @media (min-width: $breakpoint-navigation-threshold) {
+          transform: rotate(180deg);
+        }
       }
 
       .p-navigation__dropdown,
@@ -570,18 +616,29 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
       // add padding to accommodate icon
       padding-right: 2 * $sph--small + map-get($icon-sizes, default);
     }
+
+    &:first-child .p-navigation__link::before {
+      content: none;
+    }
   }
 
   .p-navigation__dropdown-item {
     @extend %navigation-link-responsive-padding-horizontal;
+    @extend %navigation-link-responsive-padding-vertical;
+    @extend %vf-navigation-separator;
 
     display: block;
-    padding-bottom: $spv--small;
-    padding-top: $spv--small;
+    padding-left: calc(#{map-get($grid-margin-widths, small)} + #{$sph--x-large}); // make dropdown items align with the tag logo text
+    position: relative;
     white-space: nowrap;
 
+    @media (min-width: $threshold-4-6-col) {
+      padding-left: calc(#{map-get($grid-margin-widths, default)} + #{$sph--x-large});
+    }
+
     @media (min-width: $breakpoint-navigation-threshold) {
       padding-bottom: $spv--medium;
+      padding-left: $sph--large;
       padding-top: $spv--medium;
     }
 
@@ -685,7 +742,10 @@ $spv-navigation-logo-bottom-position: 0.125rem; // 2px when 1rem is 16px
     }
   }
 
-  .p-navigation__nav .p-navigation__link::before {
+  // add color to separator line for navigation items, navigation links and dropdown items
+  .p-navigation__nav .p-navigation__link::before,
+  .p-navigation__nav .p-navigation__items::before,
+  .p-navigation__nav .p-navigation__items .p-navigation__dropdown-item::before {
     background: $color-navigation-separator;
   }
 

package/scss/_patterns_search-and-filter.scss

@@ -72,7 +72,7 @@
     .p-search-and-filter__panel {
       @include vf-transition(opacity, fast);
 
-      background-color: $colors--light-theme--background-inputs;
+      background-color: $color-x-light;
       border-radius: $border-radius;
       box-shadow: $box-shadow;
       opacity: 1;

package/scss/_utilities_has-icon.scss

@@ -0,0 +1,6 @@
+@mixin vf-u-has-icon {
+  .u-has-icon [class*='p-icon--']:first-child {
+    margin-right: $sph--small;
+    margin-top: $spv--small;
+  }
+}

package/scss/_vanilla.scss

@@ -67,6 +67,7 @@
 @import 'utilities_equal-height';
 @import 'utilities_floats';
 @import 'utilities_font-metrics';
+@import 'utilities_has-icon';
 @import 'utilities_hide';
 @import 'utilities_image-position';
 @import 'utilities_layout';
@@ -150,6 +151,7 @@
   @include vf-u-embedded-media;
   @include vf-u-equal-height;
   @include vf-u-floats;
+  @include vf-u-has-icon;
   @include vf-u-image-position;
   @include vf-u-layout;
   @include vf-u-margin-collapse;