Add README.

Move HSLuvColor to main directory.
Minor fixes.
Refactoring before release.

CHANGELOG.md

@@ -1,2 +1,2 @@
-## [1.0.0] 
-* Initial port of HSLuv and a nice sample.
+## [1.0.4] 
+* Initial port of HSLuv with a nice sample app.

README.md

@@ -0,0 +1,117 @@
+# HSLuv for Dart & Flutter
+Dart port of [HSLuv](http://www.hsluv.org) (revision 4) with a [Flutter sample](example). This was a direct conversion of the [reference implementation](https://github.com/hsluv/hsluv/tree/master/haxe).
+
+[<p align="center"><img src="https://github.com/bernaferrari/hsluv-dart/raw/master/assets/sample_app.jpg?raw=true" width="400"/></p>](example)
+
+> HSLuv is a human-friendly alternative to HSL.
+ 
+ It is like HSL, but color only gets perceptually lighter or darker when the Lightness attribute changes.
+ In HSL, if you go from a green hue to a red one, there will be big differences in the perceived lightness. In HSLuv, almost none.
+
+ If you want to see for yourself, check the [sample app](example) and open the Color Compare screen. Contrast "only" changes when Lightness changes.
+ When Hue or Saturation attributes change, there might be minimal changes in contrast (in the 0.01 range), but nothing perceivable and certainly better than HSV/HSL. 
+
+ This is specially useful when [building acessible color systems](https://stripe.com/blog/accessible-color-systems).
+ For more information, check: [Designing Color Spaces](https://programmingdesignsystems.com/color/perceptually-uniform-color-spaces/index.html) / [Wikipedia article](https://en.wikipedia.org/wiki/HSLuv)
+
+## Usage
+
+In the `pubspec.yaml` of your flutter project, add the following dependency:
+
+[![pub package](https://img.shields.io/pub/v/hsluv.svg)](https://pub.dev/packages/hsluv)
+
+```yaml
+dependencies:
+  hsluv: ^VERSION
+```
+
+In your project you can use it in two different ways, either low level (directly accessing values as a `list<double>`) or high level (similar to [HSLColor](https://api.flutter.dev/flutter/painting/HSLColor-class.html)).
+`HSLuvColor` is easier to use, but has less flexibility than a raw list.
+
+```dart
+import 'package:hsluv/hsluv.dart';
+
+void main() {
+  
+  // Low level usage.
+  final List<double> hsluvLow = Hsluv.rgbToHsluv([0.2,0.5,0.7]);
+  print(Hsluv.hsluvToHex(hsluvLow));
+
+  // High level usage.
+  final hsluvFromColor = HSLuvColor.fromColor(Colors(0xffef3e4a));
+  print(hsluvFromColor.toString());
+
+  final hsluvFromHSL = HSLuvColor.fromHSL(300, 70, 60);
+  print(hsluvFromHSL.toString());
+}
+```
+
+[<p align="center"><img src="https://github.com/bernaferrari/hsluv-dart/raw/master/assets/hsv_vs_hsluv.gif?raw=true" width="300"/></p>](example)
+
+[Sample app](example) showing HSV (top) vs HSLuv (bottom). See how the perceived lightness changes as the hue slider moves. 
+
+### Color values ranges
+- RGB values are ranging in [0...1]
+- HSLuv and HPLuv values have different ranging for their components
+    - H : [0...360]
+    - S and L : [0...100]
+- LUV has different ranging for their components
+    - L* : [0...100]
+    - u* and v* : [-100...100]
+- LCh has different ranging for their components
+    - L* : [0...100]
+    - C* : [0...?] Upper bound varies depending on L* and H*
+    - H* : [0...360]
+- XYZ values are ranging in [0...1]
+
+**Important**: Flutter's HSLColor has lightness and saturation ranging from 0 to 1.0. HSLuv uses 0 to 100.
+There is a class, called HSInterColor in the [sample](example) that tries to mitigate this.
+
+### API functions
+
+#### Note
+The passing/returning values, when not `String` are `List<double>` containing each component of the given color space/system in the name's order :
+- RGB : [red, blue, green]
+- XYZ : [X, Y, Z]
+- LCH : [L, C, H]
+- LUV : [L, u, v]
+- HSLuv/HPLuv : [H, S, L]
+
+#### Function listing
+- `xyzToRgb(List<double> tuple)`
+- `rgbToXyz(List<double> tuple)`
+- `xyzToLuv(List<double> tuple)`
+- `luvToXyz(List<double> tuple)`
+- `luvToLch(List<double> tuple)`
+- `lchToLuv(List<double> tuple)`
+- `hsluvToLch(List<double> tuple)`
+- `lchToHsluv(List<double> tuple)`
+- `hpluvToLch(List<double> tuple)`
+- `lchToHpluv(List<double> tuple)`
+- `lchToRgb(List<double> tuple)`
+- `rgbToLch(List<double> tuple)`
+- `hsluvToRgb(List<double> tuple)`
+- `rgbToHsluv(List<double> tuple)`
+- `hpluvToRgb(List<double> tuple)`
+- `rgbToHpluv(List<double> tuple)`
+- `hsluvToHex(List<double> tuple)`
+- `hpluvToHex(List<double> tuple)`
+- `hexToHsluv(String s)`
+- `hexToHpluv(String s)`
+- `rgbToHex(List<double> tuple)`
+- `hexToRgb(String hex)`
+
+### Reporting Issues
+
+Issues and Pull Requests are welcome.
+You can report [here](https://github.com/bernaferrari/hsluv-dart/issues).
+
+### License
+
+    Copyright 2019 Bernardo Ferrari
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

example/README.md

@@ -1,16 +1,100 @@
-# material
+<p align="center"><img src="https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/ic_launcher-playstore.png" alt="HSLuv Sample" height="200px"></p>
 
-A new Flutter project.
+HSLuv Sample for Flutter
+===================================
 
-## Getting Started
+| Sliders | Main Screen | Color Blindness | About |
+|:-:|:-:|:-:|:-:|
+| ![First](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/sliders.jpg?raw=true) | ![Sec](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/main.jpg?raw=true) | ![Third](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/color-blindness.jpg?raw=true) | ![Fourth](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/about.jpg?raw=true) |
 
-This project is a starting point for a Flutter application.
+Most color pickers give you 16 million colors and ask you to choose one. I designed and developed this app to help developers and designers find the best color for them with the smallest amount of effort.
 
-A few resources to get you started if this is your first Flutter project:
+This app is actually part of another one, which is coming out hopefully soon and will also be open source. The project grew so large I thought it was better to split in two, test the public reception and collect feedback before moving forward. This is why this might be one of the most full-fledged over-engineered sample apps out there.
+It is hard to develop alone. If you have any good or bad feedback, want to be alerted when the bigger app is released or want to be more involved, [please contact me](mailto:[email protected])!
 
-- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
+[Download the APK](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/hsluv_sample.apk)
 
-For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+This app contains the following screens:
+* Three sliders. RGB, HSV and HSLuv. You can see how they interact with each other.
+* HSLuv/HSV vertical picker. Shows a lot of colors without being overwhelming.
+* About. Contains a button to shuffle colors and a button open the compare colors screen.
+* Color Library. Colors from [Color Claim](https://www.vanschneider.com/colors), the color palette from Tobias van Schneider. 
+* Compare Colors. Compare the WACG contrast between the first color and all the others. 
+* Info. Check how the color attributes are changing from first color to others. Easy to see patterns (i.e. colors are similar but only Hue is changing!) 
+
+## Color Blindness
+> Color blindness involves difficulty in perceiving or distinguishing between colors, as well as sensitivity to color brightness. It affects approximately one in twelve men and one in two hundred women worldwide.
+> [Carbon Design System](https://www.carbondesignsystem.com/guidelines/accessibility/color#introduction)
+
+| Type           | Color deficiency |
+| -------------- | ---------------- |
+| _Protanopia_   | Red/green        |
+| _Tritanopia_   | Blue             |
+| _Deuteranopia_ | Green            |
+| _Monochromacy_ | All colors       |
+
+The app calculates color blindness by using the formulas from a Swift library named [Colorblinds](https://github.com/jdekock/Colorblinds).
+
+## Contrast
+[WCAG](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html) specifies:
+- **3.0:1** minimum contrast ratio for texts larger than 18pt (AA+).
+- **4.5:1** minimum contrast ratio for texts smaller than 18pt (AA).
+- **7.0:1** minimum contrast ratio is preferred, when possible (AAA).
+
+The Compare Colors screen will help you check if your color palette is accessible enough.
+
+For more information about those A letters, [see this guide](https://usecontrast.com/guide). [IBM Checkpoint 1.4.3 Contrast (Minimum)](https://www.ibm.com/able/guidelines/ci162/contrast.html).
+Google [also follows](https://material.io/design/usability/accessibility.html#color-contrast) these guidelines in Material Design.
+
+## Color Claim
+The app uses [Color Claim](https://www.vanschneider.com/colors) as the main palette, both in "Color Library" screen and when shuffling colors.
+Every time the method to shuffle the colors is called, it is actually retrieving Color Claim, shuffling it, and getting the first n elements.
+This pseudo-randomization strategy guarantees nice colors always. 
+
+To retrieve the colors, I opened the `colorclaim.1.1.sketchpalette` file in Visual Studio Code and took all the hex colors.
+
+| Compare | Info | Color Library |
+|:-:|:-:|:-:|
+| ![First](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/compare.jpg?raw=true) | ![Sec](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/info.jpg?raw=true) | ![Third](https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/library.jpg?raw=true) |
+
+## HSV vs HSLuv
+<p align="center"><img src="https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/hsluv_vs_hsv.jpg" alt="HSV vs HSLuv" height="350px"></p>
+You can see in that image the difference between Hue values in HSV (or HSL, which has the same Hue values) and HSLuv. HSLuv only changes the apparent lightness when lightness changes.
+You can change both Hue and Saturation values that, when compared to another color, the resulting contrast value will be the same. This is one of the foundations for the "Contrast Compare" screen.
+You only need to update the lightness value and nothing else to modify the contrast ratio. Therefore, you only need one picker or slider, not three, if you are aiming at the contrast.
+
+## HSInterColor
+While developing this app, there was a need to interop HSLuvColor with HSVColor (or HSLColor). Given the similarities but differences between both (HSLuv's Saturation and Lightness range from 0 to 100, instead of 0 to 1.0),
+ HSInterColor was born. You pass a kind parameter, which can be HSLuv or HSV and it automatically wraps them, so you can have unified `toString`, `toColor` and others. It is also extensible and modifying it to wrap other color structures should be easy.
+
+## Design Process
+<p align="center"><img src="https://github.com/bernaferrari/hsluv-dart/raw/master/example/assets/design_process.jpg" alt="Design Process" height="350px"></p>
+
+Many strategies were used to design this app. One of them was to draw in iPad using [Paper by Wetransfer](https://apps.apple.com/us/app/paper-by-wetransfer/id506003812) until a satisfiable design appeared.
+Another one was to sometimes test the app in iPad instead of phone. The large rectangular screen would make some designs immediately obsolete. And vice-versa. There was a previous iteration of the Color Compare screen that only compared two colors, but with a lot of details (like 3 selectors for each - H, S and V).
+This couldn't fit comfortably a phone's screen and, at the end, the 2 Color Compare screen was replaced by a multi Color Compare. It became more flexible and now works across all screens.
+
+## Why Flutter?
+I've been developing with Flutter for the past few months and has been a really enjoyable experience. There are [a lot bugs](https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+author%3Abernaferrari), tooling for Dart is miles behind Kotlin, and there was even a feature in this app that had to be disabled because of mutable bugs.
+On the good side, it avoided me having to do the same work 3 times and this
+ project even lead to [a contribution in Flutter](https://github.com/flutter/flutter/pull/40641), the addition of `onLongPress` in Buttons.
+
+Another fun thing: I needed to clone the Material Slider and modify it to fix [this](https://github.com/flutter/flutter/issues/40310). While not something good (or even expected), it is great that Flutter doesn't use private internal fields in their own libraries.
+This could never happen in native Android with Material Components. Everything is tightly coupled. 
+
+While there were many frustrations, bugs, and some things that weren't possible (yet), I am really happy with the result and there would be few benefits if **this** app were native.
+
+### Reporting Issues
+
+Issues and Pull Requests are welcome.
+You can report [here](https://github.com/bernaferrari/hsluv-dart/issues).
+
+### License
+
+    Copyright 2019 Bernardo Ferrari
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

example/android/.gitignore

@@ -0,0 +1,7 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java

example/ios/.gitignore

@@ -0,0 +1,32 @@
+*.mode1v3
+*.mode2v3
+*.moved-aside
+*.pbxuser
+*.perspectivev3
+**/*sync/
+.sconsign.dblite
+.tags*
+**/.vagrant/
+**/DerivedData/
+Icon?
+**/Pods/
+**/.symlinks/
+profile
+xcuserdata
+**/.generated/
+Flutter/App.framework
+Flutter/Flutter.framework
+Flutter/Flutter.podspec
+Flutter/Generated.xcconfig
+Flutter/app.flx
+Flutter/app.zip
+Flutter/flutter_assets/
+Flutter/flutter_export_environment.sh
+ServiceDefinitions.json
+Runner/GeneratedPluginRegistrant.*
+
+# Exceptions to above rules.
+!default.mode1v3
+!default.mode2v3
+!default.pbxuser
+!default.perspectivev3

example/lib/blocs/multiple_contrast_color/multiple_contrast_color_state.dart

@@ -2,7 +2,7 @@ import 'dart:ui';
 
 import 'package:equatable/equatable.dart';
 import 'package:flutter/cupertino.dart';
-import 'package:hsluv/flutter/hsluvcolor.dart';
+import 'package:hsluv/hsluvcolor.dart';
 import 'package:meta/meta.dart';
 
 @immutable

example/lib/blocs/slider_color/slider_color_bloc.dart

@@ -2,7 +2,7 @@ import 'dart:async';
 
 import 'package:bloc/bloc.dart';
 import 'package:flutter/cupertino.dart';
-import 'package:hsluv/flutter/hsluvcolor.dart';
+import 'package:hsluv/hsluvcolor.dart';
 import 'package:hsluvsample/blocs/slider_color/slider_color_state.dart';
 import 'package:rxdart/rxdart.dart';
 

example/lib/blocs/slider_color/slider_color_state.dart

@@ -2,7 +2,7 @@ import 'dart:ui';
 
 import 'package:equatable/equatable.dart';
 import 'package:flutter/cupertino.dart';
-import 'package:hsluv/flutter/hsluvcolor.dart';
+import 'package:hsluv/hsluvcolor.dart';
 import 'package:meta/meta.dart';
 
 @immutable

example/lib/contrast/contrast_list.dart

@@ -47,8 +47,7 @@ class ContrastList extends StatelessWidget {
               scrollDirection: Axis.horizontal,
               key: PageStorageKey<String>("$pageKey $sectionIndex"),
               itemBuilder: (BuildContext context, int absoluteIndex) {
-                final int index = absoluteIndex.abs() % listSize;
-                return colorCompare(index);
+                return colorCompare(absoluteIndex % listSize);
               },
             )
           : MediaQuery.removePadding(

example/lib/contrast/contrast_screen.dart

@@ -572,6 +572,8 @@ class _Buttons extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
+    final contrastColor = contrastingColor(color);
+
     return Row(
       children: <Widget>[
         OutlineButton.icon(
@@ -580,6 +582,7 @@ class _Buttons extends StatelessWidget {
             size: 16,
           ),
           color: color,
+          textColor: contrastColor,
           highlightedBorderColor: otherColor,
           borderSide: BorderSide(color: otherColor),
           label: Text(color.toHexStr()),
@@ -604,6 +607,7 @@ class _Buttons extends StatelessWidget {
               Theme.of(context).colorScheme.onSurface.withOpacity(0.12),
           minWidth: 48,
           elevation: 0,
+          textColor: contrastColor,
           child: Icon(
             FeatherIcons.shuffle,
             size: 16,

example/lib/hsinter.dart

@@ -3,7 +3,7 @@ import 'dart:ui';
 
 import 'package:flutter/cupertino.dart';
 import 'package:flutter/foundation.dart';
-import 'package:hsluv/flutter/hsluvcolor.dart';
+import 'package:hsluv/hsluvcolor.dart';
 import 'package:hsluvsample/util/when.dart';
 
 /// HSInterColor means Hue Saturation Interchangeable Color.

example/lib/main.dart

@@ -62,19 +62,19 @@ class _BoxedAppState extends State<BoxedApp> {
     return MultiBlocProvider(
       providers: [
         BlocProvider<MultipleContrastColorBloc>(
-          builder: (context) => MultipleContrastColorBloc(_sliderBloc)
+          create: (context) => MultipleContrastColorBloc(_sliderBloc)
             ..add(
               MultipleLoadInit(getShuffledColors()),
             ),
         ),
         BlocProvider<SliderColorBloc>(
-          builder: (context) => _sliderBloc,
+          create: (context) => _sliderBloc,
         ),
         BlocProvider<MdcSelectedBloc>(
-          builder: (context) => MdcSelectedBloc(_sliderBloc, colorBlindBloc),
+          create: (context) => MdcSelectedBloc(_sliderBloc, colorBlindBloc),
         ),
         BlocProvider<ColorBlindBloc>(
-          builder: (context) => colorBlindBloc,
+          create: (context) => colorBlindBloc,
         )
       ],
       child: MaterialApp(

example/lib/mdc/util/color_blind_from_index.dart

@@ -1,18 +1,9 @@
 import 'package:flutter/cupertino.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/widgets.dart';
-import 'package:flutter_bloc/flutter_bloc.dart';
-import 'package:flutter_feather_icons/flutter_feather_icons.dart';
-import 'package:hsluvsample/blocs/blocs.dart';
-import 'package:hsluvsample/contrast/shuffle_color.dart';
 import 'package:hsluvsample/screens/single_color_blindness.dart';
-import 'package:hsluvsample/util/selected.dart';
-import 'package:hsluvsample/util/tiny_color.dart';
 import 'package:hsluvsample/util/when.dart';
-import 'package:hsluvsample/widgets/loading_indicator.dart';
-import 'package:infinite_listview/infinite_listview.dart';
 
-import '../../contrast/inter_color_with_contrast.dart';
 import '../../util/color_blindness.dart';
 
 ColorWithBlind getColorBlindFromIndex(Color color, int i) {