@sc-360-v2/storefront-cms-library 0.5.65 → 0.5.67

package/dist/filters.scss

@@ -2675,7 +2675,7 @@ $resizeActive: '[data-cms-element-resizer="true"]';
         border-radius: 10px;
         //   padding: 20px;
         width: 100%;
-        max-width: 300px;
+        // max-width: 300px;
         padding-inline: 8px;
         // margin: auto;
       }

package/dist/map.scss

@@ -128,6 +128,18 @@ $data: (
   )
 );
 
+// Tooltip Design > Horizontal Alignment, translated for `text-align`. The control is
+// picked from the shared alignment list (flex-start | center | flex-end), and those
+// keywords mean nothing to text-align, so the two ends have to be mapped. The last two
+// entries are the pre-list values, still stored on pages saved before that fix.
+$tooltipTextAlign: (
+  "flex-start": left,
+  "center": center,
+  "flex-end": right,
+  "left": left,
+  "right": right,
+);
+
 [data-div-type="element"] {
   &[data-element-type="map"] {
     // Half the pin as it actually renders, and the gap the tooltip keeps from the
@@ -266,6 +278,26 @@ $data: (
           var(--_ctm-dn-tp-dn-sw-cr);
       }
     }
+
+    // Tooltip Design > Horizontal Alignment, applied to the tooltip text itself.
+    //
+    // .text_box re-applies the control as align-items further down, which moves the
+    // title and the description only while they are narrower than the tooltip. A title
+    // long enough to wrap fills that wrapper, and a flex container cannot move a child
+    // that is already full width — which is why the control looked dead on the title
+    // while the shorter description still followed it.
+    //
+    // The value reaches the DOM as a data attribute because align-items keywords are
+    // not text-align keywords; Map Widget Layout's alignment takes the same route to
+    // .gallery-header above. The tooltip-level control wins over the per-text Alignment
+    // in Tooltip Text Design — it is the one that positions the text block.
+    @each $key, $align in $tooltipTextAlign {
+      &[data-tooltip-text-alignment="#{$key}"] {
+        .map-element .hotspot__tooltip .text_box > * {
+          text-align: $align;
+        }
+      }
+    }
     &[data-hotspot-tooltip-image-style-show-border="true"] {
       .tooltip__image {
         border-style: var(--_ctm-dn-tp-ie-dn-br-se);
@@ -388,6 +420,13 @@ $data: (
         // Text Container Width. 100% is the previous behaviour, so an unset width
         // still spans the container.
         width: prepareMediaVariable(--_ctm-dn-mp-wt-lt-tt-cr-wh, 100%);
+        // ...but never wider than the widget. The control accepts a percentage of the
+        // widget and a raw length, and either can be dialled past the widget's own
+        // width — a percentage over 100, or a length longer than the widget. Both used
+        // to push the header (and the text painted on it) out over whatever sits to the
+        // right of the map. Clamping here rather than only capping the control also
+        // covers pages already saved with an oversized width.
+        max-width: 100%;
         // Lets it shrink to that width beside the map — a flex item defaults to
         // min-width:auto and refuses to go below its longest word.
         min-width: 0;
@@ -505,10 +544,7 @@ $data: (
           );
           word-wrap: var(
             --_ctm-mob-dn-mp-wt-wd-wp-dc,
-            var(
-              --_ctm-tab-dn-mp-wt-wd-wp-dc,
-              var(--_ctm-dn-mp-wt-wd-wp-dc, break-word)
-            )
+            var(--_ctm-tab-dn-mp-wt-wd-wp-dc, var(--_ctm-dn-mp-wt-wd-wp-dc, break-word))
           );
           word-break: var(
             --_ctm-mob-dn-mp-wt-wd-bk-dc,
@@ -800,6 +836,24 @@ $data: (
           max-width: 100%;
           width: 100%;
           height: 100%;
+          // This wrapper fills the tooltip on both axes, so the justify-content /
+          // align-items set on .hotspot__tooltip above have nothing left to move —
+          // that is why both alignment controls looked dead. Same trap the image
+          // hotspot hit with .tooltip__image_with_text (hotspot.scss): the alignment
+          // has to be re-applied on the box that actually holds the title and the
+          // description. The stack is a column here, so the *vertical* control drives
+          // justify-content and the *horizontal* one drives align-items — the opposite
+          // mapping to the tooltip itself.
+          display: flex;
+          flex-direction: column;
+          justify-content: prepareMediaVariable(--_ctm-dn-tp-dn-vl-at);
+          align-items: prepareMediaVariable(--_ctm-dn-tp-dn-hl-at);
+
+          // align-items shrinks each child to its content width, so the text still
+          // needs a cap to wrap against instead of overflowing the tooltip.
+          > * {
+            max-width: 100%;
+          }
 
           h6 {
             font-size: prepareMediaVariable(--_ctm-dn-tp-tt-dn-ft-se);
@@ -980,8 +1034,8 @@ $data: (
       //             --_ctm-mob-dn-pn-se-in-c1,
       //             var(--_ctm-tab-dn-pn-se-in-c1, var(--_ctm-dn-pn-se-in-c1))
       //           );
-  // Overrides the stroke-width presentation attribute baked into the icon markup.
-  stroke-width: prepareMediaVariable(--_ctm-dn-pn-se-se-wh, 1.25);
+      // Overrides the stroke-width presentation attribute baked into the icon markup.
+      stroke-width: prepareMediaVariable(--_ctm-dn-pn-se-se-wh, 1.25);
       //           fill: var(
       //             --_ctm-mob-dn-pn-se-in-c1,
       //             var(--_ctm-tab-dn-pn-se-in-c1, var(--_ctm-dn-pn-se-in-c1))
@@ -1089,8 +1143,8 @@ $data: (
       //             --_ctm-mob-dn-pn-se-in-c1,
       //             var(--_ctm-tab-dn-pn-se-in-c1, var(--_ctm-dn-pn-se-in-c1))
       //           );
-  // Overrides the stroke-width presentation attribute baked into the icon markup.
-  stroke-width: prepareMediaVariable(--_ctm-dn-pn-se-se-wh, 1.25);
+      // Overrides the stroke-width presentation attribute baked into the icon markup.
+      stroke-width: prepareMediaVariable(--_ctm-dn-pn-se-se-wh, 1.25);
       //         }
       //       }
       //     }

package/dist/product-options.scss

@@ -11,6 +11,18 @@
   @return prepareMediaVariable($newVar, prepareMediaVariable($legacyVar));
 }
 
+// The value text's typography is not state-aware — the Option Value Text Style panel has
+// no Default / Hover / Selected picker — so its keys sit flat on optionValueTextStyle
+// rather than under defaultState. Three shapes can be on disk, so resolve in order: the
+// flat variable, then the defaultState-nested one saved while the section still had the
+// picker, then the pre-split optionValueStyle.defaultState one.
+@function optionValueTextDefaultVar($flatVar, $stateVar, $legacyVar) {
+  @return prepareMediaVariable(
+    $flatVar,
+    prepareMediaVariable($stateVar, prepareMediaVariable($legacyVar))
+  );
+}
+
 [data-div-type="element"] {
   &[data-element-type="productOptions"] {
     width: var(
@@ -558,46 +570,83 @@
         .option__value__text {
           color: var(
             --_sf-hr-cr,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-cr, --_ctm-dn-on-ve-se-dt-se-cr)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-cr,
+                --_ctm-dn-on-ve-tt-se-dt-se-cr,
+                --_ctm-dn-on-ve-se-dt-se-cr
+              )}
           );
           font-family: var(
             --_sf-hr-ft-fy,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-fy, --_ctm-dn-on-ve-se-dt-se-ft-fy)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-ft-fy,
+                --_ctm-dn-on-ve-tt-se-dt-se-ft-fy,
+                --_ctm-dn-on-ve-se-dt-se-ft-fy
+              )}
           );
           text-transform: var(
             --_sf-hr-tt-tm,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-tt-tm, --_ctm-dn-on-ve-se-dt-se-tt-tm)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-tt-tm,
+                --_ctm-dn-on-ve-tt-se-dt-se-tt-tm,
+                --_ctm-dn-on-ve-se-dt-se-tt-tm
+              )}
           );
           word-wrap: var(
             --_sf-hr-wd-wp,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-wd-wp, --_ctm-dn-on-ve-se-dt-se-wd-wp)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-wd-wp,
+                --_ctm-dn-on-ve-tt-se-dt-se-wd-wp,
+                --_ctm-dn-on-ve-se-dt-se-wd-wp
+              )}
           );
           word-break: var(
             --_sf-hr-wd-bk,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-wd-bk, --_ctm-dn-on-ve-se-dt-se-wd-bk)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-wd-bk,
