saturon 0.2.3 → 0.3.0

package/dist/converters.js

@@ -1,7 +1,5 @@
-import { Color } from "./Color.js";
-import { config } from "./config.js";
 import { HSL_to_RGB, HWB_to_RGB, LAB_to_LCH, LAB_to_XYZD50, LCH_to_LAB, MATRICES, OKLAB_to_OKLCH, OKLAB_to_XYZD65, OKLCH_to_OKLAB, RGB_to_HSL, RGB_to_HWB, RGB_to_XYZD65, XYZD50_to_LAB, XYZD65_to_OKLAB, XYZD65_to_RGB, } from "./math.js";
-import { modelConverterToColorConverter, spaceConverterToModelConverter, fit, extractBalancedExpression, } from "./utils.js";
+import { spaceConverterToModelConverter } from "./utils.js";
 /**
  * A collection of `<named-color>`s and their RGB values.
  *
@@ -322,6 +320,7 @@ export const colorModels = {
             r: { index: 0, value: [0, 255], precision: 0 },
             g: { index: 1, value: [0, 255], precision: 0 },
             b: { index: 2, value: [0, 255], precision: 0 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "xyz-d65",
         toBridge: RGB_to_XYZD65,
@@ -334,6 +333,7 @@ export const colorModels = {
             h: { index: 0, value: "hue", precision: 0 },
             s: { index: 1, value: "percentage", precision: 0 },
             l: { index: 2, value: "percentage", precision: 0 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "rgb",
         toBridge: HSL_to_RGB,
@@ -344,6 +344,7 @@ export const colorModels = {
             h: { index: 0, value: "hue", precision: 0 },
             w: { index: 1, value: "percentage", precision: 0 },
             b: { index: 2, value: "percentage", precision: 0 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "rgb",
         toBridge: HWB_to_RGB,
@@ -355,6 +356,7 @@ export const colorModels = {
             l: { index: 0, value: "percentage", precision: 5 },
             a: { index: 1, value: [-125, 125], precision: 5 },
             b: { index: 2, value: [-125, 125], precision: 5 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "xyz-d50",
         toBridge: LAB_to_XYZD50,
@@ -366,6 +368,7 @@ export const colorModels = {
             l: { index: 0, value: "percentage", precision: 5 },
             c: { index: 1, value: [0, 150], precision: 5 },
             h: { index: 2, value: "hue", precision: 5 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "lab",
         toBridge: LCH_to_LAB,
@@ -377,6 +380,7 @@ export const colorModels = {
             l: { index: 0, value: [0, 1], precision: 5 },
             a: { index: 1, value: [-0.4, 0.4], precision: 5 },
             b: { index: 2, value: [-0.4, 0.4], precision: 5 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "xyz-d65",
         toBridge: OKLAB_to_XYZD65,
@@ -388,6 +392,7 @@ export const colorModels = {
             l: { index: 0, value: [0, 1], precision: 5 },
             c: { index: 1, value: [0, 0.4], precision: 5 },
             h: { index: 2, value: "hue", precision: 5 },
+            alpha: { index: 3, value: [0, 1], precision: 3 },
         },
         bridge: "oklab",
         toBridge: OKLCH_to_OKLAB,
@@ -395,422 +400,3 @@ export const colorModels = {
     },
     ...colorSpaces,
 };
-/**
- * A collection of `<color-function>`s as `<color>` converters.
- *
- * @see {@link https://www.w3.org/TR/css-color-5/|CSS Color Module Level 5}
- */
-export const colorFunctions = Object.fromEntries(Object.entries(colorModels).map(([name, converter]) => [
-    name,
-    modelConverterToColorConverter(name, converter),
-]));
-/**
- * A collection of `<color-base>`s as `<color>` converters.
- *
- * @see {@link https://www.w3.org/TR/css-color-5/|CSS Color Module Level 5}
- */
-export const colorBases = {
-    "hex-color": {
-        isValid: (str) => str[0] === "#",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const HEX = str.slice(1);
-            if (![3, 4, 6, 8].includes(HEX.length))
-                throw new Error("Invalid hex color length.");
-            for (const ch of HEX)
-                if (!/^[0-9a-fA-F]$/.test(ch))
-                    throw new Error("Invalid hex color character.");
-            const expand = (c) => parseInt(c.length === 1 ? c + c : c, 16);
-            const [r, g, b, a = 255] = HEX.length <= 4
-                ? HEX.split("").map(expand)
-                : [HEX.slice(0, 2), HEX.slice(2, 4), HEX.slice(4, 6), HEX.slice(6, 8)].map((c) => parseInt(c || "ff", 16));
-            return [r, g, b, a / 255];
-        },
-        fromBridge: (coords) => coords,
-        format: ([r, g, b, a = 1]) => {
-            const toHex = (v) => v.toString(16).padStart(2, "0");
-            const hex = [r, g, b].map((v) => toHex(Math.round(Math.max(0, Math.min(255, v))))).join("");
-            return `#${hex}${a < 1 ? toHex(Math.round(a * 255)) : ""}`;
-        },
-    },
-    ...colorFunctions,
-    "named-color": {
-        isValid: (str) => Object.keys(namedColors).some((key) => key === str),
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (name) => {
-            const rgb = namedColors[name];
-            if (!rgb)
-                throw new Error(`Invalid named-color: ${name}.`);
-            return [...rgb, 1];
-        },
-        fromBridge: (coords) => coords,
-        format: (rgb) => {
-            const [r, g, b] = rgb.map((v, i) => (i < 3 ? Math.round(Math.min(255, Math.max(0, v))) : v));
-            for (const [name, [nr, ng, nb]] of Object.entries(namedColors)) {
-                if (r === nr && g === ng && b === nb)
-                    return name;
-            }
-        },
-    },
-    "color-mix": {
-        isValid: (str) => str.slice(0, 10) === "color-mix(" && str[str.length - 1] === ")",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const extractColorAndWeight = (colorStr) => {
-                const s = colorStr.trim();
-                let weight;
-                let remaining = s;
-                const leadingWeightMatch = remaining.match(/^(\d+)%\s+/);
-                if (leadingWeightMatch) {
-                    const raw = parseInt(leadingWeightMatch[1], 10);
-                    weight = Math.min(1, Math.max(0, raw / 100));
-                    remaining = remaining.slice(leadingWeightMatch[0].length).trim();
-                }
-                let colorExpression = "";
-                let rest = "";
-                if (/^[a-z]/i.test(remaining)) {
-                    const { expression: expr, end: e } = extractBalancedExpression(remaining, 0);
-                    if (expr) {
-                        colorExpression = expr;
-                        rest = remaining.slice(e).trim();
-                    }
-                    else {
-                        const m = remaining.match(/^([^\s]+)(.*)$/);
-                        colorExpression = m ? m[1] : remaining;
-                        rest = m ? m[2].trim() : "";
-                    }
-                }
-                else {
-                    const m = remaining.match(/^([^\s]+)(.*)$/);
-                    colorExpression = m ? m[1] : remaining;
-                    rest = m ? m[2].trim() : "";
-                }
-                if (weight === undefined) {
-                    const trailingWeightMatch = rest.match(/^(-?(?:\d+\.?\d*|\.\d+))%/);
-                    if (trailingWeightMatch) {
-                        const raw = parseInt(trailingWeightMatch[1], 10);
-                        weight = raw / 100;
-                        rest = rest.slice(trailingWeightMatch[0].length).trim();
-                        if (weight < 0) {
-                            throw new Error("Percentages less than 0 are not valid.");
-                        }
-                        else if (weight > 1) {
-                            throw new Error("Percentages greater than 100 are not valid.");
-                        }
-                    }
-                    else if (rest.slice(0, 5) === "calc(") {
-                        const { expression: calcExpr, end } = extractBalancedExpression(rest, 0);
-                        if (!calcExpr) {
-                            throw new Error("Malformed calc() weight expression.");
-                        }
-                        rest = rest.slice(end).trim();
-                    }
-                }
-                if (rest.length > 0) {
-                    throw new Error(`Unexpected extra tokens after color: '${rest}'.`);
-                }
-                const color = Color.from(colorExpression);
-                return { color, weight };
-            };
-            const getWeight2Prime = (weight1, weight2) => {
-                if (weight1 === undefined && typeof weight2 === "number") {
-                    weight1 = 1 - weight2;
-                }
-                else if (typeof weight1 === "number" && weight2 === undefined) {
-                    weight2 = 1 - weight1;
-                }
-                else if (weight1 === undefined && weight2 === undefined) {
-                    weight1 = weight2 = 0.5;
-                }
-                else {
-                    weight1 = weight1;
-                    weight2 = weight2;
-                    if (weight1 + weight2 <= 0) {
-                        throw new Error("Sum of percengates cannot be 0%.");
-                    }
-                }
-                const totalWeight = weight1 + weight2;
-                let alphaMultiplier;
-                if (totalWeight > 1) {
-                    weight1 /= totalWeight;
-                    weight2 /= totalWeight;
-                }
-                else {
-                    weight1 /= totalWeight;
-                    weight2 /= totalWeight;
-                    alphaMultiplier = totalWeight;
-                }
-                return { amount: weight2, alphaMultiplier };
-            };
-            const fnName = "color-mix";
-            const { expression } = extractBalancedExpression(str, fnName.length);
-            if (!expression)
-                throw new Error("Malformed color-mix expression.");
-            const inner = expression.slice(1, -1).trim();
-            const parts = [];
-            let i = 0;
-            let current = "";
-            while (i < inner.length) {
-                const char = inner[i];
-                if (char === ",") {
-                    parts.push(current.trim());
-                    current = "";
-                    i++;
-                    continue;
-                }
-                if (char === "(" || /[a-zA-Z]/.test(char)) {
-                    const { expression: expr, end } = extractBalancedExpression(inner, i);
-                    if (expr) {
-                        current += expr;
-                        i = end;
-                        continue;
-                    }
-                }
-                current += char;
-                i++;
-            }
-            parts.push(current.trim());
-            if (parts.length !== 3) {
-                throw new Error("color-mix must have three comma-separated parts.");
-            }
-            const inPart = parts[0];
-            const inMatch = inPart.match(/^in\s+([a-z0-9-]+)(?:\s+(shorter|longer|increasing|decreasing)\s+hue)?$/);
-            if (!inMatch) {
-                throw new Error("Invalid model and hue format.");
-            }
-            const model = inMatch[1];
-            let hue = inMatch[2];
-            if (model === "rgb")
-                throw new Error(`RGB model is not allowed in color-mix(). Use "srgb" instead.`);
-            if (hue) {
-                const comps = colorModels[model].components;
-                if (!comps) {
-                    throw new Error(`Unknown color model: ${model}.`);
-                }
-                const hasHue = Object.values(comps).some((c) => c.value === "hue");
-                if (!hasHue) {
-                    throw new Error(`Hue interpolation not supported in ${model} space.`);
-                }
-            }
-            else {
-                hue = "shorter";
-            }
-            const { color: color1, weight: weight1 } = extractColorAndWeight(parts[1]);
-            const { color: color2, weight: weight2 } = extractColorAndWeight(parts[2]);
-            const { amount, alphaMultiplier = 1 } = getWeight2Prime(weight1, weight2);
-            return color1
-                .with({ alpha: (a) => (isNaN(a) ? a : a * alphaMultiplier) }, false)
-                .in(model)
-                .mix(color2.with({ alpha: (a) => (isNaN(a) ? a : a * alphaMultiplier) }, false), { amount, hue })
-                .in("rgb").coords;
-        },
-    },
-    transparent: {
-        isValid: (str) => str === "transparent",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => [NaN, NaN, NaN, 0], // eslint-disable-line no-unused-vars
-    },
-};
-/**
- * A collection of `<color>` converters.
- *
- * @see {@link https://www.w3.org/TR/css-color-5/|CSS Color Module Level 5}
- */
-export const colorTypes = {
-    ...colorBases,
-    currentColor: {
-        isValid: (str) => str === "currentcolor",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => [0, 0, 0, 1], // eslint-disable-line no-unused-vars
-    },
-    "system-color": {
-        isValid: (str) => Object.keys(config.systemColors).some((key) => key.toLowerCase() === str),
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const { systemColors } = config;
-            const key = Object.keys(systemColors).find((k) => k.toLowerCase() === str);
-            const rgbArr = systemColors[key][config.theme === "light" ? 0 : 1];
-            return [...rgbArr, 1];
-        },
-    },
-    "contrast-color": {
-        isValid: (str) => str.slice(0, 15) === "contrast-color(" && str[str.length - 1] === ")",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const inner = str.slice(15, -1);
-            const [, luminance] = Color.from(inner).in("xyz-d65").coords;
-            return luminance > 0.5 ? [0, 0, 0, 1] : [255, 255, 255, 1];
-        },
-    },
-    "device-cmyk": {
-        isValid: (str) => str.slice(0, 12) === "device-cmyk(" && str[str.length - 1] === ")",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const fnName = "device-cmyk";
-            const fnIndex = str.indexOf(fnName);
-            if (fnIndex === -1)
-                throw new Error("Invalid device-cmyk syntax");
-            const { expression } = extractBalancedExpression(str, fnIndex + fnName.length);
-            if (!expression)
-                throw new Error("Malformed device-cmyk expression");
-            const content = expression.slice(1, -1).trim();
-            const tokens = [];
-            let i = 0;
-            while (i < content.length) {
-                const char = content[i];
-                if (char === " ") {
-                    i++;
-                    continue;
-                }
-                if (char === "(" || /[a-zA-Z-]/.test(char)) {
-                    const { expression: expr, end } = extractBalancedExpression(content, i);
-                    if (expr) {
-                        tokens.push(expr);
-                        i = end;
-                        continue;
-                    }
-                }
-                if (/[\d.+-]/.test(char)) {
-                    let num = "";
-                    while (i < content.length && /[\d.eE+-]/.test(content[i])) {
-                        num += content[i];
-                        i++;
-                    }
-                    if (i < content.length && content[i] === "%") {
-                        num += "%";
-                        i++;
-                    }
-                    else if (i < content.length && /[a-zA-Z]/.test(content[i])) {
-                        while (i < content.length && /[a-zA-Z]/.test(content[i])) {
-                            num += content[i];
-                            i++;
-                        }
-                    }
-                    tokens.push(num);
-                    continue;
-                }
-                if (char === "," || char === "/") {
-                    tokens.push(char);
-                    i++;
-                    continue;
-                }
-                throw new Error(`Unexpected character: ${char}`);
-            }
-            const parseValue = (token) => {
-                return token[token.length - 1] === "%" ? parseFloat(token) / 100 : parseFloat(token);
-            };
-            if (tokens.length >= 2 && tokens[1] === ",") {
-                const values = tokens.filter((t) => t !== ",");
-                if (values.length === 4 || values.length === 5) {
-                    const [c, m, y, k, alpha = 1] = values.map(parseValue);
-                    const red = 1 - Math.min(1, c * (1 - k) + k);
-                    const green = 1 - Math.min(1, m * (1 - k) + k);
-                    const blue = 1 - Math.min(1, y * (1 - k) + k);
-                    return [red * 255, green * 255, blue * 255, alpha];
-                }
-                throw new Error("Invalid number of components for comma-separated device-cmyk");
-            }
-            let idx = 0;
-            const components = [];
-            while (idx < tokens.length && components.length < 4 && tokens[idx] !== "/" && tokens[idx] !== ",") {
-                components.push(tokens[idx]);
-                idx++;
-            }
-            if (components.length !== 4) {
-                throw new Error("Invalid number of components for space-separated device-cmyk");
-            }
-            const [c, m, y, k] = components.map(parseValue);
-            let alpha = 1;
-            if (idx < tokens.length && tokens[idx] === "/") {
-                idx++;
-                if (idx >= tokens.length)
-                    throw new Error("Missing alpha value");
-                alpha = parseValue(tokens[idx]);
-                idx++;
-            }
-            if (idx < tokens.length && tokens[idx] === ",") {
-                idx++;
-                const fallbackStr = tokens.slice(idx).join(" ");
-                return Color.from(fallbackStr).in("rgb").coords;
-            }
-            const red = 1 - Math.min(1, c * (1 - k) + k);
-            const green = 1 - Math.min(1, m * (1 - k) + k);
-            const blue = 1 - Math.min(1, y * (1 - k) + k);
-            return [red * 255, green * 255, blue * 255, alpha];
-        },
-        fromBridge: (coords) => coords,
-        format: ([red, green, blue, alpha = 1], options = {}) => {
-            const { legacy = false, precision = 3, fit: fitMethod = config.defaults.fit } = options;
-            const [fr, fg, fb] = fit([red, green, blue], "rgb", { method: fitMethod });
-            const r = fr / 255;
-            const g = fg / 255;
-            const b = fb / 255;
-            const k = 1 - Math.max(r, g, b);
-            const formatComponent = (value) => {
-                return Number(precision === null ? value : value.toFixed(precision)).toString();
-            };
-            const c = formatComponent(k === 1 ? 0 : (1 - r - k) / (1 - k));
-            const m = formatComponent(k === 1 ? 0 : (1 - g - k) / (1 - k));
-            const y = formatComponent(k === 1 ? 0 : (1 - b - k) / (1 - k));
-            const kFormatted = formatComponent(k);
-            const alphaFormatted = Number(alpha.toFixed(3)).toString();
-            if (legacy) {
-                return `device-cmyk(${c}, ${m}, ${y}, ${kFormatted}${alpha < 1 ? `, ${alphaFormatted}` : ""})`;
-            }
-            const rgbPart = colorFunctions.rgb.format?.([fr, fg, fb, alpha], options);
-            return `device-cmyk(${c} ${m} ${y} ${kFormatted}${alpha < 1 ? ` / ${alphaFormatted}` : ""}, ${rgbPart})`;
-        },
-    },
-    "light-dark": {
-        isValid: (str) => str.slice(0, 11) === "light-dark(" && str[str.length - 1] === ")",
-        bridge: "rgb",
-        toBridge: (coords) => coords,
-        parse: (str) => {
-            const fnName = "light-dark";
-            const fnIndex = str.indexOf(fnName);
-            if (fnIndex === -1)
-                throw new Error("Not a <light-dark()> expression");
-            const { expression } = extractBalancedExpression(str, fnIndex + fnName.length);
-            if (!expression)
-                throw new Error("Malformed <light-dark()> expression");
-            const inner = expression.slice(1, -1).trim();
-            const parts = [];
-            let current = "";
-            let i = 0;
-            while (i < inner.length) {
-                const char = inner[i];
-                if (char === ",") {
-                    parts.push(current.trim());
-                    current = "";
-                    i++;
-                    continue;
-                }
-                if (char === "(" || /[a-zA-Z]/.test(char)) {
-                    const { expression: expr, end } = extractBalancedExpression(inner, i);
-                    if (expr) {
-                        current += expr;
-                        i = end;
-                        continue;
-                    }
-                }
-                current += char;
-                i++;
-            }
-            parts.push(current.trim());
-            if (parts.length !== 2) {
-                throw new Error("Invalid light-dark format");
-            }
-            const [color1, color2] = parts;
-            const { theme } = config;
-            return Color.from(theme === "light" ? color1 : color2).coords;
-        },
-    },
-};

