update the natural language output to be more sql-y

public/lang-docs.md

@@ -90,7 +90,7 @@ Maps:
 
 Description: Highly saturated light colors are not appropriate for palettes that seek to be serious.  See "Affective color in visualization" for more.
 
-Natural Language: ALL c in colors WHERE hsl.l(c) > 70, NOT hsl.s(c) > 70
+Natural Language: ALL c IN colors WHERE hsl.l(c) > 70 SUCH THAT NOT hsl.s(c) > 70
 
 
 Program:
@@ -122,7 +122,7 @@ Program:
 
 Description: Highly saturated light colors are not appropriate for palettes that seek to be trustworthy.  See "Affective color in visualization" for more.
 
-Natural Language: ALL c in colors WHERE hsl.l(c) > 70, NOT hsl.s(c) > 70
+Natural Language: ALL c IN colors WHERE hsl.l(c) > 70 SUCH THAT NOT hsl.s(c) > 70
 
 
 Program:
@@ -154,7 +154,7 @@ Program:
 
 Description: Highly saturated light colors are not appropriate for palettes that seek to be calm.  See "Affective color in visualization" for more.
 
-Natural Language: ALL c in colors WHERE hsl.l(c) > 70, NOT hsl.s(c) > 70
+Natural Language: ALL c IN colors WHERE hsl.l(c) > 70 SUCH THAT NOT hsl.s(c) > 70
 
 
 Program:
@@ -186,7 +186,7 @@ Program:
 
 Description: Palettes that seek to be playful should have at least one light blue, beige, or gray.  See "Affective color in visualization" for more.
 
-Natural Language: EXIST c in colors, (similar(c, lightblue) < 20 or similar(c, beige) < 20 or similar(c, gray) < 20)
+Natural Language: EXIST c IN colors SUCH THAT (similar(c, lightblue) < 20 OR similar(c, beige) < 20 OR similar(c, gray) < 20)
 
 
 Program:
@@ -217,7 +217,7 @@ Program:
 
 Description: Palettes that seek to be positive should not have dark reds or browns.  See "Affective color in visualization" for more.
 
-Natural Language: ALL c in colors, NOT (similar(c, darkred) < 20 or similar(c, brown) < 20)
+Natural Language: ALL c IN colors SUCH THAT NOT (similar(c, darkred) < 20 OR similar(c, brown) < 20)
 
 
 Program:
@@ -249,7 +249,7 @@ Program:
 
 Description: Palettes that seek to be negative should not have light colors, particularly greens.  See "Affective color in visualization" for more.
 
-Natural Language: ALL c in colors, NOT (similar(c, green) < 20 or lab.l(c) > 70)
+Natural Language: ALL c IN colors SUCH THAT NOT (similar(c, green) < 20 OR lab.l(c) > 70)
 
 
 Program:
