@stackoverflow/stacks 1.4.1 → 1.5.0

package/lib/css/components/modals.less

@@ -1,133 +1,108 @@
-//
-//  STACK OVERFLOW
-//  MODALS
-//
-//  This CSS comes from Stacks, our CSS & Pattern library for rapidly building
-//  Stack Overflow. For documentation of all these classes and how to contribute,
-//  visit https://stackoverflow.design/
-//
-//  TABLE OF CONTENTS
-//  • BASE STYLE
-//  • LAYOUT TRANSITIONS
-//
-//  ============================================================================
-//  $   BASE STYLE
-//  ----------------------------------------------------------------------------
 .s-modal {
-    display: flex;
-    visibility: hidden;
-    position: fixed;
-    z-index: var(--zi-hide); // Make sure it's also below everything so we can't interact with it.
-
-    // This fills the entire viewport without having to worry about size.
-    top: 0;
-    right: 0;
-    bottom: 0;
-    left: 0;
-    align-items: center;
-    justify-content: center;
-    background-color: fade(@black-900, 50%); // Background remains fixed
-    opacity: 0;
-    backface-visibility: hidden;
-    transition: opacity 100ms var(--te-smooth) 0s, z-index 0s 100ms, visibility 0s 100ms; // Transition out
-    will-change: visibility, z-index, opacity; // Not supported in Edge
-
-    &[aria-hidden="false"],
-    &[aria-hidden="false"] .s-modal--dialog {
-        visibility: visible;
-        z-index: var(--zi-modals);
-        opacity: 1;
-        transform: translate3d(0, 0, 0) scale3d(1, 1, 1);
-        transition: opacity 100ms var(--te-smooth) 10ms, z-index 0s 0s, visibility 0s 0s, transform 100ms var(--te-smooth) 10ms, transform 100ms var(--te-smooth) 10ms; // Transition in
+    --_mo-bg: fade(@black-900, 50%); // Background remains fixed
+    --_mo-hmx: unset;
+    --_mo-wmx: unset;
+    --_mo-close-t: var(--su8);
+    --_mo-dialog-bg: var(--white);
+    --_mo-dialog-pt: var(--su24);
+    --_mo-header-fc: var(--fc-dark);
+
+    // CONTEXTUAL STYLES
+    &[aria-hidden="false"] {
+        &,
+        .s-modal--dialog {
+            opacity: 1;
+            transform: translate3d(0, 0, 0) scale3d(1, 1, 1);
+            transition: opacity 100ms var(--te-smooth) 10ms, z-index 0s 0s, visibility 0s 0s, transform 100ms var(--te-smooth) 10ms, transform 100ms var(--te-smooth) 10ms; // Transition in
+            visibility: visible;
+            z-index: var(--zi-modals);
+        }
     }
-}
 
-.s-modal--dialog {
-    overflow-y: auto;
-    visibility: hidden;
-    z-index: var(--zi-hide); // Make sure it's also below everything so we can't interact with it.
-    max-width: 600px;
-    max-height: 100%;
-    padding: var(--su24);
-    border-radius: var(--br-lg);
-    background-color: var(--white);
-    box-shadow: var(--bs-lg);
-    opacity: 0;
-    backface-visibility: hidden;
-    transform: translate3d(0, 30%, 0) scale3d(0.6, 0.6, 0.6);
-
-    .dark-mode({
-        background-color: var(--black-100);
-    });
-
-    @scrollbar-styles();
+    // MODIFIERS
+    &&__celebration {
+        --_mo-close-t: var(--su48);
+        --_mo-dialog-pt: var(--su64);
 
-    transition: opacity 200ms var(--te-smooth) 0s, z-index 0s 100ms, visibility 0s 100ms, transform 100ms var(--te-smooth) 0s, transform 100ms var(--te-smooth) 0s; // Transition out
-    will-change: visibility, z-index, opacity, transform; // Not supported by Edge
-
-    .s-modal[aria-hidden="false"] & {
-        transform: translate3d(0, 0, 0) scale3d(1, 1, 1); // Transition in
+        .s-modal--dialog {
+            .bg-confetti-animated;
+        }
     }
-}
-
-//  [1] To override .s-btn class attributes
-.s-modal--close {
-    position: absolute !important; // [1]
-    top: var(--su8);
-    right: var(--su8);
-    padding: var(--su12) !important; // [1]
-
-    .svg-icon {
-        margin: 0 !important;
+    &&__full {
+        --_mo-hmx: calc(100% - var(--su48));
+        --_mo-wmx: calc(100% - var(--su48));
     }
-}
 
-//  ============================================================================
-//  $   DIALOG PIECES
-//  ----------------------------------------------------------------------------
-.s-modal--header {
-    margin-bottom: var(--su16);
-    color: var(--fc-dark);
-    font-size: var(--fs-headline1);
-    font-weight: normal;
-    line-height: var(--lh-sm);
-}
-
-.s-modal--body {
-    margin-bottom: var(--su24);
-    color: var(--fc-medium);
-}
-
-.s-modal--footer {
-    margin-top: var(--su24);
-}
-
-
-//  ============================================================================
-//  $   STATES
-//  ----------------------------------------------------------------------------
-.s-modal.has-danger,
-.s-modal.s-modal__danger {
-    background-color: darken(fade(@red-900, 50%), 23%);
-
-    .s-modal--header {
-        color: var(--red-600);
+    // VARIANTS
+    &.has-danger,
+    &&__danger {
+        --_mo-bg: darken(fade(@red-900, 50%), 23%);
+        --_mo-header-fc: var(--red-600);
     }
-}
 
-.s-modal.s-modal__celebration .s-modal--dialog {
-    padding-top: var(--su64);
-    .bg-confetti-animated;
+    // CHILD ELEMENTS
+    & &--body {
+        color: var(--fc-medium);
+        margin-bottom: var(--su24);
+    }
+    & &--close {
+        //  [1] To override .s-btn class attributes
+        .svg-icon {
+            margin: 0 !important;
+        }
+
+        padding: var(--su12) !important; // [1]
+        position: absolute !important; // [1]
+        right: var(--su8);
+        top: var(--_mo-close-t);
+    }
+    & &--dialog {
+        .dark-mode({
+            --_mo-dialog-bg: var(--black-100);
+        });
+
+        padding: var(--_mo-dialog-pt) var(--su24) var(--su24);
+
+        @scrollbar-styles();
+        backface-visibility: hidden;
+        background-color: var(--_mo-dialog-bg);
+        border-radius: var(--br-lg);
+        box-shadow: var(--bs-lg);
+        max-height: 100%;
+        max-width: 600px;
+        opacity: 0;
+        overflow-y: auto;
+        transform: translate3d(0, 30%, 0) scale3d(0.6, 0.6, 0.6);
+        transition: opacity 200ms var(--te-smooth) 0s, z-index 0s 100ms, visibility 0s 100ms, transform 100ms var(--te-smooth) 0s, transform 100ms var(--te-smooth) 0s; // Transition out
+        visibility: hidden;
+        will-change: visibility, z-index, opacity, transform; // Not supported by Edge
+        z-index: var(--zi-hide); // Make sure it's also below everything so we can't interact with it.
+    }
+    & &--footer {
+        margin-top: var(--su24);
+    }
+    & &--header {
+        color: var(--_mo-header-fc);
 
-    .s-modal--close {
-        top: var(--su48);
+        font-size: var(--fs-headline1);
+        font-weight: normal;
+        line-height: var(--lh-sm);
+        margin-bottom: var(--su16);
     }
-}
 
-//  ============================================================================
-//  $   SIZES
-//  ----------------------------------------------------------------------------
-.s-modal__full {
-    max-width: calc(100% - var(--su48));
-    max-height: calc(100% - var(--su48));
+    background-color: var(--_mo-bg);
+    max-height: var(--_mo-hmx);
+    max-width: var(--_mo-wmx);
+
+    align-items: center;
+    backface-visibility: hidden;
+    display: flex;
+    inset: 0; // This fills the entire viewport without having to worry about size.
+    justify-content: center;
+    opacity: 0;
+    position: fixed;
+    transition: opacity 100ms var(--te-smooth) 0s, z-index 0s 100ms, visibility 0s 100ms; // Transition out
+    visibility: hidden;
+    will-change: visibility, z-index, opacity; // Not supported in Edge
+    z-index: var(--zi-hide); // Make sure it's also below everything so we can't interact with it.
 }

package/lib/css/components/navigation.less

@@ -63,7 +63,6 @@
         });
 
         // STATES
-        // Selected
         &.is-selected {
             --_na-item-bg: var(--theme-primary-color);
             --_na-item-fc: var(--white);
@@ -92,7 +91,7 @@
             padding-right: 2em;
         }
 
-        // Interaction states
+        // INTERACTION
         &:hover,
         &:active {
             background-color: var(--_na-item-bg-hover);

package/lib/css/components/page-titles.less

@@ -1,15 +1,3 @@
-//
-//  STACK OVERFLOW
-//  PAGE TITLES
-//
-//  This CSS comes from Stacks, our CSS & Pattern library for rapidly building
-//  Stack Overflow. For documentation of all these classes and how to contribute,
-//  visit https://stackoverflow.design/
-//
-//  ============================================================================
-//  $  BASE
-//  ----------------------------------------------------------------------------
-
 .s-page-title {
     --_pt-ai: flex-end;
     --_pt-fd: row;
@@ -46,7 +34,7 @@
         font-weight: normal;
         line-height: var(--lh-sm);
         margin: 0;
-        margin-bottom: 0; // TODO: investigate why this exists. I assume it's so margin-bottom isn't overrode, but 🤷‍♂️
+        margin-bottom: 0; // TODO: investigate why this exists. I assume it's so margin-bottom isn't overridden, but 🤷‍♂️
     }
     .s-breadcrumbs {
         margin-bottom: var(--_pt-breadcrums-mb);

package/lib/css/components/pagination.less

@@ -3,11 +3,11 @@
         --_pa-item-bg: transparent;
         --_pa-item-bc: var(--bc-medium);
         --_pa-item-fc: var(--fc-medium);
-        // hover
         --_pa-item-bg-hover: var(--black-100);
         --_pa-item-bc-hover: var(--bc-darker);
         --_pa-item-fc-hover: var(--fc-dark);
 
+        // CONTEXTUAL STYLES
         .highcontrast-mode({ text-decoration: none; });
 
         // MODIFIERS

package/lib/css/components/popovers.less

@@ -1,197 +1,148 @@
-//
-//  STACK OVERFLOW
-//  POPOVERS
-//
-//  This CSS comes from Stacks, our CSS & Pattern library for rapidly building
-//  Stack Overflow. For documentation of all these classes and how to contribute,
-//  visit https://stackoverflow.design/
-//
-//  TABLE OF CONTENTS
-//  • VARIABLES
-//  • BASE STYLE
-//  • ARROWS
-//  • LOCATIONS
-//
-//  ============================================================================
-//  $   BASE STYLES
-//  ----------------------------------------------------------------------------
 .s-popover {
-    display: none;
-    position: absolute;
-    max-width: 24rem;
-    padding: var(--su12);
-    z-index: var(--zi-popovers);
-    border-radius: var(--br-md);
-    border: 1px solid var(--bc-medium);
-    background-color: var(--white);
-    box-shadow: var(--bs-md);
-    color: var(--fc-dark);
-    font-size: var(--fs-body1);
-    min-width: 12rem;
-    width: 100%;
-
-    // Guard against popovers being in a container with white-space: nowrap
-    // Without this, the content pops *out* of the popover.
-    white-space: normal; 
-
+    --_po-bg: var(--white);
+    --_po-bc: var(--bc-medium);
+    --_po-bs: var(--bs-md);
+    --_po-d: none;
+    --_po-wmn: 12rem;
+    --_po-w: 100%;
+    // arrow
+    --_po-arrow-fc: var(--white);
+    --_po-arrow-b: unset;
+    --_po-arrow-l: unset;
+    --_po-arrow-r: unset;
+    --_po-arrow-t: unset;
+    --_po-arrow-ps: calc(var(--su6) * -1); // ps suffix used for placement, not positioning value
+    --_po-arrow-after-b: unset;
+    --_po-arrow-after-l: unset;
+    --_po-arrow-after-r: unset;
+    --_po-arrow-after-t: unset;
+    --_po-arrow-after-bs: unset;
+  
+    // CONTEXTUAL STYLES
     .dark-mode({
-        background-color: var(--black-075);
-        border-color: var(--bc-light);
-        box-shadow: var(--bs-lg);
+        --_po-bg: var(--black-075);
+        --_po-bc: var(--bc-light);
+        --_po-bs: var(--bs-lg);
+        --_po-arrow-fc: var(--black-075);
     });
-
-    &.s-popover__tooltip {
-        width: auto;
-        min-width: unset;
-    }
-
+  
+    // MODIFIERS
     &.is-visible {
-        display: block;
+        --_po-d: block;
     }
-
-    &[data-popper-placement^="top"] > .s-popover--arrow,
-    .s-popover--arrow__bc,
-    .s-popover--arrow__bl,
-    .s-popover--arrow__br {
-        bottom: calc(var(--su6) * -1);
-
-        &:after {
-            bottom: 1px;
-            box-shadow: 2px 2px 5px 0 hsla(0, 0, 0, 0.07), 2px 2px 2px -1px hsla(0, 0, 0, 0.1);
-
-            .highcontrast-mode({
-                box-shadow: 1px 1px 0 0 var(--bc-medium);
-            });
-        }
+    &&__tooltip {
+        --_po-wmn: unset;
+        --_po-w: auto;
     }
-
-    &[data-popper-placement^="bottom"] > .s-popover--arrow,
-    .s-popover--arrow__tc,
-    .s-popover--arrow__tl,
-    .s-popover--arrow__tr {
-        top: calc(var(--su6) * -1);
-
-        &:after {
-            top: 1px;
-            box-shadow: -1px -1px 1px 0 hsla(0, 0, 0, 0.12);
-
-            .highcontrast-mode({
-                box-shadow: -1px -1px 0 0 var(--bc-medium);
-            });
-        }
+  
+    // CHILD ELEMENTS
+    // Arrow
+    &[data-popper-placement^="top"] > &--arrow,
+    & &--arrow__bc,
+    & &--arrow__bl,
+    & &--arrow__br {
+        --_po-arrow-b: var(--_po-arrow-ps);
+        --_po-arrow-after-b: var(--su-static1);
+        --_po-arrow-after-bs: 2px 2px 5px 0 hsla(0, 0%, 0%, 0.07), 2px 2px 2px -1px hsla(0, 0%, 0%, 0.1);
+        .highcontrast-mode({ --_po-arrow-after-bs: 1px 1px 0 0 var(--bc-medium); });
     }
-
-    &[data-popper-placement^="left"] > .s-popover--arrow,
-    .s-popover--arrow__rc,
-    .s-popover--arrow__rt,
-    .s-popover--arrow__rb {
-        right: calc(var(--su6) * -1);
-
-        &:after {
-            right: 1px;
-            box-shadow: 2px -2px 5px 0 hsla(0, 0, 0, 0.07), 2px -2px 2px -1px hsla(0, 0, 0, 0.1);
-
-            .highcontrast-mode({
-                box-shadow: 1px -1px 0 0 var(--bc-medium);
-            });
-        }
+    &[data-popper-placement^="bottom"] > &--arrow,
+    & &--arrow__tc,
+    & &--arrow__tl,
+    & &--arrow__tr {
+        --_po-arrow-t: var(--_po-arrow-ps);
+        --_po-arrow-after-t: var(--su-static1);
+        --_po-arrow-after-bs: -1px -1px 1px 0 hsla(0, 0%, 0%, 0.12);
+        .highcontrast-mode({ --_po-arrow-after-bs: -1px -1px 0 0 var(--bc-medium); });
     }
-
-    &[data-popper-placement^="right"] > .s-popover--arrow,
-    .s-popover--arrow__lc,
-    .s-popover--arrow__lt,
-    .s-popover--arrow__lb {
-        left: calc(var(--su6) * -1);
-
-        &:after {
-            left: 1px;
-            box-shadow: -2px 2px 5px 0 hsla(0, 0, 0, 0.07), -2px 2px 2px -1px hsla(0, 0, 0, 0.1);
-
-            .highcontrast-mode({
-                box-shadow: -1px 1px 0 0 var(--bc-medium);
-            });
-        }
+    &[data-popper-placement^="left"] > &--arrow,
+    & &--arrow__rc,
+    & &--arrow__rt,
+    & &--arrow__rb {
+        --_po-arrow-r: var(--_po-arrow-ps);
+        --_po-arrow-after-r: var(--su-static1);
+        --_po-arrow-after-bs: 2px -2px 5px 0 hsla(0, 0%, 0%, 0.07), 2px -2px 2px -1px hsla(0, 0%, 0%, 0.1);
+        .highcontrast-mode({ --_po-arrow-after-bs: 1px -1px 0 0 var(--bc-medium); });
     }
-
-    .s-popover--arrow__tc,
-    .s-popover--arrow__bc {
-        left: calc(50% - var(--su6));
+    &[data-popper-placement^="right"] > &--arrow,
+    & &--arrow__lc,
+    & &--arrow__lt,
+    & &--arrow__lb {
+        --_po-arrow-l: var(--_po-arrow-ps);
+        --_po-arrow-after-l: var(--su-static1);
+        --_po-arrow-after-bs: -2px 2px 5px 0 hsla(0, 0%, 0%, 0.07), -2px 2px 2px -1px hsla(0, 0%, 0%, 0.1);
+        .highcontrast-mode({ --_po-arrow-after-bs: -1px 1px 0 0 var(--bc-medium); });
     }
-
-    .s-popover--arrow__lc,
-    .s-popover--arrow__rc {
-        top: calc(50% - var(--su6));
+    & &--arrow__tc,
+    & &--arrow__bc {
+        --_po-arrow-l: calc(50% - var(--su6));
     }
-
-    .s-popover--arrow__tr,
+    & &--arrow__lc,
+    & &--arrow__rc {
+        --_po-arrow-t: calc(50% - var(--su6));
+    }
+    & &--arrow__tr,
     .s-popover--arrow__br {
-        right: var(--su12);
+        --_po-arrow-r: var(--su12);
     }
-
-    .s-popover--arrow__rb,
-    .s-popover--arrow__lb {
-        bottom: var(--su12);
+    & &--arrow__rb,
+    & &--arrow__lb {
+        --_po-arrow-b: var(--su12);
     }
-}
-
-//  ============================================================================
-//  $   CLOSE BUTTON
-//  ----------------------------------------------------------------------------
-
-.s-popover--close {
-    float: right; // Use floats for title wrapping
-    top: calc(var(--su8) * -1); // Compensate for s-popover's padding
-    right: calc(var(--su8) * -1); // Compensate for s-popover's padding
-    padding: var(--su8) !important;
-}
-
-//  ============================================================================
-//  $   ARROWS
-//  ----------------------------------------------------------------------------
-//
-//  TABLE OF CONTENTS
-//  • BASE STYLE
-//  • LOCATIONS
-//      • TOP
-//      • BOTTOM
-//      • TOP & BOTTOM DIRECTIONS (Left, Center, Right)
-//      • LEFT
-//      • RIGHT
-//      • LEFT & RIGHT DIRECTIONS (Top, Center, Bottom)
-//
-//  ============================================================================
-//  $   BASE STYLE
-//      Sets the base arrow style for tooltips, popovers, and dropdowns.
-//  ----------------------------------------------------------------------------
+    & &--arrow {
+        &,
+        &:before,
+        &:after {
+            display: block;
+            height: var(--su12);
+            position: absolute;
+            width: var(--su12);
+            z-index: -1;
+        }
+        &:before, // This renders our border
+        &:after {
+            content: '';
+            transform: rotate(45deg);
+        }
+        &:after { // This renders our foreground color
+            bottom: var(--_po-arrow-after-b);
+            box-shadow: var(--_po-arrow-after-bs);
+            left: var(--_po-arrow-after-l);
+            right: var(--_po-arrow-after-r);
+            top: var(--_po-arrow-after-t);
+
+            background: currentColor;
+            border-radius: calc(var(--su-static1) * 1.5);
+        }
 
-.s-popover--arrow,
-.s-popover--arrow:before,
-.s-popover--arrow:after {
+        bottom: var(--_po-arrow-b);
+        color: var(--_po-arrow-fc);
+        left: var(--_po-arrow-l);
+        right: var(--_po-arrow-r);
+        top: var(--_po-arrow-t);
+    }
+    // Close btn
+    & &--close {
+        float: right; // Use floats for title wrapping
+        top: calc(var(--su8) * -1); // Compensate for s-popover's padding
+        right: calc(var(--su8) * -1); // Compensate for s-popover's padding
+        padding: var(--su8) !important;
+    }
+  
+    background-color: var(--_po-bg);
+    border: 1px solid var(--_po-bc);
+    box-shadow: var(--_po-bs);
+    display: var(--_po-d);
+    min-width: var(--_po-wmn);
+    width: var(--_po-w);
+  
+    border-radius: var(--br-md);
+    color: var(--fc-dark);
+    font-size: var(--fs-body1);
+    max-width: 24rem;
+    padding: var(--su12);
     position: absolute;
-    display: block;
-    width: var(--su12);
-    height: var(--su12);
-    z-index: -1;
-}
-
-.s-popover--arrow {
-    color: var(--white);
-
-    .dark-mode({
-        color: var(--black-075);
-    });
-}
-
-.s-popover--arrow:before {
-    // This renders our border
-    content: '';
-    transform: rotate(45deg);
-}
-
-.s-popover--arrow:after {
-    // This renders our foreground color
-    content: '';
-    transform: rotate(45deg);
-    border-radius: 1.5px;
-    background: currentColor;
-}
+    white-space: normal; // Guard against popovers being in a container with white-space: nowrap. Without this, the content pops *out* of the popover.
+    z-index: var(--zi-popovers);
+  }
+  

package/lib/css/components/prose.less

@@ -1,15 +1,3 @@
-//
-//  STACK OVERFLOW
-//  PROSE
-//
-//  This CSS comes from Stacks, our CSS & Pattern library for rapidly building
-//  Stack Overflow. For documentation of all these classes and how to contribute,
-//  visit https://stackoverflow.design/
-//
-//  ============================================================================
-//  $  BASE
-//  ----------------------------------------------------------------------------
-
 .s-prose {
     --s-prose-line-height: 1.5;
     --s-prose-spacing: 1.1em;