vanilla-framework 4.50.0 → 4.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-framework",
-  "version": "4.50.0",
+  "version": "4.52.0",
   "author": {
     "email": "webteam@canonical.com",
     "name": "Canonical Webteam"

package/scss/_layouts_full-width.scss

@@ -19,11 +19,10 @@
     }
 
     .l-full-width__sidebar {
-      background: $colors--theme--background-alt;
-
       // height of top navigation, as padding applied to .p-navigation__link + line-heigh of the anchor text inside
       $navigation-top-height: $spv--large * 2 + map-get($settings-text-default, line-height);
 
+      background: $colors--theme--background-alt;
       height: calc(100% - $navigation-top-height); // height of document reduced by height of top nav
       min-height: calc(100dvh - $navigation-top-height);
       position: absolute;

package/scss/_patterns_content-card.scss

@@ -10,10 +10,12 @@
         Modifier for a 4-column width horizontal layout. Applied ONLY to the parent .p-content-card.
       "&.p-content-card--cols-6":
         Modifier for a 6-column width horizontal layout. Applied ONLY to the parent .p-content-card.
+      "&.p-content-card--cols-8":
+        Modifier for an 8-column (full-width) layout with 50/50 content and image split on desktop. Applied ONLY to the parent .p-content-card. Image is required.
       "&.has-image":
         State class applied to the parent when the card includes an image.
       "&.has-desc":
-        State class applied to the parent when the card includes a description that appears on hover.
+        State class applied to the parent when the card includes a description. For col-2/4/6 the description slides up on hover; for col-8 it is always visible below the heading.
     Links:
       .p-content-card__overlay-link:
         Invisible absolute link spanning the entire card to make it clickable.
@@ -78,9 +80,10 @@ $card-author-padding-bottom: $sp-small;
 
 $card-fallback-spacing-large: $sp-x-large;
 $card-fallback-image-gap: $sp-small + $sp-xx-small;
+$card-height-8col: 22rem;
 
 @mixin mq-min($breakpoint) {
-  @media screen and (width >= $breakpoint) {
+  @media screen and (width >=$breakpoint) {
     @content;
   }
 }
@@ -92,7 +95,7 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
 }
 
 @mixin mq-between($min, $max) {
-  @media screen and ($min <= width < $max) {
+  @media screen and ($min <=width < $max) {
     @content;
   }
 }
@@ -111,18 +114,24 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
 
     /* 2-Column Spanning */
     &--2 {
-      grid-column: 1 / -1; /* Mobile */
+      grid-column: 1 / -1;
+
+      /* Mobile */
       @include mq-between($breakpoint-small, $breakpoint-large) {
-        grid-column: span 2; /* Medium */
+        grid-column: span 2;
+        /* Medium */
       }
+
       @include mq-min($breakpoint-large) {
-        grid-column: span 2; /* Desktop */
+        grid-column: span 2;
+        /* Desktop */
       }
     }
 
     /* 4-Column Spanning */
     &--4 {
       grid-column: 1 / -1;
+
       @include mq-min($breakpoint-large) {
         grid-column: span 4;
       }
@@ -131,10 +140,16 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
     /* 6-Column Spanning */
     &--6 {
       grid-column: 1 / -1;
+
       @include mq-min($breakpoint-large) {
         grid-column: span 6;
       }
     }
+
+    /* 8-Column Spanning (full width) */
+    &--8 {
+      grid-column: 1 / -1;
+    }
   }
 
   /* =========================================
@@ -168,7 +183,8 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
       &:not(:has(.p-content-card__footer-outer)) {
         height: auto;
         min-height: 0;
-        padding-bottom: var(--spacing-vertical-large, $sp-medium); /* Keeps spacing balanced */
+        padding-bottom: var(--spacing-vertical-large, $sp-medium);
+        /* Keeps spacing balanced */
       }
     }
 
@@ -221,6 +237,16 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
       }
     }
 
+    /* 8-Column: Desktop horizontal grid layout */
+    @include mq-min($breakpoint-large) {
+      &.p-content-card--cols-8.has-image {
+        display: grid;
+        grid-template-columns: 1fr 1fr;
+        min-height: $card-height-8col;
+        padding: 0;
+      }
+    }
+
     &__overlay-link {
       inset: 0;
       position: absolute;
@@ -242,6 +268,18 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
         line-clamp: 2;
       }
 
