[css-color-6] syntax to specify contrast algorithm for contrast-color(), following WG resolution

Closes #7356

Author: LeaVerou

css-color-6/Overview.bs

@@ -61,7 +61,8 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 	Its syntax is:
 
 	
-		contrast-color() = contrast-color( <> [ vs <>#{2,} ]? [ to [<> | AA | AA-large | AAA | AAA-large]]? )
+		contrast-color() = contrast-color( <> [ vs <>#{2,} ]? [ to <>]? )
+		<> = wcag2([<> | [ aa | aaa ] && large? ])
 	
 
 	The only mandatory argument is the first color, which is the color to be contrasted,
@@ -85,12 +86,14 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 	and the target contrast, if present, is separated from the list
 	with the keyword to.
 
+	The target contrast is specified by providing a function for the algorithm used
+	(currently only [WCAG 2.1](#luminance-contrast) is supported )
+	with the contrast ratio as the argument.
 
-
-	The keyword AA is equivalent to ''4.5'',
-	 AA-large is equivalent to ''3'',
-	 AAA is equivalent to ''7'', and
-	 AAA-large is equivalent to ''4.5'' .
+	For ''wcag2()'', ''aa'' is equivalent to ''4.5'',
+	''aa large'' (or ''large aa'') is equivalent to ''3'',
+	''aaa'' is equivalent to ''7'',
+	and ''aaa large'' (or ''large aaa'') is equivalent to ''4.5''.
 
 
 	Calculating luminance and WCAG 2.1 contrast
@@ -160,7 +163,7 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 		https://colorjs.io/notebook/?storage=https%3A%2F%2Fgist.github.com%2Fsvgeesus%2Fec249f376fcecbaa8794f75dbfc1dacf
 	-->
 
-		contrast-color(wheat vs bisque, darkgoldenrod, olive, sienna, darkgreen, maroon to AA)
+		contrast-color(wheat vs bisque, darkgoldenrod, olive, sienna, darkgreen, maroon to wcag2(aa))
 
 		The calculation is as follows:
 			*  wheat (#f5deb3), the background, has relative luminance 0.749
@@ -177,7 +180,7 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 	
 
 
-		contrast-color(wheat vs bisque, darkgoldenrod, olive, sienna, darkgreen, maroon to 5.8)
+		contrast-color(wheat vs bisque, darkgoldenrod, olive, sienna, darkgreen, maroon to wcag2(5.8))
 
 		The calculation is as follows:
 			* the relative luminances and contrast ratios are the same as the previous example.
@@ -205,7 +208,7 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 	whichever has the higher contrast.
 
 
-		contrast-color(wheat vs bisque, darkgoldenrod, olive to AA)
+		contrast-color(wheat vs bisque, darkgoldenrod, olive to wcag2(AA))
 
 		The calculation is as follows:
 			* the relative luminances and contrast ratios are the same as the previous example.
@@ -268,7 +271,7 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 			For example, given the value
 
 			
-				contrast-color(rgb(179 213 230) vs cadetblue, hsl(200 83% 23%) to AA)
+				contrast-color(rgb(179 213 230) vs cadetblue, hsl(200 83% 23%) to wcag2(AA))
 			
 
 			the contrast with cadetblue is 1.97
@@ -289,13 +292,13 @@ Computing a sufficiently contrasting color: the ''contrast-color()'' function {#
 			the value
 
 			
-				contrast-color(currentColor vs hsl(200 83% 23%), purple to AA)
+				contrast-color(currentColor vs hsl(200 83% 23%), purple to wcag2(AA))
 			
 
 			has the computed value
 
 			
-				contrast-color(currentColor vs rgb(10 75 107), rgb(128 0 128) to 4.5)
+				contrast-color(currentColor vs rgb(10 75 107), rgb(128 0 128) to wcag2(4.5))