diff --git a/.sassdocrc b/.sassdocrc index 8e23041..75aaceb 100644 --- a/.sassdocrc +++ b/.sassdocrc @@ -34,6 +34,6 @@ herman: - name: 'CSS Colors Level 5' url: 'https://www.w3.org/TR/css-color-5/' - name: 'GitHub Source' - url: 'https://github.com/mirisuzanne/blend/' + url: 'https://github.com/oddbird/blend/' - name: 'OddBird' url: 'http://oddbird.net/' diff --git a/CHANGELOG.md b/CHANGELOG.md index c232622..e1bed25 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,28 +1,32 @@ # Blend Changelog -## v0.2.0 - UNRELEASED -- BREAKING: Remove over-complicated settings & output options for now. - Focus on Sass <-> CIE functions. -- NEW: `lch()` hue channel accepts any angle unit +## v0.2.0 - 2020.05.27 +- **BREAKING**: Moved project to [oddbird/blend][repo] on GitHub, + and [@oddbird/blend][pkg] on NPM. +- **BREAKING**: Remove over-complicated settings & output options for now. + Focus on practical Sass conversion to and from CIE functions. +- **NEW**: `lch()` hue channel accepts any angle unit (e.g. `turn`, `rad`, `grad`, or `deg`) -- NEW: `lab($lab, $a)` returns an (sRGB) Sass color -- NEW: Inspect LCH/Lab values of a Sass color with +- **NEW**: `lab($lab, $a)` returns an (sRGB) Sass color +- **NEW**: Inspect LCH/Lab values of a Sass color with - `lightness()` - `a()` and `b()` - `chroma()` and `hue()` -- NEW: `contrast()` selects the best contrast from a list -- NEW: Generate new colors based on relative LCH & Lab adjustments: +- **NEW**: `contrast()` selects the best contrast from a list +- **NEW**: Generate new colors based on relative LCH & Lab adjustments: - `set()` to replace a channel value - `adjust()` to add or subtract from a channel - `scale()` to scale fluidly towards one "end" of the channel range -- NEW: `from()` converts a Sass color to LCH +- **NEW**: `from()` converts a Sass color to LCH in order to adjust CIE lightness, chroma, and hue -- using a syntax roughly based on [CSS Colors Level 5 relative syntax][relative] +[pkg]: https://www.npmjs.com/package/@oddbird/blend +[repo]: https://github.com/oddbird/blend/ [relative]: https://www.w3.org/TR/css-color-5/#relative-RGB ## v0.1.1 - 2020.05.06 -- NEW: `lch($lch, $a)` returns an (sRGB) Sass color +- **NEW**: `lch($lch, $a)` returns an (sRGB) Sass color - Various other now-removed things… ¯\\\_(ツ)_/¯ that's what pre-releases are for diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e2aa36a..0e99305 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,7 +2,7 @@ Ideas, issues, and pull-requests are welcome! -- [**Github Issues**](https://github.com/mirisuzanne/blend/issues/) +- [**Github Issues**](https://github.com/oddbird/blend/issues/) are the best place to request a feature, file a bug, or just ask a question. diff --git a/README.md b/README.md index f37f42a..19af82a 100644 --- a/README.md +++ b/README.md @@ -13,14 +13,6 @@ while working with Sass colors. [Level 4]: https://www.w3.org/TR/css-color-4/ [Level 5]: https://www.w3.org/TR/css-color-5/ -See the wonderful interactive -[LCH Color Picker](https://css.land/lch/) -by [Lea Verou](http://lea.verou.me/). -We use the same conversion math, -originally written in JS by -[Chris Lilley](https://svgees.us/) -and [Tab Atkins](https://www.xanthir.com/). - Note that conversion between color-spaces requires gamut-adjustments and rounding. While we use the same conversion math recommended for browsers, @@ -28,12 +20,25 @@ pre-processing can result in slight variations in each step. Converting a color from one format to another and back again, may result in slight differences. +## Color Picker + +To get started with new CSS color formats +(and LCH in particular), +check out the wonderful +[LCH Color Picker](https://css.land/lch/) +by [Lea Verou](http://lea.verou.me/). + +We use the same conversion math, +originally written in JS by +[Chris Lilley](https://svgees.us/) +and [Tab Atkins](https://www.xanthir.com/). + ## Usage Download the files from GitHub, or install the npm package: ``` -npm install @mirisuzanne/blend --save-dev +npm install @oddbird/blend --save-dev ``` Import with Dart Sass @@ -121,7 +126,11 @@ $from: ( The initial version is mostly focused on CIE colors, but Level 4 includes an array of new formats. -We're working on it… +We're working on it. + +See the full list of [planned enhancements][todo]. + +[todo]: https://github.com/oddbird/blend/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement ```scss @use 'blend'; diff --git a/docs/CHANGELOG.html b/docs/CHANGELOG.html index ed82072..285a694 100644 --- a/docs/CHANGELOG.html +++ b/docs/CHANGELOG.html @@ -7,7 +7,7 @@ - Changelog | @mirisuzanne/blend Documentation + Changelog | @oddbird/blend Documentation @@ -40,9 +40,9 @@
- @mirisuzanne/blend + @oddbird/blend - 0.1.1 + 0.2.0
@@ -57,7 +57,7 @@