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

package/blankslate/blankslate.scss

@@ -3,17 +3,23 @@
   position: relative;
   padding: $spacer-5;
   text-align: center;
-  background-color: $gray-000;
-  border: 1px solid $gray-200;
-  border-radius: 3px;
-  box-shadow: inset 0 0 10px rgba($black, 0.05);
+
+  p {
+    color: var(--color-fg-muted);
+  }
 
   code {
+    // stylelint-disable-next-line primer/spacing
     padding: 2px 5px 3px;
     font-size: $h5-size;
-    background: $bg-white;
-    border: 1px solid $border-gray-light;
-    border-radius: 3px;
+    background: var(--color-canvas-default);
+    border: $border-width $border-style var(--color-border-muted);
+    border-radius: $border-radius;
+  }
+
+  img {
+    width: 56px;
+    height: 56px;
   }
 }
 
@@ -21,14 +27,15 @@
   margin-right: $spacer-1;
   margin-bottom: $spacer-2;
   margin-left: $spacer-1;
-  color: lighten($gray-400, 5%);
+  color: var(--color-fg-muted);
 }
 
 .blankslate-capped {
-  border-radius: 0 0 3px 3px;
+  border-radius: 0 0 $border-radius $border-radius;
 }
 
 .blankslate-spacious {
+  // stylelint-disable-next-line primer/spacing
   padding: ($spacer-6 * 2) $spacer-6;
 }
 
@@ -38,10 +45,17 @@
 }
 
 // was .large-format
