@optique/core 1.1.0-dev.2057 → 1.1.0-dev.2069

package/dist/valueparser.cjs

@@ -835,6 +835,1136 @@ function fileSize(options = {}) {
 		}
 	};
 }
+const CSS_NAMED_COLORS = {
+	aliceblue: {
+		r: 240,
+		g: 248,
+		b: 255,
+		a: 1
+	},
+	antiquewhite: {
+		r: 250,
+		g: 235,
+		b: 215,
+		a: 1
+	},
+	aqua: {
+		r: 0,
+		g: 255,
+		b: 255,
+		a: 1
+	},
+	aquamarine: {
+		r: 127,
+		g: 255,
+		b: 212,
+		a: 1
+	},
+	azure: {
+		r: 240,
+		g: 255,
+		b: 255,
+		a: 1
+	},
+	beige: {
+		r: 245,
+		g: 245,
+		b: 220,
+		a: 1
+	},
+	bisque: {
+		r: 255,
+		g: 228,
+		b: 196,
+		a: 1
+	},
+	black: {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 1
+	},
+	blanchedalmond: {
+		r: 255,
+		g: 235,
+		b: 205,
+		a: 1
+	},
+	blue: {
+		r: 0,
+		g: 0,
+		b: 255,
+		a: 1
+	},
+	blueviolet: {
+		r: 138,
+		g: 43,
+		b: 226,
+		a: 1
+	},
+	brown: {
+		r: 165,
+		g: 42,
+		b: 42,
+		a: 1
+	},
+	burlywood: {
+		r: 222,
+		g: 184,
+		b: 135,
+		a: 1
+	},
+	cadetblue: {
+		r: 95,
+		g: 158,
+		b: 160,
+		a: 1
+	},
+	chartreuse: {
+		r: 127,
+		g: 255,
+		b: 0,
+		a: 1
+	},
+	chocolate: {
+		r: 210,
+		g: 105,
+		b: 30,
+		a: 1
+	},
+	coral: {
+		r: 255,
+		g: 127,
+		b: 80,
+		a: 1
+	},
+	cornflowerblue: {
+		r: 100,
+		g: 149,
+		b: 237,
+		a: 1
+	},
+	cornsilk: {
+		r: 255,
+		g: 248,
+		b: 220,
+		a: 1
+	},
+	crimson: {
+		r: 220,
+		g: 20,
+		b: 60,
+		a: 1
+	},
+	cyan: {
+		r: 0,
+		g: 255,
+		b: 255,
+		a: 1
+	},
+	darkblue: {
+		r: 0,
+		g: 0,
+		b: 139,
+		a: 1
+	},
+	darkcyan: {
+		r: 0,
+		g: 139,
+		b: 139,
+		a: 1
+	},
+	darkgoldenrod: {
+		r: 184,
+		g: 134,
+		b: 11,
+		a: 1
+	},
+	darkgray: {
+		r: 169,
+		g: 169,
+		b: 169,
+		a: 1
+	},
+	darkgreen: {
+		r: 0,
+		g: 100,
+		b: 0,
+		a: 1
+	},
+	darkgrey: {
+		r: 169,
+		g: 169,
+		b: 169,
+		a: 1
+	},
+	darkkhaki: {
+		r: 189,
+		g: 183,
+		b: 107,
+		a: 1
+	},
+	darkmagenta: {
+		r: 139,
+		g: 0,
+		b: 139,
+		a: 1
+	},
+	darkolivegreen: {
+		r: 85,
+		g: 107,
+		b: 47,
+		a: 1
+	},
+	darkorange: {
+		r: 255,
+		g: 140,
+		b: 0,
+		a: 1
+	},
+	darkorchid: {
+		r: 153,
+		g: 50,
+		b: 204,
+		a: 1
+	},
+	darkred: {
+		r: 139,
+		g: 0,
+		b: 0,
+		a: 1
+	},
+	darksalmon: {
+		r: 233,
+		g: 150,
+		b: 122,
+		a: 1
+	},
+	darkseagreen: {
+		r: 143,
+		g: 188,
+		b: 143,
+		a: 1
+	},
+	darkslateblue: {
+		r: 72,
+		g: 61,
+		b: 139,
+		a: 1
+	},
+	darkslategray: {
+		r: 47,
+		g: 79,
+		b: 79,
+		a: 1
+	},
+	darkslategrey: {
+		r: 47,
+		g: 79,
+		b: 79,
+		a: 1
+	},
+	darkturquoise: {
+		r: 0,
+		g: 206,
+		b: 209,
+		a: 1
+	},
+	darkviolet: {
+		r: 148,
+		g: 0,
+		b: 211,
+		a: 1
+	},
+	deeppink: {
+		r: 255,
+		g: 20,
+		b: 147,
+		a: 1
+	},
+	deepskyblue: {
+		r: 0,
+		g: 191,
+		b: 255,
+		a: 1
+	},
+	dimgray: {
+		r: 105,
+		g: 105,
+		b: 105,
+		a: 1
+	},
+	dimgrey: {
+		r: 105,
+		g: 105,
+		b: 105,
+		a: 1
+	},
+	dodgerblue: {
+		r: 30,
+		g: 144,
+		b: 255,
+		a: 1
+	},
+	firebrick: {
+		r: 178,
+		g: 34,
+		b: 34,
+		a: 1
+	},
+	floralwhite: {
+		r: 255,
+		g: 250,
+		b: 240,
+		a: 1
+	},
+	forestgreen: {
+		r: 34,
+		g: 139,
+		b: 34,
+		a: 1
+	},
+	fuchsia: {
+		r: 255,
+		g: 0,
+		b: 255,
+		a: 1
+	},
+	gainsboro: {
+		r: 220,
+		g: 220,
+		b: 220,
+		a: 1
+	},
+	ghostwhite: {
+		r: 248,
+		g: 248,
+		b: 255,
+		a: 1
+	},
+	gold: {
+		r: 255,
+		g: 215,
+		b: 0,
+		a: 1
+	},
+	goldenrod: {
+		r: 218,
+		g: 165,
+		b: 32,
+		a: 1
+	},
+	gray: {
+		r: 128,
+		g: 128,
+		b: 128,
+		a: 1
+	},
+	green: {
+		r: 0,
+		g: 128,
+		b: 0,
+		a: 1
+	},
+	greenyellow: {
+		r: 173,
+		g: 255,
+		b: 47,
+		a: 1
+	},
+	grey: {
+		r: 128,
+		g: 128,
+		b: 128,
+		a: 1
+	},
+	honeydew: {
+		r: 240,
+		g: 255,
+		b: 240,
+		a: 1
+	},
+	hotpink: {
+		r: 255,
+		g: 105,
+		b: 180,
+		a: 1
+	},
+	indianred: {
+		r: 205,
+		g: 92,
+		b: 92,
+		a: 1
+	},
+	indigo: {
+		r: 75,
+		g: 0,
+		b: 130,
+		a: 1
+	},
+	ivory: {
+		r: 255,
+		g: 255,
+		b: 240,
+		a: 1
+	},
+	khaki: {
+		r: 240,
+		g: 230,
+		b: 140,
+		a: 1
+	},
+	lavender: {
+		r: 230,
+		g: 230,
+		b: 250,
+		a: 1
+	},
+	lavenderblush: {
+		r: 255,
+		g: 240,
+		b: 245,
+		a: 1
+	},
+	lawngreen: {
+		r: 124,
+		g: 252,
+		b: 0,
+		a: 1
+	},
+	lemonchiffon: {
+		r: 255,
+		g: 250,
+		b: 205,
+		a: 1
+	},
+	lightblue: {
+		r: 173,
+		g: 216,
+		b: 230,
+		a: 1
+	},
+	lightcoral: {
+		r: 240,
+		g: 128,
+		b: 128,
+		a: 1
+	},
+	lightcyan: {
+		r: 224,
+		g: 255,
+		b: 255,
+		a: 1
+	},
+	lightgoldenrodyellow: {
+		r: 250,
+		g: 250,
+		b: 210,
+		a: 1
+	},
+	lightgray: {
+		r: 211,
+		g: 211,
+		b: 211,
+		a: 1
+	},
+	lightgreen: {
+		r: 144,
+		g: 238,
+		b: 144,
+		a: 1
+	},
+	lightgrey: {
+		r: 211,
+		g: 211,
+		b: 211,
+		a: 1
+	},
+	lightpink: {
+		r: 255,
+		g: 182,
+		b: 193,
+		a: 1
+	},
+	lightsalmon: {
+		r: 255,
+		g: 160,
+		b: 122,
+		a: 1
+	},
+	lightseagreen: {
+		r: 32,
+		g: 178,
+		b: 170,
+		a: 1
+	},
+	lightskyblue: {
+		r: 135,
+		g: 206,
+		b: 250,
+		a: 1
+	},
+	lightslategray: {
+		r: 119,
+		g: 136,
+		b: 153,
+		a: 1
+	},
+	lightslategrey: {
+		r: 119,
+		g: 136,
+		b: 153,
+		a: 1
+	},
+	lightsteelblue: {
+		r: 176,
+		g: 196,
+		b: 222,
+		a: 1
+	},
+	lightyellow: {
+		r: 255,
+		g: 255,
+		b: 224,
+		a: 1
+	},
+	lime: {
+		r: 0,
+		g: 255,
+		b: 0,
+		a: 1
+	},
+	limegreen: {
+		r: 50,
+		g: 205,
+		b: 50,
+		a: 1
+	},
+	linen: {
+		r: 250,
+		g: 240,
+		b: 230,
+		a: 1
+	},
+	magenta: {
+		r: 255,
+		g: 0,
+		b: 255,
+		a: 1
+	},
+	maroon: {
+		r: 128,
+		g: 0,
+		b: 0,
+		a: 1
+	},
+	mediumaquamarine: {
+		r: 102,
+		g: 205,
+		b: 170,
+		a: 1
+	},
+	mediumblue: {
+		r: 0,
+		g: 0,
+		b: 205,
+		a: 1
+	},
+	mediumorchid: {
+		r: 186,
+		g: 85,
+		b: 211,
+		a: 1
+	},
+	mediumpurple: {
+		r: 147,
+		g: 112,
+		b: 219,
+		a: 1
+	},
+	mediumseagreen: {
+		r: 60,
+		g: 179,
+		b: 113,
+		a: 1
+	},
+	mediumslateblue: {
+		r: 123,
+		g: 104,
+		b: 238,
+		a: 1
+	},
+	mediumspringgreen: {
+		r: 0,
+		g: 250,
+		b: 154,
+		a: 1
+	},
+	mediumturquoise: {
+		r: 72,
+		g: 209,
+		b: 204,
+		a: 1
+	},
+	mediumvioletred: {
+		r: 199,
+		g: 21,
+		b: 133,
+		a: 1
+	},
+	midnightblue: {
+		r: 25,
+		g: 25,
+		b: 112,
+		a: 1
+	},
+	mintcream: {
+		r: 245,
+		g: 255,
+		b: 250,
+		a: 1
+	},
+	mistyrose: {
+		r: 255,
+		g: 228,
+		b: 225,
+		a: 1
+	},
+	moccasin: {
+		r: 255,
+		g: 228,
+		b: 181,
+		a: 1
+	},
+	navajowhite: {
+		r: 255,
+		g: 222,
+		b: 173,
+		a: 1
+	},
+	navy: {
+		r: 0,
+		g: 0,
+		b: 128,
+		a: 1
+	},
+	oldlace: {
+		r: 253,
+		g: 245,
+		b: 230,
+		a: 1
+	},
+	olive: {
+		r: 128,
+		g: 128,
+		b: 0,
+		a: 1
+	},
+	olivedrab: {
+		r: 107,
+		g: 142,
+		b: 35,
+		a: 1
+	},
+	orange: {
+		r: 255,
+		g: 165,
+		b: 0,
+		a: 1
+	},
+	orangered: {
+		r: 255,
+		g: 69,
+		b: 0,
+		a: 1
+	},
+	orchid: {
+		r: 218,
+		g: 112,
+		b: 214,
+		a: 1
+	},
+	palegoldenrod: {
+		r: 238,
+		g: 232,
+		b: 170,
+		a: 1
+	},
+	palegreen: {
+		r: 152,
+		g: 251,
+		b: 152,
+		a: 1
+	},
+	paleturquoise: {
+		r: 175,
+		g: 238,
+		b: 238,
+		a: 1
+	},
+	palevioletred: {
+		r: 219,
+		g: 112,
+		b: 147,
+		a: 1
+	},
+	papayawhip: {
+		r: 255,
+		g: 239,
+		b: 213,
+		a: 1
+	},
+	peachpuff: {
+		r: 255,
+		g: 218,
+		b: 185,
+		a: 1
+	},
+	peru: {
+		r: 205,
+		g: 133,
+		b: 63,
+		a: 1
+	},
+	pink: {
+		r: 255,
+		g: 192,
+		b: 203,
+		a: 1
+	},
+	plum: {
+		r: 221,
+		g: 160,
+		b: 221,
+		a: 1
+	},
+	powderblue: {
+		r: 176,
+		g: 224,
+		b: 230,
+		a: 1
+	},
+	purple: {
+		r: 128,
+		g: 0,
+		b: 128,
+		a: 1
+	},
+	rebeccapurple: {
+		r: 102,
+		g: 51,
+		b: 153,
+		a: 1
+	},
+	red: {
+		r: 255,
+		g: 0,
+		b: 0,
+		a: 1
+	},
+	rosybrown: {
+		r: 188,
+		g: 143,
+		b: 143,
+		a: 1
+	},
+	royalblue: {
+		r: 65,
+		g: 105,
+		b: 225,
+		a: 1
+	},
+	saddlebrown: {
+		r: 139,
+		g: 69,
+		b: 19,
+		a: 1
+	},
+	salmon: {
+		r: 250,
+		g: 128,
+		b: 114,
+		a: 1
+	},
+	sandybrown: {
+		r: 244,
+		g: 164,
+		b: 96,
+		a: 1
+	},
+	seagreen: {
+		r: 46,
+		g: 139,
+		b: 87,
+		a: 1
+	},
+	seashell: {
+		r: 255,
+		g: 245,
+		b: 238,
+		a: 1
+	},
+	sienna: {
+		r: 160,
+		g: 82,
+		b: 45,
+		a: 1
+	},
+	silver: {
+		r: 192,
+		g: 192,
+		b: 192,
+		a: 1
+	},
+	skyblue: {
+		r: 135,
+		g: 206,
+		b: 235,
+		a: 1
+	},
+	slateblue: {
+		r: 106,
+		g: 90,
+		b: 205,
+		a: 1
+	},
+	slategray: {
+		r: 112,
+		g: 128,
+		b: 144,
+		a: 1
+	},
+	slategrey: {
+		r: 112,
+		g: 128,
+		b: 144,
+		a: 1
+	},
+	snow: {
+		r: 255,
+		g: 250,
+		b: 250,
+		a: 1
+	},
+	springgreen: {
+		r: 0,
+		g: 255,
+		b: 127,
+		a: 1
+	},
+	steelblue: {
+		r: 70,
+		g: 130,
+		b: 180,
+		a: 1
+	},
+	tan: {
+		r: 210,
+		g: 180,
+		b: 140,
+		a: 1
+	},
+	teal: {
+		r: 0,
+		g: 128,
+		b: 128,
+		a: 1
+	},
+	thistle: {
+		r: 216,
+		g: 191,
+		b: 216,
+		a: 1
+	},
+	tomato: {
+		r: 255,
+		g: 99,
+		b: 71,
+		a: 1
+	},
+	transparent: {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 0
+	},
+	turquoise: {
+		r: 64,
+		g: 224,
+		b: 208,
+		a: 1
+	},
+	violet: {
+		r: 238,
+		g: 130,
+		b: 238,
+		a: 1
+	},
+	wheat: {
+		r: 245,
+		g: 222,
+		b: 179,
+		a: 1
+	},
+	white: {
+		r: 255,
+		g: 255,
+		b: 255,
+		a: 1
+	},
+	whitesmoke: {
+		r: 245,
+		g: 245,
+		b: 245,
+		a: 1
+	},
+	yellow: {
+		r: 255,
+		g: 255,
+		b: 0,
+		a: 1
+	},
+	yellowgreen: {
+		r: 154,
+		g: 205,
+		b: 50,
+		a: 1
+	}
+};
+const CSS_NAMED_COLOR_KEYS = Object.keys(CSS_NAMED_COLORS);
+function hslToRgb(h, s, l) {
+	h = (h % 360 + 360) % 360;
+	const a = s * Math.min(l, 1 - l);
+	const f = (n) => {
+		const k = (n + h / 30) % 12;
+		return l - a * Math.max(-1, Math.min(k - 3, 9 - k, 1));
+	};
+	return [
+		Math.round(f(0) * 255),
+		Math.round(f(8) * 255),
+		Math.round(f(4) * 255)
+	];
+}
+function rgbToHsl(r, g, b) {
+	const rn = r / 255, gn = g / 255, bn = b / 255;
+	const max = Math.max(rn, gn, bn);
+	const min = Math.min(rn, gn, bn);
+	const l = (max + min) / 2;
+	if (max === min) return [
+		0,
+		0,
+		l * 100
+	];
+	const d = max - min;
+	const s = l > .5 ? d / (2 - max - min) : d / (max + min);
+	let h;
+	if (max === rn) h = ((gn - bn) / d + (gn < bn ? 6 : 0)) / 6;
+	else if (max === gn) h = ((bn - rn) / d + 2) / 6;
+	else h = ((rn - gn) / d + 4) / 6;
+	return [
+		h * 360,
+		s * 100,
+		l * 100
+	];
+}
+const COLOR_HEX_SHORT_REGEX = /^#([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])?$/;
+const COLOR_HEX_LONG_REGEX = /^#([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})?$/;
+const COLOR_NUM_PATTERN = "(?:\\d+(?:\\.\\d*)?|\\d*\\.\\d+)";
+const COLOR_HUE_PATTERN = `(?:-?${COLOR_NUM_PATTERN})`;
+const COLOR_RGB_REGEX = new RegExp(`^rgba?\\(\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})\\s*,\\s*(\\d{1,3})\\s*(?:,\\s*(${COLOR_NUM_PATTERN}))?\\s*\\)$`, "i");
+const COLOR_HSL_REGEX = new RegExp(`^hsla?\\(\\s*(${COLOR_HUE_PATTERN})\\s*,\\s*(${COLOR_NUM_PATTERN})%\\s*,\\s*(${COLOR_NUM_PATTERN})%\\s*(?:,\\s*(${COLOR_NUM_PATTERN}))?\\s*\\)$`, "i");
+const VALID_COLOR_FORMATS = [
+	"hex",
+	"rgb",
+	"hsl",
+	"named"
+];
+/**
+* Creates a value parser that accepts CSS color strings and returns a
+* structured {@link Color} object with normalized RGBA components.
+*
+* Supported input notations by default:
+* - Hex: `#rgb`, `#rrggbb`, `#rgba`, `#rrggbbaa`
+* - RGB: `rgb(r, g, b)`, `rgba(r, g, b, a)`
+* - HSL: `hsl(h, s%, l%)`, `hsla(h, s%, l%, a)`
+* - Named: all 148 CSS Level 4 named colors (e.g., `red`, `rebeccapurple`)
+*
+* The `format()` method always outputs canonical lowercase hex
+* (`#rrggbb` when fully opaque, `#rrggbbaa` otherwise).
+*
+* @param options Configuration options for the parser.
+* @returns A sync value parser producing {@link Color} objects.
+* @throws {TypeError} If {@link ColorOptions.metavar} is an empty string, or
+*   if {@link ColorOptions.formats} contains an invalid format name.
+* @throws {RangeError} If {@link ValueParser.format} is called with a
+*   {@link Color} whose `r`, `g`, or `b` channel is not an integer in
+*   0–255, or whose `a` channel is not a finite number in 0–1.
+* @since 1.1.0
+*/
+function color(options = {}) {
+	const metavar = options.metavar ?? "COLOR";
+	require_nonempty.ensureNonEmptyString(metavar);
+	if (options.formats !== void 0) {
+		for (const fmt of options.formats) if (!VALID_COLOR_FORMATS.includes(fmt)) throw new TypeError(`Expected formats to contain only ${VALID_COLOR_FORMATS.map((v) => JSON.stringify(v)).join(", ")}, but got: ${JSON.stringify(fmt)}.`);
+	}
+	const allowedFormats = options.formats ?? VALID_COLOR_FORMATS;
+	const allowHex = allowedFormats.includes("hex");
+	const allowRgb = allowedFormats.includes("rgb");
+	const allowHsl = allowedFormats.includes("hsl");
+	const allowNamed = allowedFormats.includes("named");
+	const defaultPlaceholder = {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 1
+	};
+	const formatExamples = [
+		...allowHex ? ["#ff0000"] : [],
+		...allowRgb ? ["rgb(255, 0, 0)"] : [],
+		...allowHsl ? ["hsl(0, 100%, 50%)"] : [],
+		...allowNamed ? ["red"] : []
+	];
+	function invalidFormatError(input) {
+		return {
+			success: false,
+			error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : require_message.message`Expected a CSS color like ${require_message.valueSet(formatExamples, {
+				fallback: "a valid color",
+				type: "disjunction"
+			})}, but got ${input}.`
+		};
+	}
+	return {
+		mode: "sync",
+		metavar,
+		placeholder: options.placeholder ?? defaultPlaceholder,
+		parse(input) {
+			const trimmed = input.trim();
+			if (allowHex) {
+				let m = COLOR_HEX_LONG_REGEX.exec(trimmed);
+				if (m != null) {
+					const r = parseInt(m[1], 16);
+					const g = parseInt(m[2], 16);
+					const b = parseInt(m[3], 16);
+					const a = m[4] !== void 0 ? parseInt(m[4], 16) / 255 : 1;
+					return {
+						success: true,
+						value: {
+							r,
+							g,
+							b,
+							a
+						}
+					};
+				}
+				m = COLOR_HEX_SHORT_REGEX.exec(trimmed);
+				if (m != null) {
+					const r = parseInt(m[1] + m[1], 16);
+					const g = parseInt(m[2] + m[2], 16);
+					const b = parseInt(m[3] + m[3], 16);
+					const a = m[4] !== void 0 ? parseInt(m[4] + m[4], 16) / 255 : 1;
+					return {
+						success: true,
+						value: {
+							r,
+							g,
+							b,
+							a
+						}
+					};
+				}
+			}
+			if (allowRgb) {
+				const m = COLOR_RGB_REGEX.exec(trimmed);
+				if (m != null) {
+					const r = parseInt(m[1], 10);
+					const g = parseInt(m[2], 10);
+					const b = parseInt(m[3], 10);
+					const aRaw = m[4] !== void 0 ? parseFloat(m[4]) : 1;
+					if (r > 255 || g > 255 || b > 255 || !Number.isFinite(aRaw) || aRaw < 0 || aRaw > 1) return invalidFormatError(input);
+					const a = Math.round(aRaw * 255) / 255;
+					return {
+						success: true,
+						value: {
+							r,
+							g,
+							b,
+							a
+						}
+					};
+				}
+			}
+			if (allowHsl) {
+				const m = COLOR_HSL_REGEX.exec(trimmed);
+				if (m != null) {
+					const h = parseFloat(m[1]);
+					const s = parseFloat(m[2]);
+					const l = parseFloat(m[3]);
+					const aRaw = m[4] !== void 0 ? parseFloat(m[4]) : 1;
+					if (!Number.isFinite(h) || !Number.isFinite(s) || s < 0 || s > 100 || !Number.isFinite(l) || l < 0 || l > 100 || !Number.isFinite(aRaw) || aRaw < 0 || aRaw > 1) return invalidFormatError(input);
+					const [r, g, b] = hslToRgb(h, s / 100, l / 100);
+					const a = Math.round(aRaw * 255) / 255;
+					return {
+						success: true,
+						value: {
+							r,
+							g,
+							b,
+							a
+						}
+					};
+				}
+			}
+			if (allowNamed) {
+				const key = trimmed.toLowerCase();
+				if (Object.hasOwn(CSS_NAMED_COLORS, key)) return {
+					success: true,
+					value: { ...CSS_NAMED_COLORS[key] }
+				};
+			}
+			return invalidFormatError(input);
+		},
+		format(value) {
+			const { r, g, b, a } = value;
+			if (!Number.isInteger(r) || r < 0 || r > 255 || !Number.isInteger(g) || g < 0 || g > 255 || !Number.isInteger(b) || b < 0 || b > 255 || !Number.isFinite(a) || a < 0 || a > 1) throw new RangeError(`Color components out of range: r=${r}, g=${g}, b=${b}, a=${a}.`);
+			const aStr = parseFloat(a.toFixed(4));
+			if (allowHex) {
+				const rh = r.toString(16).padStart(2, "0");
+				const gh = g.toString(16).padStart(2, "0");
+				const bh = b.toString(16).padStart(2, "0");
+				if (a === 1) return `#${rh}${gh}${bh}`;
+				const ah = Math.round(a * 255).toString(16).padStart(2, "0");
+				return `#${rh}${gh}${bh}${ah}`;
+			}
+			if (allowRgb) return a === 1 ? `rgb(${r}, ${g}, ${b})` : `rgba(${r}, ${g}, ${b}, ${aStr})`;
+			if (allowHsl) {
+				const [h, s, l] = rgbToHsl(r, g, b);
+				const hStr = parseFloat(h.toFixed(4));
+				const sStr = parseFloat(s.toFixed(4));
+				const lStr = parseFloat(l.toFixed(4));
+				return a === 1 ? `hsl(${hStr}, ${sStr}%, ${lStr}%)` : `hsla(${hStr}, ${sStr}%, ${lStr}%, ${aStr})`;
+			}
+			for (const [name, c] of Object.entries(CSS_NAMED_COLORS)) if (c.r === r && c.g === g && c.b === b && c.a === a) return name;
+			throw new RangeError(`No CSS named color matches { r: ${r}, g: ${g}, b: ${b}, a: ${a} }.`);
+		},
+		normalize(value) {
+			if (!Number.isInteger(value.r) || value.r < 0 || value.r > 255 || !Number.isInteger(value.g) || value.g < 0 || value.g > 255 || !Number.isInteger(value.b) || value.b < 0 || value.b > 255 || !Number.isFinite(value.a) || value.a < 0 || value.a > 1) return value;
+			const a = Math.round(value.a * 255) / 255;
+			return a === value.a ? value : {
+				...value,
+				a
+			};
+		},
+		*suggest(prefix) {
+			if (allowNamed) {
+				const lowerPrefix = prefix.toLowerCase();
+				for (const name of CSS_NAMED_COLOR_KEYS) if (name.startsWith(lowerPrefix)) yield {
+					kind: "literal",
+					text: name
+				};
+			}
+		}
+	};
+}
 /**
 * The set of URL schemes that are considered "special" by the WHATWG URL
 * Standard.  These schemes always use the `://` authority syntax.
@@ -4014,12 +5144,104 @@ function cidr(options) {
 	});
 	return cidrParserObj;
 }
+const SEMVER_REGEX = /^(?<prefix>v)?(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<pre>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?<meta>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+const SEMVER_SUGGESTIONS = Object.freeze([
+	"0.0.0",
+	"1.0.0",
+	"1.0.0-alpha",
+	"1.0.0-alpha.1",
+	"1.0.0+build.1",
+	"1.0.0-alpha.1+build.1"
+]);
+const SEMVER_SUGGESTIONS_WITH_PREFIX = Object.freeze([...SEMVER_SUGGESTIONS, ...SEMVER_SUGGESTIONS.map((s) => `v${s}`)]);
+function semVer(options = {}) {
+	const metavar = options.metavar ?? "SEMVER";
+	require_nonempty.ensureNonEmptyString(metavar);
+	checkEnumOption(options, "type", ["string", "object"]);
+	checkBooleanOption(options, "allowPrefix");
+	const allowPrefix = options.allowPrefix ?? false;
+	const objectMode = options.type === "object";
+	const errorOption = options.errors?.invalidSemVer;
+	const suggestions = allowPrefix ? SEMVER_SUGGESTIONS_WITH_PREFIX : SEMVER_SUGGESTIONS;
+	function makeError(input) {
+		return {
+			success: false,
+			error: errorOption ? typeof errorOption === "function" ? errorOption(input) : errorOption : require_message.message`Expected a valid Semantic Versioning 2.0.0 string (e.g. ${"1.0.0"}), but got ${input}.`
+		};
+	}
+	if (objectMode) return {
+		mode: "sync",
+		metavar,
+		placeholder: {
+			major: 0,
+			minor: 0,
+			patch: 0
+		},
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const major = parseInt(m.groups.major, 10);
+			const minor = parseInt(m.groups.minor, 10);
+			const patch = parseInt(m.groups.patch, 10);
+			if (!Number.isSafeInteger(major) || !Number.isSafeInteger(minor) || !Number.isSafeInteger(patch)) return makeError(input);
+			const result = {
+				major,
+				minor,
+				patch,
+				...m.groups.pre != null ? { preRelease: m.groups.pre } : {},
+				...m.groups.meta != null ? { metadata: m.groups.meta } : {}
+			};
+			return {
+				success: true,
+				value: result
+			};
+		},
+		format(value) {
+			let s = `${value.major}.${value.minor}.${value.patch}`;
+			if (value.preRelease != null) s += `-${value.preRelease}`;
+			if (value.metadata != null) s += `+${value.metadata}`;
+			return s;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+	return {
+		mode: "sync",
+		metavar,
+		placeholder: "0.0.0",
+		parse(input) {
+			const m = SEMVER_REGEX.exec(input);
+			if (m == null) return makeError(input);
+			if (!allowPrefix && m.groups.prefix != null) return makeError(input);
+			const canonical = `${m.groups.major}.${m.groups.minor}.${m.groups.patch}` + (m.groups.pre != null ? `-${m.groups.pre}` : "") + (m.groups.meta != null ? `+${m.groups.meta}` : "");
+			return {
+				success: true,
+				value: canonical
+			};
+		},
+		format(value) {
+			return value;
+		},
+		*suggest(prefix) {
+			for (const s of suggestions) if (s.startsWith(prefix)) yield {
+				kind: "literal",
+				text: s
+			};
+		}
+	};
+}
 
 //#endregion
 exports.checkBooleanOption = checkBooleanOption;
 exports.checkEnumOption = checkEnumOption;
 exports.choice = choice;
 exports.cidr = cidr;
+exports.color = color;
 exports.domain = domain;
 exports.email = email;
 exports.ensureNonEmptyString = require_nonempty.ensureNonEmptyString;
@@ -4036,6 +5258,7 @@ exports.locale = locale;
 exports.macAddress = macAddress;
 exports.port = port;
 exports.portRange = portRange;
+exports.semVer = semVer;
 exports.socketAddress = socketAddress;
 exports.string = string;
 exports.url = url;