@@ -283,7 +283,7 @@ Program:
 
 Description: All colors in a palette should be differentiable by people with deuteranopia (ie can't see green). This is because if they are not, then they will not be differentiable from each other in some contexts.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), NOT similar(cvdSim(a, deuteranopia), cvdSim(b, deuteranopia)) < 9
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT NOT similar(cvdSim(a, deuteranopia), cvdSim(b, deuteranopia)) < 9
 
 Palettes that will fail this test:
 
@@ -327,7 +327,7 @@ Program:
 
 Description: All colors in a palette should be differentiable by people with protanopia (ie can't see red). This is because if they are not, then they will not be differentiable from each other in some contexts.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), NOT similar(cvdSim(a, protanopia), cvdSim(b, protanopia)) < 9
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT NOT similar(cvdSim(a, protanopia), cvdSim(b, protanopia)) < 9
 
 Palettes that will fail this test:
 
@@ -371,7 +371,7 @@ Program:
 
 Description: All colors in a palette should be differentiable by people with tritanopia (ie can't see blue). This is because if they are not, then they will not be differentiable from each other in some contexts.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), NOT similar(cvdSim(a, tritanopia), cvdSim(b, tritanopia)) < 9
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT NOT similar(cvdSim(a, tritanopia), cvdSim(b, tritanopia)) < 9
 
 Palettes that will fail this test:
 
@@ -415,7 +415,7 @@ Program:
 
 Description: All colors in a palette should be differentiable by people with grayscale . This is because if they are not, then they will not be differentiable from each other in some contexts.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), NOT similar(cvdSim(a, grayscale), cvdSim(b, grayscale)) < 9
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT NOT similar(cvdSim(a, grayscale), cvdSim(b, grayscale)) < 9
 
 Palettes that will fail this test:
 
@@ -459,7 +459,7 @@ Program:
 
 Description: Axes should have low contrast with the background. Having it too high can make the axes too distracting. See "Whisper, Don't Scream: Grids and Transparency" for more.
 
-Natural Language: ALL a in colors WHERE isTag(a, axis), contrast(a, background, Lstar) < 20
+Natural Language: ALL a IN colors WHERE isTag(a, axis) SUCH THAT contrast(a, background, Lstar) < 20
 
 Palettes that will fail this test:
 
@@ -500,7 +500,7 @@ Program:
 
 Description: Blue should be high probability for the basic color term blue. If it's not, it can be confusing to users.
 
-Natural Language: ALL a in colors WHERE isTag(a, blue), name(a) == blue
+Natural Language: ALL a IN colors WHERE isTag(a, blue) SUCH THAT name(a) == blue
 
 Palettes that will fail this test:
 
@@ -540,7 +540,7 @@ Program:
 
 Description: Do the colors stand out equally? A color palette is described as fair if both chroma and luminance ranges are below a certain threshold and unfair if one of them is above a certain threshold.
 
-Natural Language: (extent(sort(colors, x => lch.l(x))) < 50 and extent(sort(colors, x => lch.c(x))) < 80)
+Natural Language: (extent(sort(colors, x => lch.l(x))) < 50 AND extent(sort(colors, x => lch.c(x))) < 80)
 
 Palettes that will fail this test:
 
@@ -628,7 +628,7 @@ Program:
 
 Description: Background should be sufficiently desaturated. 
 
-Natural Language: (((hsl.l(background) > 90 and hsv.s(background) < 8) or hsl.l(background) > 99) or (hsl.l(background) > 10 and hsl.l(background) < 26 and hsv.s(background) < 21))
+Natural Language: (((hsl.l(background) > 90 AND hsv.s(background) < 8) OR hsl.l(background) > 99) OR (hsl.l(background) > 10 AND hsl.l(background) < 26 AND hsv.s(background) < 21))
 
 Palettes that will fail this test:
 
@@ -690,7 +690,7 @@ Program:
 
 Description: Tetradic palettes are hard to work with and are not recommended.
 
-Natural Language: NOT EXIST a in colors, (EXIST b in colors, similar(hsl.h(a), hsl.h(b) + 90) < 5 and EXIST b in colors, similar(hsl.h(a), hsl.h(b) + 90) < 5 and EXIST b in colors, similar(hsl.h(a), hsl.h(b) + 90) < 5)
+Natural Language: NOT EXIST a IN colors SUCH THAT (EXIST b IN colors SUCH THAT similar(hsl.h(a), hsl.h(b) + 90) < 5 AND EXIST b IN colors SUCH THAT similar(hsl.h(a), hsl.h(b) + 90) < 5 AND EXIST b IN colors SUCH THAT similar(hsl.h(a), hsl.h(b) + 90) < 5)
 
 Palettes that will fail this test:
 
@@ -775,7 +775,7 @@ Program:
 
 Description: When using green, make it a yellow or blue one. This makes it easier to play nicely with other colors.
 
-Natural Language: ALL a in colors, (hsl.h(a) < 90 or hsl.h(a) > 150)
+Natural Language: ALL a IN colors SUCH THAT (hsl.h(a) < 90 OR hsl.h(a) > 150)
 
 Palettes that will fail this test:
 
@@ -819,7 +819,7 @@ Program:
 
 Description: Don't make your colors too dark and saturated when you're using a bright background. If in doubt, try it out. Make your colors lighter, pull some saturation out of them and see how it feels.
 
-Natural Language: ((hsl.l(background) > 50 and ALL a in colors, contrast(a, background, WCAG21) < 10) or hsl.l(background) < 50)
+Natural Language: ((hsl.l(background) > 50 AND ALL a IN colors SUCH THAT contrast(a, background, WCAG21) < 10) OR hsl.l(background) < 50)
 
 Palettes that will fail this test:
 
@@ -873,7 +873,7 @@ Program:
 
 Description: Use color complements whenever possible
 
-Natural Language: EXIST (a, b) in colors, similar(hsl.h(a), hsl.h(b) + 180) < 5
+Natural Language: EXIST (a, b) IN colors SUCH THAT similar(hsl.h(a), hsl.h(b) + 180) < 5
 
 
 Program:
@@ -906,7 +906,7 @@ Program:
 
 Description: Pairs of colors in a palette should be differentiable from each other in Thin marks. 
 
-Natural Language: ALL (x, y) in colors WHERE index(x) != index(y), (lab.l(x) absDiff lab.l(y) > 12.58 or lab.a(x) absDiff lab.a(y) > 20.740000000000002 or lab.b(x) absDiff lab.b(y) > 34.05)
+Natural Language: ALL (x, y) IN colors WHERE index(x) != index(y) SUCH THAT (absDiff(lab.l(x), lab.l(y)) > 12.58 OR absDiff(lab.a(x), lab.a(y)) > 20.740000000000002 OR absDiff(lab.b(x), lab.b(y)) > 34.05)
 
 Palettes that will fail this test:
 
@@ -969,7 +969,7 @@ Program:
 
 Description: Pairs of colors in a palette should be differentiable from each other in Medium marks. 
 
-Natural Language: ALL (x, y) in colors WHERE index(x) != index(y), (lab.l(x) absDiff lab.l(y) > 6.58 or lab.a(x) absDiff lab.a(y) > 8.42 or lab.b(x) absDiff lab.b(y) > 11.09)
+Natural Language: ALL (x, y) IN colors WHERE index(x) != index(y) SUCH THAT (absDiff(lab.l(x), lab.l(y)) > 6.58 OR absDiff(lab.a(x), lab.a(y)) > 8.42 OR absDiff(lab.b(x), lab.b(y)) > 11.09)
 
 Palettes that will fail this test:
 
@@ -1032,7 +1032,7 @@ Program:
 
 Description: Pairs of colors in a palette should be differentiable from each other in Wide marks. 
 
-Natural Language: ALL (x, y) in colors WHERE index(x) != index(y), (lab.l(x) absDiff lab.l(y) > 5.83 or lab.a(x) absDiff lab.a(y) > 6.88 or lab.b(x) absDiff lab.b(y) > 8.219999999999999)
+Natural Language: ALL (x, y) IN colors WHERE index(x) != index(y) SUCH THAT (absDiff(lab.l(x), lab.l(y)) > 5.83 OR absDiff(lab.a(x), lab.a(y)) > 6.88 OR absDiff(lab.b(x), lab.b(y)) > 8.219999999999999)
 
 Palettes that will fail this test:
 
@@ -1095,7 +1095,7 @@ Program:
 
 Description: Colors at either end of the lightness spectrum can be hard to discriminate in some contexts, and are sometimes advised against. See https://blog.datawrapper.de/beautifulcolors/#6 for more.
 
-Natural Language: ALL a in colors, ALL b in ([#000000, #ffffff, #0000ff, #ff0000, #00ff00]), NOT a == b
+Natural Language: ALL a IN colors SUCH THAT ALL b IN ([#000000, #ffffff, #0000ff, #ff0000, #00ff00]) SUCH THAT NOT a == b
 
 Palettes that will fail this test:
 
@@ -1138,7 +1138,7 @@ Program:
 
 Description: All colors in a palette should have a sufficient contrast ratio with the background color. This is because if they are not, then they will not be differentiable from each other in some contexts. Valid algorithms are "APCA", "WCAG21", "Michelson", "Weber", "Lstar", "DeltaPhi".
 
-Natural Language: ALL a in colors, contrast(a, background, WCAG21) > 1.1
+Natural Language: ALL a IN colors SUCH THAT contrast(a, background, WCAG21) > 1.1
 
 Palettes that will fail this test:
 
@@ -1178,7 +1178,7 @@ Program:
 
 Description: Opt for colors that are perceptually distinguishable in a logical sequence when designing visual elements like charts or graphs. This ensures that viewers can easily recognize the order or progression of data points. For categorical this means that when only a small number of colors are used, they should be as different as possible. For sequential and diverging, this means that the colors should be as different as possible in order.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) == index(b) - 1, deltaE(a, b, 2000) > 10
+Natural Language: ALL (a, b) IN colors WHERE index(a) == index(b) - 1 SUCH THAT deltaE(a, b, 2000) > 10
 
 Palettes that will fail this test:
 
@@ -1224,7 +1224,7 @@ Program:
 
 Description: Categorical values should have an even distribution around the hue circle in LCH color space
 
-Natural Language: (std(speed(sort(colors, x => lch.h(x)),   =>  )) < 10 or std(speed(sort(colors, x => lch.h(x) + 180 % 360),   =>  )) < 10)
+Natural Language: (std(speed(sort(colors, x => lch.h(x)))) < 10 OR std(speed(sort(colors, x => lch.h(x) + 180 % 360))) < 10)
 
 Palettes that will fail this test:
 
@@ -1289,7 +1289,7 @@ Program:
 
 Description: Checks if the colors are in the sRGB gamut. This is important to ensure that the colors are visible and can be displayed on most devices.
 
-Natural Language: ALL a in colors, inGamut(a) == TRUE
+Natural Language: ALL a IN colors SUCH THAT inGamut(a) == TRUE
 
 Palettes that will fail this test:
 
@@ -1357,7 +1357,7 @@ Program:
 
 Description: All colors in a palette should be different from each other. This is because if they are not, then they will not be differentiable from each other in some contexts.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), dist(a, b, lab) > 15
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT dist(a, b, lab) > 15
 
 Palettes that will fail this test:
 
@@ -1398,7 +1398,7 @@ Program:
 
 Description: Being able to identify colors by name is important for usability and for memorability.
 
-Natural Language: ALL (a, b) in colors WHERE index(a) != index(b), name(a) != name(b)
+Natural Language: ALL (a, b) IN colors WHERE index(a) != index(b) SUCH THAT name(a) != name(b)
 
 Palettes that will fail this test:
 
@@ -1436,7 +1436,7 @@ Program:
 
 Description: Sequential palettes should be ordered by lightness. This is a defining property of a sequential palette and ensures that values are understood as having an increase (or decreasing) value.
 
-Natural Language: (sort(colors, x => lch.l(x)) == map(colors, x => lch.l(x)) or sort(colors, x => lch.l(x)) == reverse(map(colors, x => lch.l(x)),   =>  ))
+Natural Language: (sort(colors, x => lch.l(x)) == map(colors, x => lch.l(x)) OR sort(colors, x => lch.l(x)) == reverse(map(colors, x => lch.l(x))))
 
 Palettes that will fail this test:
 
@@ -1482,7 +1482,7 @@ Program:
 
 Description: Colors that are close to what are known as ugly colors are sometimes advised against. See https://www.colourlovers.com/palette/1416250/The_Ugliest_Colors for more details.
 
-Natural Language: ALL a in colors, ALL b in ([#56FF00, #0010FF, #6A7E25, #FF00EF, #806E28]), deltaE(a, b, 2000) > 10
+Natural Language: ALL a IN colors SUCH THAT ALL b IN ([#56FF00, #0010FF, #6A7E25, #FF00EF, #806E28]) SUCH THAT deltaE(a, b, 2000) > 10
 
 Palettes that will fail this test: