github-docs 0.0.1

data/_sass/primer-utilities/borders.scss

@@ -0,0 +1,100 @@
+// Border utilities
+// stylelint-disable block-opening-brace-space-before, primer/selector-no-utility, comment-empty-line-before
+
+/* Add a gray border on all sides */
+.border { border: $border !important; }
+
+/* Add a gray border to the left and right */
+.border-y {
+  border-top: $border !important;
+  border-bottom: $border !important;
+}
+
+/* Remove borders from all sides */
+.border-0 { border: 0 !important; }
+
+.border-dashed { border-style: dashed !important; }
+
+/* Use with .border to turn the border blue */
+.border-blue        { border-color: $border-blue !important; }
+/* Use with .border to turn the border blue-light */
+.border-blue-light  { border-color: $border-blue-light !important; }
+/* Use with .border to turn the border green */
+.border-green       { border-color: $border-green !important; }
+/* Use with .border to turn the border green light */
+.border-green-light { border-color: $border-green-light !important; }
+/* Use with .border to turn the border red */
+.border-red         { border-color: $border-red !important; }
+/* Use with .border to turn the border red-light */
+.border-red-light   { border-color: $border-red-light !important; }
+/* Use with .border to turn the border purple */
+.border-purple      { border-color: $border-purple !important; }
+/* Use with .border to turn the border yellow */
+.border-yellow      { border-color: $border-yellow !important; }
+/* Use with .border to turn the border gray-light */
+.border-gray-light  { border-color: $border-gray-light !important; }
+/* Use with .border to turn the border gray-dark */
+.border-gray-dark   { border-color: $border-gray-dark !important; }
+/* Use with .border to turn the border rgba black 0.15 */
+.border-black-fade  { border-color: $border-black-fade !important; }
+
+$edges: (
+  top: (top-left, top-right),
+  right: (top-right, bottom-right),
+  bottom: (bottom-right, bottom-left),
+  left: (bottom-left, top-left)
+);
+
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    /* Add a gray border */
+    /* Add a gray border to the top */
+    .border#{$variant}-top    { border-top: $border !important; }
+    /* Add a gray border to the right */
+    .border#{$variant}-right  { border-right: $border !important; }
+    /* Add a gray border to the bottom */
+    .border#{$variant}-bottom { border-bottom: $border !important; }
+    /* Add a gray border to the left */
+    .border#{$variant}-left   { border-left: $border !important; }
+
+    /* Remove the top border */
+    .border#{$variant}-top-0    { border-top: 0 !important; }
+    /* Remove the right border */
+    .border#{$variant}-right-0  { border-right: 0 !important; }
+    /* Remove the bottom border */
+    .border#{$variant}-bottom-0 { border-bottom: 0 !important; }
+    /* Remove the left border */
+    .border#{$variant}-left-0   { border-left: 0 !important; }
+
+    // Rounded corners
+    /* Remove the border-radius */
+    .rounded#{$variant}-0 { border-radius: 0 !important; }
+    /* Add a border-radius to all corners */
+    .rounded#{$variant}-1 { border-radius: $border-radius !important; }
+    /* Add a 2x border-radius to all corners */
+    .rounded#{$variant}-2 { border-radius: $border-radius * 2 !important; }
+
+    @each $edge, $corners in $edges {
+      .rounded#{$variant}-#{$edge}-0 {
+        @each $corner in $corners {
+          border-#{$corner}-radius: 0 !important;
+        }
+      }
+
+      .rounded#{$variant}-#{$edge}-1 {
+        @each $corner in $corners {
+          border-#{$corner}-radius: $border-radius !important;
+        }
+      }
+
+      .rounded#{$variant}-#{$edge}-2 {
+        @each $corner in $corners {
+          border-#{$corner}-radius: $border-radius * 2 !important;
+        }
+      }
+    }
+  }
+}
+
+/* Add a 50% border-radius to make something into a circle */
+.circle { border-radius: 50% !important; }

data/_sass/primer-utilities/box-shadow.scss