+                --_ctm-dn-on-ve-tt-se-dt-se-wd-bk,
+                --_ctm-dn-on-ve-se-dt-se-wd-bk
+              )}
           );
           font-size: var(
             --_sf-hr-ft-se,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-se, --_ctm-dn-on-ve-se-dt-se-ft-se)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-ft-se,
+                --_ctm-dn-on-ve-tt-se-dt-se-ft-se,
+                --_ctm-dn-on-ve-se-dt-se-ft-se
+              )}
           );
           font-weight: var(
             --_sf-hr-ft-wt,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-wt, --_ctm-dn-on-ve-se-dt-se-ft-wt)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-ft-wt,
+                --_ctm-dn-on-ve-tt-se-dt-se-ft-wt,
+                --_ctm-dn-on-ve-se-dt-se-ft-wt
+              )}
           );
           font-style: var(
             --_sf-hr-ft-se-ic,
-            #{optionValueTextVar(
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-ft-se-ic,
                 --_ctm-dn-on-ve-tt-se-dt-se-ft-se-ic,
                 --_ctm-dn-on-ve-se-dt-se-ft-se-ic
               )}
           );
           text-align: var(
             --_sf-hr-tt-an,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-tt-an, --_ctm-dn-on-ve-se-dt-se-tt-an)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-tt-an,
