@depict-ai/react-ui 2.0.9 → 2.0.11

package/dist/styles/components/PLP/Buttons.scss

@@ -2,39 +2,76 @@
 @use "../../helpers/supports-hover";
 @use "../../helpers/utils";
 @use "sass:color";
+@use "sass:map";
 
-$primary-button-background: variables.$brand-black;
-$primary-button-color: #fff;
-$primary-button-border: 1px solid transparent; // so that the page doesn't jump when there's half a border when switching between having sort and filters open (the buttons switch between pimary and secondary)
-$primary-button-border-radius: variables.$border-radius;
-$primary-button-hover-filter: drop-shadow(-2px -2px 4px rgba(255, 255, 255, 0.25))
-  drop-shadow(2px 2px 4px rgba(0, 0, 0, 0.15));
-$primary-button-active-filter: drop-shadow(2px 2px 4px rgba(255, 255, 255, 0.25))
-  drop-shadow(-2px -2px 4px rgba(0, 0, 0, 0.15));
-$primary-button-focus-visible-filter: drop-shadow(2px 2px 4px rgba(65, 143, 195, 0.8))
-  drop-shadow(-2px -2px 4px rgba(65, 143, 195, 0.8));
+$primary-button-overrides: ();
+$secondary-button-overrides: ();
 