+// QUESTION: should we deprecate this?
 .blankslate-large {
+  img {
+    width: 80px;
+    height: 80px;
+  }
+
   h3 {
     margin: $spacer-3 0;
-    font-size: $h3-size;
+    //font-size: $h3-size; // This doesn't actually make the text larger. Should this be $h2-size?
+    font-size: $h2-size;
   }
 
   p {
@@ -50,8 +64,7 @@
 }
 
 // was .clean-background
+// TO DO: deprecate this and use utility instead
 .blankslate-clean-background {
-  background: none;
   border: 0;
-  box-shadow: none;
 }

package/blankslate/index.scss

@@ -1,3 +1,3 @@
-@import "../support/index.scss";
+@import '../support/index.scss';
 
-@import "./blankslate.scss";
+@import './blankslate.scss';

package/box/README.md

@@ -1,37 +1,25 @@
-# Primer box
+---
+bundle: "box"
+generated: true
+---
 
-> Box is a module for creating rounded-corner boxes with a white background and gray borders. Box has optional element styles for headers, lists, and footers.
-
-This repository is a module of the full [primer][primer] repository.
+# Primer CSS: `box` 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-box/index.scss";
+@import "@primer/css/box/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/box](https://primer.style/css/components/box).
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/box.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/box/box.scss

@@ -2,8 +2,10 @@
 // Intended to replace simple-box, boxed-group, and table-list
 
 .Box {
-  background-color: $white;
-  border: $border-width $border-style $border-gray-dark;
+  background-color: var(--color-canvas-default);
+  border-color: var(--color-border-default);
+  border-style: $border-style;
+  border-width: $border-width;
   border-radius: $border-radius;
 }
 
@@ -26,6 +28,7 @@
   .Box-btn-octicon {
     &.btn-octicon {
       padding: $spacer-2 $spacer-3;
+      // stylelint-disable-next-line primer/spacing
       margin: (-$spacer-2) (-$spacer-3);
       line-height: $lh-condensed;
     }
@@ -34,7 +37,6 @@
   .Box-row {
     padding: $spacer-2 $spacer-3;
   }
-
 }
 
 .Box--spacious {
@@ -58,6 +60,7 @@
   .Box-btn-octicon {
     &.btn-octicon {
       padding: $spacer-4;
+      // stylelint-disable-next-line primer/spacing
       margin: (-$spacer-4) (-$spacer-4);
     }
   }
@@ -65,14 +68,14 @@
   .Box-row {
     padding: $spacer-4;
   }
-
 }
 
 .Box-header {
   padding: $spacer-3;
+  // stylelint-disable-next-line primer/spacing
   margin: (-$border-width) (-$border-width) 0;
-  background-color: $bg-gray;
-  border-color: $border-gray-dark;
+  background-color: var(--color-canvas-subtle);
+  border-color: var(--color-border-default);
   border-style: $border-style;
   border-width: $border-width;
   border-top-left-radius: $border-radius;
@@ -86,32 +89,35 @@
 
 .Box-body {
   padding: $spacer-3;
-  border-bottom: $border-width $border-style $border-gray;
+  border-bottom: $border-width $border-style var(--color-border-default);
 
   // Ensures bottom-border doesn't poke out when .Box-body used without box-footer
   &:last-of-type {
+    // stylelint-disable-next-line primer/spacing
     margin-bottom: -$border-width;
-    border-bottom-right-radius: 2px;
-    border-bottom-left-radius: 2px;
+    border-bottom-right-radius: $border-radius;
+    border-bottom-left-radius: $border-radius;
   }
 }
 
 // Box rows
 .Box-row {
   padding: $spacer-3;
+  // stylelint-disable-next-line primer/spacing
   margin-top: -1px;
   list-style-type: none; // To account for applying Box component to a list
-  border-top: $border-width $border-style $border-gray;
+  border-top-color: var(--color-border-muted);
+  border-top-style: $border-style;
+  border-top-width: $border-width;
 
   &:first-of-type {
-    border-top-color: transparent;
-    border-top-left-radius: 2px;
-    border-top-right-radius: 2px;
+    border-top-left-radius: $border-radius;
+    border-top-right-radius: $border-radius;
   }
 
   &:last-of-type {
-    border-bottom-right-radius: 2px;
-    border-bottom-left-radius: 2px;
+    border-bottom-right-radius: $border-radius;
+    border-bottom-left-radius: $border-radius;
   }
 
   // Adds a blue vertical line to the left of the row
@@ -119,13 +125,14 @@
   &.Box-row--unread,
   // .unread to be deprecated with .Box-row-unread
   &.unread {
-    box-shadow: 2px 0 0 $blue inset;
+    // stylelint-disable-next-line primer/box-shadow
+    box-shadow: inset 2px 0 0 var(--color-accent-emphasis);
   }
 
   &.navigation-focus {
     // Focus styles for when drag icon
     .Box-row--drag-button {
-      color: $text-blue;
+      color: var(--color-accent-fg);
       cursor: grab;
       opacity: 100;
     }
@@ -137,43 +144,42 @@
 
     // Row dragging styles
     &.sortable-chosen {
-      background-color: $bg-gray-light;
+      background-color: var(--color-canvas-subtle);
     }
 
     // Makes dragging row background gray
     &.sortable-ghost {
-      background-color: $bg-gray;
+      background-color: var(--color-canvas-subtle);
 
       // Hides contents of row while dragging so row looks solid gray
       .Box-row--drag-hide {
         opacity: 0;
       }
     }
-
   }
 }
 
 .Box-row--focus-gray {
   &.navigation-focus {
-    background-color: $bg-gray;
+    background-color: var(--color-canvas-subtle);
   }
 }
 
 .Box-row--focus-blue {
   &.navigation-focus {
-    background-color: $bg-blue-light;
+    background-color: var(--color-accent-subtle);
   }
 }
 
 .Box-row--hover-gray {
   &:hover {
-    background-color: $bg-gray;
+    background-color: var(--color-canvas-subtle);
   }
 }
 
 .Box-row--hover-blue {
   &:hover {
-    background-color: $bg-blue-light;
+    background-color: var(--color-accent-subtle);
   }
 }
 
@@ -182,15 +188,13 @@
 // and links are dark-gray with blue hover on desktop.
 .Box-row-link {
   @include breakpoint(md) {
-
-    color: $text-gray-dark;
+    color: var(--color-fg-default);
     text-decoration: none;
 
     &:hover {
-      color: $text-blue;
+      color: var(--color-accent-fg);
       text-decoration: none;
     }
-
   }
 }
 
@@ -202,8 +206,12 @@
 
 .Box-footer {
   padding: $spacer-3;
+  // stylelint-disable-next-line primer/spacing
   margin-top: -1px; // prevents double border when used with .Box-body
-  border-top: $border-width $border-style $border-gray;
+  border-top-color: var(--color-border-default);
+  border-top-style: $border-style;
+  border-top-width: $border-width;
+  border-radius: 0 0 $border-radius $border-radius;
 }
 
 // Option for a box with scrolling content
@@ -215,69 +223,69 @@
 // Box themes
 
 .Box--blue {
-  border-color: $border-blue-light;
+  border-color: var(--color-accent-muted);
 
   .Box-header {
-    background-color: $bg-blue-light;
-    border-color: $border-blue-light;
+    background-color: var(--color-accent-subtle);
+    border-color: var(--color-accent-muted);
   }
 
   .Box-body {
-    border-color: $border-blue-light;
+    border-color: var(--color-accent-muted);
   }
 
   .Box-row {
-    border-color: $border-blue-light;
+    border-color: var(--color-accent-muted);
   }
 
   .Box-footer {
-    border-color: $border-blue-light;
+    border-color: var(--color-accent-muted);
   }
 }
 
 // Applies and red border to the outside of the box,
 // but not to the border separating rows.
 .Box--danger {
-  border-color: $border-red;
+  border-color: var(--color-danger-emphasis);
 
   .Box-row {
     &:first-of-type {
-      border-color: $border-red;
+      border-color: var(--color-danger-emphasis);
     }
   }
 
   .Box-body {
     &:last-of-type {
-      border-color: $border-red;
+      border-color: var(--color-danger-emphasis);
     }
   }
 }
 
 .Box-header--blue {
-  background-color: $bg-blue-light;
-  border-color: $border-blue-light;
+  background-color: var(--color-accent-subtle);
+  border-color: var(--color-accent-muted);
 }
 
 // Box row highlight themes
 
 .Box-row--yellow {
-  background-color: $yellow-100;
+  background-color: var(--color-attention-subtle);
 }
 
 .Box-row--blue {
-  background-color: $bg-blue-light;
+  background-color: var(--color-accent-subtle);
 }
 
 .Box-row--gray {
-  background-color: $bg-gray;
+  background-color: var(--color-canvas-subtle);
 }
 
 //Box with btn-octicon
 .Box-btn-octicon {
-
   // Increase specificity when btn-octicon is used because comes after .Box in the cascade
   &.btn-octicon {
     padding: $spacer-3 $spacer-3;
+    // stylelint-disable-next-line primer/spacing
     margin: (-$spacer-3) (-$spacer-3);
     line-height: $lh-default; // override btn-octicon line-height
   }

package/box/index.scss

@@ -1,2 +1,2 @@
-@import "../support/index.scss";
-@import "./box.scss";
+@import '../support/index.scss';
+@import './box.scss';

package/branch-name/README.md

@@ -1,37 +1,25 @@
-# Primer / Branch Name
+---
+bundle: "branch-name"
+generated: true
+---
 
-> A nice, consistent way to display branch names.
-
-This repository is a module of the full [primer][primer] repository.
+# Primer CSS: `branch-name` 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-branch-name/index.scss";
+@import "@primer/css/branch-name/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, an 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/branch-name](https://primer.style/css/components/branch-name).
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/branch-name.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/branch-name/branch-name.scss

@@ -1,20 +1,30 @@
+// stylelint-disable selector-max-type, selector-no-qualifying-type
+
 // A nice way to display branch names inside the UI. Can be a link or not.
-// stylelint-disable selector-max-type
+
 .branch-name {
   display: inline-block;
+  // stylelint-disable-next-line primer/spacing
   padding: 2px 6px;
   font: 12px $mono-font;
-  color: rgba($black, 0.6);
-  background-color: lighten($blue-100, 3%);
-  border-radius: 3px;
+  color: var(--color-fg-muted);
+  background-color: var(--color-accent-subtle);
+  border-radius: $border-radius;
 
   .octicon {
+    // stylelint-disable-next-line primer/spacing
     margin: 1px -2px 0 0;
-    color: desaturate($blue-300, 70%);
+    color: var(--color-fg-muted);
   }
 }
 
 // When a branch name is a link
-// stylelint-disable selector-no-qualifying-type
-a.branch-name { color: $text-blue; }
-// stylelint-enable selector-no-qualifying-type
+
+a.branch-name {
+  color: var(--color-accent-fg);
+  background-color: var(--color-accent-subtle);
+
+  .octicon {
+    color: var(--color-accent-fg);
+  }
+}

package/branch-name/index.scss

@@ -1,3 +1,3 @@
 // support files
-@import "../support/index.scss";
-@import "./branch-name.scss";
+@import '../support/index.scss';
+@import './branch-name.scss';

package/breadcrumb/README.md

@@ -1,21 +1,25 @@
-# Primer Breadcrumb Navigation
+---
+bundle: "breadcrumb"
+generated: true
+---
 
-> Breadcrumb navigation for GitHub's pages with parents / grandparents.
+# Primer CSS: `breadcrumb` bundle
 
-This repository is a module of the full [primer][primer] repository.
+## Usage
 
-## Documentation
+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:
 
-Find further documentation at [primer.style/css/components/breadcrumb](https://primer.style/css/components/breadcrumb).
+```scss
+@import "@primer/css/breadcrumb/index.scss";
+```
+
+## Build
+
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/breadcrumb.css`.
 
 ## License
 
-MIT © [GitHub](https://github.com/)
+[MIT](https://github.com/primer/css/blob/main/LICENSE) © [GitHub](https://github.com/)
+
 
-[primer]: https://github.com/primer/css
-[primer-support]: https://github.com/primer/css-support
-[support]: https://github.com/primer/css-support
-[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/breadcrumb/breadcrumb.scss

@@ -1,14 +1,18 @@
 .breadcrumb-item {
   display: inline-block;
+  // stylelint-disable-next-line primer/spacing
   margin-left: -0.35em;
   white-space: nowrap;
   list-style: none;
 
   &::after {
-    padding-right: $em-spacer-5;
-    padding-left: $em-spacer-5;
-    color: $border-gray;
-    content: "/";
+    display: inline-block;
+    height: 0.8em;
+    margin: 0 $em-spacer-5;
+    content: '';
+    // stylelint-disable-next-line primer/borders
+    border-right: 0.1em $border-style var(--color-fg-muted);
+    transform: rotate(15deg);
   }
 
   &:first-child {
@@ -16,8 +20,14 @@
   }
 }
 
-.breadcrumb-item-selected {
+.breadcrumb-item-selected,
+.breadcrumb-item[aria-current]:not([aria-current=false]) {
   &::after {
     content: none;
   }
 }
+
+// stylelint-disable selector-max-type
+.breadcrumb-item-selected a {
+  color: var(--color-fg-default);
+}

package/breadcrumb/index.scss

@@ -1,3 +1,3 @@
 // support files
-@import "../support/index.scss";
-@import "./breadcrumb.scss";
+@import '../support/index.scss';
+@import './breadcrumb.scss';

package/buttons/README.md

@@ -1,37 +1,25 @@
-# Primer Buttons
+---
+bundle: "buttons"
+generated: true
+---
 
-> Buttons are used for actions, like in forms, while textual hyperlinks are used for destinations, or moving from one page to another.
-
-This repository is a module of the full [primer][primer] repository.
+# Primer CSS: `buttons` 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-buttons/index.scss";
+@import "@primer/css/buttons/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/buttons](https://primer.style/css/components/buttons).
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/buttons.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/buttons/button-group.scss

@@ -33,6 +33,7 @@
   }
 
   &.selected,
+  &[aria-selected=true],
   &:focus,
   &:active,
   &:hover {
@@ -65,6 +66,7 @@
   }
 
   &.selected,
+  &[aria-selected=true],
   &:focus,
   &:active,
   &:hover {