package/dist/engine.d.ts

@@ -0,0 +1,148 @@
+import { ColorFormatter, ColorModel, ColorModelConverter, ColorSpace, ColorSpaceConverter, ComponentDefinition, FitFunction, FitMethod, FormattingOptions, GrammarRuleSpec, NamedColor, OutputType, SystemColor } from "./types.js";
+export declare const grammar = "\n/* ==========================================================================\n   Core Color Types\n   ========================================================================== */\n<color> = <color-base> | currentColor | <system-color> | <contrast-color()> | <device-cmyk()> | <light-dark-color>\n\n<color-base> = <hex-color> | <color-function> | <named-color> | <color-mix()> | transparent\n\n<color-function> = <rgb()> | <rgba()> | <hsl()> | <hsla()> | <hwb()> | <lab()> | <lch()> | <oklab()> | <oklch()> | <alpha()> | <color()> | <custom-color-function>\n\n/* ==========================================================================\n   RGB & RGBA Syntax\n   ========================================================================== */\n<rgb()> = [ <legacy-rgb-syntax> | <modern-rgb-syntax> | <relative-rgb-syntax> ]\n<rgba()> = [ <legacy-rgba-syntax> | <modern-rgba-syntax> | <relative-rgba-syntax> ]\n\n<legacy-rgb-syntax> = rgb( <percentage>#{3} [ , <alpha-value> ]? ) | rgb( <number>#{3} [ , <alpha-value> ]? )      \n<legacy-rgba-syntax> = rgba( <percentage>#{3} [ , <alpha-value> ]? ) | rgba( <number>#{3} [ , <alpha-value> ]? )      \n\n<modern-rgb-syntax> = rgb( <rgb-absolute-component>{3} [ / <alpha-absolute-value> ]? )\n<modern-rgba-syntax> = rgba( <rgb-absolute-component>{3} [ / <alpha-absolute-value> ]? )\n<rgb-absolute-component> = <number> | <percentage> | none\n<alpha-absolute-value> = <alpha-value> | none\n\n<relative-rgb-syntax> = rgb( from <color> <rgb-relative-component>{3} [ / <rgb-relative-alpha> ]? )\n<relative-rgba-syntax> = rgba( from <color> <rgb-relative-component>{3} [ / <rgb-relative-alpha> ]? )\n\n/* ==========================================================================\n   HSL & HSLA Syntax\n   ========================================================================== */\n<hsl()> = [ <legacy-hsl-syntax> | <modern-hsl-syntax> | <relative-hsl-syntax> ]\n<hsla()> = [ <legacy-hsla-syntax> | <modern-hsla-syntax> | <relative-hsla-syntax> ]\n\n<legacy-hsl-syntax> = hsl( <hue> , <percentage> , <percentage> [ , <alpha-value> ]? )  \n<legacy-hsla-syntax> = hsla( <hue> , <percentage> , <percentage> [ , <alpha-value> ]? )  \n\n<modern-hsl-syntax> = hsl( [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / <alpha-absolute-value> ]? )\n<modern-hsla-syntax> = hsla( [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / <alpha-absolute-value> ]? )\n\n<relative-hsl-syntax> = hsl( from <color> <hsl-relative-hue> <hsl-relative-component>{2} [ / <hsl-relative-alpha> ]? )\n<relative-hsla-syntax> = hsla( from <color> <hsl-relative-hue> <hsl-relative-component>{2} [ / <hsl-relative-alpha> ]? )\n<hsl-relative-hue> = <hue> | none | h | s | l | alpha\n<hsl-relative-component> = <percentage> | <number> | none | h | s | l | alpha\n<hsl-relative-alpha> = <alpha-value> | none | h | s | l | alpha\n\n/* ==========================================================================\n   HWB Syntax\n   ========================================================================== */\n<hwb()> = [ <absolute-hwb-syntax> | <relative-hwb-syntax> ]\n<absolute-hwb-syntax> = hwb( [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / <alpha-absolute-value> ]? )\n<relative-hwb-syntax> = hwb( from <color> <hwb-relative-hue> <hwb-relative-component>{2} [ / <hwb-relative-alpha> ]? )\n<hwb-relative-hue> = <hue> | none | h | w | b | alpha\n<hwb-relative-component> = <percentage> | <number> | none | h | w | b | alpha\n<hwb-relative-alpha> = <alpha-value> | none | h | w | b | alpha\n\n/* ==========================================================================\n   LAB & LCH Syntax\n   ========================================================================== */\n<lab()> = [ <absolute-lab-syntax> | <relative-lab-syntax> ]\n<absolute-lab-syntax> = lab( [ <percentage> | <number> | none ]{3} [ / <alpha-absolute-value> ]? )\n<relative-lab-syntax> = lab( from <color> <lab-relative-component>{3} [ / <lab-relative-alpha> ]? )\n<lab-relative-component> = <percentage> | <number> | none | l | a | b | alpha\n<lab-relative-alpha> = <alpha-value> | none | l | a | b | alpha\n\n<lch()> = [ <absolute-lch-syntax> | <relative-lch-syntax> ]\n<absolute-lch-syntax> = lch( [ <percentage> | <number> | none ]{2} [ <hue> | none ] [ / <alpha-absolute-value> ]? )\n<relative-lch-syntax> = lch( from <color> <lch-relative-component>{2} <lch-relative-hue> [ / <lch-relative-alpha> ]? )\n<lch-relative-component> = <percentage> | <number> | none | l | c | h | alpha\n<lch-relative-hue> = <hue> | none | l | c | h | alpha\n<lch-relative-alpha> = <alpha-value> | none | l | c | h | alpha\n\n/* ==========================================================================\n   OKLAB & OKLCH Syntax\n   ========================================================================== */\n<oklab()> = [ <absolute-oklab-syntax> | <relative-oklab-syntax> ]\n<absolute-oklab-syntax> = oklab( [ <percentage> | <number> | none ]{3} [ / <alpha-absolute-value> ]? )\n<relative-oklab-syntax> = oklab( from <color> <oklab-relative-component>{3} [ / <oklab-relative-alpha> ]? )\n<oklab-relative-component> = <percentage> | <number> | none | l | a | b | alpha\n<oklab-relative-alpha> = <alpha-value> | none | l | a | b | alpha\n\n<oklch()> = [ <absolute-oklch-syntax> | <relative-oklch-syntax> ]\n<absolute-oklch-syntax> = oklch( [ <percentage> | <number> | none ]{2} [ <hue> | none ] [ / <alpha-absolute-value> ]? )\n<relative-oklch-syntax> = oklch( from <color> <oklch-relative-component>{2} <oklch-relative-hue> [ / <oklch-relative-alpha> ]? )\n<oklch-relative-component> = <percentage> | <number> | none | l | c | h | alpha\n<oklch-relative-hue> = <hue> | none | l | c | h | alpha\n<oklch-relative-alpha> = <alpha-value> | none | l | c | h | alpha\n\n/* ==========================================================================\n   ALPHA Syntax\n   ========================================================================== */\n<alpha()> = alpha( from <color> [ / [ <alpha-value> | none | alpha ] ]? )\n\n/* ==========================================================================\n   COLOR Space Function Syntax\n   ========================================================================== */\n<color()> = [ <absolute-color-syntax> | <relative-color-syntax> ]\n<absolute-color-syntax> = color( [ <predefined-rgb> | <xyz-space> | <custom-color-space> ] [ <number> | <percentage> | none ]{3} [ / [ <alpha-value> | none ] ]? )\n<relative-color-syntax> = [ <relative-rgb-color-syntax> | <relative-xyz-color-syntax> | <relative-custom-color-syntax> ]\n\n<relative-rgb-color-syntax> = color( from <color> <predefined-rgb> <rgb-relative-component>{3} [ / <rgb-relative-alpha> ]? )\n\n<relative-xyz-color-syntax> = color( from <color> <xyz-space> <xyz-relative-component>{3} [ / <xyz-relative-alpha> ]? )\n<xyz-relative-component> = <number> | <percentage> | none | x | y | z | alpha\n<xyz-relative-alpha> = <alpha-value> | none | x | y | z | alpha\n\n<predefined-rgb> = srgb | srgb-linear | display-p3 | a98-rgb | prophoto-rgb | rec2020\n<xyz-space> = xyz | xyz-d50 | xyz-d65\n\n<relative-custom-color-syntax> = %unregistered-sentinal-value%\n\n/* ==========================================================================\n   Functional Utilities (Light/Dark, Contrast, CMYK, Mix)\n   ========================================================================== */\n<light-dark-color> = light-dark( <color> , <color> )\n\n<contrast-color()> = contrast-color( <color> )\n\n<device-cmyk()> = <legacy-device-cmyk-syntax> | <modern-device-cmyk-syntax>\n<legacy-device-cmyk-syntax> = device-cmyk( <number>#{4} )\n<modern-device-cmyk-syntax> = device-cmyk( <cmyk-component>{4} [ / [ <alpha-value> | none ] ]? )\n<cmyk-component> = <number> | <percentage> | none\n\n<color-mix()> = color-mix( [ <color-interpolation-method> , ]? [ <color> && <percentage [0,100]>? ]# )\n<color-interpolation-method> = in [ <rectangular-color-space> | <polar-color-space> <hue-interpolation-method>? ]\n<color-space> = <rectangular-color-space> | <polar-color-space>\n<rectangular-color-space> = srgb | srgb-linear | display-p3 | display-p3-linear | a98-rgb | prophoto-rgb | rec2020 | lab | oklab | <xyz-space> | <custom-color-space> | <custom-rectangular-space>\n<polar-color-space> = hsl | hwb | lch | oklch | <custom-polar-space>\n<hue-interpolation-method> = [ shorter | longer | increasing | decreasing ] hue\n\n<custom-color-function> = %unregistered-sentinel-value%\n<custom-rectangular-space> = %unregistered-sentinel-value%\n<custom-polar-space> = %unregistered-sentinel-value%\n\n/* ==========================================================================\n   Shared Value Components\n   ========================================================================== */\n<alpha-value> = <number> | <percentage>\n<hue> = <number> | <angle>\n<rgb-relative-component> = <number> | <percentage> | none | r | g | b | alpha\n<rgb-relative-alpha> = <alpha-value> | none | r | g | b | alpha\n<custom-color-space> = %unregistered-sentinel-value%\n";
+export declare const grammarMap: Record<string, GrammarNode>;
+type GrammarNode = SequenceNode | ChoiceNode | LiteralNode | RefNode | OptionalNode | RepeatNode | PermutationNode | HashListNode;
+type PermutationNode = {
+    kind: "permutation";
+    nodes: GrammarNode[];
+};
+type HashListNode = {
+    kind: "hashList";
+    node: GrammarNode;
+};
+type SequenceNode = {
+    kind: "sequence";
+    nodes: GrammarNode[];
+};
+type ChoiceNode = {
+    kind: "choice";
+    nodes: GrammarNode[];
+};
+type LiteralNode = {
+    kind: "literal";
+    value: string;
+};
+type RefNode = {
+    kind: "ref";
+    name: string;
+    args?: string[];
+};
+type OptionalNode = {
+    kind: "optional";
+    node: GrammarNode;
+};
+type RepeatNode = {
+    kind: "repeat";
+    node: GrammarNode;
+    min: number;
+    max?: number;
+};
+export type ParseNode = {
+    type: string;
+    value: string | ParseNode[];
+};
+type MatchResult = {
+    success: boolean;
+    nextIndex: number;
+    nodes: ParseNode[];
+};
+export type ParseTreeNode<T extends string = string> = {
+    type: T;
+    value: T extends "literal" | "symbol" ? string : string | ParseTreeNode[];
+};
+export declare function validateTokens(tokens: string[], rootRule?: string): ParseNode;
+export declare function matchRule(ruleName: string, tokens: string[], index: number, grammar: Record<string, GrammarNode>, memo: Map<string, MatchResult[]>, currentFunction: string | null, args?: string[]): MatchResult[];
+export declare function matchNode(node: GrammarNode, tokens: string[], index: number, grammar: Record<string, GrammarNode>, memo: Map<string, MatchResult[]>, currentFunction: string | null): MatchResult[];
+export declare function tokenize(input: string): string[];
+export declare function parseGrammar(grammar: string): Record<string, GrammarNode>;
+export declare function parseExpression(expr: string): GrammarNode;
+export declare function evaluateComponent(node: ParseTreeNode, expectedType: ComponentDefinition["value"], base?: Record<string, number>): number;
+export declare function evaluateCSSValue(tokenString: string, expectedType: ComponentDefinition["value"], base?: Record<string, number>): number;
+export declare const validators: {
+    "<named-color>": (str: string) => boolean;
+    "<system-color>": (str: string) => boolean;
+    "<hex-color>": (str: string) => boolean;
+    "<number>": (str: string, args: string[] | undefined) => boolean;
+    "<percentage>": (str: string, args: string[] | undefined) => boolean;
+    "<angle>": (str: string, args: string[] | undefined) => boolean;
+};
+export declare const parsers: Record<string, (node: ParseTreeNode) => {
+    model: ColorModel;
+    coords: number[];
+}>;
+export declare const formatters: {
+    readonly "hex-color": {
+        readonly bridge: "rgb";
+        readonly fromBridge: (coords: number[]) => number[];
+        readonly format: ([r, g, b, a]: number[]) => string;
+    };
+    readonly "named-color": {
+        readonly bridge: "rgb";
+        readonly fromBridge: (coords: number[]) => number[];
+        readonly format: (rgb: number[]) => string | undefined;
+    };
+    readonly "device-cmyk": {
+        readonly bridge: "rgb";
+        readonly fromBridge: (coords: number[]) => number[];
+        readonly format: ([red, green, blue, alpha]: number[], options?: FormattingOptions) => string;
+    };
+    readonly "xyz-d65": ColorFormatter;
+    readonly rgb: ColorFormatter;
+    readonly "xyz-d50": ColorFormatter;
+    readonly lab: ColorFormatter;
+    readonly oklab: ColorFormatter;
+    readonly srgb: ColorFormatter;
+    readonly "srgb-linear": ColorFormatter;
+    readonly "display-p3": ColorFormatter;
+    readonly rec2020: ColorFormatter;
+    readonly "a98-rgb": ColorFormatter;
+    readonly "prophoto-rgb": ColorFormatter;
+    readonly xyz: ColorFormatter;
+    readonly hsl: ColorFormatter;
+    readonly hwb: ColorFormatter;
+    readonly lch: ColorFormatter;
+    readonly oklch: ColorFormatter;
+};
+export declare function parseNode(node: ParseTreeNode): {
+    model: ColorModel;
+    coords: number[];
+};
+export declare function isValid(input: string, rule?: string): boolean;
+declare const getters: {
+    readonly "color-models": () => ColorModel[];
+    readonly "color-spaces": () => ColorSpace[];
+    readonly "named-colors": () => NamedColor[];
+    readonly "system-colors": () => SystemColor[];
+    readonly "output-types": () => OutputType[];
+    readonly plugins: () => string[];
+    readonly "fit-methods": () => FitMethod[];
+};
+type Getter = keyof typeof getters;
+/**
+ * Retrieve a list of registered items of a specified type.
+ *
+ * @param type - The getter type, e.g. "color-types".
+ * @returns The array returned by the getter.
+ */
+export declare function get<T extends Getter>(type: T): ReturnType<(typeof getters)[T]>;
+declare const registerers: {
+    readonly "named-color": (name: string, rgb: number[]) => void;
+    readonly "color-function": (name: string, converter: ColorModelConverter) => void;
+    readonly "color-space": (name: string, converter: ColorSpaceConverter) => void;
+    readonly parser: (name: string, spec: GrammarRuleSpec) => void;
+    readonly formatter: (name: string, converter: ColorFormatter) => void;
+    readonly "fit-method": (name: string, method: FitFunction) => void;
+};
+type RegistererType = keyof typeof registerers;
+type RegistererEntry<T extends RegistererType> = {
+    name: string;
+    value: Parameters<(typeof registerers)[T]>[1];
+};
+/**
+ * Bulk register multiple converters of a specified type.
+ *
+ * @param type - The converter type, e.g. "color-function".
+ * @param entries - Array of { name, value } objects.
+ */
+export declare function register<T extends RegistererType>(type: T, entries: RegistererEntry<T>[]): void;
+export {};