-$secondary-button-background: variables.$brand-lightest-grey;
-$secondary-button-color: variables.$brand-dark-grey;
-$secondary-button-border: 1px solid variables.$brand-black;
-$secondary-button-border-radius: variables.$border-radius;
-$secondary-button-hover-filter: drop-shadow(-2px -2px 4px rgba(255, 255, 255, 0.25))
-  drop-shadow(2px 2px 4px rgba(0, 0, 0, 0.15));
-$secondary-button-active-filter: drop-shadow(2px 2px 4px rgba(255, 255, 255, 0.25))
-  drop-shadow(-2px -2px 4px rgba(0, 0, 0, 0.15));
-$secondary-button-focus-visible-filter: drop-shadow(-2px -2px 4px rgba(65, 143, 195, 0.8))
-  drop-shadow(2px 2px 4px rgba(65, 143, 195, 0.8));
+/// Used to get the current properties of the primary button. (`Buttons.$primary-button-overrides` merged into the default properties.) This is so that parts of the button styling can be re-used in other mixins in the state they were in as the mixins get called.
+/// @example
+///  filter: map.get(Buttons.get-primary-button-properties(), "focus-visible-filter");
+@function get-primary-button-properties() {
+  $primary-button-properties: (
+    "background": variables.$brand-black,
+    "color": #fff,
+    // so that the page doesn't jump when there's half a border when switching between having sort and filters open (the buttons switch between pimary and secondary)
+    "border": 1px solid transparent,
+    "border-radius": variables.$border-radius,
+    "hover-filter": drop-shadow(-2px -2px 4px rgba(255, 255, 255, 0.25)) drop-shadow(2px 2px 4px rgba(0, 0, 0, 0.15)),
+    "active-filter": drop-shadow(2px 2px 4px rgba(255, 255, 255, 0.25)) drop-shadow(-2px -2px 4px rgba(0, 0, 0, 0.15)),
+    "focus-visible-filter": drop-shadow(2px 2px 4px rgba(65, 143, 195, 0.8))
+      drop-shadow(-2px -2px 4px rgba(65, 143, 195, 0.8)),
+  );
+  @return map.merge($primary-button-properties, $primary-button-overrides);
+}
+
+/// Used to get the current properties of the secondary button. (`Buttons.$secondary-button-overrides` merged into the default properties.) This is so that parts of the button styling can be re-used in other mixins in the state they were in as the mixins get called.
+/// @example
+///  filter: map.get(Buttons.get-secondary-button-properties(), "focus-visible-filter");
+@function get-secondary-button-properties() {
+  $secondary-button-properties: (
+    "background": variables.$brand-lightest-grey,
+    "color": variables.$brand-dark-grey,
+    "border": 1px solid variables.$brand-black,
+    "border-radius": variables.$border-radius,
+    "hover-filter": drop-shadow(-2px -2px 4px rgba(255, 255, 255, 0.25)) drop-shadow(2px 2px 4px rgba(0, 0, 0, 0.15)),
+    "active-filter": drop-shadow(2px 2px 4px rgba(255, 255, 255, 0.25)) drop-shadow(-2px -2px 4px rgba(0, 0, 0, 0.15)),
+    "focus-visible-filter": drop-shadow(-2px -2px 4px rgba(65, 143, 195, 0.8))
+      drop-shadow(2px 2px 4px rgba(65, 143, 195, 0.8)),
+  );
+  @return map.merge($secondary-button-properties, $secondary-button-overrides);
+}
+
+/// Generates styling for our primary buttons, including hover, active and focus-visible states
+///
+/// *Please only provide options to this mixin if you want to create styling for just a specific button.*
+///
+/// This mixin and the SecondaryButton mixin are currently specialties in how they get customised using maps. Everything that isn't customised using maps is subject to change in the future.
+////
+/// *For generally changing how the buttons look, override the $primary-button-overrides map with a custom map containing the properties you want to change.*
+/// See the example below.
+/// @example
+///   // To override styling (see explanation in description)
+///   Buttons.$primary-button-overrides: ("background": #3f322a, "color": rgb(240,240,240));
+/// @param {Color} $background [map.get(get-primary-button-properties(), "background")] - The background color of the button. From this color other button states will be automatically inferred by lightening or darkening it.
+///
+/// @param {Color} $color [map.get(get-primary-button-properties(), "color")] - The color of the button text
+/// @param {Border} $border [map.get(get-primary-button-properties(), "border")] - The button border
+/// @param {Number with unit} $border-radius [map.get(get-primary-button-properties(), "border-radius")] - The button border radius
+/// @param {Filter} $hover-filter [map.get(get-primary-button-properties(), "hover-filter")] - The filter to apply on hover
+/// @param {Filter} $active-filter [map.get(get-primary-button-properties(), "active-filter")] - The filter to apply on active
+/// @param {Filter} $focus-visible-filter [map.get(get-primary-button-properties(), "focus-visible-filter")] - The filter to apply on focus-visible (when the button is focused using keyboard navigation)
 
 @mixin PrimaryButton(
-  $background: $primary-button-background,
-  $color: $primary-button-color,
-  $border: $primary-button-border,
-  $border-radius: $primary-button-border-radius,
-  $hover-filter: $primary-button-hover-filter,
-  $active-filter: $primary-button-active-filter,
-  $focus-visible-filter: $primary-button-focus-visible-filter
+  $background: map.get(get-primary-button-properties(), "background"),
+  $color: map.get(get-primary-button-properties(), "color"),
+  $border: map.get(get-primary-button-properties(), "border"),
+  $border-radius: map.get(get-primary-button-properties(), "border-radius"),
+  $hover-filter: map.get(get-primary-button-properties(), "hover-filter"),
+  $active-filter: map.get(get-primary-button-properties(), "active-filter"),
+  $focus-visible-filter: map.get(get-primary-button-properties(), "focus-visible-filter")
 ) {
-  // not using .primary since that's 100% going to conflict with existing declarations on sites
+  // not using button.primary since that's 100% going to conflict with existing declarations on sites
   button.major {
     @include Button(
       $background,
@@ -50,16 +87,36 @@ $secondary-button-focus-visible-filter: drop-shadow(-2px -2px 4px rgba(65, 143,
   }
 }
 
+/// Generates styling for our secondary buttons, including hover, active and focus-visible states
+///
+/// *Please only provide options to this mixin if you want to create styling for just a specific button.*
+///
+/// This mixin and the SecondaryButton mixin are currently specialties in how they get customised using maps. Everything that isn't customised using maps is subject to change in the future.
+////
+/// *For generally changing how the buttons look, override the $secondary-button-overrides map with a custom map containing the properties you want to change.*
+/// See the example below.
+/// @example
+///   // To override styling (see explanation in description)
+///   Buttons.$secondary-button-overrides: ("border": 1px solid #afafaf, "background": white);
+/// @param {Color} $background [map.get(get-secondary-button-properties(), "background")] - The background color of the button. From this color other button states will be automatically inferred by lightening or darkening it.
+///
+/// @param {Color} $color [map.get(get-secondary-button-properties(), "color")] - The color of the button text
+/// @param {Border} $border [map.get(get-secondary-button-properties(), "border")] - The button border
+/// @param {Number with unit} $border-radius [map.get(get-secondary-button-properties(), "border-radius")] - The button border radius
+/// @param {Filter} $hover-filter [map.get(get-secondary-button-properties(), "hover-filter")] - The filter to apply on hover
+/// @param {Filter} $active-filter [map.get(get-secondary-button-properties(), "active-filter")] - The filter to apply on active
+/// @param {Filter} $focus-visible-filter [map.get(get-secondary-button-properties(), "focus-visible-filter")] - The filter to apply on focus-visible (when the button is focused using keyboard navigation)
+
 @mixin SecondaryButton(
-  $background: $secondary-button-background,
-  $color: $secondary-button-color,
-  $border: $secondary-button-border,
-  $border-radius: $secondary-button-border-radius,
-  $hover-filter: $secondary-button-hover-filter,
-  $active-filter: $secondary-button-active-filter,
-  $focus-visible-filter: $secondary-button-focus-visible-filter
+  $background: map.get(get-secondary-button-properties(), "background"),
+  $color: map.get(get-secondary-button-properties(), "color"),
+  $border: map.get(get-secondary-button-properties(), "border"),
+  $border-radius: map.get(get-secondary-button-properties(), "border-radius"),
+  $hover-filter: map.get(get-secondary-button-properties(), "hover-filter"),
+  $active-filter: map.get(get-secondary-button-properties(), "active-filter"),
+  $focus-visible-filter: map.get(get-secondary-button-properties(), "focus-visible-filter")
 ) {
-  // not using .secondary since that's 100% going to conflict with existing declarations on sites
+  // not using button.secondary since that's 100% going to conflict with existing declarations on sites
   button.minor {
     @include Button(
       $background,

package/dist/styles/components/PLP/MorphingSign.scss

@@ -2,10 +2,9 @@
   .morphing-sign {
     /* https://stackoverflow.com/a/38136283 */
     border: 0;
-    font-size: 1.5em;
     position: relative;
-    width: 1em;
-    height: 1em;
+    width: 1.5em;
+    height: 1.5em;
 
     span {
       position: absolute;

package/dist/styles/components/PLP/PLPResults.scss

@@ -1,8 +1,14 @@
 @use "../../variables";
 @use "../../helpers/utils";
 
+/// Base styling (PLP) that applies to both category and search pages for the PLPResults component, the component which holds the product cards.
+/// Another part of this styling is in the ProductListingPage mixin, which takes care about the overall layout of the page (which mostly means margins and paddings).
+
 @mixin PLPResults() {
   .listing-page {
+    display: flex;
+    flex-direction: column;
+
     .no-results {
       background: white;
       padding: 40px;

package/dist/styles/components/PLP/ProductListingPage.scss

@@ -1,9 +1,15 @@
 @use "../../helpers/utils";
 
+/// Styling that ties together the different components that are common to both Category and Search pages. Mainly takes care of margins and paddings but also sets the styling for .cards which is in both PLPResults and SearchRecommendations.
+///
+/// Note that for the gaps not the exact values will always be used but often multiples for different places where it's appropriate.
+///
+/// @param {Number with size unit} $spacing-to-filters [12px] - The spacing between the filters and content.
+/// @param {Number with size unit} $desktop-item-gap [20px] - The vertical gap between the different items on desktop.
+/// @param {Number with size unit} $mobile-item-gap [16px] - The vertical gap between the different items on mobile.
+
 @mixin ProductListingPage($spacing-to-filters: 12px, $desktop-item-gap: 20px, $mobile-item-gap: 16px) {
   .listing-page {
-    display: flex;
-    flex-direction: column;
     padding: $desktop-item-gap calc(#{$desktop-item-gap} / 2);
     @include mobile_sizes() {
       padding: $mobile-item-gap calc(#{$mobile-item-gap} / 2);
@@ -50,10 +56,22 @@
       flex-direction: row;
       flex-grow: 1;
       overflow: hidden;
+      align-content: flex-start;
     }
   }
 }
 
+/// Styling that ties together the different components on the SearchPage. Mainly takes care of margins and paddings.
+///
+/// Note that for the gaps not the exact values will always be used but often multiples for different places where it's appropriate.
+///
+/// @param {Number with size unit} $spacing-to-filters [12px] - The spacing between the filters and content.
+/// @param {Number with size unit} $desktop-item-gap [20px] - The vertical gap between the different items on desktop.
+/// @param {Number with size unit} $mobile-item-gap [16px] - The vertical gap between the different items on mobile.
+/// @param {Boolean} $spacing-above-search-field [true] - Whether to add equal spacing above the search field as below.
+/// @param {Number with size unit} $query-input-width [800px] - The max width of the query input field (if present)
+/// @param {Number} $gaps-to-recs-factor [3] - The factor to multiply the gaps with to get the spacing above the recommendations.
+
 @mixin SearchPage(
   $spacing-to-filters: 12px,
   $desktop-item-gap: 20px,
@@ -123,6 +141,12 @@
   }
 }
 
+/// Styling that ties together the different components on the CategoryPage. Mainly takes care of margins and paddings.
+///
+/// @param {Number with size unit} $spacing-to-filters [12px] - The spacing between the filters and content.
+/// @param {Number with size unit} $desktop-item-gap [20px] - The vertical gap between the different items on desktop.
+/// @param {Number with size unit} $mobile-item-gap [16px] - The vertical gap between the different items on mobile.
+
 @mixin CategoryPage($spacing-to-filters: 12px, $desktop-item-gap: 20px, $mobile-item-gap: 16px) {
   .listing-page {
     .quicklinks,
@@ -135,6 +159,8 @@
   }
 }
 
+/// Internal mixin that dictates when the vertical spaces should switch to the "mobile" versions
+
 @mixin mobile_sizes() {
   @media (max-width: 651px) {
     @content;

package/dist/styles/components/PLP/ScrollStatus.scss

@@ -1,8 +1,15 @@
 @use "../../variables";
 
+/// ScrollStatus shows the user how many items are left to scroll through, if they scroll at a speed that indicates that they are no longer looking at each product but rather just trying to see how many there are.
+///
+/// If you too think that blurring the background would look great here, please take a minute to upvote this chrome bug: https://bugs.chromium.org/p/chromium/issues/detail?id=1382360
+///
+/// @param {Color} $scroll-status-background [rgba(100, 100, 100, 0.9)] - The background color of the scroll status. I recommend setting a slightly transparent color.
+/// @param {Number with size unit} $border-radius [variables.$border-radius * 5] - The border-radius of the scroll status.
+
 @mixin ScrollStatus(
   $scroll-status-background: rgba(100, 100, 100, 0.9),
-  $border-radius: calc(variables.$border-radius * 5)
+  $border-radius: calc(#{variables.$border-radius} * 5)
 ) {
   .scroll-status {
     pointer-events: none;

package/dist/styles/components/PLP/SelectedFilters.scss

@@ -2,6 +2,14 @@
 @use "../../helpers/utils";
 @use "../../helpers/supports-hover";
 @use "./Buttons";
+@use "sass:map";
+
+/// Mixin that styles the SelectedFilters component, which is the component that shows the selected filters if both the sorting and filtering menus are currently hidden.
+/// @param {Number with size unit} $border-radius [variables.$border-radius] - A local override of the border-radius variable.
+/// @param {String} $title-color [variables.$brand-black] - The color of the text that says "Filters:" (the key of this string is `selected_filters_title_` in the locale files).
+/// @param {String} $filter-title-transform [uppercase] - text-transform for the aforementioned "Filters:" string
+/// @param {Number with size unit} $margin-on-desktop [0px] - Margin above/below SelectedFilters on desktop. This is set here because ExpandingContainer, our expanding component, gets confused when the margin isn't precisely on this element. Otherwise this value would be in ProductListingPage.scss.
+/// @param {Boolean} $set-border-on-crumbs [true] - Whether to set a border on the "crumbs" (a crumb is one selected filter).
 
 @mixin SelectedFilters(
   $border-radius: variables.$border-radius,
@@ -40,7 +48,7 @@
 
         .clear-filter {
           @if $set-border-on-crumbs {
-            border: 1px solid Buttons.$primary-button-background;
+            border: 1px solid map.get(Buttons.get-primary-button-properties(), "background");
           }
           svg {
             width: 12.64px;
@@ -49,7 +57,7 @@
         }
         .clear-all-filters {
           @if $set-border-on-crumbs {
-            border: Buttons.$secondary-button-border;
+            border: map.get(Buttons.get-secondary-button-properties(), "border");
           }
         }
 

package/dist/styles/components/PLP/SlidableItems.scss

@@ -1,8 +1,11 @@
 // @use "../../../rendering/slider_button_positioning";
 @use "../../helpers/utils";
+@use "../../components/PLP/Buttons";
 @use "../../variables";
 @use "../../helpers/supports-hover";
+@use "sass:map";
 
+/// Mixin copy-pasted from @depict-ai/utilishared that helps with positioning slider buttons
 @mixin button_positioning {
   .d-navbutton {
     position: absolute;
@@ -45,7 +48,14 @@
   }
 }
 
+/// Styling for sliders used in the PLP.
+/// Most of the times SlidableItems is used for items laid out horizontally that do not fit the screen width.
+///
+/// Examples are the QuickLinks (used to navigate sideways or downwards in the category tree) and the SelectedFilters (if not all selected filters fit on the screen).
+/// @param {Color} $fade-to [variables.$brand-lighter-grey] - The color the slider buttons fade to, set this to the background color behind the slider.
+/// @param {Color} @fade-from [transparent] - The color the slider buttons fade from, you probably want to leave this at transparent.
 @mixin SlidableItems($fade-to: variables.$brand-lighter-grey, $fade-from: rgba(238, 238, 240, 0)) {
+  // TODO: we could probably infer these colours (and maybe some more) if we add some global background color variable
   .depict-slider {
     width: 100%;
     position: relative;
@@ -80,6 +90,10 @@
       justify-content: flex-end;
       border: none;
 
+      & > div {
+        display: flex;
+      }
+
       @include supports-hover.supports-hover() {
         &:hover {
           svg {
@@ -87,6 +101,14 @@
           }
         }
       }
+      &:focus-visible {
+        svg {
+          transform: scale(1.5);
+          path {
+            filter: map.get(Buttons.get-secondary-button-properties(), "focus-visible-filter");
+          }
+        }
+      }
       svg {
         transition-duration: 150ms;
       }

package/dist/styles/components/PLP/SortAndFilter/FloatingButtons.scss

@@ -1,6 +1,15 @@
 @use "../../../variables";
 @use "../../../helpers/supports-hover";
 
+/// Styles the FloatingButtons. FloatingButtons are three buttons, one button to open sorting, one button to open filters and one button to scroll to the top that show up when scrolling upwards for a while on a mobile device not really close to the top of the page.
+/// @param {Color} $button-background [variables.$brand-lighter-grey] - The background color of the buttons.
+/// @param {Color} $hovered-button-background [variables.$brand-lightest-grey] - The background color of the buttons when hovered.
+/// @param {Color} $button-border-color [variables.$brand-black] - The border color of the buttons.
+/// @param {Color} $icon-color [variables.$brand-dark-grey] - The color of the icons.
+/// @param {Number with unit} $bottom-distance [12px] - The distance from the bottom of the buttons to the bottom of the screen.
+/// @param {Number with unit} $side-distance [12px] - The distance from the `$position`-side of the buttons to the `$position`-side of the screen.
+/// @param {"left" | "right"} $position [left] - The side of the screen the buttons should be aligned to.
+
 @mixin FloatingButtons(
   $button-background: variables.$brand-lighter-grey,
   $hovered-button-background: variables.$brand-lightest-grey,

package/dist/styles/components/PLP/SortAndFilter/SortAndFilter.scss

@@ -6,6 +6,63 @@
 @use "../../../helpers/supports-hover";
 @use "../Buttons";
 @use "sass:color";
+@use "sass:map";
+
+/// Mixin that styles the sorting and filtering menus.
+/// The way this is configured is soon going to be subject to change, therefore the parameters are not argumented.
+/// @param {Color} $mobile-top-level-collapse-color [variables.$brand-black] -
+/// @param {Color} $mobile-top-level-collapse-background [#fff] -
+/// @param {Color} $custom-input-checked-background [#fff] -
+/// @param {Color} $custom-input-background [#fff] -
+/// @param {Color} $custom-input-indicator-color [variables.$brand-black] -
+/// @param {Color} $checkbox-background-color [#fff] -
+/// @param {Color} $checkbox-checked-background-color [variables.$brand-black] -
+/// @param {Color} $checkbox-checkmark-color [#fff] -
+/// @param {Number with size unit} $checkbox-border-radius [if(variables.$border-radius == 0, 0, if(variables.$border-radius == 0px, 0, 2px))] -
+/// @param {Border} $checkbox-border [1px solid variables.$brand-dark-grey] -
+/// @param {Number with size unit} $checkbox-top-offset [0px] -
+/// @param {Number with size unit} $checkbox-left-offset [0px] -
+/// @param {Border} $radio-border [1px solid variables.$brand-dark-grey] -
+/// @param {Color} $radio-background-color [#fff] -
+/// @param {Color} $radio-selected-dot-color [variables.$brand-black] -
+/// @param {Number with size unit} $radio-selected-dot-size [14px] -
+/// @param {Number with size unit} $radio-selected-offset [0px] -
+/// @param {Color} $separator-color [variables.$brand-dark-grey] -
+/// @param {Color} $price-range-min-max-text-color [variables.$brand-dark-grey] -
+/// @param {Color} $range-input-bg-color [variables.$brand-lightest-grey] -
+/// @param {Color} $top-level-summary-background [variables.$brand-black] -
+/// @param {Color} $hovered-top-level-summary-background [variables.$brand-dark-grey] -
+/// @param {Color} $hovered-range-input-bg-color [variables.$brand-lighter-grey] -
+/// @param {Color} $hovered-checkbox-bg [variables.$brand-lighter-grey] -
+/// @param {false | Color} $hovered-checkbox-checked-background-color [false] -
+/// @param {Color} $input-row-label-color [variables.$brand-dark-grey] -
+/// @param {Color} $checked-input-row-label-color [#000] -
+/// @param {Number} $input-row-label-font-weight [400] -
+/// @param {Number} $checked-input-row-label-font-weight [500] -
+/// @param {Color} $showing-selected-subfilter-count-color [variables.$brand-grey] -
+/// @param {Color} $filter-available-products-color [variables.$brand-grey] -
+/// @param {Color} $count-zero-input-row-label-color [rgb(194, 194, 194)] -
+/// @param {Number with size unit} $spacing_between_input_rows [10px] -
+/// @param {Number with size unit} $ungrouped-top-margin [25px] -
+/// @param {Border} $hovered-checkbox-border [2px solid variables.$brand-black] -
+/// @param {Border} $hovered-radio-border [2px solid variables.$brand-black] -
+/// @param {Padding} $sort-and-filter-button-padding [10px 20px] -
+/// @param {Color} $expandable-seperator-color [variables.$brand-lightest-grey] -
+/// @param {Color} $expandable-seperator-hover-color [variables.$brand-lighter-grey] -
+/// @param {Number with size unit} $expandable-seperator-height [1px] -
+/// @param {Color} $filter-group-heading-color [#fff] -
+/// @param {Color} $filter-groups-morphing-sign-color [#fff] -
+/// @param {Number with size unit} $filter-group-summary-border-radius [4px] -
+/// @param {Color} $sort-and-filter-modal-background [variables.$brand-lighter-grey] -
+/// @param {Number with size unit} $filter-group-heading-padding [10px] -
+/// @param {Number with size unit} $filter-group-summary-spacings [10px] -
+/// @param {Number with size unit} $range-input-field-border-radius [4px] -
+/// @param {Border} $range-input-field-border [none] -
+/// @param {false | Number} $filter-group-title-bold [false] -
+/// @param {Color} $view-more-clear-background [rgb(253, 253, 253)] -
+/// @param {Color} $filter-collapsible-body-background [rgb(238, 238, 240)] -
+/// @param {Number | Boolean} $sort-and-filter-modal-section-title-font-weight [false] -
+/// @param {Number | Boolean} $sort-and-filter-modal-section-expanded-title-font-weight [$sort-and-filter-modal-section-title-font-weight] -
 
 @mixin SortAndFilter(
   $mobile-top-level-collapse-color: variables.$brand-black,
@@ -18,10 +75,10 @@
   $checkbox-checkmark-color: #fff,
   $checkbox-border-radius: if(variables.$border-radius == 0, 0, if(variables.$border-radius == 0px, 0, 2px)),
   // if global border radius is 0 or 0px, don't round input fields in their default value
-  $checkbox-border: 1px solid variables.$brand-black,
+  $checkbox-border: 1px solid variables.$brand-dark-grey,
   $checkbox-top-offset: 0px,
   $checkbox-left-offset: 0px,
-  $radio-border: 1px solid variables.$brand-black,
+  $radio-border: 1px solid variables.$brand-dark-grey,
   $radio-background-color: #fff,
   $radio-selected-dot-color: variables.$brand-black,
   $radio-selected-dot-size: 14px,
@@ -63,7 +120,8 @@
   $sort-and-filter-modal-section-title-font-weight: false,
   $sort-and-filter-modal-section-expanded-title-font-weight: $sort-and-filter-modal-section-title-font-weight
 ) {
-  $input-row-height-goal: 20px;
+  $input-row-height-goal: max(21px, 1em); // if text gets bigger we have to get bigger too to not cut off the text
+  // it was meant to be 20px but there was a bug so I'm setting it to 21px now so it doesn't change
   $count-distance-to-right: 30px;
   $largest-border-on-custom-input: max(
     custom_input.get_border_width($checkbox-border),
@@ -151,7 +209,7 @@
       align-items: center;
       transition: opacity 250ms ease-in-out;
       font-size: 12px;
-      z-index: calc(variables.$search-page-base-z-index + 1);
+      z-index: calc(#{variables.$search-page-base-z-index} + 1);
     }
     .open-filters-button-container {
       position: relative;
@@ -191,7 +249,8 @@
       $hovered-checkbox-checked-background-color,
       $hovered-checkbox-border,
       $hovered-radio-border,
-      $width-and-height: calc(#{$input-row-height-goal} - #{$largest-border-on-custom-input})
+      $input-row-height-goal,
+      $largest-border-on-custom-input
     );
   }
   .filters {
@@ -218,9 +277,7 @@
         }
         .text {
           //line-height: 1.8; /** Fix for ÅÄÖ getting cut-off **/
-          line-height: calc(
-            #{$input-row-height-goal} + #{$largest-border-on-custom-input}
-          ); // Sorry ÅÄÖ, hope you survive this
+          line-height: $input-row-height-goal; // Sorry ÅÄÖ, hope you survive this
           display: -webkit-box;
           text-overflow: ellipsis;
           white-space: pre-line;
@@ -381,7 +438,7 @@
             }
             &:focus-visible {
               outline: none;
-              filter: Buttons.$secondary-button-focus-visible-filter;
+              filter: map.get(Buttons.get-secondary-button-properties(), "focus-visible-filter");
             }
           }
         }
@@ -523,7 +580,7 @@
                 }
                 & > .summary {
                   justify-content: flex-end;
-                  $morphing-sign-width: calc(#{$input-row-height-goal} + #{$largest-border-on-custom-input});
+                  $morphing-sign-width: #{$input-row-height-goal};
                   .count {
                     margin-right: calc(#{$count-distance-to-right} - #{$morphing-sign-width});
                   }
@@ -684,6 +741,7 @@
           }
         }
       }
+      @include CheckboxColor();
     }
   }
   .sorting {
@@ -712,17 +770,31 @@
 }
 
 @mixin default_morphing_sign_in_expandable {
-  .morphing-sign span {
-    background: #333333;
+  .morphing-sign {
+    span {
+      background: #333333;
 
-    &:first-child {
-      width: 5%;
-      left: 47.5%;
+      &:first-child {
+        width: 5%;
+        left: 47.5%;
+      }
+
+      &:last-child {
+        height: 5%;
+        top: 47.5%;
+      }
     }
+  }
+}
+
+@mixin CheckboxColor() {
+  .checkbox-color {
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: space-between;
 
-    &:last-child {
-      height: 5%;
-      top: 47.5%;
+    .input-row {
+      width: calc(50% - 10px);
     }
   }
 }

package/dist/styles/components/PLP/SortAndFilter/SortAndFilterModal.scss

@@ -1,9 +1,7 @@
 @use "../../../variables";
 @use "../../../helpers/utils";
 
-/*
-*  Mobile modal - taking arguments from SortAndFilter mixin
-*/
+/// Mobile modal - taking arguments from SortAndFilter mixin so see SortAndFilter docs for more info
 @mixin SortAndFilterModal(
   $mobile-top-level-collapse-color,
   $mobile-top-level-collapse-background,
@@ -39,7 +37,7 @@
   }
 
   .filter-sort-modal {
-    z-index: calc(variables.$base-z-index + 2);
+    z-index: calc(#{variables.$base-z-index} + 2);
     position: fixed;
     top: 0;
     left: 30px;

package/dist/styles/components/PLP/SortAndFilter/WhiteSortAndFilter.scss

@@ -6,6 +6,10 @@
 @use "../../../helpers/supports-hover";
 @use "SortAndFilter";
 
+/// A wrapper around SortAndFilter that styles the sorting and filtering menus for the white theme by providing a default set of white variables.
+///
+/// ### Parameters
+/// See [SortAndFilter](#undefined-mixin-SortAndFilter) for parameters.
 @mixin WhiteSortAndFilter(
   $mobile-top-level-collapse-color: variables.$brand-black,
   $mobile-top-level-collapse-background: #fff,
@@ -17,10 +21,10 @@
   $checkbox-checkmark-color: #fff,
   $checkbox-border-radius: if(variables.$border-radius == 0, 0, if(variables.$border-radius == 0px, 0, 2px)),
   // if global border radius is 0 or 0px, don't round input fields in their default value
-  $checkbox-border: 1px solid variables.$brand-black,
+  $checkbox-border: 1px solid variables.$brand-dark-grey,
   $checkbox-top-offset: 0px,
   $checkbox-left-offset: 0px,
-  $radio-border: 1px solid variables.$brand-black,
+  $radio-border: 1px solid variables.$brand-dark-grey,
   $radio-background-color: #fff,
   $radio-selected-dot-color: variables.$brand-black,
   $radio-selected-dot-size: 14px,

package/dist/styles/components/PLP/Toast.scss

@@ -1,6 +1,11 @@
 @use "../../variables";
 @use "../../helpers/utils";
 
+/// Toast is a small, unobtrusive, banner that appears at the bottom of the page when we clear their filters when going sideways in the category tree (or they do it manually). The Toast has a button that allows them to get their filters back (restore them) in case they want it back.
+/// It's a general component otherwise and might also be used for other messages.
+/// @param {Number} $z-index [variables.$base-z-index * 5] - The z-index of the Toast.
+/// @param {Color} $progress-bar-color [variables.$brand-dark-grey] - The color of the progress bar below the toast that shows when it will auto-close.
+
 @mixin Toast($z-index: calc(#{variables.$base-z-index} + 5), $progress-bar-color: variables.$brand-dark-grey) {
   .depict.plp.toast {
     position: fixed;

package/dist/styles/components/PLP/index.scss

@@ -1,6 +1,7 @@
 @use "sass:meta";
 
 // Component style mixins
+@use "../../variables";
 @use "SelectedFilters";
 @use "ScrollStatus";
 @use "SlidableItems";
@@ -23,19 +24,24 @@
 @forward "ProductListingPage";
 @forward "Buttons";
 
-// Default variables
+/// Default variables
 @forward "../../variables";
 
-// Load all mixins with default values. If only minor theming is needed styles in variables.scss can be
-// reassigned: https://sass-lang.com/documentation/at-rules/use#reassigning-variables
-// If more control is needed use these mixins separately and pass custom params
-@mixin all-components() {
+/// Load all PLP mixins with default values. PLP encompasses both Search and Category page, so you will always need to include the mixins that this includes somehow. If only minor theming is needed styles in variables.scss can be
+/// reassigned: https://sass-lang.com/documentation/at-rules/use#reassigning-variables
+/// If more control is needed use these mixins separately and pass custom params
+
+@mixin all-PLP-components() {
   .depict.plp {
     @include PLPResults.PLPResults();
     @include ProductListingPage.ProductListingPage();
     @include SelectedFilters.SelectedFilters();
     @include ScrollStatus.ScrollStatus();
-    @include SortAndFilter.SortAndFilter();
+    @if variables.$white {
+      @include WhiteSortAndFilter.WhiteSortAndFilter();
+    } @else {
+      @include SortAndFilter.SortAndFilter();
+    }
     @include FloatingButtons.FloatingButtons();
     @include SlidableItems.SlidableItems();
     @include Buttons.PrimaryButton();