vanilla-framework 3.3.0 → 3.6.0

package/package.json

@@ -27,10 +27,11 @@
   },
   "scripts": {
     "start": "yarn build && yarn serve",
-    "build": "yarn build-scss && yarn build-js",
-    "build-scss": "yarn run build-js && sass --load-path=node_modules --embed-sources --style=compressed scss:build/css && postcss --use autoprefixer --replace 'build/css/**/*.css' --map",
+    "build": "yarn build-scss && yarn build-js && yarn build-class-references",
+    "build-scss": "sass --load-path=node_modules --embed-sources --style=compressed scss:build/css && postcss --use autoprefixer --replace 'build/css/**/*.css' --map",
     "build:essential": "yarn run build-js && sass --load-path=node_modules --embed-sources --style=compressed scss/build.scss:build/css/build.css scss/docs:build/css/docs && postcss --use autoprefixer --replace 'build/css/**/*.css' --map",
     "build-js": "mkdir -p build/js/modules && cp node_modules/@canonical/cookie-policy/build/js/cookie-policy.js build/js/modules && cp node_modules/@canonical/latest-news/dist/latest-news.js build/js/modules",
+    "build-class-references": "node scripts/create-class-references.js",
     "serve": "./entrypoint 0.0.0.0:${PORT}",
     "test-scss": "node -e 'require(\"./tests/parker\").parkerTest()'",
     "test-spelling": "mdspell templates/docs/**/*.md -r -n -a --en-gb",
@@ -44,7 +45,7 @@
     "percy": "percy exec -- node snapshots.js",
     "icon-svgs-to-mixins": "node scripts/convert-svgs-to-icon-mixins.js icons"
   },