+                --_ctm-dn-on-ve-tt-se-dt-se-tt-an,
+                --_ctm-dn-on-ve-se-dt-se-tt-an
+              )}
           );
           letter-spacing: var(
             --_sf-hr-lr-sg,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-lr-sg, --_ctm-dn-on-ve-se-dt-se-lr-sg)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-lr-sg,
+                --_ctm-dn-on-ve-tt-se-dt-se-lr-sg,
+                --_ctm-dn-on-ve-se-dt-se-lr-sg
+              )}
           );
           // The pre-split key is `le-ht-dc`; the new section is read under both spellings
           // so whichever one the converter writes resolves.
@@ -605,7 +654,8 @@
             --_sf-hr-le-ht,
             prepareMediaVariable(
               --_ctm-dn-on-ve-tt-se-dt-se-le-ht,
-              #{optionValueTextVar(
+              #{optionValueTextDefaultVar(
+                  --_ctm-dn-on-ve-tt-se-le-ht-dc,
                   --_ctm-dn-on-ve-tt-se-dt-se-le-ht-dc,
                   --_ctm-dn-on-ve-se-dt-se-le-ht-dc
                 )}
@@ -613,7 +663,11 @@
           );
           text-decoration: var(
             --_sf-hr-ue,
-            #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ue, --_ctm-dn-on-ve-se-dt-se-ue)}
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-ue,
+                --_ctm-dn-on-ve-tt-se-dt-se-ue,
+                --_ctm-dn-on-ve-se-dt-se-ue
+              )}
           );
           // The swatch item is a fixed box (Swatch Item Size), so a value like "Small"
           // broke onto a second line inside it. Keep it on one line.