@@ -0,0 +1,26 @@
+// Box shadow utilities
+// stylelint-disable primer/selector-no-utility
+
+// Box shadows
+
+.box-shadow {
+  box-shadow: $box-shadow !important;
+}
+
+.box-shadow-medium {
+  box-shadow: $box-shadow-medium !important;
+}
+
+.box-shadow-large {
+  box-shadow: $box-shadow-large !important;
+}
+
+.box-shadow-extra-large {
+  box-shadow: $box-shadow-extra-large !important;
+}
+
+// Turn off box shadow
+
+.box-shadow-none {
+  box-shadow: none !important;
+}

data/_sass/primer-utilities/colors.scss

@@ -0,0 +1,106 @@
+// Color utilities
+// stylelint-disable block-opening-brace-space-before, primer/selector-no-utility
+// stylelint-disable comment-empty-line-before
+
+// background colors
+/* Set the background to $bg-white */
+.bg-white      { background-color: $bg-white !important; }
+/* Set the background to $bg-blue */
+.bg-blue       { background-color: $bg-blue !important; }
+/* Set the background to $bg-blue-light */
+.bg-blue-light { background-color: $bg-blue-light !important; }
+/* Set the background to $bg-gray-dark */
+.bg-gray-dark  { background-color: $bg-gray-dark !important; }
+/* Set the background to $bg-gray */
+.bg-gray       { background-color: $bg-gray !important; }
+/* Set the background to $bg-gray-light */
+.bg-gray-light { background-color: $bg-gray-light !important; }
+/* Set the background to $bg-green */
+.bg-green      { background-color: $bg-green !important; }
+/* Set the background to $bg-green-light */
+.bg-green-light     { background-color: $bg-green-light !important; }
+/* Set the background to $bg-red */
+.bg-red        { background-color: $bg-red !important; }
+/* Set the background to $bg-red-light */
+.bg-red-light  { background-color: $bg-red-light !important; }
+/* Set the background to $bg-yellow */
+.bg-yellow     { background-color: $bg-yellow !important; }
+/* Set the background to $bg-yellow-light */
+.bg-yellow-light     { background-color: $bg-yellow-light !important; }
+/* Set the background to $bg-purple */
+.bg-purple     { background-color: $bg-purple !important; }
+/* Set the background to $bg-purple-light */
+.bg-purple-light     { background-color: $bg-purple-light !important; }
+
+.bg-shade-gradient {
+  background-image: linear-gradient(180deg, rgba($black, 0.065), rgba($black, 0)) !important;
+  background-repeat: no-repeat !important;
+  background-size: 100% 200px !important;
+}
+
+// text colors
+/* Set the text color to $text-blue */
+.text-blue          { color: $text-blue !important; }
+/* Set the text color to $text-red */
+.text-red           { color: $text-red !important; }
+/* Set the text color to $text-gray-light */
+.text-gray-light    { color: $text-gray-light !important; }
+/* Set the text color to $text-gray */
+.text-gray          { color: $text-gray !important; }
+/* Set the text color to $text-gray-dark */
+.text-gray-dark     { color: $text-gray-dark !important; }
+/* Set the text color to $text-green */
+.text-green         { color: $text-green !important; }
+/* Set the text color to $text-orange */
+.text-orange        { color: $text-orange !important; }
+/* Set the text color to $text-orange-light */
+.text-orange-light        { color: $text-orange-light !important; }
+/* Set the text color to $text-purple */
+.text-purple        { color: $text-purple !important; }
+/* Set the text color to $text-white */
+.text-white         { color: $text-white !important; }
+/* Set the text color to inherit */
+.text-inherit       { color: inherit !important; }
+
+// Text states
+// These can probably all be regular utilities
+.text-pending { color: $yellow-800 !important; }
+// Separate text and background colors in future to improve a11y
+.bg-pending { color: $yellow-700 !important; }
+
+// Link colors
+// Sets the links color to $text-gray and $text-blue on hover
+.link-gray {
+  color: $text-gray !important;
+
+  &:hover {
+    color: $text-blue !important;
+  }
+}
+
+// Sets the links color to $text-gray-dark and $text-blue on hover
+.link-gray-dark {
+  color: $text-gray-dark !important;
+
+  &:hover {
+    color: $text-blue !important;
+  }
+}
+
+/* Set the link color to $text-blue on hover
+  Useful when you want only part of a link to turn blue on hover */
+.link-hover-blue {
+  &:hover {
+    color: $text-blue !important;
+  }
+}
+
+/* Make a link $text-gray, then $text-blue on hover and removes the underline */
+.muted-link {
+  color: $text-gray !important;
+
+  &:hover {
+    color: $text-blue !important;
+    text-decoration: none;
+  }
+}

