feat: Expose color names, keywords and KeywordSet class (#473)

closes #311

---------

Co-authored-by: Bart Veneman <bart@frameless.io>

Author: bartveneman

src/index.js

@@ -1083,4 +1083,15 @@ export {
   isValuePrefixed
 } from './values/vendor-prefix.js'
 
+export {
+  colorFunctions,
+  colorKeywords,
+  namedColors,
+  systemColors,
+} from './values/colors.js'
+
+export { keywords as cssKeywords } from './values/values.js'
+
 export { hasVendorPrefix } from './vendor-prefix.js'
+
+export { KeywordSet } from './keyword-set.js'

src/index.test.js

@@ -11,6 +11,13 @@ import {
   isPropertyHack,
   isValuePrefixed,
   hasVendorPrefix,
+  cssKeywords,
+  KeywordSet,
+  // Color exports
+  namedColors,
+  systemColors,
+  colorFunctions,
+  colorKeywords,
 } from "./index.js"
 
 const Api = suite("Public API")
@@ -55,6 +62,32 @@ Api('exposes the "hasVendorPrefix" method', () => {
   assert.is(typeof hasVendorPrefix, "function")
 })
 
+Api('exposes the namedColors KeywordSet', () => {
+  assert.ok(namedColors.has('Red'))
+})
+
+Api('exposes the systemColors KeywordSet', () => {
+  assert.ok(systemColors.has('LinkText'))
+})
+
+Api('exposes the colorFunctions KeywordSet', () => {
+  assert.ok(colorFunctions.has('okLAB'))
+})
+
+Api('exposes the colorKeywords KeywordSet', () => {
+  assert.ok(colorKeywords.has('TRANSPARENT'))
+})
+
+Api('exposes CSS keywords KeywordSet', () => {
+  assert.ok(cssKeywords.has('Auto'))
+  assert.ok(cssKeywords.has('inherit'))
+})
+
+Api('exposes the KeywordSet class', () => {
+  assert.is(typeof KeywordSet, 'function')
+  assert.is((new KeywordSet()).constructor.name, 'KeywordSet')
+})
+
 Api("does not break on CSS Syntax Errors", () => {
   assert.not.throws(() => analyze("test, {}"))
   assert.not.throws(() => analyze("test { color red }"))

src/keyword-set.js

@@ -3,7 +3,7 @@
  */
 export class KeywordSet {
 
-	/** @param {string[]} items */
+	/** @param {Lowercase<string>[]} items */
 	constructor(items) {
 		/** @type {Set<string>} */
 		this.set = new Set(items)

src/keyword-set.test.js

@@ -0,0 +1,15 @@
+import { KeywordSet } from './keyword-set.js'
+import { test } from 'uvu'
+import * as assert from "uvu/assert"
+
+test('happy path', () => {
+	assert.not.ok(new KeywordSet([]).has('a'))
+	expect.not.ok(new KeywordSet([]).has(''))
+	expect.ok(new KeywordSet(['a', 'b']).has('a'))
+	expect.ok(new KeywordSet(['a', 'b']).has('A'))
+	expect.not.ok(new KeywordSet(['a', 'b']).has('aa'))
+
+	expect.ok(new KeywordSet(['currentcolor']).has('currentColor'))
+	expect.ok(new KeywordSet(['marktext']).has('MarkText'))
+	expect.ok(new KeywordSet(['revert-layer']).has('Revert-Layer'))
+})