@stackoverflow/stacks 1.4.1 → 1.5.0

package/lib/css/atomic/flex.less

@@ -54,6 +54,8 @@
             #stacks-internals #flex-builder-helpers .create-flex-count-cols(@num, (@count + 1));
         }
 
+        // DEPRECATED - START
+        //
         //  --  FLEX GUTTERS
         //  ============================================================================
         //      We need two mixins to properly generate flex gutters:
@@ -151,6 +153,38 @@
             //      widths for the new gutters.
             #stacks-internals #flex-builder-helpers .flex-fixed-item-spacing(@spacing, @flex-cols);
         }
+        //
+        // DEPRECATED - END
+
+        //  -- FLEX GAP
+        //  ------------------------------------------------------------------------
+        //  [1] FIXED WIDTH ITEMS
+        //      This makes the fixed width items to account for gaps.
+        //
+        //  [2] UNIFORM CHILD FLEX ITEMS
+        //      This class allows you to uniformly state the width of `.flex--item`
+        //      divs within a `.d-flex` element. In particular we adjust the flex-basis
+        //      and max-width here to account for gaps.
+        //  ------------------------------------------------------------------------
+        .flex-fixed-item-spacing-gap(@spacing, @num, @count: 1) when (@count =< @num) {
+            @itemWidth: (@count * 100% / @num);
+            @gapRatio: ((@num - @count) / @num);
+
+            > .flex--item@{count},                                  // [1]
+            &.flex__allitems@{count} > .d-flex,                     // [2]
+            &.flex__allitems@{count} > .flex--item {                // [2]
+                flex-basis: calc(~"@{itemWidth} - (@{spacing} * @{gapRatio})");
+            }
+
+            #stacks-internals #flex-builder-helpers .flex-fixed-item-spacing-gap(@spacing, @num, (@count + 1));
+        }
+
+
+        .gap-spacing(@spacing) {
+            #stacks-internals #flex-builder-settings();
+
+            #stacks-internals #flex-builder-helpers .flex-fixed-item-spacing-gap(@spacing, @flex-cols);
+        }
     }
 }
 
@@ -194,9 +228,24 @@
 }
 //  ============================================================================
 //  $   FLEX SPACING
-//      Insert spaces or gutters in between flex items
+//      Insert spaces or gaps in between flex items
 //  ----------------------------------------------------------------------------
