@sc-360-v2/storefront-cms-library 0.5.72 → 0.5.74

package/dist/global-styles.scss

@@ -1,198 +1,202 @@
-@use "sass:map";
-@use "sass:list";
-@use "./functions.scss" as *;
-
-.custom-upload {
-  display: flex;
-  &:has(.preview_image_container) {
-    justify-content: space-between;
-  }
-  align-items: center;
-  border: 1px solid var(--_gray-300);
-  background-color: var(--_base-white);
-  padding: 16px;
-  border-radius: 4px;
-  gap: 12px;
-  .preview_image_container {
-    width: 100%;
-    display: flex;
-    align-items: center;
-    gap: 12px;
-    .image_title {
-      font-size: 14px;
-      margin-top: 3px;
-      .label {
-        color: var(--_thm-cs-at-sy);
-        @include restrictToLinesShow(1);
-      }
-    }
-    .preview_image {
-      height: 36px;
-      width: 36px;
-      border-radius: 50%;
-      padding: 4px;
-      background: var(--_base-white);
-      border: 1px solid var(--_gray-300);
-      img {
-        width: 100%;
-        width: 100%;
-        object-fit: contain;
-      }
-    }
-  }
-  .clear_upload_icon {
-    svg {
-      width: 18px;
-      height: 18px;
-    }
-  }
-  .uploadicon {
-    padding: 8px;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    background: var(--_gray-200);
-    outline: 6px solid var(--_gray-100);
-    border-radius: 50%;
-    height: 36px;
-    width: 36px;
-    .svg_icon {
-      svg {
-        width: 20px;
-        height: 20px;
-        path {
-          stroke: var(--_gray-700);
-        }
-      }
-    }
-  }
-
-  .file_upload_text {
-    display: flex;
-    flex-direction: column;
-    gap: 8px;
-    .label {
-      @include restrictToLinesShow(1);
-    }
-    p {
-      color: var(--_thm-cs-at-py);
-      font-weight: 600;
-    }
-    span {
-      color: var(--_thm-cs-at-sy);
-      font-size: 14px;
-    }
-  }
-}
-
-// Skeleton for the reused ProductOptions swatches (rendered inside the CMS
-// builder/preview, e.g. the Category Groups product cards). Mirrors the website
-// globals so the swatch placeholders keep their spacing here too.
-.product_options_skeleton {
-  width: 100%;
-  .sklts_swatch {
-    display: flex;
-    gap: 8px;
-    margin-bottom: 8px;
-  }
-}
-
-// Skeleton base styles (mirrored from storefront-websites globals so reused
-// element skeletons render identically inside the CMS builder/preview).
-.skeleton {
-  background-color: #e5e7eb !important;
-  border: none !important;
-  min-height: 8px;
-  position: relative;
-  overflow: hidden;
-  display: block;
-
-  &--rectangular {
-    width: 100%;
-    height: 100%;
-  }
-
-  &--circular {
-    border-radius: 50%;
-  }
-
-  &--text {
-    transform-origin: 0 55%;
-    transform: scale(1, 0.6);
-    border-radius: 4px;
-
-    &::before {
-      content: "\00a0";
-    }
-  }
-
-  &--shimmer {
-    &::after {
-      content: "";
-      position: absolute;
-      top: 0;
-      left: 0;
-      right: 0;
-      bottom: 0;
-      background: linear-gradient(
-        90deg,
-        transparent 0%,
-        rgba(255, 255, 255, 0.4) 50%,
-        transparent 100%
-      );
-      animation: skeleton-shimmer 1.5s infinite;
-      transform: translateX(-100%);
-    }
-  }
-
-  &--pulse {
-    animation: skeleton-pulse 1.5s ease-in-out infinite;
-  }
-}
-
-@keyframes skeleton-shimmer {
-  0% {
-    transform: translateX(-100%);
-  }
-  100% {
-    transform: translateX(100%);
-  }
-}
-
-@keyframes skeleton-pulse {
-  0%,
-  100% {
-    opacity: 1;
-  }
-  50% {
-    opacity: 0.5;
-  }
-}
-
-.skeleton__element {
-  @extend .skeleton;
-  @extend .skeleton--shimmer;
-}
-
-// Text Overflow fallback.
-//
-// Text Overflow is a `controls` property, not a CSS one, so it cannot travel to the
-// stylesheet as a variable — the renderer opts a text node in with `.flex__overflow`
-// and carries the line count in `--_sf-line-clamp`.
-//
-// This is the clamp declared once, for every text node whose own block does not set a
-// competing `display`. Blocks that do (a flex label, say) carry their own scoped
-// `&.flex__overflow` rule, since this one is a single class and would lose to them.
-//
-// The class is only ever emitted when the toggle is on, so this cannot clamp a node
-// that was not asked to be clamped.
-//
-// Mirrored in storefront-cms-library/src/components/css/widgets/global-styles.scss —
-// change one, copy it across.
-.flex__overflow {
-  // A clamp can only reach its second line if the text is allowed to wrap, so this
-  // undoes any `white-space: nowrap` the node carries — the same thing the hand-written
-  // clamps in allocations-quota-details.scss and friends do.
-  white-space: normal;
-  @include restrictToLinesShow(#{var(--_sf-line-clamp, 1)});
-}
+@use "sass:map";
+@use "sass:list";
+@use "./functions.scss" as *;
+
+.custom-upload {
+  display: flex;
+  &:has(.preview_image_container) {
+    justify-content: space-between;
+  }
+  align-items: center;
+  border: 1px solid var(--_gray-300);
+  background-color: var(--_base-white);
+  padding: 16px;
+  border-radius: 4px;
+  gap: 12px;
+  .preview_image_container {
+    width: 100%;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    .image_title {
+      font-size: 14px;
+      margin-top: 3px;
+      .label {
+        color: var(--_thm-cs-at-sy);
+        @include restrictToLinesShow(1);
+      }
+    }
+    .preview_image {
+      height: 36px;
+      width: 36px;
+      border-radius: 50%;
+      padding: 4px;
+      background: var(--_base-white);
+      border: 1px solid var(--_gray-300);
+      img {
+        width: 100%;
+        width: 100%;
+        object-fit: contain;
+      }
+    }
+  }
+  .clear_upload_icon {
+    svg {
+      width: 18px;
+      height: 18px;
+    }
+  }
+  .uploadicon {
+    padding: 8px;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    background: var(--_gray-200);
+    outline: 6px solid var(--_gray-100);
+    border-radius: 50%;
+    height: 36px;
+    width: 36px;
+    .svg_icon {
+      svg {
+        width: 20px;
+        height: 20px;
+        path {
+          stroke: var(--_gray-700);
+        }
+      }
+    }
+  }
+
+  .file_upload_text {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    .label {
+      @include restrictToLinesShow(1);
+    }
+    p {
+      color: var(--_thm-cs-at-py);
+      font-weight: 600;
+    }
+    span {
+      color: var(--_thm-cs-at-sy);
+      font-size: 14px;
+    }
+  }
+}
+
+// Skeleton for the reused ProductOptions swatches (rendered inside the CMS
+// builder/preview, e.g. the Category Groups product cards). Mirrors the website
+// globals so the swatch placeholders keep their spacing here too.
+.product_options_skeleton {
+  width: 100%;
+  .sklts_swatch {
+    display: flex;
+    gap: 8px;
+    margin-bottom: 8px;
+  }
+}
+
+// Skeleton base styles (mirrored from storefront-websites globals so reused
+// element skeletons render identically inside the CMS builder/preview).
+.skeleton {
+  background-color: #e5e7eb !important;
+  border: none !important;
+  // One radius for every placeholder, never the element's schema radius — see the
+  // note on `.skeleton` in storefront-websites globals.scss. `!important` beats both
+  // the element classes templates reuse and the Skeleton component's inline `br`.
+  border-radius: 4px !important;
+  min-height: 8px;
+  position: relative;
+  overflow: hidden;
+  display: block;
+
+  &--rectangular {
+    width: 100%;
+    height: 100%;
+  }
+
+  &--circular {
+    // The only exception to 6px; needs `!important` to survive the base rule.
+    border-radius: 50% !important;
+  }
+
+  &--text {
+    transform-origin: 0 55%;
+    transform: scale(1, 0.6);
+
+    &::before {
+      content: "\00a0";
+    }
+  }
+
+  &--shimmer {
+    &::after {
+      content: "";
+      position: absolute;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: linear-gradient(
+        90deg,
+        transparent 0%,
+        rgba(255, 255, 255, 0.4) 50%,
+        transparent 100%
+      );
+      animation: skeleton-shimmer 1.5s infinite;
+      transform: translateX(-100%);
+    }
+  }
+
+  &--pulse {
+    animation: skeleton-pulse 1.5s ease-in-out infinite;
+  }
+}
+
+@keyframes skeleton-shimmer {
+  0% {
+    transform: translateX(-100%);
+  }
+  100% {
+    transform: translateX(100%);
+  }
+}
+
+@keyframes skeleton-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.5;
+  }
+}
+
+.skeleton__element {
+  @extend .skeleton;
+  @extend .skeleton--shimmer;
+}
+
+// Text Overflow fallback.
+//
+// Text Overflow is a `controls` property, not a CSS one, so it cannot travel to the
+// stylesheet as a variable — the renderer opts a text node in with `.flex__overflow`
+// and carries the line count in `--_sf-line-clamp`.
+//
+// This is the clamp declared once, for every text node whose own block does not set a
+// competing `display`. Blocks that do (a flex label, say) carry their own scoped
+// `&.flex__overflow` rule, since this one is a single class and would lose to them.
+//
+// The class is only ever emitted when the toggle is on, so this cannot clamp a node
+// that was not asked to be clamped.
+//
+// Mirrored in storefront-cms-library/src/components/css/widgets/global-styles.scss —
+// change one, copy it across.
+.flex__overflow {
+  // A clamp can only reach its second line if the text is allowed to wrap, so this
+  // undoes any `white-space: nowrap` the node carries — the same thing the hand-written
+  // clamps in allocations-quota-details.scss and friends do.
+  white-space: normal;
+  @include restrictToLinesShow(#{var(--_sf-line-clamp, 1)});
+}

package/dist/option-families.scss

@@ -0,0 +1,252 @@
+@use "./functions.scss" as *;
+
+// Option Families — swatch tiles of option families ("Shop by Color"): every family, the ones
+// picked in Choose Item, or one per row when repeated by a Repeater.
+//
+// Variable names come from the builderData keys in element-edit/optionFamilies.ts:
+//   layout.swatchHeight -> --_ctm-lt-sh-ht
+//   design.tile.*       -> --_ctm-dn-te-*
+//   design.swatch.*     -> --_ctm-dn-sh-*
+//   design.image.*      -> --_ctm-dn-ie-*
+//   design.label.*      -> --_ctm-dn-ll-*
+// Keep this file in step with storefront-cms-library/src/components/css/widgets/option-families.scss.
+
+[data-div-type="element"] {
+  &[data-element-type="optionFamilies"] {
+    // Reads the percentage the left/right resize handles write, same as Quota Details.
+    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)))
+      )
+    );
+    min-width: 64px;
+    margin: prepareMediaVariable(--_ctm-lt-mn, 0);
+
+    & > .wrapper {
+      width: 100%;
+      height: auto;
+    }
+
+    // Connected on its own the element holds every family shown in Choose Item, one tile each,
+    // side by side in a single row that shares the element's width. Inside a Repeater it holds one.
+    .option__families__list {
+      display: flex;
+      flex-wrap: nowrap;
+      gap: 12px;
+      width: 100%;
+
+      & > * {
+        flex: 1 1 0;
+        min-width: 0;
+      }
+    }
+
+    .option__families__tile {
+      display: flex;
+      flex-direction: column;
+      gap: prepareMediaVariable(--_ctm-dn-te-im-gp);
+      width: 100%;
+      box-sizing: border-box;
+      padding: prepareMediaVariable(--_ctm-lt-pg, 8px);
+      color: inherit;
+      text-decoration: none;
+      background-color: prepareMediaVariable(--_ctm-dn-te-bd-cr, #ffffff);
+      border-color: prepareMediaVariable(--_ctm-dn-te-br-cr, #eaecf0);
+      border-style: prepareMediaVariable(--_ctm-dn-te-br-se, solid);
+      border-width: prepareMediaVariable(--_ctm-dn-te-br-wh, 1px);
+      border-radius: prepareMediaVariable(--_ctm-dn-te-br-rs, 6px);
+      box-shadow: var(
+        --_sf-of-te-show-shadow,
+        prepareMediaVariable(--_ctm-dn-te-sw-ae, 0px 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-br, 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-sd, 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-cr, transparent)
+      );
+      transition: transform 0.15s ease;
+
+      &[data-has-link="true"] {
+        cursor: pointer;
+
+        // &:hover {
+        //   transform: translateY(-2px);
+        // }
+      }
+    }
+
+    &[data-tile-shadow="false"] .option__families__tile {
+      --_sf-of-te-show-shadow: none;
+    }
+
+    .option__families__swatch {
+      position: relative;
+      display: flex;
+      align-items: flex-end;
+      justify-content: center;
+      overflow: hidden;
+      width: 100%;
+      height: prepareMediaVariable(--_ctm-lt-sh-ht, 88px);
+      box-sizing: border-box;
+      // `--_sf-of-swatch` is the row's hex colour, set on the element by the renderer.
+      background-color: var(--_sf-of-swatch, #d0d5dd);
+      border-color: prepareMediaVariable(--_ctm-dn-sh-br-cr, #eaecf0);
+      border-style: prepareMediaVariable(--_ctm-dn-sh-br-se, solid);
+      border-width: prepareMediaVariable(--_ctm-dn-sh-br-wh, 0px);
+      border-radius: prepareMediaVariable(--_ctm-dn-sh-br-rs, 4px);
+      box-shadow: var(
+        --_sf-of-sh-show-shadow,
+        prepareMediaVariable(--_ctm-dn-sh-sw-ae, 0px 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-br, 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-sd, 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-cr, transparent)
+      );
+
+      // Measured by SwatchImage (OptionFamilies.tsx) for the size it asks the CDN for.
+      .option__families__image-frame {
+        position: absolute;
+        inset: 0;
+      }
+
+      .option__families__image {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+        box-sizing: border-box;
+        object-fit: cover;
+        object-position: center;
+        background-color: prepareMediaVariable(--_ctm-dn-ie-bd-cr, transparent);
+        border-color: prepareMediaVariable(--_ctm-dn-ie-br-cr, #eaecf0);
+        border-style: prepareMediaVariable(--_ctm-dn-ie-br-se, solid);
+        border-width: prepareMediaVariable(--_ctm-dn-ie-br-wh, 0px);
+        border-radius: prepareMediaVariable(--_ctm-dn-ie-br-rs, 0px);
+        transition: transform 0.3s ease-in-out;
+        // Fit Options and Image Position are applied by the image CDN (scale.option /
+        // canvas.position in the request URL, see OptionFamilies.tsx), which returns an
+        // image of exactly the swatch's size — so nothing to fit here.
+      }
+
+      .option__families__label {
+        position: relative;
+        z-index: 2;
+        padding: 0 6px 8px;
+      }
+    }
+
+    // Layout > Image Settings > On Hover. The swatch clips it (overflow: hidden), so the
+    // zoom stays inside the tile. Zoom Out is a visible 0.92 — the Image element's 0.9998
+    // is too small to see on a swatch this size.
+    .option__families__tile:hover .option__families__image {
+      &[data-on-hover="Zoom In"] {
+        transform: scale(1.08);
+      }
+      &[data-on-hover="Zoom Out"] {
+        transform: scale(0.92);
+      }
+    }
+
+    // Layout > Swatch Shape. Rectangle is the default above: a full-width tile and swatch, with
+    // the Border Radius set in Design for each. Square and Circle make the swatch Swatch Height on
+    // each side and shrink the tile around it, so every border — tile, swatch and image — takes
+    // the shape: square corners for Square, round for Circle. There the shape decides the corners
+    // and the Design > Border Radius controls do not apply.
+    &[data-swatch-shape="square"],
+    &[data-swatch-shape="circle"] {
+      .option__families__tile {
+        flex: 0 1 auto;
+        width: fit-content;
+        max-width: 100%;
+        margin-inline: auto;
+      }
+
+      .option__families__swatch {
+        width: prepareMediaVariable(--_ctm-lt-sh-ht, 88px);
+        max-width: 100%;
+        align-self: center;
+      }
+    }
+
+    // &[data-swatch-shape="square"] {
+    //   .option__families__tile,
+    //   .option__families__swatch,
+    //   .option__families__image {
+    //     border-radius: 0;
+    //   }
+    // }
+
+    &[data-swatch-shape="circle"] {
+      // The swatch and its image are square boxes, so 50% makes them round.
+      .option__families__swatch,
+      .option__families__image {
+        border-radius: 50%;
+      }
+
+      // With the name inside the swatch the tile is square too (swatch plus even padding) and
+      // 50% draws a circle. A name below makes it taller than wide, where 50% would draw an
+      // oval, so it becomes a pill instead.
+      &[data-label-position="inside"] .option__families__tile {
+        border-radius: 50%;
+      }
+      &[data-label-position="below"] .option__families__tile {
+        border-radius: 9999px;
+      }
+    }
+
+    &[data-swatch-shadow="false"] .option__families__swatch {
+      --_sf-of-sh-show-shadow: none;
+    }
+
+    .option__families__label {
+      display: block;
+      min-width: 0;
+      overflow-wrap: anywhere;
+      color: prepareMediaVariable(--_ctm-dn-ll-cr, #ffffff);
+      font-family: prepareMediaVariable(--_ctm-dn-ll-ft-fy);
+      font-size: prepareMediaVariable(--_ctm-dn-ll-ft-se, 14px);
+      font-weight: prepareMediaVariable(--_ctm-dn-ll-ft-wt, bold);
+      font-style: prepareMediaVariable(--_ctm-dn-ll-ft-se-ic);
+      text-align: prepareMediaVariable(--_ctm-dn-ll-tt-an, center);
+      letter-spacing: prepareMediaVariable(--_ctm-dn-ll-lr-sg);
+      line-height: prepareMediaVariable(--_ctm-dn-ll-le-ht);
+      text-decoration: prepareMediaVariable(--_ctm-dn-ll-ue);
+      text-transform: prepareMediaVariable(--_ctm-dn-ll-tt-tm, uppercase);
+      box-sizing: border-box;
+      max-width: 100%;
+
+      // Design > Label > Typography > Text Overflow: N lines, then an ellipsis. `--_sf-line-clamp`
+      // is set on the label by the renderer. `overflow-wrap: anywhere` above would break a long
+      // word across lines before the ellipsis could apply, so the clamp restores normal wrapping.
+      &.flex__overflow {
+        @include restrictToLinesShow(#{var(--_sf-line-clamp, 1)});
+        overflow-wrap: normal;
+        word-break: normal;
+      }
+    }
+
+    // A Square or Circle tile is only as wide as its content. A label below the swatch would
+    // widen it to fit the whole name, leaving nothing to clamp; this makes the label take the
+    // tile's width (set by the swatch) without adding to it.
+    &[data-swatch-shape="square"],
+    &[data-swatch-shape="circle"] {
+      &[data-label-position="below"] .option__families__tile > .option__families__label {
+        width: 0;
+        min-width: 100%;
+      }
+    }
+
+    // Light swatches get a faint inner edge so they don't melt into a white tile. An
+    // outline, not the border: the border width holds four values and is the merchant's.
+    .option__families__swatch[data-light="true"] {
+      outline: 1px solid rgba(16, 24, 40, 0.12);
+      outline-offset: -1px;
+    }
+
+    // A white label disappears on white/cream swatches. Only while the label sits inside
+    // the swatch — below it, the label is on the tile and keeps its own colour.
+    &[data-label-position="inside"]
+      .option__families__swatch[data-light="true"]
+      .option__families__label {
+      color: #344054;
+    }
+  }
+}