+      .p-content-card--cols-8 & {
+        -webkit-line-clamp: 3;
+        line-clamp: 3;
+      }
+
+      @include mq-between($breakpoint-small, $breakpoint-large) {
+        .p-content-card--cols-8 & {
+          -webkit-line-clamp: 2;
+          line-clamp: 2;
+        }
+      }
+
       &:hover,
       &:focus,
       &:active,
@@ -268,7 +306,6 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
       display: -webkit-box;
       -webkit-line-clamp: 3;
       line-clamp: 3;
-      line-height: 1.5;
       margin-top: 0 !important;
       max-height: 4.5em;
       max-width: none;
@@ -283,11 +320,25 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
         max-height: 3em;
       }
 
+      .p-content-card--cols-8 & {
+        -webkit-line-clamp: 3;
+        line-clamp: 3;
+        max-height: 4.5em;
+      }
+
       @include mq-min($breakpoint-large) {
         .p-content-card--cols-6 & {
           margin-top: $card-nudge-negative !important;
         }
       }
+
+      @include mq-between($breakpoint-small, $breakpoint-large) {
+        .p-content-card--cols-8 & {
+          -webkit-line-clamp: 2;
+          line-clamp: 2;
+          max-height: 3em;
+        }
+      }
     }
 
     &__content {
@@ -298,6 +349,12 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
       justify-content: space-between;
       min-width: 0;
       width: 100%;
+
+      @include mq-min($breakpoint-large) {
+        .p-content-card--cols-8 & {
+          grid-column: 1;
+        }
+      }
     }
 
     &__body {
@@ -315,6 +372,20 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
           padding: 0;
         }
       }
+
+      .p-content-card--cols-8 & {
+        display: flex;
+        flex-direction: column;
+        min-height: 0;
+        padding: 0 $sp-medium;
+      }
+
+      @include mq-min($breakpoint-large) {
+        .p-content-card--cols-8 & {
+          align-self: stretch;
+          padding: $sp-medium $sp-medium 0 $sp-medium;
+        }
+      }
     }
 
     &__primary-content,
@@ -335,6 +406,13 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
     &__hover-content {
       opacity: 0;
       transform: translateY(150px);
+
+      .p-content-card--cols-8 & {
+        flex: 1;
+        min-height: 0;
+        opacity: 1;
+        transform: translateY(0);
+      }
     }
 
     &__description {
@@ -350,6 +428,19 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
         line-clamp: 2;
       }
 
