@carbon/colors 10.0.0-rc.0 → 10.2.0

package/CHANGELOG.md

@@ -0,0 +1,489 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [10.1.1](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v10.1.0...v10.1.1) (2019-04-13)
+
+**Note:** Version bump only for package @carbon/colors
+
+
+
+
+
+# 10.1.0 (2019-04-12)
+
+
+### Features
+
+* **sassdoc:** render Sassdoc in markdown ([#462](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/462)) ([73cea35](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/73cea35)), closes [#470](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/470)
+
+
+
+# 10.0.0 (2019-03-29)
+
+
+
+# 10.0.0-rc.0 (2019-03-27)
+
+
+
+## 0.0.1-beta.5 (2019-03-25)
+
+
+
+## 0.0.1-beta.4 (2019-03-22)
+
+
+
+## 0.0.1-beta.3 (2019-03-22)
+
+
+### Features
+
+* **test-utils:** make test-utils public ([#446](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/446)) ([7f86f8f](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/7f86f8f))
+* **theme:** add theme maps and theme mixin ([#397](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/397)) ([a91e527](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/a91e527))
+
+
+
+## 0.0.1-beta.2 (2019-03-19)
+
+
+
+## 0.0.1-beta.1 (2019-03-13)
+
+
+
+## 0.0.1-beta.0 (2019-03-07)
+
+
+
+## 0.0.1-alpha.32 (2019-02-12)
+
+
+### Bug Fixes
+
+* **colors:** change namespace to be consistent with rules ([5b58050](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/5b58050))
+
+
+### Features
+
+* **colors:** update color values ([#328](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/328)) ([83e3e92](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/83e3e92))
+
+
+
+## 0.0.1-alpha.31 (2019-01-28)
+
+
+
+## 0.0.1-alpha.30 (2019-01-22)
+
+
+### Bug Fixes
+
+* **colors:** don't quote grade values in map ([#273](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/273)) ([fa83003](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/fa83003))
+
+
+
+## 0.0.1-alpha.29 (2019-01-14)
+
+
+### Bug Fixes
+
+* **themes:** add in deprecated tokens ([#263](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/263)) ([21b9401](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/21b9401))
+
+
+
+## 0.0.1-alpha.28 (2019-01-11)
+
+
+### Bug Fixes
+
+* **colors:** add back in ibm-color-map ([#254](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/254)) ([b0ba7f8](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/b0ba7f8))
+
+
+
+## 0.0.1-alpha.27 (2019-01-10)
+
+
+### Bug Fixes
+
+* **colors:** add all colors to export ([#246](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/246)) ([8b6ac7f](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/8b6ac7f))
+* **colors:** update scss map name ([#198](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/198)) ([4dcb170](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/4dcb170))
+
+
+### Features
+
+* **bundler:** add support for scss compilation ([#222](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/222)) ([5cfcdb8](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/5cfcdb8))
+
+
+
+## 0.0.1-alpha.26 (2018-12-13)
+
+
+### Bug Fixes
+
+* **colors:** add map with grades to scss output, add black100, white0, yellow20, and orange40 vars ([#141](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/141)) ([6d6bc04](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/6d6bc04))
+
+
+
+## 0.0.1-alpha.25 (2018-12-11)
+
+
+
+## 0.0.1-alpha.24 (2018-12-07)
+
+
+
+## 0.0.1-alpha.23 (2018-12-06)
+
+
+
+## 0.0.1-alpha.22 (2018-12-04)
+
+
+
+## 0.0.1-alpha.21 (2018-12-04)
+
+
+### Features
+
+* **colors:** update color and token values ([#107](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/107)) ([63795d6](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/63795d6))
+
+
+
+## 0.0.1-alpha.20 (2018-11-29)
+
+
+
+## 0.0.1-alpha.19 (2018-11-29)
+
+
+
+## 0.0.1-alpha.18 (2018-11-28)
+
+
+
+## 0.0.1-alpha.17 (2018-11-25)
+
+
+
+## 0.0.1-alpha.16 (2018-11-21)
+
+
+
+## 0.0.1-alpha.15 (2018-11-21)
+
+
+
+## 0.0.1-alpha.14 (2018-11-20)
+
+
+
+## 0.0.1-alpha.13 (2018-11-19)
+
+
+
+## 0.0.1-alpha.12 (2018-11-18)
+
+
+
+## 0.0.1-alpha.11 (2018-11-18)
+
+
+
+## 0.0.1-alpha.10 (2018-11-18)
+
+
+
+## 0.0.1-alpha.9 (2018-11-18)
+
+
+
+## 0.0.1-alpha.8 (2018-11-18)
+
+
+### Features
+
+* add tokens alongside JavaScript output for certain packages ([#72](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/72)) ([6ca03e2](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/6ca03e2))
+
+
+
+## 0.0.1-alpha.7 (2018-11-14)
+
+
+
+## 0.0.1-alpha.5 (2018-11-14)
+
+
+
+## 0.0.1-alpha.4 (2018-11-09)
+
+
+### Bug Fixes
+
+* **colors:** update build process to output proper token names ([88d631e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/88d631e))
+
+
+
+## 0.0.1-alpha.3 (2018-11-09)
+
+
+### Features
+
+* update for alpha.3 ([dcbfc59](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/dcbfc59))
+
+
+
+## 0.0.1-alpha.2 (2018-10-02)
+
+
+### Features
+
+* **icons-react:** add `icons-react` package ([#6](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/6)) ([43eb47c](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/43eb47c))
+* **type:** add type package ([#17](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/17)) ([904462e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/904462e))
+
+
+
+## 0.0.1-alpha.0 (2018-08-30)
+
+
+### Features
+
+* **colors:** add colors package ([#5](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/5)) ([8b4d40e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/8b4d40e))
+
+
+
+
+
+# [10.0.0](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v10.0.0-rc.0...v10.0.0) (2019-03-29)
+
+
+
+# [10.0.0-rc.0](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.5...v10.0.0-rc.0) (2019-03-27)
+
+
+
+## [0.0.1-beta.5](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.4...v0.0.1-beta.5) (2019-03-25)
+
+
+
+## [0.0.1-beta.4](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.3...v0.0.1-beta.4) (2019-03-22)
+
+
+
+## [0.0.1-beta.3](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.2...v0.0.1-beta.3) (2019-03-22)
+
+
+### Features
+
+* **test-utils:** make test-utils public ([#446](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/446)) ([7f86f8f](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/7f86f8f))
+* **theme:** add theme maps and theme mixin ([#397](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/397)) ([a91e527](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/a91e527))
+
+
+
+## [0.0.1-beta.2](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.1...v0.0.1-beta.2) (2019-03-19)
+
+
+
+## [0.0.1-beta.1](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-beta.0...v0.0.1-beta.1) (2019-03-13)
+
+
+
+## [0.0.1-beta.0](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.32...v0.0.1-beta.0) (2019-03-07)
+
+
+
+## [0.0.1-alpha.32](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.31...v0.0.1-alpha.32) (2019-02-12)
+
+
+### Bug Fixes
+
+* **colors:** change namespace to be consistent with rules ([5b58050](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/5b58050))
+
+
+### Features
+
+* **colors:** update color values ([#328](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/328)) ([83e3e92](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/83e3e92))
+
+
+
+## [0.0.1-alpha.31](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.30...v0.0.1-alpha.31) (2019-01-28)
+
+
+
+## [0.0.1-alpha.30](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.29...v0.0.1-alpha.30) (2019-01-22)
+
+
+### Bug Fixes
+
+* **colors:** don't quote grade values in map ([#273](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/273)) ([fa83003](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/fa83003))
+
+
+
+## [0.0.1-alpha.29](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.28...v0.0.1-alpha.29) (2019-01-14)
+
+
+### Bug Fixes
+
+* **themes:** add in deprecated tokens ([#263](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/263)) ([21b9401](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/21b9401))
+
+
+
+## [0.0.1-alpha.28](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.27...v0.0.1-alpha.28) (2019-01-11)
+
+
+### Bug Fixes
+
+* **colors:** add back in ibm-color-map ([#254](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/254)) ([b0ba7f8](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/b0ba7f8))
+
+
+
+## [0.0.1-alpha.27](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.26...v0.0.1-alpha.27) (2019-01-10)
+
+
+### Bug Fixes
+
+* **colors:** add all colors to export ([#246](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/246)) ([8b6ac7f](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/8b6ac7f))
+* **colors:** update scss map name ([#198](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/198)) ([4dcb170](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/4dcb170))
+
+
+### Features
+
+* **bundler:** add support for scss compilation ([#222](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/222)) ([5cfcdb8](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/5cfcdb8))
+
+
+
+## [0.0.1-alpha.26](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.25...v0.0.1-alpha.26) (2018-12-13)
+
+
+### Bug Fixes
+
+* **colors:** add map with grades to scss output, add black100, white0, yellow20, and orange40 vars ([#141](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/141)) ([6d6bc04](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/6d6bc04))
+
+
+
+## [0.0.1-alpha.25](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.24...v0.0.1-alpha.25) (2018-12-11)
+
+
+
+## [0.0.1-alpha.24](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.23...v0.0.1-alpha.24) (2018-12-07)
+
+
+
+## [0.0.1-alpha.23](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.22...v0.0.1-alpha.23) (2018-12-06)
+
+
+
+## [0.0.1-alpha.22](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.21...v0.0.1-alpha.22) (2018-12-04)
+
+
+
+## [0.0.1-alpha.21](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.20...v0.0.1-alpha.21) (2018-12-04)
+
+
+### Features
+
+* **colors:** update color and token values ([#107](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/107)) ([63795d6](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/63795d6))
+
+
+
+## [0.0.1-alpha.20](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.19...v0.0.1-alpha.20) (2018-11-29)
+
+
+
+## [0.0.1-alpha.19](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.18...v0.0.1-alpha.19) (2018-11-29)
+
+
+
+## [0.0.1-alpha.18](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.17...v0.0.1-alpha.18) (2018-11-28)
+
+
+
+## [0.0.1-alpha.17](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.16...v0.0.1-alpha.17) (2018-11-25)
+
+
+
+## [0.0.1-alpha.16](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.15...v0.0.1-alpha.16) (2018-11-21)
+
+
+
+## [0.0.1-alpha.15](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.14...v0.0.1-alpha.15) (2018-11-21)
+
+
+
+## [0.0.1-alpha.14](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.13...v0.0.1-alpha.14) (2018-11-20)
+
+
+
+## [0.0.1-alpha.13](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.12...v0.0.1-alpha.13) (2018-11-19)
+
+
+
+## [0.0.1-alpha.12](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.11...v0.0.1-alpha.12) (2018-11-18)
+
+
+
+## [0.0.1-alpha.11](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.10...v0.0.1-alpha.11) (2018-11-18)
+
+
+
+## [0.0.1-alpha.10](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.9...v0.0.1-alpha.10) (2018-11-18)
+
+
+
+## [0.0.1-alpha.9](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.8...v0.0.1-alpha.9) (2018-11-18)
+
+
+
+## [0.0.1-alpha.8](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.7...v0.0.1-alpha.8) (2018-11-18)
+
+
+### Features
+
+* add tokens alongside JavaScript output for certain packages ([#72](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/72)) ([6ca03e2](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/6ca03e2))
+
+
+
+## [0.0.1-alpha.7](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.5...v0.0.1-alpha.7) (2018-11-14)
+
+
+
+## [0.0.1-alpha.5](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.4...v0.0.1-alpha.5) (2018-11-14)
+
+
+
+## [0.0.1-alpha.4](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.3...v0.0.1-alpha.4) (2018-11-09)
+
+
+### Bug Fixes
+
+* **colors:** update build process to output proper token names ([88d631e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/88d631e))
+
+
+
+## [0.0.1-alpha.3](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.2...v0.0.1-alpha.3) (2018-11-09)
+
+
+### Features
+
+* update for alpha.3 ([dcbfc59](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/dcbfc59))
+
+
+
+## [0.0.1-alpha.2](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/v0.0.1-alpha.0...v0.0.1-alpha.2) (2018-10-02)
+
+
+### Features
+
+* **icons-react:** add `icons-react` package ([#6](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/6)) ([43eb47c](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/43eb47c))
+* **type:** add type package ([#17](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/17)) ([904462e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/904462e))
+
+
+
+## [0.0.1-alpha.0](https://github.com/IBM/carbon-elements/tree/master/packages/colors/compare/8b4d40e...v0.0.1-alpha.0) (2018-08-30)
+
+
+### Features
+
+* **colors:** add colors package ([#5](https://github.com/IBM/carbon-elements/tree/master/packages/colors/issues/5)) ([8b4d40e](https://github.com/IBM/carbon-elements/tree/master/packages/colors/commit/8b4d40e))

package/LICENSE

@@ -178,7 +178,7 @@
    APPENDIX: How to apply the Apache License to your work.
 
       To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
+      boilerplate notice, with the fields enclosed by brackets "{}"
       replaced with your own identifying information. (Don't include
       the brackets!)  The text should be enclosed in the appropriate
       comment syntax for the file format. We also recommend that a
@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2018 IBM Corp.
+   Copyright 2015 IBM Corp.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,19 +1,18 @@
 # @carbon/colors
 
-> Colors for digital and software products using the Carbon Design
-> System
+> Colors for digital and software products using the Carbon Design System
 
 ## Getting started
 
-To install `@carbon/colors` in your project, you will need to run the
-following command using [npm](https://www.npmjs.com/):
+To install `@carbon/colors` in your project, you will need to run the following
+command using [npm](https://www.npmjs.com/):
 
 ```bash
 npm install -S @carbon/colors
 ```
 
-If you prefer [Yarn](https://yarnpkg.com/en/), use the following
-command instead:
+If you prefer [Yarn](https://yarnpkg.com/en/), use the following command
+instead:
 
 ```bash
 yarn add @carbon/colors
@@ -21,8 +20,8 @@ yarn add @carbon/colors
 
 ## Usage
 
-You can use the `@carbon/colors` module in your JavaScript, in
-addition to your Sass.
+You can use the `@carbon/colors` module in your JavaScript, in addition to your
+Sass.
 
 ### Sass
 
@@ -76,6 +75,7 @@ swatches is also a map, but each key is now the grade. In code, this looks like
 the following:
 
 <!-- prettier-ignore-start -->
+
 ```scss
 $carbon--colors: (
   'blue': (
@@ -84,6 +84,7 @@ $carbon--colors: (
   )
 );
 ```
+
 <!-- prettier-ignore-end -->
 
 You can include this variable by including `@carbon/colors/scss/colors` or
@@ -94,8 +95,8 @@ calling the `carbon--colors()` mixin directly.
 If you were originally using a project that had color variables defined as
 `$ibm-color__<swatch>-<grade>`, or are relying on `$ibm-color-map`, you can also
 use the entrypoint described above to access these colors. They are meant as an
-easier way to help adopt these packages. However, these variables will be removed
-in the next release of Carbon.
+easier way to help adopt these packages. However, these variables will be
+removed in the next release of Carbon.
 
 Similar to previous efforts, we also provide colors in the formats mentioned
 above. For example:
@@ -105,8 +106,8 @@ $ibm-color__blue-50;
 $ibm-color__warm-gray-100;
 ```
 
-If you would like a mixin to conditionally include these variables,
-you can include the mixin by using:
+If you would like a mixin to conditionally include these variables, you can
+include the mixin by using:
 
 ```scss
 @import '@carbon/colors/scss/mixins';
@@ -116,8 +117,8 @@ you can include the mixin by using:
 
 ### JavaScript
 
-For JavaScript, you can import and use this module by doing the
-following in your code:
+For JavaScript, you can import and use this module by doing the following in
+your code:
 
 ```js
 // ESM
@@ -127,9 +128,8 @@ import { black, blue, warmGray } from '@carbon/colors';
 const { black, blue, warmGray } = require('@carbon/colors');
 ```
 
-Each color swatch is exported as a variable, and each color name is
-also exported as an object that can be called by specifying grade, for
-example:
+Each color swatch is exported as a variable, and each color name is also
+exported as an object that can be called by specifying grade, for example:
 
 ```js
 black;
@@ -137,12 +137,17 @@ blue[50]; // Using the `blue` object.
 warmGray100; // Using the `warmGray100` variable.
 ```
 
+## 📖 API Documentation
+
+If you're looking for `@carbon/colors` API documentation, check out:
+
+- [Sass](./docs/sass.md)
+
 ## 🙌 Contributing
 
-We're always looking for contributors to help us fix bugs, build new
-features, or help us improve the project documentation. If you're
-interested, definitely check out our [Contributing Guide](/.github/CONTRIBUTING.md)
-! 👀
+We're always looking for contributors to help us fix bugs, build new features,
+or help us improve the project documentation. If you're interested, definitely
+check out our [Contributing Guide](/.github/CONTRIBUTING.md) ! 👀
 
 ## 📝 License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/colors",
   "description": "Colors for digital and software products using the Carbon Design System",
-  "version": "10.0.0-rc.0",
+  "version": "10.2.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -25,17 +25,18 @@
     "access": "public"
   },
   "scripts": {
-    "build": "yarn clean && bundler bundle src/index.js --name CarbonColors && node tasks/build.js && bundler check 'scss/*.scss'",
+    "build": "yarn clean && bundler bundle src/index.js --name CarbonColors && node tasks/build.js && bundler check 'scss/*.scss' && bundler sassdoc 'scss/*.scss'",
     "clean": "rimraf css es lib umd scss"
   },
   "devDependencies": {
-    "@carbon/bundler": "10.0.0-rc.0",
-    "@carbon/cli-reporter": "10.0.0-rc.0",
-    "@carbon/test-utils": "10.0.0-rc.0",
+    "@carbon/bundler": "10.2.0",
+    "@carbon/cli-reporter": "10.2.0",
+    "@carbon/scss-generator": "10.2.0",
+    "@carbon/test-utils": "10.2.0",
     "change-case": "^3.0.2",
+    "core-js": "^3.0.1",
     "fs-extra": "^7.0.0",
     "node-sass": "^4.11.0",
-    "prettier": "^1.14.3",
     "rimraf": "^2.6.2"
   },
   "eyeglass": {
@@ -44,5 +45,5 @@
     "sassDir": "scss",
     "needs": "^1.3.0"
   },
-  "gitHead": "1d45594d448a22447b2b2685445362438b7c8944"
+  "gitHead": "e71825a0cf44f6f41fee7d2b0dd9c57d7bda126a"
 }

package/scss/colors.scss

@@ -1,7 +1,11 @@
 // Code generated by @carbon/colors. DO NOT EDIT.
-
+//
+// Copyright IBM Corp. 2018, 2018
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
 @import './mixins';
-
 // Deprecated ☠️
 @include ibm--colors();
 // Preferred

package/scss/index.scss

@@ -0,0 +1,12 @@
+// Code generated by @carbon/colors. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2018, 2018
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+@import './mixins';
+// Deprecated ☠️
+@include ibm--colors();
+// Preferred
+@include carbon--colors();

package/scss/mixins.scss

@@ -1,7 +1,15 @@
 // Code generated by @carbon/colors. DO NOT EDIT.
-
-// Deprecated ☠️
-@mixin ibm--colors {
+//
+// Copyright IBM Corp. 2018, 2018
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+/// Define color variables
+/// @access public
+/// @group @carbon/colors
+/// @deprecated Use `$carbon--colors` going forward
+@mixin ibm--colors() {
   $ibm-color__black-100: #000000 !default !global;
   $ibm-color__blue-10: #edf4ff !default !global;
   $ibm-color__blue-20: #c9deff !default !global;
@@ -106,10 +114,9 @@
   $ibm-color__warm-gray-100: #1a1717 !default !global;
   $ibm-color__white-0: #ffffff !default !global;
   $ibm-color__yellow-20: #fdd13a !default !global;
-
   $ibm-color-map: (
     'black': (
-      100: #000000
+      100: #000000,
     ),
     'blue': (
       10: #edf4ff,
@@ -121,7 +128,19 @@
       70: #054ada,
       80: #0530ad,
       90: #061f80,
-      100: #051243
+      100: #051243,
+    ),
+    'cool-gray': (
+      10: #f2f4f8,
+      20: #d5d9e0,
+      30: #b9bfc7,
+      40: #9fa5ad,
+      50: #868d95,
+      60: #697077,
+      70: #50565b,
+      80: #373d42,
+      90: #242a2e,
+      100: #13171a,
     ),
     'coolGray': (
       10: #f2f4f8,
@@ -133,7 +152,7 @@
       70: #50565b,
       80: #373d42,
       90: #242a2e,
-      100: #13171a
+      100: #13171a,
     ),
     'cyan': (
       10: #e3f6ff,
@@ -145,7 +164,7 @@
       70: #0058a1,
       80: #003d73,
       90: #002b50,
-      100: #07192b
+      100: #07192b,
     ),
     'gray': (
       10: #f3f3f3,
@@ -157,7 +176,7 @@
       70: #565656,
       80: #3d3d3d,
       90: #282828,
-      100: #171717
+      100: #171717,
     ),
     'green': (
       10: #dafbe4,
@@ -169,7 +188,7 @@
       70: #10642a,
       80: #054719,
       90: #01330f,
-      100: #081b09
+      100: #081b09,
     ),
     'magenta': (
       10: #fff0f6,
@@ -181,10 +200,10 @@
       70: #a11950,
       80: #760a3a,
       90: #57002b,
-      100: #2a0a16
+      100: #2a0a16,
     ),
     'orange': (
-      40: #fc7b1e
+      40: #fc7b1e,
     ),
     'purple': (
       10: #f7f1ff,
@@ -196,7 +215,7 @@
       70: #6e32c9,
       80: #4f2196,
       90: #38146b,
-      100: #1e1033
+      100: #1e1033,
     ),
     'red': (
       10: #fff0f1,
@@ -208,7 +227,7 @@
       70: #a51920,
       80: #750e13,
       90: #570408,
-      100: #2c080a
+      100: #2c080a,
     ),
     'teal': (
       10: #dbfbfb,
@@ -220,7 +239,19 @@
       70: #006161,
       80: #004548,
       90: #003137,
-      100: #081a1c
+      100: #081a1c,
+    ),
+    'warm-gray': (
+      10: #f7f3f1,
+      20: #e0dbda,
+      30: #c1bcbb,
+      40: #a7a2a2,
+      50: #8f8b8b,
+      60: #726e6e,
+      70: #595555,
+      80: #403c3c,
+      90: #2b2828,
+      100: #1a1717,
     ),
     'warmGray': (
       10: #f7f3f1,
@@ -232,18 +263,20 @@
       70: #595555,
       80: #403c3c,
       90: #2b2828,
-      100: #1a1717
+      100: #1a1717,
     ),
     'white': (
-      0: #ffffff
+      0: #ffffff,
     ),
     'yellow': (
-      20: #fdd13a
-    )
+      20: #fdd13a,
+    ),
   ) !default !global;
 }
-
-@mixin carbon--colors {
+/// Define color variables
+/// @access public
+/// @group @carbon/colors
+@mixin carbon--colors() {
   $carbon--black-100: #000000 !default !global;
   $carbon--blue-10: #edf4ff !default !global;
   $carbon--blue-20: #c9deff !default !global;
@@ -454,7 +487,7 @@
   $yellow-20: #fdd13a !default !global;
   $carbon--colors: (
     'black': (
-      100: #000000
+      100: #000000,
     ),
     'blue': (
       10: #edf4ff,
@@ -466,7 +499,19 @@
       70: #054ada,
       80: #0530ad,
       90: #061f80,
-      100: #051243
+      100: #051243,
+    ),
+    'cool-gray': (
+      10: #f2f4f8,
+      20: #d5d9e0,
+      30: #b9bfc7,
+      40: #9fa5ad,
+      50: #868d95,
+      60: #697077,
+      70: #50565b,
+      80: #373d42,
+      90: #242a2e,
+      100: #13171a,
     ),
     'coolGray': (
       10: #f2f4f8,
@@ -478,7 +523,7 @@
       70: #50565b,
       80: #373d42,
       90: #242a2e,
-      100: #13171a
+      100: #13171a,
     ),
     'cyan': (
       10: #e3f6ff,
@@ -490,7 +535,7 @@
       70: #0058a1,
       80: #003d73,
       90: #002b50,
-      100: #07192b
+      100: #07192b,
     ),
     'gray': (
       10: #f3f3f3,
@@ -502,7 +547,7 @@
       70: #565656,
       80: #3d3d3d,
       90: #282828,
-      100: #171717
+      100: #171717,
     ),
     'green': (
       10: #dafbe4,
@@ -514,7 +559,7 @@
       70: #10642a,
       80: #054719,
       90: #01330f,
-      100: #081b09
+      100: #081b09,
     ),
     'magenta': (
       10: #fff0f6,
@@ -526,10 +571,10 @@
       70: #a11950,
       80: #760a3a,
       90: #57002b,
-      100: #2a0a16
+      100: #2a0a16,
     ),
     'orange': (
-      40: #fc7b1e
+      40: #fc7b1e,
     ),
     'purple': (
       10: #f7f1ff,
@@ -541,7 +586,7 @@
       70: #6e32c9,
       80: #4f2196,
       90: #38146b,
-      100: #1e1033
+      100: #1e1033,
     ),
     'red': (
       10: #fff0f1,
@@ -553,7 +598,7 @@
       70: #a51920,
       80: #750e13,
       90: #570408,
-      100: #2c080a
+      100: #2c080a,
     ),
     'teal': (
       10: #dbfbfb,
@@ -565,7 +610,19 @@
       70: #006161,
       80: #004548,
       90: #003137,
-      100: #081a1c
+      100: #081a1c,
+    ),
+    'warm-gray': (
+      10: #f7f3f1,
+      20: #e0dbda,
+      30: #c1bcbb,
+      40: #a7a2a2,
+      50: #8f8b8b,
+      60: #726e6e,
+      70: #595555,
+      80: #403c3c,
+      90: #2b2828,
+      100: #1a1717,
     ),
     'warmGray': (
       10: #f7f3f1,
@@ -577,13 +634,13 @@
       70: #595555,
       80: #403c3c,
       90: #2b2828,
-      100: #1a1717
+      100: #1a1717,
     ),
     'white': (
-      0: #ffffff
+      0: #ffffff,
     ),
     'yellow': (
-      20: #fdd13a
-    )
+      20: #fdd13a,
+    ),
   ) !default !global;
 }