-// TODO: Make this play nice with spacing units… or yeet this in the age of gap
+.g0, .gx0, .gy0 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su0)); }
+.g1, .gx1, .gy1 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su1)); }
+.g2, .gx2, .gy2 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su2)); }
+.g4, .gx4, .gy4 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su4)); }
+.g6, .gx6, .gy6 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su6)); }
+.g8, .gx8, .gy8 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su8)); }
+.g12, .gx12, .gy12 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su12)); }
+.g16, .gx16, .gy16 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su16)); }
+.g24, .gx24, .gy24 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su24)); }
+.g32, .gx32, .gy32 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su32)); }
+.g48, .gx48, .gy48 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su48)); }
+.g64, .gx64, .gy64 { #stacks-internals #flex-builder-helpers .gap-spacing(var(--su64)); }
+
+
+// DEPRECATED - START
+//
 .gs2 { #stacks-internals #flex-builder-helpers .gutter-spacing(var(--su2)); }
 .gs4 { #stacks-internals #flex-builder-helpers .gutter-spacing(var(--su4)); }
 .gs6 { #stacks-internals #flex-builder-helpers .gutter-spacing(var(--su6)); }
@@ -227,6 +276,8 @@
         margin-left: 0;
     }
 }
+//
+// DEPRECATED - END
 
 
 //  ============================================================================

package/lib/css/atomic/gap.less

@@ -1,15 +1,15 @@
-#stacks-internals #responsify('.g0', { --_gap-x: 0; --_gap-y: 0; });
-#stacks-internals #responsify('.g1', { --_gap-x: var(--su1); --_gap-y: var(--su1); });
-#stacks-internals #responsify('.g2', { --_gap-x: var(--su2); --_gap-y: var(--su2); });
-#stacks-internals #responsify('.g4', { --_gap-x: var(--su4); --_gap-y: var(--su4); });
-#stacks-internals #responsify('.g6', { --_gap-x: var(--su6); --_gap-y: var(--su6); });
-#stacks-internals #responsify('.g8', { --_gap-x: var(--su8); --_gap-y: var(--su8); });
-#stacks-internals #responsify('.g12', { --_gap-x: var(--su12); --_gap-y: var(--su12); });
-#stacks-internals #responsify('.g16', { --_gap-x: var(--su16); --_gap-y: var(--su16); });
-#stacks-internals #responsify('.g24', { --_gap-x: var(--su24); --_gap-y: var(--su24); });
-#stacks-internals #responsify('.g32', { --_gap-x: var(--su32); --_gap-y: var(--su32); });
-#stacks-internals #responsify('.g48', { --_gap-x: var(--su48); --_gap-y: var(--su48); });
-#stacks-internals #responsify('.g64', { --_gap-x: var(--su64); --_gap-y: var(--su64); });
+#stacks-internals #responsify('.g0', { --_gap-y: 0; --_gap-x: 0; });
+#stacks-internals #responsify('.g1', { --_gap-y: var(--su1); --_gap-x: var(--su1); });
+#stacks-internals #responsify('.g2', { --_gap-y: var(--su2); --_gap-x: var(--su2); });
+#stacks-internals #responsify('.g4', { --_gap-y: var(--su4); --_gap-x: var(--su4); });
+#stacks-internals #responsify('.g6', { --_gap-y: var(--su6); --_gap-x: var(--su6); });
+#stacks-internals #responsify('.g8', { --_gap-y: var(--su8); --_gap-x: var(--su8); });
+#stacks-internals #responsify('.g12', { --_gap-y: var(--su12); --_gap-x: var(--su12); });
+#stacks-internals #responsify('.g16', { --_gap-y: var(--su16); --_gap-x: var(--su16); });
+#stacks-internals #responsify('.g24', { --_gap-y: var(--su24); --_gap-x: var(--su24); });
+#stacks-internals #responsify('.g32', { --_gap-y: var(--su32); --_gap-x: var(--su32); });
+#stacks-internals #responsify('.g48', { --_gap-y: var(--su48); --_gap-x: var(--su48); });
+#stacks-internals #responsify('.g64', { --_gap-y: var(--su64); --_gap-x: var(--su64); });
 
 #stacks-internals #responsify('.gx0', { --_gap-x: 0; });
 #stacks-internals #responsify('.gx1', { --_gap-x: var(--su1); });
@@ -40,5 +40,5 @@
 .gx0, .gx1, .gx2, .gx4, .gx6, .gx8, .gx12, .gx16, .gx24, .gx32, .gx48, .gx64,
 .gy0, .gy1, .gy2, .gy4, .gy6, .gy8, .gy12, .gy16, .gy24, .gy32, .gy48, .gy64,
 .g0, .g1, .g2, .g4, .g6, .g8, .g12, .g16, .g24, .g32, .g48, .g64 {
-  gap: var(--_gap-x, 0) var(--_gap-y, 0);
+  gap: var(--_gap-y, 0) var(--_gap-x, 0);
 }

package/lib/css/components/_styles-template.less

@@ -26,6 +26,12 @@
         --_cn-bg: transparent;
     }
 
+    // STATES
+    // These are generally classes prefixed with `.is-` or `.has-`
+    &.is-selected {
+        --_cn-bg: var(--orange-200);
+    }
+
     // MODIFIERS
     // Modifiers are considered to be classes that can be combined with other modifiers outside of their respective groupings without collisions
     // Sizes
@@ -51,14 +57,11 @@
     }
 
     // CHILD ELEMENTS