+      .p-content-card--cols-8 & {
+        -webkit-line-clamp: 3;
+        line-clamp: 3;
+      }
+
+      @include mq-max($breakpoint-large) {
+        .p-content-card--cols-8 & {
+          -webkit-line-clamp: 2;
+          line-clamp: 2;
+          margin-bottom: 1rem;
+        }
+      }
+
       @include mq-min($breakpoint-large) {
         .p-content-card--cols-6 & {
           margin-top: $card-nudge-negative !important;
@@ -359,9 +450,13 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
 
     &__footer-container {
       /* Structural grouping element.
-        Because the parent (.p-content-card__content) uses flexbox space-between, 
+        Because the parent (.p-content-card__content) uses flexbox space-between,
         this wrapper prevents the <hr> from floating awkwardly in the middle of the card.
       */
+
+      .p-content-card--cols-8 & {
+        width: 100%;
+      }
     }
 
     &__footer-outer {
@@ -444,6 +539,11 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
         .p-content-card--cols-6 & {
           height: $card-image-height-horizontal-large;
         }
+
+        .p-content-card--cols-8 & {
+          aspect-ratio: auto;
+          height: 100%;
+        }
       }
     }
 
@@ -457,6 +557,17 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
 
       width: 100%;
 
+      @include mq-min($breakpoint-large) {
+        .p-content-card--cols-8 & {
+          grid-column: 2;
+          grid-row: 1 / -1;
+          height: 100%;
+          padding: 0.5rem;
+          padding-bottom: 0;
+          width: 100%;
+        }
+      }
+
       @include mq-min($breakpoint-small) {
         .p-content-card--cols-4 &,
         .p-content-card--cols-6 & {
@@ -465,6 +576,12 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
           width: $card-image-width;
         }
       }
+
+      @include mq-max($breakpoint-large) {
+        .p-content-card--cols-8 & {
+          padding: 0rem 0.5rem 1rem 0.5rem;
+        }
+      }
     }
 
     &__author-and-date {
@@ -508,14 +625,14 @@ $card-fallback-image-gap: $sp-small + $sp-xx-small;
     }
 
     @include mq-min($breakpoint-large) {
-      &.has-desc:hover .p-content-card__primary-content,
-      &.has-desc:focus-within .p-content-card__primary-content {
+      &.has-desc:not(.p-content-card--cols-8):hover .p-content-card__primary-content,
+      &.has-desc:not(.p-content-card--cols-8):focus-within .p-content-card__primary-content {
         opacity: 0;
         transform: translateY(-150px);
       }
 
-      &.has-desc:hover .p-content-card__hover-content,
-      &.has-desc:focus-within .p-content-card__hover-content {
+      &.has-desc:not(.p-content-card--cols-8):hover .p-content-card__hover-content,
+      &.has-desc:not(.p-content-card--cols-8):focus-within .p-content-card__hover-content {
         opacity: 1;
         transform: translateY(0);
       }

package/scss/_patterns_image.scss

@@ -18,6 +18,10 @@
         Wraps contents in a container with an aspect ratio of 2.4:1.
       .p-image-container--square:
         Wraps contents in a container with an aspect ratio of 1:1.
+      .p-image-container--auto-height:
+        Stretches the container to the height of an adjacent grid column, clamped between a 16:9 minimum and a 2:3 maximum of the column width using CSS container queries.
+      .p-image-container--auto-height-on-(small|medium|large):
+        Auto-height variant applied only at the specified breakpoint.
       .p-image-container--(16-9|3-2|2-3|cinematic|square)-on-(small|medium|large):
         Wraps contents in a container with the specified aspect ratio on the specified breakpoint.
     Image:
@@ -37,6 +41,11 @@ $aspect-ratios: (
   'square': 1,
 );
 
+// Auto-height clamp bounds, expressed as a percentage of the container's width.
+// Upper bound matches the 2:3 (portrait) ratio; lower bound matches 16:9.
+$image-container-auto-height-max: math.div(1, map-get($aspect-ratios, '2-3')) * 100cqw;
+$image-container-auto-height-min: math.div(1, map-get($aspect-ratios, '16-9')) * 100cqw;
+
 @mixin apply-aspect-ratio-styles($padding-value) {
   &::before {
     content: '';
@@ -57,6 +66,19 @@ $aspect-ratios: (
   }
 }
 
+@mixin apply-auto-height-styles {
+  container-type: inline-size;
+  height: 100%;
+  max-height: $image-container-auto-height-max;
+  min-height: $image-container-auto-height-min;
+
+  .p-image-container__image {
+    height: 100%;
+    object-fit: contain;
+    width: 100%;
+  }
+}
+
 @mixin aspect-ratio-classes {
   @each $aspect-ratio, $aspect-ratio-value in $aspect-ratios {
     $padding-percentage: math.div(1, $aspect-ratio-value) * 100%;
@@ -65,6 +87,10 @@ $aspect-ratios: (
     }
   }
 
+  .p-image-container--auto-height {
+    @include apply-auto-height-styles;
+  }
+
   // Responsive aspect ratios
   @each $breakpoint-name, $breakpoint-bounds-pair in $breakpoint-bounds {
     $min-width: map-get($breakpoint-bounds-pair, min);
@@ -78,6 +104,9 @@ $aspect-ratios: (
             @include apply-aspect-ratio-styles($padding-percentage);
           }
         }
+        .p-image-container--auto-height-on-#{$breakpoint-name} {
+          @include apply-auto-height-styles;
+        }
       }
     } @else if $min-width {
       @media (width >= $min-width) {
@@ -87,6 +116,9 @@ $aspect-ratios: (
             @include apply-aspect-ratio-styles($padding-percentage);
           }
         }
+        .p-image-container--auto-height-on-#{$breakpoint-name} {
+          @include apply-auto-height-styles;
+        }
       }
     } @else if $max-width {
       @media (width < $max-width) {
@@ -96,6 +128,9 @@ $aspect-ratios: (
             @include apply-aspect-ratio-styles($padding-percentage);
           }
         }
+        .p-image-container--auto-height-on-#{$breakpoint-name} {
+          @include apply-auto-height-styles;
+        }
       }
     }
   }