@@ -677,46 +731,83 @@
       .option__value__text {
         color: var(
           --_sf-hr-cr,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-cr, --_ctm-dn-on-ve-se-dt-se-cr)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-cr,
+              --_ctm-dn-on-ve-tt-se-dt-se-cr,
+              --_ctm-dn-on-ve-se-dt-se-cr
+            )}
         );
         font-family: var(
           --_sf-hr-ft-fy,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-fy, --_ctm-dn-on-ve-se-dt-se-ft-fy)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-ft-fy,
+              --_ctm-dn-on-ve-tt-se-dt-se-ft-fy,
+              --_ctm-dn-on-ve-se-dt-se-ft-fy
+            )}
         );
         text-transform: var(
           --_sf-hr-tt-tm,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-tt-tm, --_ctm-dn-on-ve-se-dt-se-tt-tm)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-tt-tm,
+              --_ctm-dn-on-ve-tt-se-dt-se-tt-tm,
+              --_ctm-dn-on-ve-se-dt-se-tt-tm
+            )}
         );
         word-wrap: var(
           --_sf-hr-wd-wp,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-wd-wp, --_ctm-dn-on-ve-se-dt-se-wd-wp)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-wd-wp,
+              --_ctm-dn-on-ve-tt-se-dt-se-wd-wp,
+              --_ctm-dn-on-ve-se-dt-se-wd-wp
+            )}
         );
         word-break: var(
           --_sf-hr-wd-bk,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-wd-bk, --_ctm-dn-on-ve-se-dt-se-wd-bk)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-wd-bk,
+              --_ctm-dn-on-ve-tt-se-dt-se-wd-bk,
+              --_ctm-dn-on-ve-se-dt-se-wd-bk
+            )}
         );
         font-size: var(
           --_sf-hr-ft-se,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-se, --_ctm-dn-on-ve-se-dt-se-ft-se)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-ft-se,
+              --_ctm-dn-on-ve-tt-se-dt-se-ft-se,
+              --_ctm-dn-on-ve-se-dt-se-ft-se
+            )}
         );
         font-weight: var(
           --_sf-hr-ft-wt,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ft-wt, --_ctm-dn-on-ve-se-dt-se-ft-wt)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-ft-wt,
+              --_ctm-dn-on-ve-tt-se-dt-se-ft-wt,
+              --_ctm-dn-on-ve-se-dt-se-ft-wt
+            )}
         );
         font-style: var(
           --_sf-hr-ft-se-ic,
-          #{optionValueTextVar(
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-ft-se-ic,
               --_ctm-dn-on-ve-tt-se-dt-se-ft-se-ic,
               --_ctm-dn-on-ve-se-dt-se-ft-se-ic
             )}
         );
         text-align: var(
           --_sf-hr-tt-an,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-tt-an, --_ctm-dn-on-ve-se-dt-se-tt-an)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-tt-an,
+              --_ctm-dn-on-ve-tt-se-dt-se-tt-an,
+              --_ctm-dn-on-ve-se-dt-se-tt-an
+            )}
         );
         letter-spacing: var(
           --_sf-hr-lr-sg,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-lr-sg, --_ctm-dn-on-ve-se-dt-se-lr-sg)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-lr-sg,
+              --_ctm-dn-on-ve-tt-se-dt-se-lr-sg,
+              --_ctm-dn-on-ve-se-dt-se-lr-sg
+            )}
         );
         // The pre-split key is `le-ht-dc`; the new section is read under both spellings
         // so whichever one the converter writes resolves.
@@ -724,7 +815,8 @@
           --_sf-hr-le-ht,
           prepareMediaVariable(
             --_ctm-dn-on-ve-tt-se-dt-se-le-ht,
-            #{optionValueTextVar(
+            #{optionValueTextDefaultVar(
+                --_ctm-dn-on-ve-tt-se-le-ht-dc,
                 --_ctm-dn-on-ve-tt-se-dt-se-le-ht-dc,
                 --_ctm-dn-on-ve-se-dt-se-le-ht-dc
               )}