-    &--image {
+    & &--image {
         background-color: var(--_cn-image-bg);
     }
 
     // INTERACTION
-    .is-selected {
-        --_cn-bg: var(--orange-200);
-    }
     &:hover {
         --_cn-bg: var(--_black-050);
     }

package/lib/css/components/activity-indicator.less

@@ -3,19 +3,20 @@
     --_ai-bg: var(--theme-secondary-400);
     --_ai-fc: @white;
 
+    // CONTEXTUAL STYLES
     .highcontrast-mode({ --_ai-fc: var(--white); });
 
     // VARIANTS
     &&__success {
-        --_ai-bg-color: var(--green-500);
+        --_ai-bg: var(--green-500);
         --_ai-focus-ring: var(--focus-ring-success);
     }
     &&__warning {
-        --_ai-bg-color: var(--yellow-600);
+        --_ai-bg: var(--yellow-600);
         --_ai-focus-ring: var(--focus-ring-warning);
     }
     &&__danger {
-        --_ai-bg-color: var(--red-500);
+        --_ai-bg: var(--red-500);
         --_ai-focus-ring: var(--focus-ring-error);
     }
 

package/lib/css/components/avatars.less

@@ -5,6 +5,7 @@
     --_av-fs-letter: calc(var(--su-static12) - var(--su-static1));
     --_av-scale-badge: 1;
 
+    // CONTEXTUAL STYLES
     .highcontrast-mode({
         background-color: var(--black);
         box-shadow: 0 0 0 1px var(--black);
@@ -15,7 +16,7 @@
         }
     });
 
-    // VARIANTS
+    // MODIFIERS
     // Sizes
     &&__32,
     &&__48 {

package/lib/css/components/badges.less

@@ -10,19 +10,20 @@
     --_ba-py: 0;
     --_ba-wmn: 0;
 
+    // CONTEXTUAL STYLES
     .highcontrast-mode({
         // Badge counts
-        &__gold,
-        &__silver,
-        &__bronze,
+        &&__gold,
+        &&__silver,
+        &&__bronze,
         // Number counts
-        &__rep,
-        &__rep-down,
-        &__votes,
+        &&__rep,
+        &&__rep-down,
+        &&__votes,
         // Users
-        &__admin,
-        &__moderator,
-        &__staff {
+        &&__admin,
+        &&__moderator,
+        &&__staff {
             --_ba-bc: currentColor;
         }
     });
@@ -193,6 +194,7 @@
         }
     }
 
+    // CHILD ELEMENTS
     & &--image {
         display: inline-flex;
         align-self: center;
@@ -200,6 +202,7 @@
         margin-left: calc((var(--su4) + var(--su1)) * -1);
     }
 
+    // INTERACTION
     a&:hover {
         text-decoration: none;
     }

package/lib/css/components/cards.less

@@ -1,9 +1,12 @@
 .s-card {
     --_ca-bc: var(--bc-medium);
 
+    // CONTEXTUAL STYLES
     a& {
         text-decoration: none !important;
     }
+
+    // VARIANTS
     &&__muted {
         --_ca-bc: var(--bc-light);
 
@@ -18,7 +21,7 @@
         margin-bottom: 0;
     }
 
-    border: 1px solid var(--_ca-bc);
+    border: var(--su-static1) solid var(--_ca-bc);
 
     background-color: var(--white);
     border-radius: var(--br-sm);

package/lib/css/components/empty-states.less

@@ -1,9 +1,5 @@
 .s-empty-state {
-    color: var(--fc-light);
-    text-align: center;
-    margin-left: auto;
-    margin-right: auto;
-
+    // CHILD ELEMENTS
     p {
         font-size: var(--fs-body1);
         margin-bottom: var(--su12);
@@ -12,4 +8,9 @@
             color: var(--fc-dark);
         }
     }
+
+    color: var(--fc-light);
+    text-align: center;
+    margin-left: auto;
+    margin-right: auto;
 }

