Add hex conversion

Author: PhoneDroid

Documentation/Conversions.md

@@ -30,6 +30,23 @@ All channels are integers in the range of  `0 - 255`
 <br>
 <br>
 
+## Hex ( + Alpha )
+
+All channels are integers in the range of  `0 - FF`
+
+<br>
+
+|   | Hex | Hex (Alpha) |
+|:-:|:---:|:-----------:|
+| **Single** | `#RGB`    | `#RGBA`
+| **Double** | `#RRGGBB` | `#RRGGBBAA`
+
+*`#`  is optional.*
+
+<br>
+<br>
+
+
 ## CMYK ( A )
 
 All channels are decimals of  `0 - 100`  <br>

Documentation/Sources/Hex.md

@@ -0,0 +1,48 @@
+
+# Hex
+
+*Convert Hex color strings to HSL.*
+
+```JavaScript
+import { fromHex } from 'HSL'
+```
+
+<br>
+
+## Single & Double
+
+*Use either format to specify the RGB parts.*
+
+```JavaScript
+const hsl = fromHex('RGB');
+```
+
+```JavaScript
+const hsl = fromHex('RRGGBB');
+```
+
+<br>
+
+## Hashtag
+
+*Optionally place the  `#`  before it.*
+
+```JavaScript
+const hsl = fromHex('#RRGGBB');
+```
+
+<br>
+
+## Alpha
+
+*Optionally include an Alpha channel.*
+
+```JavaScript
+const hsla = fromHex('RGBA');
+```
+
+```JavaScript
+const hsla = fromHex('RRGGBBAA');
+```
+
+<br>

Documentation/Usage.md

@@ -11,7 +11,8 @@
 <br>
 
 [![Button RGB]][RGB]   
-[![Button CMYK]][CMYK]
+[![Button CMYK]][CMYK]   
+[![Button Hex]][Hex]
 
 </div>
 
@@ -47,9 +48,11 @@ import * as HSL from 'https://deno.land/x/hsl/mod.ts'
 
 [CMYK]: Sources/CMYK.md
 [RGB]: Sources/RGB.md
+[Hex]: Sources/Hex.md
 
 
 <!---------------------------------[ Buttons ]--------------------------------->
 
 [Button CMYK]: https://img.shields.io/badge/CMYK-04ACE6?style=for-the-badge
 [Button RGB]: https://img.shields.io/badge/RGB-37814A?style=for-the-badge
+[Button Hex]: https://img.shields.io/badge/Hex-EF2D5E?style=for-the-badge

Source/Sources/Hex.js

@@ -0,0 +1,43 @@
+
+import fromRGB from './RGB.js'
+
+
+const { errors } = Deno;
+const { log } = console;
+
+const 
+    channels_single = /^([0-9a-f]{1})([0-9a-f]{1})([0-9a-f]{1})([0-9a-f]{1})?$/i ,
+    channels_double = /^([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/i ;
+
+const invalid_hex_string = 
+    'Invalid hex color string format, must be (#)RRGGBB(AA) or (#)RGB(A)';
+
+const parseHex = (string) =>
+    parseInt(string,16);
+
+
+/*
+ *  (#)RRGGBB(AA) or (#)RGB(A) -> [ H , S , L , (A) ]
+ */
+
+export default function fromHex(hex){
+    
+    if(hex.startsWith('#'))
+        hex = hex.substring(1);
+    
+    const { length } = hex;
+    
+    const matches = 
+        hex.match(channels_double) ??
+        hex.match(channels_single) ;
+        
+    if(!matches)
+        throw new InvalidData(invalid_hex_string);
+
+    const channels = matches
+        .slice(1)
+        .filter((value) => value)
+        .map(parseHex);
+
+    return fromRGB(channels);
+}

Source/mod.ts

@@ -1,6 +1,7 @@
 
 import CMYK from './Sources/CMYK.js'
 import RGB from './Sources/RGB.js'
+import Hex from './Sources/Hex.js'
 
 
 /**
@@ -19,6 +20,22 @@ export function fromRGB (
 }
 
 
+/**
+ *  Convert a Hex color string to HSL
+ *  
+ *  Alpha channel can be included and won't be altered.
+ *
+ *  @param color (#)RRGGBB(AA) or (#)RGB(A)
+ *  @return A HSL(A) color array 
+ */
+
+export function fromHex (
+    color : string
+) : number [] {
+    return Hex( color ) as number [];
+}
+
+
 /**
  *  Convert a CMYK color to HSL
  *  

Tests/AssertColor.js

@@ -1,6 +1,6 @@
 
 
-import { fromCMYK , fromRGB } from 'HSL'
+import { fromCMYK , fromHex , fromRGB } from 'HSL'
 import { assertEquals } from 'Assert'
 
 
@@ -12,3 +12,8 @@ export function assertRGBIsHSL(input,output){
 export function assertCMYKIsHSL(input,output){
     assertEquals(fromCMYK(input),output);
 }
+
+
+export function assertHexIsHSL(input,output){
+    assertEquals(fromHex(input),output);
+}

Tests/Sources/Hex.js

@@ -0,0 +1,33 @@
+
+import { assertHexIsHSL } from 'AssertColor'
+
+const { test } = Deno;
+
+
+test('Hex String Conversion',() => {
+    
+    //  Black
+    
+    assertHexIsHSL('#000000',[ 0 , 0 , 0 ]);
+
+    
+    //  White
+    
+    assertHexIsHSL('#FFFFFF',[ 0 , 0 , 100 ]);
+    
+    
+    //  Red
+    
+    assertHexIsHSL('#FF0000',[ 0 , 100 , 50 ]);
+    
+    
+    //  Green
+    
+    assertHexIsHSL('#00FF00',[ 120 , 100 , 50 ]);
+    
+    
+    //  Blue
+    
+    assertHexIsHSL('#0000FF',[ 240 , 100 , 50 ]);
+
+})