data/_sass/primer-utilities/details.scss

@@ -0,0 +1,18 @@
+// stylelint-disable selector-max-type
+.details-overlay[open] > summary::before {
+  position: fixed;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: 0;
+  z-index: 80;
+  display: block;
+  cursor: default;
+  content: " ";
+  background: transparent;
+}
+
+.details-overlay-dark[open] > summary::before {
+  z-index: 99;
+  background: $black-fade-50;
+}

data/_sass/primer-utilities/flexbox.scss

@@ -0,0 +1,52 @@
+// Flex utility classes
+// stylelint-disable block-opening-brace-space-after, block-opening-brace-space-before
+// stylelint-disable comment-empty-line-before
+
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    // Flexbox classes
+    // Container
+    .flex#{$variant}-row         { flex-direction: row !important; }
+    .flex#{$variant}-row-reverse { flex-direction: row-reverse !important; }
+    .flex#{$variant}-column      { flex-direction: column !important; }
+
+    .flex#{$variant}-wrap     { flex-wrap: wrap !important; }
+    .flex#{$variant}-nowrap   { flex-wrap: nowrap !important; }
+
+    .flex#{$variant}-justify-start    { justify-content: flex-start !important; }
+    .flex#{$variant}-justify-end      { justify-content: flex-end !important; }
+    .flex#{$variant}-justify-center   { justify-content: center !important; }
+    .flex#{$variant}-justify-between  { justify-content: space-between !important; }
+    .flex#{$variant}-justify-around   { justify-content: space-around !important; }
+
+    .flex#{$variant}-items-start      { align-items: flex-start !important; }
+    .flex#{$variant}-items-end        { align-items: flex-end !important; }
+    .flex#{$variant}-items-center     { align-items: center !important; }
+    .flex#{$variant}-items-baseline   { align-items: baseline !important; }
+    .flex#{$variant}-items-stretch    { align-items: stretch !important; }
+
+    .flex#{$variant}-content-start    { align-content: flex-start !important; }
+    .flex#{$variant}-content-end      { align-content: flex-end !important; }
+    .flex#{$variant}-content-center   { align-content: center !important; }
+    .flex#{$variant}-content-between  { align-content: space-between !important; }
+    .flex#{$variant}-content-around   { align-content: space-around !important; }
+    .flex#{$variant}-content-stretch  { align-content: stretch !important; }
+
+    // Item
+    .flex#{$variant}-auto { flex: 1 1 auto !important; }
+    .flex#{$variant}-shrink-0 { flex-shrink: 0 !important; }
+
+    .flex#{$variant}-self-auto        { align-self: auto !important; }
+    .flex#{$variant}-self-start       { align-self: flex-start !important; }
+    .flex#{$variant}-self-end         { align-self: flex-end !important; }
+    .flex#{$variant}-self-center      { align-self: center !important; }
+    .flex#{$variant}-self-baseline    { align-self: baseline !important; }
+    .flex#{$variant}-self-stretch     { align-self: stretch !important; }
+
+    // Shorthand for equal width and height cols
+    .flex#{$variant}-item-equal {
+      flex-grow: 1;
+      flex-basis: 0;
+    }
+  }
+}

data/_sass/primer-utilities/index.scss