package/lib/css/components/expandable.less

@@ -29,76 +29,86 @@
 // (no longer visible) element itself to remain at the top, thereby forcing the excess pixels to be added
 // above the top, not below the bottom. And because extending content above the document top will not do
 // anything to the document height, there is no jumping during the transition.
-
-@stacks-internals-s-expandable-transition-duration: 100ms;
+// see custom property "--_ex-transition-duration"
 
 // Per the answer referenced above, the component can only guarantee smooth transitions if above a minimum
 // height and can only guarantee the element will be hidden is below a maximimum height.
 // The minimum height has been set at 10px because that's below the height of a single line of text in an s-description.
-@stacks-internal-s-expandable-min-expected-height: 10px;
-@stacks-internal-s-expandable-max-expected-height: 1500px;
+// see custom properties "--_ex-min-expected-height" and "--_ex-content-mb"
 
 .s-expandable {
-    display: flex;
-    -webkit-clip-path: polygon(-1000000px -1000000px, 1000000px -1000000px, 1000000px 1000000px, -1000000px 1000000px);
-    clip-path: polygon(-1000000px -1000000px, 1000000px -1000000px, 1000000px 1000000px, -1000000px 1000000px);
-    align-items: flex-start; // see comment above
-    transition: clip-path 0s @stacks-internals-s-expandable-transition-duration, -webkit-clip-path 0s @stacks-internals-s-expandable-transition-duration;
+    // CONSTANTS
+    --_ex-clip-path: polygon(-1000000px -1000000px, 1000000px -1000000px, 1000000px 1000000px, -1000000px 1000000px);
+    --_ex-min-expected-height: 10px;
+    --_ex-transition-duration: 100ms;
+    // VARIABLES
+    --_ex-after-h: 10px;
+    --_ex-after-hmx: 0;
+    --_ex-after-transition:
+        height var(--_ex-transition-duration) linear,
+        max-height 0s var(--_ex-transition-duration) linear;
+    --_ex-content-hmx: 1000000px;
+    --_ex-content-mb: 0;
+    --_ex-content-o: unset;
+    --_ex-content-transform: unset;
+    --_ex-content-transition:
+        margin-bottom var(--_ex-transition-duration) cubic-bezier(0, 0, 0, 1),
+        transform var(--_ex-transition-duration) cubic-bezier(1, 0, 1, 1),
+        opacity var(--_ex-transition-duration) cubic-bezier(1, 0, 1, 1);
 
+    &:not(.is-expanded) {
+        --_ex-after-h: 0;
+        --_ex-after-hmx: var(--_ex-min-expected-height);
+        --_ex-after-transition: height var(--_ex-min-expected-height) linear;
+        --_ex-content-hmx: 0;
+        --_ex-content-mb: -1500px;
+        --_ex-content-o: 0;
+        --_ex-content-transform: scaleY(0);
+        --_ex-content-transition:
+            margin-bottom var(--_ex-transition-duration) cubic-bezier(1, 0, 1, 1),
+            visibility 0s var(--_ex-transition-duration),
+            max-height 0s var(--_ex-transition-duration),
+            transform var(--_ex-transition-duration) cubic-bezier(0, 1, 1, 1),
+            opacity var(--_ex-transition-duration) cubic-bezier(0, 1, 1, 1);
+
+        & .s-expandable--content {
+            @supports ((-webkit-clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%)) or (clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%))) {
+                --_ex-content-o: 1;
+                --_ex-content-transform: none;
+            }
+        }
+
+        -webkit-clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%);
+        clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%);
+        overflow: hidden;
+        transition: none;
+    }
     &:after {
-        content: '';
+        height: var(--_ex-after-h);
+        max-height: var(--_ex-after-hmx);
+        transition: var(--_ex-after-transition);
+
         -ms-flex-preferred-size: 0;
+        content: '';
         flex-basis: 0;
-        height: @stacks-internal-s-expandable-min-expected-height;
-        max-height: 0;
-        transition:
-            height @stacks-internals-s-expandable-transition-duration linear,
-            max-height 0s @stacks-internals-s-expandable-transition-duration linear;
     }