@@ -732,7 +824,11 @@
         );
         text-decoration: var(
           --_sf-hr-ue,
-          #{optionValueTextVar(--_ctm-dn-on-ve-tt-se-dt-se-ue, --_ctm-dn-on-ve-se-dt-se-ue)}
+          #{optionValueTextDefaultVar(
+              --_ctm-dn-on-ve-tt-se-ue,
+              --_ctm-dn-on-ve-tt-se-dt-se-ue,
+              --_ctm-dn-on-ve-se-dt-se-ue
+            )}
         );
         // The swatch item is a fixed box (Swatch Item Size), so a value like "Small"
         // broke onto a second line inside it. Keep it on one line.

package/dist/search-results-heading.scss

@@ -83,10 +83,6 @@
             --_ctm-mob-dn-sh-rs-nr-ue,
             var(--_ctm-tab-dn-sh-rs-nr-ue, var(--_ctm-dn-sh-rs-nr-ue))
           );
-          border: var(
-            --_ctm-mob-dn-sh-rs-nr-bd-cr,
-            var(--_ctm-tab-dn-sh-rs-nr-bd-cr, var(--_ctm-dn-sh-rs-nr-bd-cr))
-          );
           border-color: var(
             --_ctm-mob-dn-sh-rs-nr-br-cr,
             var(--_ctm-tab-dn-sh-rs-nr-br-cr, var(--_ctm-dn-sh-rs-nr-br-cr))
@@ -304,12 +300,10 @@
       }
     }
 
-    &[data-widget-shadow="false"] {
-      --_show-shadow: none;
-    }
-
-    &[data-show-shadow="false"] {
-      --_show-shadow: none;
+    .search__results__count[data-show-shadow="false"],
+    .search__other__text[data-show-shadow="false"],
+    .search__keyword__text[data-show-shadow="false"] {
+      --_show-text-content-shadow: none;
     }
   }
 }

package/dist/sort.scss