@@ -0,0 +1,13 @@
+// utilities
+@import "./animations.scss";
+@import "./borders.scss";
+@import "./box-shadow.scss";
+@import "./colors.scss";
+@import "./details.scss";
+@import "./flexbox.scss";
+@import "./layout.scss";
+@import "./margin.scss";
+@import "./padding.scss";
+@import "./typography.scss";
+// Visibility and display should always come last in the imports so that they override other utilities with !important
+@import "./visibility-display.scss";

data/_sass/primer-utilities/layout.scss

@@ -0,0 +1,85 @@
+// Layout
+// stylelint-disable block-opening-brace-space-after, block-opening-brace-space-before, primer/selector-no-utility
+// stylelint-disable comment-empty-line-before
+
+/* Set position to static */
+.position-static   { position: static !important; }
+/* Set position to relative */
+.position-relative { position: relative !important; }
+/* Set position to absolute */
+.position-absolute { position: absolute !important; }
+/* Set position to fixed */
+.position-fixed    { position: fixed !important; }
+
+/* Set top 0 */
+.top-0    { top: 0 !important; }
+/* Set right 0 */
+.right-0  { right: 0 !important; }
+/* Set bottom 0 */
+.bottom-0 { bottom: 0 !important; }
+/* Set left 0 */
+.left-0   { left: 0 !important; }
+
+/* Vertical align middle */
+.v-align-middle      { vertical-align: middle !important; }
+/* Vertical align top */
+.v-align-top         { vertical-align: top !important; }
+/* Vertical align bottom */
+.v-align-bottom      { vertical-align: bottom !important; }
+/* Vertical align to the top of the text */
+.v-align-text-top    { vertical-align: text-top !important; }
+/* Vertical align to the bottom of the text */
+.v-align-text-bottom { vertical-align: text-bottom !important; }
+/* Vertical align to the parent's baseline */
+.v-align-baseline    { vertical-align: baseline !important; }
+
+// Overflow utilities
+// overflow-hidden can also be used to create a new
+// block formatting context or clear floats.
+/* Set the overflow hidden */
+.overflow-hidden { overflow: hidden !important; }
+/* Set the overflow scroll */
+.overflow-scroll { overflow: scroll !important; }
+/* Set the overflow auto */
+.overflow-auto   { overflow: auto !important; }
+
+// Clear floats
+/* Clear floats around the element */
+.clearfix {
+  @include clearfix;
+}
+
+// Floats
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    /* Float to the left */
+    .float#{$variant}-left  { float: left !important; }
+    /* Float to the right */
+    .float#{$variant}-right  { float: right !important; }
+    /* No float */
+    .float#{$variant}-none { float: none !important; }
+  }
+}
+
+// Width and height utilities, helpful in combination
+// with display-table utilities and images
+/* Max width 100% */
+.width-fit   { max-width: 100% !important; }
+/* Set the width to 100% */
+.width-full  { width: 100% !important; }
+/* Max height 100% */
+.height-fit  { max-height: 100% !important; }
+/* Set the height to 100% */
+.height-full { height: 100% !important; }
+
+/* Remove min-width from element */
+.min-width-0 { min-width: 0 !important; }
+
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    /* Set the direction to rtl */
+    .direction#{$variant}-rtl { direction: rtl !important; }
+    /* Set the direction to ltr */
+    .direction#{$variant}-ltr { direction: ltr !important; }
+  }
+}

data/_sass/primer-utilities/margin.scss