-  "version": "3.3.0",
+  "version": "3.6.0",
   "files": [
     "_index.scss",
     "/scss",
@@ -53,11 +54,13 @@
   ],
   "dependencies": {
     "@canonical/cookie-policy": "3.4.0",
-    "@canonical/latest-news": "1.3.0",
-    "autoprefixer": "10.4.4",
-    "postcss": "8.4.12",
+    "@canonical/latest-news": "1.4.1",
+    "autoprefixer": "10.4.7",
+    "postcss": "8.4.14",
     "postcss-cli": "9.1.0",
-    "sass": "1.49.11"
+    "postcss-scss": "4.0.4",
+    "sass": "1.52.2",
+    "yaml": "1.10.2"
   },
   "devDependencies": {
     "@percy/script": "1.1.0",
@@ -65,7 +68,7 @@
     "markdown-spellcheck": "1.3.1",
     "parker": "0.0.10",
     "prettier": "2.6.2",
-    "stylelint": "14.6.1",
+    "stylelint": "14.8.5",
     "stylelint-config-prettier": "9.0.3",
     "stylelint-config-recommended-scss": "5.0.2",
     "stylelint-order": "5.0.0",

package/scss/_patterns_badge.scss

@@ -0,0 +1,34 @@
+@import 'settings';
+
+@mixin vf-p-badge {
+  %vf-badge {
+    @extend %x-small-text;
+    background-color: $color-dark;
+    border-radius: 1rem;
+    box-sizing: content-box;
+    color: $color-x-light;
+    margin-bottom: 0;
+    max-width: 4ch;
+    overflow: hidden;
+    padding: 0 $spv--x-small;
+  }
+
+  .p-badge,
+  .p-badge--negative {
+    @extend %vf-badge;
+  }
+
+  .p-badge--negative {
+    background-color: $color-negative;
+  }
+
+  .p-chip,
+  [class*='p-chip--'] {
+    .p-badge,
+    .p-badge--negative {
+      align-self: center;
+      margin-left: $sph--small;
+      margin-right: -0.15rem;
+    }
+  }
+}

package/scss/_patterns_code-snippet.scss

@@ -1,3 +1,49 @@
+/*
+  @classreference
+  code-snippet:
+    Root element:
+        .p-code-snippet:
+            Main element of the code snippet component.
+        "&.is-bordered":
+            Bordered variant, to be used when additional content (such as iframes) is used inside the code snippet component.
+
+    Code block:
+        .p-code-snippet__block:
+            Code block without any additonal styling elements.
+        "&.is-wrapped":
+            Code block with wrapped content in lines.
+        .p-code-snippet__block--icon:
+            Code block that starts with an icon. Default icon is a UNIX prompt. To be used with Linux CLI examples.
+        "&.is-windows-prompt":
+            Changes the `.p-code-snippet__block--icon` to use a Windows prompt icon. To be used with Windows CLI examples.
+        "&.is-url":
+            Changes the `.p-code-snippet__block--icon` to use a link icon. To be used with URLs.
+        .p-code-snippet__block--numbered:
+            Code block with numbered lines of code (to be used with longer pieces of code examples). Requires `.p-code-snippet__line`.
+
+    Code line:
+        .p-code-snippet__line:
+            A wrapper around single line of code. Needed with numbered variant of a code block.
+
+    Code block header:
+        .p-code-snippet__header:
+            A header of a code block. Contains a title and optional dropdowns.
+        "&.is-stacked":
+            A stacked version of a header (with a title displayed above the dropdowns). To be used when there are multiple dropdowns with a long title.
+
+    Code block title:
+        .p-code-snippet__title:
+            The title of a code block.
+
+    Dropdowns container:
+        .p-code-snippet__dropdowns:
+            The container element for any dropdowns in the header.
+
+    Dropdown:
+        .p-code-snippet__dropdown:
+            An individual dropdown in code block header.
+*/
+
 @import 'settings';
 
 $color-snippet-heading-bg: rgba($color-x-dark, 0.08);

package/scss/_patterns_lists.scss

@@ -171,14 +171,14 @@ $list-status-icon-nudge: 0.3rem; // 0.3rem seems to be a magic number that posit
 
     .p-inline-list__item {
       @include vf-inline-list-item;
-
+      margin-right: $sph--small;
       position: relative;
 
       &::after {
         content: '\2022';
         line-height: map-get($line-heights, default-text);
-        position: absolute;
-        right: -$sp-unit;
+        position: relative;
+        right: -0.25rem;
       }
 
       &:last-of-type,

package/scss/_patterns_navigation.scss

@@ -68,11 +68,13 @@ $spv-navigation-logo: 0.3125rem;
     display: block;
     font-weight: $font-weight-bold;
     line-height: map-get($line-heights, default-text);
-    margin-bottom: 0;
+    margin: 0;
     overflow: hidden;
     position: relative;
+    text-align: left;
     text-overflow: ellipsis;
     white-space: nowrap;
+    width: 100%;
 
     &::before {
       content: '';
@@ -243,7 +245,7 @@ $spv-navigation-logo: 0.3125rem;
 
     .p-navigation__logo-title {
       @extend %vf-heading-4;
-
+      font-size: #{map-get($font-sizes, h4)}rem;
       line-height: map-get($line-heights, x-small);
     }
 

package/scss/_patterns_notifications.scss

@@ -1,5 +1,57 @@
 @import 'settings';
 
+/*
+  @classreference
+  notification:
+    Root element:
+        .p-notification:
+            Notification in default variant. Same as `.p-notification--information`.
+        .p-notification--information:
+            Information notification. Same as default `.p-notification`.
+        .p-notification--positive:
+            Positive notification.
+        .p-notification--caution:
+            Caution notification.
+        .p-notification--negative:
+            Negative notification.
+        "&.is-borderless":
+            Borderless variant of notification. Used when notification is embeded into another container element.
+        "&.is-inline":
+            Inline version of notification with title and message rendered side by side.
+
+    Content container:
+        .p-notification__content:
+            Container element for notification content (title and message).
+
+    Title:
+        .p-notification__title:
+            The notification title.
+
+    Message:
+        .p-notification__message:
+            Text of the notification message.
+
+    Close button:
+        .p-notification__close:
+            The button to close the notification.
+
+    Meta-data container:
+        .p-notification__meta:
+            The container element for notification meta-data (timestamp and action buttons).
+
+    Timestamp:
+        .p-notification__timestamp:
+            Notification timestamp or date.
+
+    Actions container:
+        .p-notification__actions:
+            Container element for notification action buttons.
+
+    Action button:
+        .p-notification__action:
+            Single action button.
+*/
+
 // space on the left of the icon + icon width + space on the right of the icon
 $notification-content-icon-space: 2 * $sph--large + map-get($icon-sizes, default);
 

package/scss/_patterns_pagination.scss

@@ -13,7 +13,11 @@
     }
   }
 
-  .p-pagination {
+  // .p-pagination on the <ol> element is deprecated. It should be used on the wrapping <nav> element instead, and .p-pagination__items on the <ol> or <ul> element.
+
+  // stylelint-disable selector-max-type
+  .p-pagination:not(nav),
+  .p-pagination__items {
     display: flex;
     flex-direction: row;
     list-style: none;

package/scss/_patterns_side-navigation.scss

@@ -1,5 +1,81 @@
 @import 'settings';
 
+/*
+  @classreference
+  side-navigation:
+    Root element:
+        .p-side-navigation:
+            Side navigation in default variant.
+        .p-side-navigation--icons:
+            Side navigation with item icons.
+        .p-side-navigation--raw-html:
+            Raw HTML version of side navigation (used with links generated by an external service).
+        "&.is-drawer-expanded":
+            Set `.is-drawer-expanded` when side navigation drawer is open on small screens.
+        "&.is-drawer-collapsed":
+            Set `.is-drawer-collapsed` when side navigation drawer is closed on small screens.
+        "&.is-drawer-hidden":
+            Set `.is-drawer-hidden` when side navigation drawer is closed on small screens.
+        "&.is-sticky":
+            Sticky version of side navigation.
+        "&.is-dark":
+            Side navigation in dark theme (if default is light).
+        "&.is-light":
+            Side navigation in light theme (if default is dark).
+
+    Overlay:
+        .p-side-navigation__overlay:
+            Screen overlay to display when side navigation drawer is open on small screens.
+
+    Drawer:
+        .p-side-navigation__drawer:
+            Side navigation drawer (to allow expanding and collapsing the navigation on small screens).
+
+    Drawer header:
+        .p-side-navigation__drawer-header:
+            Header of the side navigation drawer.
+
+    Toggle button:
+        .p-side-navigation__toggle:
+            Side navigation toggle button (to open side navigation on small screens).
+        .p-side-navigation__toggle--in-drawer:
+            Side navigation toggle button in drawer (to close navigation on small screens).
+
+    Items list heading:
+        .p-side-navigation__heading:
+            Heading for side navigation items group (text only).
+        .p-side-navigation__heading--linked:
+            Heading for side navigation items group that contains a link (`.p-side-navigation__link`).
+
+    Items list:
+        .p-side-navigation__list:
+            Group of side navigation items (usually a `<ul>` element).
+
+    Item element:
+        .p-side-navigation__item:
+            Single item in side navigation (usually a `<li>` element). May contain nested items lists.
+        .p-side-navigation__item--title:
+            Single title item in side navigation (usually a `<li>` element).
+        "&.has-active-child":
+            Set `.has-active-child` on a item that contains an active nested item. This is used in collapsible side navigation in application layout.
+
+    Item link:
+        .p-side-navigation__link:
+            Single link in the side navigation.
+
+    Item text:
+        .p-side-navigation__text:
+            Single text item in side navigation (for items that are not linked).
+
+    Item icon:
+        .p-side-navigation__icon:
+            An icon in side navigation item (used with `.p-side-navigation--icons` variant).
+
+    Item status:
+        .p-side-navigation__status:
+            A container for status icon or label inside the navigation item.
+*/
+
 @mixin vf-p-side-navigation {
   // STYLING OF SIDE NAVIGATION RESPONSIVE DRAWER
 
@@ -206,6 +282,18 @@
     padding-top: $spv--x-small;
   }
 
+  %side-navigation__heading {
+    @extend %side-navigation__text;
+
+    // reset heading styles
+    @extend %common-default-text-properties;
+    @extend %bold;
+
+    display: block;
+    font-size: map-get($base-font-sizes, base);
+    margin: 0;
+  }
+
   %side-navigation__link {
     @include vf-focus;
 
@@ -230,6 +318,7 @@
     @extend %side-navigation__link;
   }
 
+  .p-side-navigation__heading,
   .p-side-navigation__text,
   .p-side-navigation__link {
     @extend %side-navigation__text;
@@ -275,6 +364,15 @@
     padding-left: $spv--small;
   }
 
+  .p-side-navigation__heading,
+  .p-side-navigation__heading--linked {
+    @extend %side-navigation__heading;
+  }
+
+  .p-side-navigation__heading--linked {
+    padding: 0; // padding will come from the link in heading
+  }
+
   // Styles for markup in raw HTML docs variant
   .p-side-navigation--raw-html {
     // stylelint-disable selector-max-type -- we support raw HTML markup for discourse-generated side nav
@@ -283,14 +381,7 @@
     h4,
     h5,
     h6 {
-      @extend %side-navigation__text;
-
-      // reset heading styles
-      @extend %common-default-text-properties;
-      @extend %bold;
-
-      font-size: map-get($base-font-sizes, base);
-      margin: 0;
+      @extend %side-navigation__heading;
     }
 
     ul {
@@ -488,6 +579,8 @@
     }
   }
 
+  .p-side-navigation__heading,
+  .p-side-navigation__heading--linked .p-side-navigation__link,
   .p-side-navigation__item--title,
   .p-side-navigation__item--title .p-side-navigation__link {
     color: $color-sidenav-text-active;

package/scss/_patterns_tabs.scss

@@ -42,9 +42,12 @@
       );
       @include vf-highlight-bar(transparent, bottom, false);
 
+      align-items: center;
       border: none;
       color: $color-dark;
-      display: block;
+      display: flex;
+      gap: $sph--small;
+      height: 100%;
       line-height: map-get($line-heights, default-text);
       margin-bottom: 0;
       padding: $spv--medium $sph--large;

package/scss/_vanilla.scss

@@ -8,6 +8,7 @@
 @import 'patterns_buttons';
 @import 'patterns_card';
 @import 'patterns_chip';
+@import 'patterns_badge';
 @import 'patterns_code-snippet';
 @import 'patterns_contextual-menu';
 @import 'patterns_divider';
@@ -88,6 +89,7 @@
   @include vf-p-buttons;
   @include vf-p-card;
   @include vf-p-chip;
+  @include vf-p-badge;
   @include vf-p-code-snippet;
   @include vf-p-contextual-menu;
   @include vf-p-divider;