@primer/css 0.0.0-1ea75fe → 0.0.0-202110100305

package/actionlist/action-list-item.scss

@@ -0,0 +1,444 @@
+@mixin focusOutline {
+  position: relative;
+  z-index: 1;
+  outline: none;
+  box-shadow: 0 0 0 2px var(--color-accent-fg); // this color breaks convention
+}
+
+// <li>
+.ActionList-item {
+  position: relative;
+  list-style: none;
+  background-color: transparent;
+  border-radius: $border-radius;
+
+  &:hover,
+  &:active {
+    cursor: pointer;
+
+    // a href
+    .ActionList-content {
+      text-decoration: none;
+    }
+  }
+
+  // only hover li without list as children
+  &:not(.ActionList-item--hasSubItem) {
+    &:hover {
+      cursor: pointer;
+      background-color: var(--color-action-list-item-default-hover-bg);
+    }
+
+    &:active {
+      background: var(--color-action-list-item-default-active-bg);
+
+      @media screen and (prefers-reduced-motion: no-preference) {
+        animation: ActionList-item-active-bg 4s forwards cubic-bezier(0.33, 1, 0.68, 1);
+      }
+
+      // stylelint-disable primer/box-shadow
+      @keyframes ActionList-item-active-bg {
+        // stylelint-disable-next-line max-nesting-depth
+        50% {
+          box-shadow: inset 0 0 0 rgba(#000, 0.04);
+          transform: scale(1);
+        }
+
+        // stylelint-disable-next-line max-nesting-depth
+        100% {
+          box-shadow: inset 0 3px 9px rgba(#000, 0.04);
+          transform: scale(0.97);
+        }
+      }
+      // stylelint-enable primer/box-shadow
+    }
+
+    &:hover,
+    &:active {
+      // hide dividers
+      // stylelint-disable-next-line selector-max-specificity
+      .ActionList-item-label::before,
+      + .ActionList-item .ActionList-item-label::before {
+        visibility: hidden;
+      }
+    }
+  }
+
+  // target contents of li if sub-item (li wraps item label + nested ul)
+  // collapse styles here
+  &.ActionList-item--hasSubItem {
+    // first child
+    > .ActionList-content {
+      &:hover {
+        background-color: var(--color-action-list-item-default-hover-bg);
+      }
+    }
+  }
+
+  // active state [aria-current]
+
+  &.ActionList-item--navActive:not(.ActionList-item--danger) {
+    background: var(--color-action-list-item-default-selected-bg);
+
+    // stylelint-disable-next-line selector-max-specificity
+    &::before,
+    + .ActionList-item::before {
+      visibility: hidden;
+    }
+
+    // blue accent line
+    &::after {
+      position: absolute;
+      top: calc(50% - 12px);
+      left: -$actionList-item-padding-horizontal;
+      width: $spacer-1;
+      height: $spacer-4;
+      content: '';
+      background: var(--color-accent-fg);
+      border-radius: $border-radius;
+    }
+  }
+
+  // collapsible item [aria-expanded]
+
+  &[aria-expanded='true'] {
+    .ActionList-item-collapseIcon {
+      transition: transform 120ms linear;
+      transform: scaleY(-1);
+    }
+
+    .ActionList--subGroup {
+      display: block;
+    }
+
+    &.ActionList-item--hasSubItem {
+      // stylelint-disable-next-line selector-max-specificity
+      > .ActionList-content > .ActionList-item-label {
+        font-weight: $font-weight-bold;
+      }
+    }
+  }
+
+  &[aria-expanded='false'] {
+    .ActionList-item-collapseIcon {
+      transition: transform 120ms linear;
+      transform: scaleY(1);
+    }
+
+    .ActionList--subGroup {
+      display: none;
+    }
+  }
+
+  // checkbox item [aria-checked]
+  // listbox [aria-selected]
+
+  &[aria-checked='true'],
+  &[aria-selected='true'] {
+    // multiselect checkmark
+    .ActionList-item-multiSelectCheckmark {
+      visibility: visible;
+      opacity: 1;
+      transition: visibility 0 linear 0, opacity $actionList-item-checkmark-transition-timing;
+    }
+
+    // singleselect checkmark
+    .ActionList-item-singleSelectCheckmark {
+      visibility: visible;
+
+      @media screen and (prefers-reduced-motion: no-preference) {
+        animation: checkmarkIn 200ms cubic-bezier(0.11, 0, 0.5, 0) forwards;
+      }
+    }
+
+    // checkbox
+    .ActionList-item-multiSelectIcon {
+      .ActionList-item-multiSelectIconRect {
+        fill: var(--color-accent-fg);
+        stroke: var(--color-accent-fg);
+        stroke-width: $border-width;
+      }
+
+      .ActionList-item-multiSelectCheckmark {
+        fill: var(--color-fg-on-emphasis);
+      }
+    }
+  }
+
+  &[aria-checked='false'],
+  &[aria-selected='false'] {
+    // multiselect checkmark
+    .ActionList-item-multiSelectCheckmark {
+      visibility: hidden;
+      opacity: 0;
+      transition:
+ visibility 0 linear $actionList-item-checkmark-transition-timing,
+        opacity $actionList-item-checkmark-transition-timing;
+    }
+
+    // singleselect checkmark
+    .ActionList-item-singleSelectCheckmark {
+      visibility: hidden;
+      transition: visibility 0s linear 200ms;
+      clip-path: inset(16px 0 0 0);
+
+      @media screen and (prefers-reduced-motion: no-preference) {
+        animation: checkmarkOut 200ms cubic-bezier(0.11, 0, 0.5, 0) forwards;
+      }
+    }
+
+    // checkbox
+    .ActionList-item-multiSelectIcon {
+      .ActionList-item-multiSelectIconRect {
+        fill: var(--color-canvas-default);
+        stroke: var(--color-border-default);
+        stroke-width: $border-width;
+      }
+    }
+
+    .ActionList-item-multiSelectIconRect {
+      fill: var(--color-canvas-default);
+      border: $border-width $border-style var(--color-border-default);
+    }
+  }
+
+  @keyframes checkmarkIn {
+    from {
+      clip-path: inset(16px 0 0 0);
+    }
+
+    to {
+      clip-path: inset(0 0 0 0);
+    }
+  }
+
+  @keyframes checkmarkOut {
+    from {
+      clip-path: inset(0 0 0 0);
+    }
+
+    to {
+      clip-path: inset(16px 0 0 0);
+    }
+  }
+
+  // variants
+
+  // danger
+  &.ActionList-item--danger {
+    .ActionList-item-label {
+      color: var(--color-danger-fg);
+    }
+
+    .ActionList-item-visual {
+      color: var(--color-danger-fg);
+    }
+
+    @media (hover: hover) and (pointer: fine) {
+      &:hover {
+        background: var(--color-action-list-item-danger-hover-bg);
+
+        // stylelint-disable-next-line max-nesting-depth
+        .ActionList-item-label {
+          color: var(--color-action-list-item-danger-hover-text);
+        }
+      }
+    }
+
+    &:active {
+      background: var(--color-action-list-item-danger-active-bg);
+    }
+  }
+
+  // disabled
+  &[aria-disabled='true'] {
+    .ActionList-item-label,
+    .ActionList-item-description {
+      color: var(--color-primer-fg-disabled);
+    }
+
+    .ActionList-item-visual {
+      fill: var(--color-primer-fg-disabled);
+    }
+
+    @media (hover: hover) and (pointer: fine) {
+      &:hover {
+        cursor: not-allowed;
+        background-color: transparent;
+      }
+    }
+  }
+
+  // if nested list exists, remove default padding
+  .ActionList {
+    // stylelint-disable-next-line primer/spacing
+    padding: unset;
+  }
+}
+
+// span or a href
+.ActionList-content {
+  position: relative;
+  display: grid;
+  // stylelint-disable-next-line primer/spacing
+  padding: $actionList-item-padding-vertical $actionList-item-padding-horizontal;
+  font-weight: $font-weight-normal;
+  color: var(--color-fg-default);
+  user-select: none;
+  border-radius: $border-radius;
+  transition: $actionList-item-bg-transition;
+  grid-template-rows: min-content;
+  grid-template-areas: 'leadingAction leadingVisual label trailingVisual trailingAction';
+  grid-template-columns: min-content min-content minmax(min-content, auto) min-content min-content;
+  align-items: center;
+
+  // column-gap persists with empty grid-areas, margin applies only when children exist
+  > :not(:last-child) {
+    margin-right: $spacer-2;
+  }
+
+  &:focus-visible {
+    @include focusOutline;
+  }
+
+  // sizes
+
+  &.ActionList-content--sizeMedium {
+    // 44px total height
+    // stylelint-disable-next-line primer/spacing
+    padding: $actionList-item-padding-vertical-md $actionList-item-padding-horizontal;
+  }
+
+  &.ActionList-content--sizeLarge {
+    // 48px total height
+    // stylelint-disable-next-line primer/spacing
+    padding: $actionList-item-padding-vertical-lg $actionList-item-padding-horizontal;
+  }
+
+  // On pointer:coarse (mobile), all list items are large
+  @media (pointer: coarse) {
+    // stylelint-disable-next-line primer/spacing
+    padding: $actionList-item-padding-vertical-lg $actionList-item-padding-horizontal;
+  }
+
+  &.ActionList-content--blockDescription {
+    // if leading/trailing visual, align with first line of content
+    .ActionList-item-visual {
+      place-self: start;
+    }
+  }
+}
+
+// place children on grid
+
+.ActionList-item-action--leading {
+  grid-area: leadingAction;
+}
+
+.ActionList-item-visual--leading {
+  grid-area: leadingVisual;
+}
+
+.ActionList-item-label {
+  grid-area: label;
+}
+
+.ActionList-item-visual--trailing {
+  grid-area: trailingVisual;
+}
+
+.ActionList-item-action--trailing {
+  grid-area: trailingAction;
+}
+
+// wrapper span
+// default block
+.ActionList-item-descriptionWrap {
+  grid-area: label;
+  display: flex;
+  flex-direction: column;
+
+  .ActionList-item-description {
+    margin-top: $spacer-1;
+  }
+
+  .ActionList-item-label {
+    font-weight: $font-weight-bold;
+  }
+}
+
+// inline
+.ActionList-item-descriptionWrap--inline {
+  flex-direction: row;
+  align-items: baseline;
+
+  .ActionList-item-description {
+    // stylelint-disable-next-line primer/spacing
+    margin-left: $actionList-item-padding-horizontal;
+  }
+}
+
+// description
+.ActionList-item-description {
+  font-size: $font-size-small;
+  font-weight: $font-weight-normal;
+  line-height: $lh-default;
+  color: var(--color-fg-muted);
+}
+
+// helper for grid alignment with multi-line content
+// span wrapping svg or text
+.ActionList-item-visual,
+.ActionList-item-action {
+  display: flex;
+  min-height: $actionList-item-height-sm;
+  color: var(--color-fg-muted); // if visual is text
+  fill: var(--color-fg-muted);
+  align-items: center;
+}
+
+// text
+// stylelint-disable-next-line no-duplicate-selectors
+.ActionList-item-label {
+  position: relative; // for pseudo dividers
+  font-weight: $font-weight-normal;
+  // we need a strict value here for grid alignment
+  // stylelint-disable-next-line primer/typography
+  line-height: $actionList-item-label-line-height;
+  color: var(--color-fg-default);
+}
+
+// nested lists (only supports 1 level currently)
+// target ActionList-item--subItem for padding-left to maintain :active :after state
+
+.ActionList-item--subItem > .ActionList-content {
+  font-size: $font-size-small;
+}
+
+// no leading visual
+.ActionList--subGroup {
+  .ActionList-item--subItem {
+    padding-left: $spacer-3;
+  }
+}
+
+// has 16px leading visual
+.ActionList-content--visual16 + .ActionList--subGroup {
+  .ActionList-item--subItem {
+    padding-left: $spacer-4;
+  }
+}
+
+// has 20px leading visual
+.ActionList-content--visual20 + .ActionList--subGroup {
+  .ActionList-item--subItem {
+    padding-left: $spacer-3 * 1.75;
+  }
+}
+
+// has 24px leading visual
+.ActionList-content--visual24 + .ActionList--subGroup {
+  .ActionList-item--subItem {
+    padding-left: $spacer-5;
+  }
+}

package/actionlist/action-list-variables.scss

@@ -0,0 +1,8 @@
+$actionList-item-height-sm: $spacer-2 * 2.5 !default;
+$actionList-item-label-line-height: $spacer-2 * 2.5 !default;
+$actionList-item-padding-vertical-md: $spacer-2 * 1.25 !default;
+$actionList-item-padding-vertical-lg: $spacer-2 * 1.75 !default;
+$actionList-item-padding-vertical: $spacer-1 * 1.5 !default;
+$actionList-item-padding-horizontal: $spacer-2 !default;
+$actionList-item-bg-transition: background 33.333ms linear !default; // 2 frames on a 60hz monitor
+$actionList-item-checkmark-transition-timing: 50ms !default;

package/actionlist/action-list.scss

@@ -0,0 +1,33 @@
+// <ul>
+.ActionList {
+  padding: $spacer-2;
+}
+
+// dividers
+
+.ActionList--divided {
+  .ActionList-item-label::before {
+    position: absolute;
+    top: -$actionList-item-padding-vertical;
+    display: block;
+    width: 100%;
+    height: 1px;
+    content: '';
+    background: var(--color-action-list-item-inline-divider);
+  }
+
+  // hide divider if item is active
+  .ActionList-item--navActive {
+    // stylelint-disable-next-line selector-max-specificity, selector-max-compound-selectors
+    .ActionList-item-label::before,
+    + .ActionList-item .ActionList-item-label::before {
+      visibility: hidden;
+    }
+  }
+}
+
+// hide if item is first of type with label::before, or is the first item after a sectionDivider
+.ActionList-item:first-of-type .ActionList-item-label::before,
+.ActionList-sectionDivider + .ActionList-item .ActionList-item-label::before {
+  visibility: hidden;
+}

package/actionlist/index.scss

@@ -0,0 +1,5 @@
+@import '../support/index.scss';
+@import './action-list-variables.scss';
+@import './action-list.scss';
+@import './action-list-item.scss';
+@import './action-list-item-divider.scss';

package/alerts/README.md

@@ -1,36 +1,25 @@
-# Primer Alerts
-> Flash messages, or alerts, inform users of successful or pending actions. Use them sparingly. Don’t show more than one at a time.
+---
+bundle: "alerts"
+generated: true
+---
 
-This repository is a module of the full [Primer CSS][primer] repository.
+# Primer CSS: `alerts` bundle
 
 ## Usage
 
-The source files included are written in [Sass][sass] (`scss`) You can simply point your sass `include-path` at your `node_modules` directory and import it like this.
+Primer CSS source files are written in [SCSS]. To include this Primer CSS module in your own build, ensure that your `node_modules` directory is listed in your Sass include paths, then import it with:
 
 ```scss
-@import "primer-alerts/index.scss";
+@import "@primer/css/alerts/index.scss";
 ```
 
-You can also import specific portions of the module by importing those partials from the `/lib/` folder. _Make sure you import any requirements along with the modules._
-
 ## Build
 
-For a compiled **css** version of this module, a npm script is included that will output a css version to `build/build.css` The built css file is also included in the npm package.
-
-```
-$ npm run build
-```
-
-## Documentation
-
-Find further documentation at [primer.style/css/components/alerts](https://primer.style/css/components/alerts).
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/alerts.css`.
 
 ## License
 
-[MIT](./LICENSE) © [GitHub](https://github.com/)
+[MIT](https://github.com/primer/css/blob/main/LICENSE) © [GitHub](https://github.com/)
+
 
-[primer]: https://github.com/primer/css
-[docs]: https://primer.style/css
-[npm]: https://www.npmjs.com/
-[install-npm]: https://docs.npmjs.com/getting-started/installing-node
-[sass]: http://sass-lang.com/
+[scss]: https://sass-lang.com/documentation/syntax#scss

package/alerts/flash.scss

@@ -1,16 +1,22 @@
+// stylelint-disable selector-max-type, no-duplicate-selectors
+
 // Default flash
-// stylelint-disable selector-max-type
 .flash {
   position: relative;
-  padding: $spacer-3;
-  color: $blue-800;
-  background-color: $blue-100;
-  border: 1px solid $border-black-fade;
-  border-radius: 3px;
+  // stylelint-disable-next-line primer/spacing
+  padding: 20px $spacer-3;
+  border-style: $border-style;
+  border-width: $border-width;
+  border-radius: $border-radius;
 
   p:last-child {
     margin-bottom: 0;
   }
+
+  .octicon {
+    // stylelint-disable-next-line primer/spacing
+    margin-right: 12px;
+  }
 }
 
 // Contain the flash messages
@@ -23,59 +29,123 @@
   float: right;
   padding: $spacer-3;
   margin: -$spacer-3;
-  color: inherit;
   text-align: center;
   cursor: pointer;
+
   // Undo `<button>` styles
   background: none;
   border: 0;
   appearance: none;
-  opacity: 0.6;
 
   &:hover {
-    opacity: 1;
+    opacity: 0.7;
+  }
+
+  &:active {
+    opacity: 0.5;
+  }
+
+  .octicon {
+    margin-right: 0;
   }
 }
 
 // Action button
 .flash-action {
   float: right;
+  // stylelint-disable-next-line primer/spacing
   margin-top: -3px;
   margin-left: $spacer-4;
+  background-clip: padding-box;
+
+  &.btn .octicon {
+    margin-right: $spacer-1;
+    color: var(--color-fg-muted);
+  }
+
+  &.btn-primary .octicon {
+    color: inherit;
+  }
 }
 
 //
-// Variations
+// Color variations
 //
 
+.flash {
+  color: var(--color-fg-default);
+  background-image: linear-gradient(var(--color-accent-subtle), var(--color-accent-subtle));
+  border-color: var(--color-accent-muted);
+
+  .octicon {
+    color: var(--color-accent-fg);
+  }
+}
+
 .flash-warn {
-  color: $yellow-900;
-  background-color: $yellow-100;
-  border-color: $black-fade-15;
+  color: var(--color-fg-default);
+  background-image: linear-gradient(var(--color-attention-subtle), var(--color-attention-subtle));
+  border-color: var(--color-attention-muted);
+
+  .octicon {
+    color: var(--color-attention-fg);
+  }
 }
 
 .flash-error {
-  color: $red-900;
-  background-color: $red-100;
-  border-color: $black-fade-15;
+  color: var(--color-fg-default);
+  background-image: linear-gradient(var(--color-danger-subtle), var(--color-danger-subtle));
+  border-color: var(--color-danger-muted);
+
+  .octicon {
+    color: var(--color-danger-fg);
+  }
 }
 
 .flash-success {
-  color: $green-800;
-  background-color: $green-100;
-  border-color: $black-fade-15;
+  color: var(--color-fg-default);
+  background-image: linear-gradient(var(--color-success-subtle), var(--color-success-subtle));
+  border-color: var(--color-success-muted);
+
+  .octicon {
+    color: var(--color-success-fg);
+  }
 }
 
+//
+// Layout variations
+//
+
 .flash-full {
+  // stylelint-disable-next-line primer/spacing
   margin-top: -1px;
-  border-width: 1px 0;
+  border-width: $border-width 0;
+  border-radius: 0;
+}
+
+// A banner rendered at the top of the page.
+.flash-banner {
+  position: fixed;
+  top: 0;
+  z-index: 90;
+  width: 100%;
+  border-top: 0;
+  border-right: 0;
+  border-left: 0;
   border-radius: 0;
 }
 
+// Makes sure the background is opaque to cover any content underneath
+.flash-full,
+.flash-banner {
+  background-color: var(--color-canvas-default);
+}
+
 // FIXME deprecate this
 .warning {
   padding: $em-spacer-5;
+  // stylelint-disable-next-line primer/spacing
   margin-bottom: 0.8em;
   font-weight: $font-weight-bold;
-  background-color: $yellow-100;
+  background-color: var(--color-attention-subtle);
 }