@@ -0,0 +1,53 @@
+// Margin spacer utilities
+// stylelint-disable block-opening-brace-space-before, declaration-colon-space-before, primer/selector-no-utility, comment-empty-line-before
+
+// Loop through the breakpoint values
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    // Loop through the spacer values
+    @for $i from 1 through length($spacers) {
+      $size: nth($spacers, $i); // sm, md, lg, xl
+      $scale: $i - 1;  // 0, 1, 2, 3, 4, 5, 6
+
+      /* Set a $size margin to all sides at $breakpoint */
+      .m#{$variant}-#{$scale}  { margin: $size !important; }
+      /* Set a $size margin on the top at $breakpoint */
+      .mt#{$variant}-#{$scale} { margin-top: $size !important; }
+      /* Set a $size margin on the right at $breakpoint */
+      .mr#{$variant}-#{$scale} { margin-right: $size !important; }
+      /* Set a $size margin on the bottom at $breakpoint */
+      .mb#{$variant}-#{$scale} { margin-bottom: $size !important; }
+      /* Set a $size margin on the left at $breakpoint */
+      .ml#{$variant}-#{$scale} { margin-left: $size !important; }
+
+      @if ($size != 0) {
+        /* Set a negative $size margin on top at $breakpoint */
+        .mt#{$variant}-n#{$scale} { margin-top   : -$size !important; }
+        /* Set a negative $size margin on the right at $breakpoint */
+        .mr#{$variant}-n#{$scale} { margin-right : -$size !important; }
+        /* Set a negative $size margin on the bottom at $breakpoint */
+        .mb#{$variant}-n#{$scale} { margin-bottom: -$size !important; }
+        /* Set a negative $size margin on the left at $breakpoint */
+        .ml#{$variant}-n#{$scale} { margin-left  : -$size !important; }
+      }
+
+      /* Set a $size margin on the left & right at $breakpoint */
+      .mx#{$variant}-#{$scale} {
+        margin-right: $size !important;
+        margin-left: $size !important;
+      }
+
+      /* Set a $size margin on the top & bottom at $breakpoint */
+      .my#{$variant}-#{$scale} {
+        margin-top: $size !important;
+        margin-bottom: $size !important;
+      }
+    }
+
+    /* responsive horizontal auto margins */
+    .mx#{$variant}-auto {
+      margin-right: auto !important;
+      margin-left: auto !important;
+    }
+  }
+}

data/_sass/primer-utilities/padding.scss

@@ -0,0 +1,54 @@
+// Padding spacer utilities
+// stylelint-disable block-opening-brace-space-before, declaration-colon-space-before
+// stylelint-disable comment-empty-line-before
+
+// Responsive padding spacer utilities
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    // Loop through the spacer values
+    @for $i from 1 through length($spacers) {
+      $size: nth($spacers, $i); // xs, sm, md, lg, xl
+      $scale: $i - 1;  // 0, 1, 2, 3, 4, 5, 6
+
+      /* Set a $size padding to all sides at $breakpoint */
+      .p#{$variant}-#{$scale}  { padding: $size !important; }
+      /* Set a $size padding to the top at $breakpoint */
+      .pt#{$variant}-#{$scale} { padding-top: $size !important; }
+      /* Set a $size padding to the right at $breakpoint */
+      .pr#{$variant}-#{$scale} { padding-right: $size !important; }
+      /* Set a $size padding to the bottom at $breakpoint */
+      .pb#{$variant}-#{$scale} { padding-bottom: $size !important; }
+      /* Set a $size padding to the left at $breakpoint */
+      .pl#{$variant}-#{$scale} { padding-left: $size !important; }
+
+      /* Set a $size padding to the left & right at $breakpoint */
+      .px#{$variant}-#{$scale} {
+        padding-right: $size !important;
+        padding-left: $size !important;
+      }
+
+      /* Set a $size padding to the top & bottom at $breakpoint */
+      .py#{$variant}-#{$scale} {
+        padding-top: $size !important;
+        padding-bottom: $size !important;
+      }
+    }
+  }
+}
+
+// responsive padding for containers
+// stylelint-disable-next-line primer/selector-no-utility
+.p-responsive {
+  padding-right: $spacer-3 !important;
+  padding-left: $spacer-3 !important;
+
+  @include breakpoint(sm) {
+    padding-right: $spacer-6 !important;
+    padding-left: $spacer-6 !important;
+  }
+
+  @include breakpoint(lg) {
+    padding-right: $spacer-3 !important;
+    padding-left: $spacer-3 !important;
+  }
+}