Added isValid function

apps/tracer.js

@@ -0,0 +1,22 @@
+import isValid from "../src/isValid.js";
+
+// args: "lch(90 0 none)",
+// args: "oklch(1 0 none)",
+// args: "hsl(none, 50%, 50%)",
+
+function main () {
+	// const value = "#ff0066";
+	// const value = "color(display-p3 0 1 0 / .5)";
+	// const value = "oklch(100% 0 30deg)";
+	const value = "rgb(10deg 10 10)";
+
+	// const value = "lch(255 255 none / 255)";
+	// const value = "rgb(255 255)";
+	// const value = "blue";
+	// const value = "GREEN";
+	console.log(
+		`Hello from Tracer, color string '${value}' is ${isValid(value) ? "VALID" : "INVALID"}`,
+	);
+}
+
+main();

src/color.js

@@ -26,6 +26,7 @@ import {
 	set,
 	setAll,
 	display,
+	isValid,
 } from "./index-fn.js";
 
 import "./spaces/xyz-d50.js";
@@ -197,6 +198,7 @@ Color.defineFunctions({
 	toGamut,
 	distance,
 	deltas,
+	isValid,
 	toString: serialize,
 });
 

src/index-fn.js

@@ -19,6 +19,7 @@ export { default as to }                  from "./to.js";
 export { default as serialize }           from "./serialize.js";
 export { default as display }             from "./display.js";
 export { default as inGamut }             from "./inGamut.js";
+export { default as isValid }             from "./isValid.js";
 export { default as toGamut, toGamutCSS } from "./toGamut.js";
 export { default as distance }            from "./distance.js";
 export { default as deltas }              from "./deltas.js";

src/isValid.js

@@ -0,0 +1,91 @@
+/* eslint-disable curly */
+import { parseFunction } from "./parse.js";
+import KEYWORDS from "./keywords.js";
+
+/**
+ * Verify string can be parsed into a color object
+ * @param {String} str
+ * @returns boolean
+ */
+export default function isValid (str) {
+	if (!str) return false;
+	if (isColorHex(str)) return true;
+	if (isTransparent(str)) return true;
+	return validateParsedValue(str, parseFunction(str));
+}
+
+/**
+ * Return if parsed is valid and not a rgb function with angles
+ * @param {String} str
+ * @param {any} parsed
+ * @returns boolean
+ */
+const validateParsedValue = (str, parsed) => {
+	return !isParsedValid(parsed, str) || isParsedRGBWithAngles(parsed) ? false : true;
+};
+
+/**
+ * Return if string is "transparent"
+ * @param {String} str
+ * @returns boolean
+ */
+const isTransparent = str => {
+	return str === "transparent";
+};
+
+/**
+ * Return if parsed is valid
+ * @param {any} parsed
+ * @param {String} str
+ * @returns boolean
+ */
+const isParsedValid = (parsed, str) => {
+	if (
+		!parsed ||
+		!parsed.name ||
+		parsed.argMeta.filter(item => isTypeNumberPercentageOrAngle(item.type)).length < 3 ||
+		parsed.argMeta.filter(item => isTypeNumberPercentageOrAngle(item.type)).length > 4
+	) {
+		if (!KEYWORDS[str.toLowerCase()]) return false;
+	}
+	return true;
+};
+
+/**
+ * Return if parsed is a rgb function with angles
+ * @param {any} parsed
+ * @returns boolean
+ */
+const isParsedRGBWithAngles = parsed => {
+	if (
+		parsed &&
+		parsed.name === "rgb" &&
+		parsed.argMeta.filter(item => item.type === "<angle>").length
+	) {
+		return true;
+	}
+	return false;
+};
+
+/**
+ * Return if string is a number, percentage or angle
+ * @param {String} type
+ * @returns boolean
+ */
+const isTypeNumberPercentageOrAngle = type => {
+	return type === "<number>" || type === "<percentage>" || type === "<angle>" || !type;
+};
+
+/**
+ * Verify string is valid hex
+ * @param {String} str
+ * @returns boolean
+ */
+function isColorHex (str) {
+	const isString = color => color && typeof color === "string";
+	if (isString(str)) {
+		const regex = /^#([\da-f]{3}){1,2}$|^#([\da-f]{4}){1,2}$/i;
+		return str && regex.test(str);
+	}
+	return false;
+}

test/index-fn.js

@@ -8,6 +8,7 @@ let tests = await Promise.all(
 		"gamut",
 		"in_gamut",
 		"parse",
+		"isValid",
 		"contrast",
 		"multiply_matrices",
 	].map(name => import(`./${name}.js`).then(module => module.default)),

test/index.json

@@ -1,5 +1,6 @@
 {
 	"parse": "Parsing",
+	"isValid": "Is Valid",
 	"construct": "Object construction",
 	"conversions": "Conversions",
 	"delta": "DeltaE",