package/scss/_patterns_lists.scss

@@ -262,6 +262,9 @@ $list-step-bullet-margin: $sph--x-large;
 
       display: grid;
 
+      // --columns is set in the container queries above
+      grid-template-columns: repeat(var(--columns), 1fr);
+
       @container (width >= #{$horizontal-list-section-medium-content-width}) {
         grid-gap: 0 map-get($grid-gutter-widths, default);
       }
@@ -282,9 +285,6 @@ $list-step-bullet-margin: $sph--x-large;
         }
       }
 
-      // --columns is set in the container queries above
-      grid-template-columns: repeat(var(--columns), 1fr);
-
       .p-list__item {
         @extend %vf-list-item;
         @include vf-list-item-icon-divisor-offset;

package/scss/_patterns_suru.scss

@@ -82,13 +82,13 @@
     // same as %section-padding--default
     padding-bottom: $spv--strip-regular * 0.5;
 
+    // padding top based on p-section--hero
+    padding-top: $spv--large;
+
     @media (min-width: $breakpoint-large) {
       padding-bottom: $spv--strip-regular;
     }
 
-    // padding top based on p-section--hero
-    padding-top: $spv--large;
-
     // on large screens, same as %section-padding--shallow
     @media (min-width: $breakpoint-large) {
       padding-top: $spv--x-large;

package/scss/_settings_colors.scss

@@ -58,7 +58,7 @@ $hover-background-opacity-percentage: $hover-background-opacity-amount * 100%;
 // NON-SEMANTIC COLOURS
 $color-label-validated: #006b75;
 $color-code-background: rgba($color-x-dark, 0.03);
-$color-code-background-dark: rgba($color-x-light, 0.3);
+$color-code-background-dark: rgba($color-x-light, 0.15);
 $color-code-heading-background: rgba($color-x-dark, 0.08);
 
 // Background colours for form elements

package/templates/_macros/vf_card.jinja

@@ -1,23 +1,27 @@
 {#
   All Params
-  columns: Grid column span for the card. Options are 2, 4, 6. Default is 2.
+  columns: Grid column span for the card. Options are 2, 4, 6, 8. Default is 2.
   heading: H4 title text. Truncated at 3 lines. Required.
   link: Link to referenced item. Makes the entire card clickable. Required.
-  image: Dictionary containing 'src' and 'alt' for the 16:9 image. Required for col-6.
+  image: Dictionary containing 'src' and 'alt' for the 16:9 image. Required for col-6 and col-8.
   author: Optional string for the author's name. Hidden if no image is provided.
   date: Optional string for the publication date. Hidden if no image is provided.
   footer: Dictionary containing 'resource_type' (icon and text) and 'content_type' (read-only chip).
-  description: Optional text that slides up on hover, truncating at 4 lines.
+  description: Optional text. For col-2/4/6 slides up on hover (4 lines; 2 for col-6). For col-8 always visible below the heading (3 lines desktop/tablet, 2 lines mobile).
 
   Variants:
   col-2: 2-column width card layout (Vertical)
     Params: columns (2), heading (req), link (req), image (opt), author (opt, hidden if no image), date (opt, hidden if no image), footer (opt), description (opt)
-  
+
   col-4: 4-column width card layout (Horizontal)
     Params: columns (4), heading (req), link (req), image (opt), footer (opt), description (opt)
-  
+
   col-6: 6-column width card layout (Horizontal)
     Params: columns (6), heading (req), link (req), image (req), author (opt), date (opt), footer (opt), description (opt)
+
+  col-8: 8-column (full-width) card layout (50/50 horizontal on desktop, vertical stack on mobile/tablet)
+    Heading uses h4 with p-heading--1 styling. Image appears on the right on desktop, above heading on mobile/tablet.
+    Params: columns (8), heading (req), link (req), image (req), author (opt), date (opt), footer (opt), description (opt)
 #}
 
 {%- macro vf_card(columns="2", link=None, heading=None, image=None, author=None, date=None, footer=None, description=None) -%}
@@ -26,11 +30,12 @@
 {%- set layout = 'p-content-card--cols-' ~ col_str -%}
 {%- set img_class = 'has-image' if image else '' -%}
 {%- set has_desc = 'has-desc' if description else '' -%}
+{%- set heading_extra_class = 'p-heading--1 ' if col_str == '8' else '' -%}
 
 <div class="p-content-card-wrapper p-content-card-wrapper--{{ col_str }}">
-    
+
     <div class="p-content-card {{ layout }} {{ img_class }} {{ has_desc }}">
-        
+
         {%- if link -%}
             <a href="{{ link }}" class="p-content-card__overlay-link" tabindex="-1" aria-hidden="true"></a>
         {%- endif -%}
@@ -43,16 +48,16 @@
 
         <div class="p-content-card__content">
             <div class="p-content-card__body">
-                
+
                 <div class="p-content-card__primary-content">
-                    <h4 class="p-content-card__heading">
+                    <h4 class="{{ heading_extra_class }}p-content-card__heading">
                         {%- if link -%}
                             <a href="{{ link }}" class="p-content-card__main-link">{{ heading }}</a>
                         {%- else -%}
                             {{ heading }}
                         {%- endif -%}
                     </h4>
-                    
+
                     {%- if image and (author or date) -%}
                     <div class="p-content-card__author-and-date u-sv-3">
                         <small>
@@ -72,7 +77,7 @@
                 {%- endif -%}
 
             </div>
-            
+
             {%- if footer -%}
             <div class="p-content-card__footer-container">
                 <hr class="p-rule--muted">
@@ -95,4 +100,5 @@
         </div>
     </div>
 </div>
+
 {%- endmacro -%}

package/templates/_macros/vf_rich-vertical-list.jinja

@@ -1,127 +1,127 @@
+{% from "_macros/vf_basic-section.jinja" import basic_section_title, vf_basic_section_blocks %}
+{% from "_macros/shared/vf_section_top_rule.jinja" import vf_section_top_rule %}
+
 # Params
-# title_text (string) (required): Title of the rich vertical list
-# list_item_tick_style (string) (optional): Type of list item tick styling. Options are "bullet", "tick", "number".
-# is_flipped (boolean) (optional): Whether the list items are flipped so image is on the left and the text is on the right. Defaults to false.
-# Slots
-# description: Paragraph-style description content
-# logo_section Logo section block
-# list_item_[1-7]: List item content, assumed to be li.p-list__item
-# image (required)
+# title (dict) (required): {text, link_attrs?} — rendered via basic_section_title (always renders <h2>).
+# items (array) (optional): Array of {type, item} dicts rendered via vf_basic_section_blocks.
+#   Supported types: description, list, code-block, logo-block, cta-block.
+#   Entries with any other type are silently dropped.
+# media (dict) (required): Media column config. Keys:
+#   - type (string): "image" | "video". Defaults to "image".
+#   - ratio.large (string): "16-9" | "3-2" | "1-1" | "2-3" | "auto-height". Defaults to "3-2".
+#   - ratio.medium_small (string): "16-9" | "3-2" | "1-1". Defaults to "3-2".
+#   - fit (string): "cover" | "contain". Defaults to "cover".
+#   - attrs (dict): Passthrough HTML attributes for the <img> or <iframe>.
+# is_flipped (bool) (optional): Swap content and media columns. Defaults to false.
+# padding (string) (optional): "deep" | "shallow" | "default". Defaults to "default".
+# top_rule_variant (string) (optional): "default" | "muted". Defaults to "default".
+# attrs (dict) (optional): HTML attrs for the <section>.
 {% macro vf_rich_vertical_list(
-  title_text,
-  list_item_tick_style="",
-  is_flipped=false
+  title={},
+  items=[],
+  media={},
+  is_flipped=false,
+  padding="default",
+  top_rule_variant="default",
+  attrs={}
 ) -%}
-  {% set description_content = caller('description') %}
-  {% set has_description = description_content|trim|length > 0 %}
-  {% set logo_section_content = caller('logo_section') %}
-  {% set has_logo_section = logo_section_content|trim|length > 0 %}
-  {% set cta_content = caller('cta') %}
-  {% set has_cta = cta_content|trim|length > 0 %}
-  {% set has_list = caller('list_item_1')|trim|length > 0 %}
-  {% set image_content = caller('image') %}
-  {% set max_list_items = 7 %}
-
-  {% set list_item_tick_style=list_item_tick_style|trim|lower %}
-  {% if list_item_tick_style|length > 0 and list_item_tick_style not in ['bullet', 'tick', 'number'] %}
-    {% set list_item_tick_style = '' %}
-  {% endif %}
+  {#- Normalise & validate padding -#}
+  {%- set padding = padding | string | trim | lower -%}
+  {%- if padding not in ['deep', 'shallow', 'default'] -%}{%- set padding = 'default' -%}{%- endif -%}
+  {%- set padding_classes = 'p-section--' ~ padding -%}
+  {%- if padding == 'default' -%}{%- set padding_classes = 'p-section' -%}{%- endif -%}
 
-  {% if list_item_tick_style == "bullet" %}
-    {% set list_item_tick_class = "has-bullet" %}
-  {% elif list_item_tick_style == "tick" %}
-    {% set list_item_tick_class = "is-ticked" %}
-  {% endif %}
+  {#- Normalise & validate top_rule_variant -#}
+  {%- set top_rule_variant = top_rule_variant | string | trim | lower -%}
+  {%- if top_rule_variant not in ['default', 'muted'] -%}{%- set top_rule_variant = 'default' -%}{%- endif -%}
 
-  {% set list_element_type = "ul" %}
-  {% if list_item_tick_style == "number" %}
-    {% set list_element_type = "ol" %}
-  {% endif %}
+  {#- Normalise & validate media config -#}
+  {%- set media_type = (media.get('type', 'image') | string | trim | lower) -%}
+  {%- if media_type not in ['image', 'video'] -%}{%- set media_type = 'image' -%}{%- endif -%}
 
-  {#-
-    Construct list of list items using caller in the top-level macro
-    The _text_column_contents macro will not have access to the caller block, so we need to extract the list items here.
-  -#}
-  {% set list_items = [] %}
-  {% if has_list %}
-    {% for list_item_index in range(1, max_list_items + 1) %}
-      {% set list_item_content = caller('list_item_' + list_item_index|string) %}
-      {% set has_list_item_content = list_item_content|trim|length > 0 %}
-      {% if has_list_item_content %}
-        {{ list_items.append(list_item_content) or ""}}
-      {% endif %}
-    {% endfor %}
-  {% endif %}
+  {%- set media_ratio = media.get('ratio', {}) -%}
+  {%- set media_ratio_large = (media_ratio.get('large', '3-2') | string | trim | lower) -%}
+  {%- set valid_large_ratios = ['16-9', '3-2', '1-1', '2-3', 'auto-height'] -%}
+  {%- if media_ratio_large not in valid_large_ratios -%}{%- set media_ratio_large = '3-2' -%}{%- endif -%}
 
-  {%- macro _text_column_contents(list_items) %}
-    {#- Mandatory title -#}
-    <div class="p-section--shallow">
-      <h2>{{ title_text }}</h2>
-    </div>
-
-    {%- if has_logo_section %}
-      {#- Optional logo section -#}
-      <div class="p-section--shallow">
-        <div class="u-fixed-width">
-        {{- logo_section_content -}}
-        </div>
-      </div>
-    {%- endif -%}
+  {%- set media_ratio_medium_small = (media_ratio.get('medium_small', '3-2') | string | trim | lower) -%}
+  {#- 'auto-height' is intentionally excluded — it requires side-by-side columns, but medium/small layouts stack -#}
+  {%- set valid_medium_small_ratios = ['16-9', '3-2', '1-1'] -%}
+  {%- if media_ratio_medium_small not in valid_medium_small_ratios -%}{%- set media_ratio_medium_small = '3-2' -%}{%- endif -%}
 
-    {%- if has_description %}
-      {#- Optional description -#}
-      <div class="p-section--shallow">
-        {{- description_content -}}
-      </div>
-    {%- endif -%}
+  {%- set media_fit = (media.get('fit', 'cover') | string | trim | lower) -%}
+  {%- if media_fit not in ['cover', 'contain'] -%}{%- set media_fit = 'cover' -%}{%- endif -%}
 
-    {%- if list_items|length > 0 %}
-      {#- Optional list -#}
-      <{{ list_element_type }} class="p-list--divided">
-       {% for list_item in list_items %}
-         <li class="p-list__item {{ list_item_tick_class }}">
-           {{- list_item -}}
-         </li>
-        {% endfor %}
-      </{{ list_element_type }}>
-    {%- endif -%}
+  {%- set media_attrs = media.get('attrs', {}) -%}
+  {%- set is_auto_height = (media_ratio_large == 'auto-height') -%}
 
-    {%- if has_cta %}
-      {#- Optional CTA block -#}
-      <div class="p-cta-block">
-        {{- cta_content -}}
-      </div>
-    {%- endif -%}
+  {#- Constrain items to the curated allow-list. Disallowed types are silently dropped. -#}
+  {%- set allowed_item_types = ['description', 'list', 'code-block', 'logo-block', 'cta-block'] -%}
+  {%- set filtered_items = items | selectattr('type', 'in', allowed_item_types) | list -%}
 
+  {%- macro _rich_list_image(ratio_large, ratio_medium_small, fit, attrs) %}
+    {%- set is_cover = (fit == 'cover') -%}
+    {#- The image-container CSS uses 'square' for the 1:1 ratio class, not '1-1'. -#}
+    {%- set ratio_large_class = 'square' if ratio_large == '1-1' else ratio_large -%}
+    {%- set ratio_medium_small_class = 'square' if ratio_medium_small == '1-1' else ratio_medium_small -%}
+    {%- set classes = 'p-image-container--' ~ ratio_large_class ~ '-on-large' -%}
+    {%- set classes = classes ~ ' p-image-container--' ~ ratio_medium_small_class ~ '-on-medium' -%}
+    {%- set classes = classes ~ ' p-image-container--' ~ ratio_medium_small_class ~ '-on-small' -%}
+    {%- if is_cover -%}{%- set classes = classes ~ ' is-cover' -%}{%- endif -%}
+    <div class="{{ classes }}">
+      <img class="p-image-container__image{%- if 'class' in attrs %} {{ attrs['class'] }}{%- endif %}"
+        {%- for attr, value in attrs.items() -%}
+          {%- if attr != 'class' %} {{ attr }}="{{ value }}"{%- endif -%}
+        {%- endfor -%}
+      />
+    </div>
   {%- endmacro -%}
 
-  {%- macro _image_column_contents() %}
-    {#- Mandatory image -#}
-    <div class="p-section--shallow">
-      {{- image_content -}}
+  {%- macro _rich_list_video(attrs) %}
+    <div class="u-embedded-media">
+      <iframe class="u-embedded-media__element{%- if 'class' in attrs %} {{ attrs['class'] }}{%- endif %}"
+        {%- for attr, value in attrs.items() -%}
+          {%- if attr != 'class' %} {{ attr }}="{{ value }}"{%- endif -%}
+        {%- endfor -%}
+      ></iframe>
     </div>
   {%- endmacro -%}
 
-  <div class="p-section">
-    <div class="grid-row--50-50-on-large">
-      <hr>
-      {% if not is_flipped -%}
-        <div class="grid-col">
-          {{- _text_column_contents(list_items) -}}
-        </div>
-        <div class="grid-col">
-          {{- _image_column_contents() -}}
-        </div>
+  {%- macro _media_column_contents(
+    media_type, media_ratio_large, media_ratio_medium_small, media_fit, media_attrs, is_auto_height
+  ) -%}
+    {%- if is_auto_height -%}
+      <div>
+    {%- else -%}
+      <div class="p-section--shallow">
+    {%- endif -%}
+      {%- if media_type == 'video' -%}
+        {{ _rich_list_video(media_attrs) }}
       {%- else -%}
-        {#- For flipped layout, place the image contents in the first column and the text in the second column -#}
-        <div class="grid-col">
-          {{- _image_column_contents() -}}
-        </div>
-        <div class="grid-col">
-          {{- _text_column_contents(list_items) -}}
-        </div>
+        {{ _rich_list_image(media_ratio_large, media_ratio_medium_small, media_fit, media_attrs) }}
       {%- endif -%}
     </div>
-  </div>
+  {%- endmacro -%}
 
+  {%- macro _content_column_contents(title, items) -%}
+    {{ basic_section_title(title) }}
+    {{ vf_basic_section_blocks(items=items) }}
+  {%- endmacro -%}
+
+<section class="{{ padding_classes }}{%- if 'class' in attrs %} {{ attrs['class'] }}{%- endif -%}"
+  {%- for attr, value in attrs.items() -%}
+    {%- if attr != 'class' %} {{ attr }}="{{ value }}"{%- endif -%}
+  {%- endfor -%}
+>
+  <div class="grid-row--50-50-on-large">
+    {{ vf_section_top_rule(top_rule_variant) }}
+    {%- if not is_flipped -%}
+      <div class="grid-col">{{ _content_column_contents(title, filtered_items) }}</div>
+      <div class="grid-col">{{ _media_column_contents(media_type, media_ratio_large, media_ratio_medium_small, media_fit, media_attrs, is_auto_height) }}</div>
+    {%- else -%}
+      <div class="grid-col">{{ _media_column_contents(media_type, media_ratio_large, media_ratio_medium_small, media_fit, media_attrs, is_auto_height) }}</div>
+      <div class="grid-col">{{ _content_column_contents(title, filtered_items) }}</div>
+    {%- endif -%}
+  </div>
+</section>
 {%- endmacro %}

package/templates/_macros/vf_tiered-list.jinja

@@ -4,16 +4,20 @@
 # is_list_full_width_on_tablet: whether list title/description each have their
 #   own row on tablet vs. 50/50 split between title/description
 # padding: Type of padding to apply. Options are "deep", "shallow", "default". Default is "default".
+# top_rule_variant: Variant of the horizontal rule rendered at the top of the pattern.
+#   Options are "default", "muted", "highlighted", "none". Default is "default".
 # Slots
 # title: top-level title element
 # description: top-level description element
 # list_item_title_[1-25]: title element of each child list item
 # list_item_description_[1-25]: description element of each child list item
 # cta: CTA block element
+{% from "_macros/shared/vf_section_top_rule.jinja" import vf_section_top_rule %}
 {% macro vf_tiered_list(
   padding="default",
   is_description_full_width_on_desktop=true,
-  is_list_full_width_on_tablet=true) -%}
+  is_list_full_width_on_tablet=true,
+  top_rule_variant="default") -%}
   {%- set title_content = caller('title') -%}
   {%- set description_content = caller('description') -%}
   {%- set has_description = description_content|trim|length > 0 -%}
@@ -30,7 +34,7 @@
   {%- endif -%}
 
   <div class="{{ padding_classes }} u-fixed-width">
-    <hr class="p-rule">
+    {{ vf_section_top_rule(top_rule_variant) }}
     <div class="p-section--shallow">
       {% if has_description == true -%}
         {%- if is_description_full_width_on_desktop == true -%}

package/templates/static/js/example.js

@@ -67,7 +67,7 @@
       // if it's a demo, use local build.css for better QA, otherwise use latest published Vanilla
       /demos\.haus$/.test(window.location.host)
         ? `${window.location.origin}/static/build/css/build.css`
-        : 'https://assets.ubuntu.com/v1/vanilla_framework_version_' + VANILLA_VERSION.replaceAll('.', '_') + '_min.css',
+        : 'https://assets.ubuntu.com/v1/vanilla_framework_version_' + VANILLA_VERSION + '.min.css',
       // link to example stylesheet (to set margin on body)
       'https://assets.ubuntu.com/v1/4653d9ba-example.css',
     ],