-}
-
-.s-expandable--content {
-    -ms-flex-preferred-size: 100%;
-    flex-basis: 100%;
-    max-height: 1000000px;
-    margin-bottom: 0;
-    -webkit-transform-origin: 0 0;
-    transform-origin: 0 0;
-    transition:
-        margin-bottom @stacks-internals-s-expandable-transition-duration cubic-bezier(0, 0, 0, 1),
-        transform @stacks-internals-s-expandable-transition-duration cubic-bezier(1, 0, 1, 1),
-        opacity @stacks-internals-s-expandable-transition-duration cubic-bezier(1, 0, 1, 1);
-}
+    & &--content {
+        max-height: var(--_ex-content-hmx);
+        margin-bottom: var(--_ex-content-mb);
+        opacity: var(--_ex-content-o);
+        -webkit-transform: var(--_ex-content-transform);
+        transform: var(--_ex-content-transform);
 
-.s-expandable:not(.is-expanded) {
-    overflow: hidden;
-    -webkit-clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%);
-    clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%);
-    transition: none;
-
-    .s-expandable--content {
-        visibility: hidden;
-        max-height: 0;
-        margin-bottom: -@stacks-internal-s-expandable-max-expected-height;
-        opacity: 0;
-        -webkit-transform: scaleY(0);
-        transform: scaleY(0);
-        transition:
-            margin-bottom @stacks-internals-s-expandable-transition-duration cubic-bezier(1, 0, 1, 1),
-            visibility 0s @stacks-internals-s-expandable-transition-duration,
-            max-height 0s @stacks-internals-s-expandable-transition-duration,
-            transform @stacks-internals-s-expandable-transition-duration cubic-bezier(0, 1, 1, 1),
-            opacity @stacks-internals-s-expandable-transition-duration cubic-bezier(0, 1, 1, 1);
-        @supports ((-webkit-clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%)) or (clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%))) {
-            opacity: 1;
-            -webkit-transform: none;
-            transform: none;
-        }
+        -ms-flex-preferred-size: 100%;
+        flex-basis: 100%;
+        -webkit-transform-origin: 0 0;
+        transform-origin: 0 0;
+        transition: var(--_ex-content-transition);
     }
 
-    &:after {
-        height: 0;
-        max-height: @stacks-internal-s-expandable-min-expected-height;
-        transition: height @stacks-internals-s-expandable-transition-duration linear;
-    }
-}
+    align-items: flex-start; // see comment above
+    display: flex;
+    -webkit-clip-path: var(--_ex-clip-path);
+    clip-path: var(--_ex-clip-path);
+    transition: clip-path 0s var(--_ex-transition-duration), -webkit-clip-path 0s var(--_ex-transition-duration);
+  }

package/lib/css/components/labels.less

@@ -18,7 +18,7 @@
         cursor: not-allowed;
     }
 
-    // VARIANTS
+    // MODIFIERS
     // Sizes
     &&__sm {
         --_la-fs: var(--fs-caption);

package/lib/css/components/menu.less

@@ -3,11 +3,13 @@
     --_me-label-btc: var(--bc-light);
     --_me-label-cursor: pointer;
 
+    // CONTEXTUAL STYLES
     .dark-mode({
         --_me-divider-bg: var(--bc-lightest);
         --_me-label-btc: var(--bc-lightest);
     });
 
+    // CHILD ELEMENTS
     & &--divider {
         background-color: var(--_me-divider-bg);
         height: var(--su-static1);