@@ -1,89 +1,176 @@
-@use "sass:map";
-@use "sass:list";
-
-$resizerId: "[data-cms-tool='cms-element-resizer']";
-$resizeActive: '[data-cms-element-resizer="true"]';
-[data-div-type="element"] {
-  &[data-element-type="sort"] {
-    width: var(
-      --_sf-el-wh-st-mx,
-      calc(
-        1% *
-          var(
-            --_ctm-mob-ele-nw-wh-vl,
-            var(--_ctm-tab-ele-nw-wh-vl, var(--_ctm-ele-nw-wh-vl, var(--_sf-nw-wh)))
-          )
-      )
-    );
-    margin: var(--_ctm-mob-lt-mn, var(--_ctm-tab-lt-mn, var(--_ctm-lt-mn)));
-
-    & > div {
-      &.wrapper {
-        width: 100%;
-      }
-    }
-    //Dropdown
-    .est__dropdown__main {
-      position: relative;
-      width: 100%;
-
-      label {
-        font-size: 14px;
-        color: var(--_gray-700);
-        margin-bottom: 8px;
-        display: block;
-      }
-
-      .est__dropdown {
-        cursor: pointer;
-        position: relative;
-        color: var(--_gray-700);
-
-        border-radius: 6px;
-        background-color: #fff;
-        display: flex;
-        justify-content: space-between;
-        align-items: center;
-        width: 100%;
-        .value__selected {
-          width: 100%;
-        }
-
-        &.open .list {
-          display: flex;
-        }
-
-        .list {
-          display: none;
-          flex-direction: column;
-          border: 1px solid var(--_gray-200);
-          border-radius: 6px;
-          position: absolute;
-          top: 100%;
-          left: 0;
-          width: 100%;
-          background-color: #fff;
-          border-radius: 4px;
-          z-index: var(--_higher-zIndex);
-          max-height: 200px;
-          overflow-y: auto;
-
-          &.top {
-            bottom: 100%;
-            top: auto;
-          }
-
-          .list__option {
-            padding: 12px;
-            cursor: pointer;
-
-            &:hover {
-              background-color: var(--_primary-25);
-              color: var(--_primary-400);
-            }
-          }
-        }
-      }
-    }
-  }
-}
+@use "sass:map";
+@use "sass:list";
+@use "./functions.scss" as *;
+
+$resizerId: "[data-cms-tool='cms-element-resizer']";
+$resizeActive: '[data-cms-element-resizer="true"]';
+[data-div-type="element"] {
+  &[data-element-type="sort"] {
+    width: var(
+      --_sf-el-wh-st-mx,
+      calc(
+        1% *
+          var(
+            --_ctm-mob-ele-nw-wh-vl,
+            var(--_ctm-tab-ele-nw-wh-vl, var(--_ctm-ele-nw-wh-vl, var(--_sf-nw-wh)))
+          )
+      )
+    );
+    margin: var(--_ctm-mob-lt-mn, var(--_ctm-tab-lt-mn, var(--_ctm-lt-mn)));
+
+    // The Design tab's Sort Button toggles. Both are CONTROLS with no CSS property of
+    // their own, so the element publishes them as data attributes and the styling has
+    // to act on them here — an unhandled toggle stores a value that never reaches the
+    // page, which is what the whole Design tab did before these variables were wired.
+    &[data-sort-button-shadow="false"] {
+      --_show-shadow-sort-button: none;
+    }
+    &[data-sort-button-border="false"] {
+      .est__dropdown {
+        border: none;
+      }
+    }
+
+    & > div {
+      &.wrapper {
+        width: 100%;
+      }
+    }
+    //Dropdown
+    .est__dropdown__main {
+      position: relative;
+      width: 100%;
+
+      label {
+        font-size: 14px;
+        color: var(--_gray-700);
+        margin-bottom: 8px;
+        display: block;
+      }
+
+      .est__dropdown {
+        cursor: pointer;
+        position: relative;
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        gap: 8px;
+        width: 100%;
+
+        // Design > Sort Button. `--_ctm-dn-st-bn-*` is what the schema's
+        // design.sortButton scope emits: splitCamelCaseAndJoin("design") -> "dn",
+        // ("sortButton") -> "st-bn". The literals stay as the fallbacks so an element
+        // saved before the Design tab existed keeps the look it had.
+        background-color: prepareMediaVariable(--_ctm-dn-st-bn-bd-cr, #fff);
+        border-color: prepareMediaVariable(--_ctm-dn-st-bn-br-cr, transparent);
+        border-style: prepareMediaVariable(--_ctm-dn-st-bn-br-se, solid);
+        border-width: prepareMediaVariable(--_ctm-dn-st-bn-br-wh, 0);
+        border-radius: prepareMediaVariable(--_ctm-dn-st-bn-br-rs, 6px);
+        box-shadow: var(
+          --_show-shadow-sort-button,
+          prepareMediaVariable(--_ctm-dn-st-bn-sw-ae, 0 0)
+            prepareMediaVariable(--_ctm-dn-st-bn-sw-br, 0)
+            prepareMediaVariable(--_ctm-dn-st-bn-sw-sd, 0)
+            prepareMediaVariable(--_ctm-dn-st-bn-sw-cr, transparent)
+        );
+
+        .value__selected {
+          display: flex;
+          align-items: baseline;
+          gap: 4px;
+          // The title and the value are laid out side by side, so the pair has to be
+          // allowed to shrink — without min-width the flex item keeps its content
+          // width and pushes the chevron out of a narrow element instead of clamping.
+          min-width: 0;
+          flex: 1;
+        }
+
+        // Text Overflow is a CONTROL, not CSS: the element adds this class and
+        // publishes the line count inline, one variable per typography scope.
+        .sort__title.flex__overflow {
+          white-space: normal;
+          @include restrictToLinesShow(#{var(--_sf-line-clamp, 1)});
+        }
+        .selected__option.flex__overflow {
+          white-space: normal;
+          @include restrictToLinesShow(#{var(--_sf-line-clamp-desc, 1)});
+        }
+
+        // Design > Sort Title (design.sortTitle -> "dn-st-te")
+        .sort__title {
+          color: prepareMediaVariable(--_ctm-dn-st-te-cr, var(--_gray-700));
+          font-family: var(--_sf-hr-ff, prepareMediaVariable(--_ctm-dn-st-te-ft-fy, inherit));
+          font-size: prepareMediaVariable(--_ctm-dn-st-te-ft-se, inherit);
+          font-weight: prepareMediaVariable(--_ctm-dn-st-te-ft-wt, inherit);
+          font-style: prepareMediaVariable(--_ctm-dn-st-te-ft-se-ic, normal);
+          text-align: prepareMediaVariable(--_ctm-dn-st-te-tt-an, left);
+          letter-spacing: prepareMediaVariable(--_ctm-dn-st-te-lr-sg, normal);
+          line-height: prepareMediaVariable(--_ctm-dn-st-te-le-ht, normal);
+          text-decoration: prepareMediaVariable(--_ctm-dn-st-te-ue, none);
+        }
+
+        // Design > Selected Option (design.selectedOption -> "dn-sd-on")
+        .selected__option {
+          color: prepareMediaVariable(--_ctm-dn-sd-on-cr, var(--_gray-700));
+          font-family: var(--_sf-hr-ff, prepareMediaVariable(--_ctm-dn-sd-on-ft-fy, inherit));
+          font-size: prepareMediaVariable(--_ctm-dn-sd-on-ft-se, inherit);
+          font-weight: prepareMediaVariable(--_ctm-dn-sd-on-ft-wt, inherit);
+          font-style: prepareMediaVariable(--_ctm-dn-sd-on-ft-se-ic, normal);
+          text-align: prepareMediaVariable(--_ctm-dn-sd-on-tt-an, left);
+          letter-spacing: prepareMediaVariable(--_ctm-dn-sd-on-lr-sg, normal);
+          line-height: prepareMediaVariable(--_ctm-dn-sd-on-le-ht, normal);
+          text-decoration: prepareMediaVariable(--_ctm-dn-sd-on-ue, none);
+        }
+
+        &.open .list {
+          display: flex;
+        }
+
+        .list {
+          display: none;
+          flex-direction: column;
+          border: 1px solid var(--_gray-200);
+          border-radius: 6px;
+          position: absolute;
+          top: 100%;
+          left: 0;
+          width: 100%;
+          background-color: #fff;
+          border-radius: 4px;
+          z-index: var(--_higher-zIndex);
+          max-height: 200px;
+          overflow-y: auto;
+
+          &.top {
+            bottom: 100%;
+            top: auto;
+          }
+
+          .list__option {
+            padding: 12px;
+            cursor: pointer;
+            // The list has no design scope of its own. It borrows the Selected
+            // Option's type so the open list matches the closed control — colour and
+            // alignment are left to the list's own resting/hover rules below, which
+            // are what make an option look clickable.
+            font-family: var(--_sf-hr-ff, prepareMediaVariable(--_ctm-dn-sd-on-ft-fy, inherit));
+            font-size: prepareMediaVariable(--_ctm-dn-sd-on-ft-se, inherit);
+            font-weight: prepareMediaVariable(--_ctm-dn-sd-on-ft-wt, inherit);
+            letter-spacing: prepareMediaVariable(--_ctm-dn-sd-on-lr-sg, normal);
+            color: var(--_gray-700);
+
+            &:hover {
+              background-color: var(--_primary-25);
+              color: var(--_primary-400);
+            }
+
+            &[aria-selected="true"] {
+              background-color: var(--_primary-25);
+              color: var(--_primary-400);
+            }
+          }
+        }
+      }
+    }
+  }
+}