omni-color 0.1.0

package/dist/src/color/__test__/deltaE.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/color/__test__/deltaE.test.js

@@ -0,0 +1,120 @@
+import { Color } from '../color';
+import { getDeltaE } from '../deltaE';
+describe('Delta E calculations', () => {
+    describe('getDeltaE', () => {
+        it('returns 0 for identical colors regardless of method', () => {
+            const neutral = new Color('#777777');
+            expect(getDeltaE(neutral, neutral, { method: 'CIE76' })).toBe(0);
+            expect(getDeltaE(neutral, neutral, { method: 'CIE94' })).toBe(0);
+            expect(getDeltaE(neutral, neutral, { method: 'CIEDE2000' })).toBe(0);
+        });
+        it('matches reference values for CIEDE2000', () => {
+            const firstPairA = new Color({ l: 50, a: 2.6772, b: -79.7751 });
+            const firstPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(firstPairA, firstPairB, { method: 'CIEDE2000' })).toBeCloseTo(0.721, 3);
+            const secondPairA = new Color({ l: 50, a: 3.1571, b: -77.2803 });
+            const secondPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(secondPairA, secondPairB, { method: 'CIEDE2000' })).toBeCloseTo(1.07197, 4);
+            const thirdPairA = new Color({ l: 50, a: 2.8361, b: -74.02 });
+            const thirdPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(thirdPairA, thirdPairB, { method: 'CIEDE2000' })).toBeCloseTo(1.42485, 4);
+        });
+        it('matches reference values for CIE94 and CIE76', () => {
+            const firstPairA = new Color({ l: 50, a: 2.6772, b: -79.7751 });
+            const firstPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(firstPairA, firstPairB, { method: 'CIE94' })).toBeCloseTo(0.7636577088674601, 6);
+            expect(getDeltaE(firstPairA, firstPairB, { method: 'CIE76' })).toBeCloseTo(1.619848449701395, 6);
+            const secondPairA = new Color({ l: 50, a: 3.1571, b: -77.2803 });
+            const secondPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(secondPairA, secondPairB, { method: 'CIE94' })).toBeCloseTo(1.069608018415056, 6);
+            expect(getDeltaE(secondPairA, secondPairB, { method: 'CIE76' })).toBeCloseTo(1.2429935639415082, 6);
+            const thirdPairA = new Color({ l: 50, a: 2.8361, b: -74.02 });
+            const thirdPairB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(getDeltaE(thirdPairA, thirdPairB, { method: 'CIE94' })).toBeCloseTo(1.6500919264582965, 6);
+            expect(getDeltaE(thirdPairA, thirdPairB, { method: 'CIE76' })).toBeCloseTo(3.4337015012956535, 6);
+        });
+        it('handles hue wrapping and zero-chroma inputs correctly', () => {
+            const nearZeroHue = new Color({ l: 60, c: 20, h: 20 });
+            const nearFullHue = new Color({ l: 60, c: 20, h: 340 });
+            const grayscaleA = new Color({ l: 55, a: 0, b: 0 });
+            const grayscaleB = new Color({ l: 45, a: 0, b: 0 });
+            expect(getDeltaE(nearZeroHue, nearFullHue, { method: 'CIEDE2000' })).toBeCloseTo(9.2596, 4);
+            expect(getDeltaE(grayscaleA, grayscaleB, { method: 'CIEDE2000' })).toBeCloseTo(10.328990616488563, 6);
+            expect(getDeltaE(grayscaleA, grayscaleB, { method: 'CIE94' })).toBeCloseTo(10.329000048382673, 6);
+            expect(getDeltaE(grayscaleA, grayscaleB, { method: 'CIE76' })).toBeCloseTo(10.329000048407398, 6);
+        });
+        it('honors custom weighting factors for CIE94', () => {
+            const lighterRed = new Color('#ff6666');
+            const darkerRed = new Color('#aa0000');
+            const defaultWeighting = getDeltaE(lighterRed, darkerRed, { method: 'CIE94' });
+            const textilesWeighting = getDeltaE(lighterRed, darkerRed, {
+                method: 'CIE94',
+                cie94Options: { kL: 2, kC: 1, kH: 1.5 },
+            });
+            expect(defaultWeighting).toBeGreaterThan(textilesWeighting);
+            expect(defaultWeighting).toBeCloseTo(29.175, 3);
+            expect(textilesWeighting).toBeCloseTo(15.172, 3);
+        });
+        it('honors custom weighting factors for CIEDE2000', () => {
+            const lighterRed = new Color('#ff6666');
+            const darkerRed = new Color('#aa0000');
+            const defaultWeighting = getDeltaE(lighterRed, darkerRed, { method: 'CIEDE2000' });
+            const customWeighting = getDeltaE(lighterRed, darkerRed, {
+                method: 'CIEDE2000',
+                ciede2000Options: { kL: 2, kC: 1, kH: 1.5 },
+            });
+            const explicitDefaults = getDeltaE(lighterRed, darkerRed, {
+                method: 'CIEDE2000',
+                ciede2000Options: { kL: 1, kC: 1, kH: 1 },
+            });
+            expect(defaultWeighting).toBeCloseTo(29.2788, 4);
+            expect(customWeighting).toBeCloseTo(15.2694, 4);
+            expect(explicitDefaults).toBeCloseTo(defaultWeighting, 12);
+        });
+        it('supports comparing colors from different input spaces', () => {
+            const red = new Color('#ff0000');
+            const green = new Color({ h: 120, s: 100, l: 50 });
+            const yellow = new Color({ l: 97.607, a: -15.578, b: 93.585 });
+            expect(getDeltaE(red, green, { method: 'CIE76' })).toBeCloseTo(170.585, 2);
+            expect(getDeltaE(red, yellow, { method: 'CIE94' })).toBeCloseTo(59.1667, 3);
+            expect(getDeltaE(red, yellow, { method: 'CIEDE2000' })).toBeCloseTo(63.5875, 4);
+        });
+        it('throws for invalid methods in getDeltaE', () => {
+            const colorA = new Color({ l: 50, a: 2.6772, b: -79.7751 });
+            const colorB = new Color({ l: 50, a: 0, b: -82.7485 });
+            expect(() => getDeltaE(colorA, colorB, { method: 'INVALID' })).toThrow("Invalid 'method'");
+        });
+        it('uses CIEDE2000 by default', () => {
+            const red = new Color('#ff0000');
+            const almostRed = new Color('#ff0100');
+            expect(getDeltaE(red, almostRed)).toBeCloseTo(0.034, 3);
+        });
+        it('accepts alternate methods', () => {
+            const blue = new Color('rgb(0, 0, 255)');
+            const teal = new Color({ h: 180, s: 100, l: 50 });
+            expect(getDeltaE(blue, teal, { method: 'CIE76' })).toBeCloseTo(168.65, 2);
+            expect(getDeltaE(blue, teal, { method: 'CIE94' })).toBeCloseTo(74.762, 2);
+        });
+        it('accepts Colors created from different input shapes', () => {
+            const base = new Color('#336699');
+            const identical = new Color({ r: 51, g: 102, b: 153 });
+            const white = new Color('#ffffff');
+            expect(getDeltaE(base, identical)).toBe(0);
+            expect(getDeltaE(base, white, { method: 'CIE76' })).toBeCloseTo(66.644, 3);
+        });
+        it('is symmetric regardless of parameter order', () => {
+            const golden = new Color('#daa520');
+            const navy = new Color('#001f3f');
+            const forward = getDeltaE(golden, navy, { method: 'CIEDE2000' });
+            const reverse = getDeltaE(navy, golden, { method: 'CIEDE2000' });
+            expect(forward).toBeCloseTo(reverse, 12);
+        });
+        it('accepts mixed case method', () => {
+            const c1 = new Color('red');
+            const c2 = new Color('maroon');
+            const d1 = getDeltaE(c1, c2, { method: 'CIE94' });
+            const d2 = getDeltaE(c1, c2, { method: 'cie94' });
+            expect(d1).toBe(d2);
+        });
+    });
+});

package/dist/src/color/__test__/formats.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/color/__test__/formats.test.js

@@ -0,0 +1,470 @@
+import { Color } from '../color';
+import { cmykToString, colorToString, getColorFormatType, hslaToString, hslToString, hwbToString, labToString, lchToString, oklabToString, oklchToString, rgbaToString, rgbToString, } from '../formats';
+describe('rgbToString', () => {
+    it('generates rgb strings', () => {
+        const black = new Color('#000000');
+        expect(rgbToString(black.toRGB())).toBe('rgb(0 0 0)');
+        expect(black.toRGBString()).toBe('rgb(0 0 0)');
+        const white = new Color('#ffffff');
+        expect(rgbToString(white.toRGB())).toBe('rgb(255 255 255)');
+        expect(white.toRGBString()).toBe('rgb(255 255 255)');
+        const gray = new Color('#808080');
+        expect(rgbToString(gray.toRGB())).toBe('rgb(128 128 128)');
+        expect(gray.toRGBString()).toBe('rgb(128 128 128)');
+        const red = new Color('#ff0000');
+        expect(rgbToString(red.toRGB())).toBe('rgb(255 0 0)');
+        expect(red.toRGBString()).toBe('rgb(255 0 0)');
+        const green = new Color('#00ff00');
+        expect(rgbToString(green.toRGB())).toBe('rgb(0 255 0)');
+        expect(green.toRGBString()).toBe('rgb(0 255 0)');
+        const blue = new Color('#0000ff');
+        expect(rgbToString(blue.toRGB())).toBe('rgb(0 0 255)');
+        expect(blue.toRGBString()).toBe('rgb(0 0 255)');
+        const yellow = new Color('#ffff00');
+        expect(rgbToString(yellow.toRGB())).toBe('rgb(255 255 0)');
+        expect(yellow.toRGBString()).toBe('rgb(255 255 0)');
+        const cyan = new Color('#00ffff');
+        expect(rgbToString(cyan.toRGB())).toBe('rgb(0 255 255)');
+        expect(cyan.toRGBString()).toBe('rgb(0 255 255)');
+        const magenta = new Color('#ff00ff');
+        expect(rgbToString(magenta.toRGB())).toBe('rgb(255 0 255)');
+        expect(magenta.toRGBString()).toBe('rgb(255 0 255)');
+        const custom = new Color('#abc123');
+        expect(rgbToString(custom.toRGB())).toBe('rgb(171 193 35)');
+        expect(custom.toRGBString()).toBe('rgb(171 193 35)');
+    });
+});
+describe('rgbaToString', () => {
+    it('generates rgba strings', () => {
+        const transparentBlack = new Color('#00000000');
+        expect(rgbaToString(transparentBlack.toRGBA())).toBe('rgb(0 0 0 / 0)');
+        expect(transparentBlack.toRGBAString()).toBe('rgb(0 0 0 / 0)');
+        const opaqueWhite = new Color('#ffffffff');
+        expect(rgbaToString(opaqueWhite.toRGBA())).toBe('rgb(255 255 255 / 1)');
+        expect(opaqueWhite.toRGBAString()).toBe('rgb(255 255 255 / 1)');
+        const gray = new Color('#80808080');
+        expect(rgbaToString(gray.toRGBA())).toBe('rgb(128 128 128 / 0.502)');
+        expect(gray.toRGBAString()).toBe('rgb(128 128 128 / 0.502)');
+        const red = new Color('#ff000080');
+        expect(rgbaToString(red.toRGBA())).toBe('rgb(255 0 0 / 0.502)');
+        expect(red.toRGBAString()).toBe('rgb(255 0 0 / 0.502)');
+        const green = new Color('#00ff007f');
+        expect(rgbaToString(green.toRGBA())).toBe('rgb(0 255 0 / 0.498)');
+        expect(green.toRGBAString()).toBe('rgb(0 255 0 / 0.498)');
+        const blue = new Color('#0000ff40');
+        expect(rgbaToString(blue.toRGBA())).toBe('rgb(0 0 255 / 0.251)');
+        expect(blue.toRGBAString()).toBe('rgb(0 0 255 / 0.251)');
+        const yellow = new Color('#ffff00c0');
+        expect(rgbaToString(yellow.toRGBA())).toBe('rgb(255 255 0 / 0.753)');
+        expect(yellow.toRGBAString()).toBe('rgb(255 255 0 / 0.753)');
+        const cyan = new Color('#00ffff20');
+        expect(rgbaToString(cyan.toRGBA())).toBe('rgb(0 255 255 / 0.125)');
+        expect(cyan.toRGBAString()).toBe('rgb(0 255 255 / 0.125)');
+        const magenta = new Color('#ff00ff99');
+        expect(rgbaToString(magenta.toRGBA())).toBe('rgb(255 0 255 / 0.6)');
+        expect(magenta.toRGBAString()).toBe('rgb(255 0 255 / 0.6)');
+        const custom = new Color('#abc123d6');
+        expect(rgbaToString(custom.toRGBA())).toBe('rgb(171 193 35 / 0.839)');
+        expect(custom.toRGBAString()).toBe('rgb(171 193 35 / 0.839)');
+    });
+    it('rounds alpha to three decimals', () => {
+        expect(rgbaToString({ r: 1, g: 2, b: 3, a: 0.123456 })).toBe('rgb(1 2 3 / 0.123)');
+        expect(rgbaToString({ r: 1, g: 2, b: 3, a: 0.98765 })).toBe('rgb(1 2 3 / 0.988)');
+    });
+});
+describe('hslToString', () => {
+    it('generates hsl strings', () => {
+        const black = new Color('#000000');
+        expect(hslToString(black.toHSL())).toBe('hsl(0 0% 0%)');
+        expect(black.toHSLString()).toBe('hsl(0 0% 0%)');
+        const white = new Color('#ffffff');
+        expect(hslToString(white.toHSL())).toBe('hsl(0 0% 100%)');
+        expect(white.toHSLString()).toBe('hsl(0 0% 100%)');
+        const gray = new Color('#808080');
+        expect(hslToString(gray.toHSL())).toBe('hsl(0 0% 50.196%)');
+        expect(gray.toHSLString()).toBe('hsl(0 0% 50.196%)');
+        const red = new Color('#ff0000');
+        expect(hslToString(red.toHSL())).toBe('hsl(0 100% 50%)');
+        expect(red.toHSLString()).toBe('hsl(0 100% 50%)');
+        const green = new Color('#00ff00');
+        expect(hslToString(green.toHSL())).toBe('hsl(120 100% 50%)');
+        expect(green.toHSLString()).toBe('hsl(120 100% 50%)');
+        const blue = new Color('#0000ff');
+        expect(hslToString(blue.toHSL())).toBe('hsl(240 100% 50%)');
+        expect(blue.toHSLString()).toBe('hsl(240 100% 50%)');
+        const yellow = new Color('#ffff00');
+        expect(hslToString(yellow.toHSL())).toBe('hsl(60 100% 50%)');
+        expect(yellow.toHSLString()).toBe('hsl(60 100% 50%)');
+        const cyan = new Color('#00ffff');
+        expect(hslToString(cyan.toHSL())).toBe('hsl(180 100% 50%)');
+        expect(cyan.toHSLString()).toBe('hsl(180 100% 50%)');
+        const magenta = new Color('#ff00ff');
+        expect(hslToString(magenta.toHSL())).toBe('hsl(300 100% 50%)');
+        expect(magenta.toHSLString()).toBe('hsl(300 100% 50%)');
+        const custom = new Color('#abc123');
+        expect(hslToString(custom.toHSL())).toBe('hsl(68.354 69.298% 44.706%)');
+        expect(custom.toHSLString()).toBe('hsl(68.354 69.298% 44.706%)');
+    });
+    it('rounds component values to three decimals', () => {
+        expect(hslToString({ h: 123.4567, s: 50.5555, l: 10.1234 })).toBe('hsl(123.457 50.556% 10.123%)');
+    });
+});
+describe('hslaToString', () => {
+    it('generates hsla strings', () => {
+        const transparentBlack = new Color('#00000000');
+        expect(hslaToString(transparentBlack.toHSLA())).toBe('hsl(0 0% 0% / 0)');
+        expect(transparentBlack.toHSLAString()).toBe('hsl(0 0% 0% / 0)');
+        const opaqueWhite = new Color('#ffffffff');
+        expect(hslaToString(opaqueWhite.toHSLA())).toBe('hsl(0 0% 100% / 1)');
+        expect(opaqueWhite.toHSLAString()).toBe('hsl(0 0% 100% / 1)');
+        const gray = new Color('#80808080');
+        expect(hslaToString(gray.toHSLA())).toBe('hsl(0 0% 50.196% / 0.502)');
+        expect(gray.toHSLAString()).toBe('hsl(0 0% 50.196% / 0.502)');
+        const red = new Color('#ff000080');
+        expect(hslaToString(red.toHSLA())).toBe('hsl(0 100% 50% / 0.502)');
+        expect(red.toHSLAString()).toBe('hsl(0 100% 50% / 0.502)');
+        const green = new Color('#00ff007f');
+        expect(hslaToString(green.toHSLA())).toBe('hsl(120 100% 50% / 0.498)');
+        expect(green.toHSLAString()).toBe('hsl(120 100% 50% / 0.498)');
+        const blue = new Color('#0000ff40');
+        expect(hslaToString(blue.toHSLA())).toBe('hsl(240 100% 50% / 0.251)');
+        expect(blue.toHSLAString()).toBe('hsl(240 100% 50% / 0.251)');
+        const yellow = new Color('#ffff00c0');
+        expect(hslaToString(yellow.toHSLA())).toBe('hsl(60 100% 50% / 0.753)');
+        expect(yellow.toHSLAString()).toBe('hsl(60 100% 50% / 0.753)');
+        const cyan = new Color('#00ffff20');
+        expect(hslaToString(cyan.toHSLA())).toBe('hsl(180 100% 50% / 0.125)');
+        expect(cyan.toHSLAString()).toBe('hsl(180 100% 50% / 0.125)');
+        const magenta = new Color('#ff00ff99');
+        expect(hslaToString(magenta.toHSLA())).toBe('hsl(300 100% 50% / 0.6)');
+        expect(magenta.toHSLAString()).toBe('hsl(300 100% 50% / 0.6)');
+        const custom = new Color('#abc123d6');
+        expect(hslaToString(custom.toHSLA())).toBe('hsl(68.354 69.298% 44.706% / 0.839)');
+        expect(custom.toHSLAString()).toBe('hsl(68.354 69.298% 44.706% / 0.839)');
+    });
+    it('rounds hsla components to three decimals', () => {
+        expect(hslaToString({ h: 123.4567, s: 50.5555, l: 10.1234, a: 0.98765 })).toBe('hsl(123.457 50.556% 10.123% / 0.988)');
+    });
+});
+describe('colorToString', () => {
+    it('generates color() strings in different spaces', () => {
+        const opaque = new Color('#336699');
+        const translucent = new Color('#336699cc');
+        expect(colorToString(opaque.toRGBA())).toBe('color(srgb 0.2 0.4 0.6)');
+        expect(colorToString(translucent.toRGBA())).toBe('color(srgb 0.2 0.4 0.6 / 0.8)');
+        expect(colorToString(translucent.toRGBA(), { space: 'display-p3' })).toBe('color(display-p3 0.249851 0.39524 0.584034 / 0.8)');
+        expect(colorToString(opaque.toRGBA(), { space: 'rec2020' })).toBe('color(rec2020 0.250128 0.336705 0.537794)');
+    });
+});
+describe('hwbToString', () => {
+    it('generates hwb strings', () => {
+        const black = new Color('#000000');
+        expect(hwbToString(black.toHWB())).toBe('hwb(0 0% 100%)');
+        expect(black.toHWBString()).toBe('hwb(0 0% 100%)');
+        expect(black.toHWBAString()).toBe('hwb(0 0% 100% / 1)');
+        const white = new Color('#ffffffff');
+        expect(hwbToString(white.toHWB())).toBe('hwb(0 100% 0%)');
+        expect(white.toHWBString()).toBe('hwb(0 100% 0%)');
+        expect(white.toHWBAString()).toBe('hwb(0 100% 0% / 1)');
+        const gray = new Color('#80808080');
+        expect(hwbToString(gray.toHWB())).toBe('hwb(0 50% 50%)');
+        expect(gray.toHWBString()).toBe('hwb(0 50% 50%)');
+        expect(gray.toHWBAString()).toBe('hwb(0 50% 50% / 0.502)');
+        const green = new Color('#00ff00');
+        expect(hwbToString(green.toHWB())).toBe('hwb(120 0% 0%)');
+        expect(green.toHWBString()).toBe('hwb(120 0% 0%)');
+        expect(green.toHWBAString()).toBe('hwb(120 0% 0% / 1)');
+        const custom = new Color('#abc123d6');
+        expect(hwbToString(custom.toHWB())).toBe('hwb(68.354 14% 24%)');
+        expect(custom.toHWBString()).toBe('hwb(68.354 14% 24%)');
+        expect(custom.toHWBAString()).toBe('hwb(68.354 14% 24% / 0.839)');
+    });
+    it('rounds hwb components to three decimals', () => {
+        expect(hwbToString({ h: 123.4567, w: 12.3456, b: 65.4321 })).toBe('hwb(123.457 12.346% 65.432%)');
+    });
+});
+describe('cmykToString', () => {
+    it('generates cmyk strings', () => {
+        const black = new Color('#000000');
+        expect(cmykToString(black.toCMYK())).toBe('device-cmyk(0% 0% 0% 100%)');
+        expect(black.toCMYKString()).toBe('device-cmyk(0% 0% 0% 100%)');
+        const white = new Color('#ffffff');
+        expect(cmykToString(white.toCMYK())).toBe('device-cmyk(0% 0% 0% 0%)');
+        expect(white.toCMYKString()).toBe('device-cmyk(0% 0% 0% 0%)');
+        const gray = new Color('#808080');
+        expect(cmykToString(gray.toCMYK())).toBe('device-cmyk(0% 0% 0% 50%)');
+        expect(gray.toCMYKString()).toBe('device-cmyk(0% 0% 0% 50%)');
+        const red = new Color('#ff0000');
+        expect(cmykToString(red.toCMYK())).toBe('device-cmyk(0% 100% 100% 0%)');
+        expect(red.toCMYKString()).toBe('device-cmyk(0% 100% 100% 0%)');
+        const green = new Color('#00ff00');
+        expect(cmykToString(green.toCMYK())).toBe('device-cmyk(100% 0% 100% 0%)');
+        expect(green.toCMYKString()).toBe('device-cmyk(100% 0% 100% 0%)');
+        const blue = new Color('#0000ff');
+        expect(cmykToString(blue.toCMYK())).toBe('device-cmyk(100% 100% 0% 0%)');
+        expect(blue.toCMYKString()).toBe('device-cmyk(100% 100% 0% 0%)');
+        const yellow = new Color('#ffff00');
+        expect(cmykToString(yellow.toCMYK())).toBe('device-cmyk(0% 0% 100% 0%)');
+        expect(yellow.toCMYKString()).toBe('device-cmyk(0% 0% 100% 0%)');
+        const cyan = new Color('#00ffff');
+        expect(cmykToString(cyan.toCMYK())).toBe('device-cmyk(100% 0% 0% 0%)');
+        expect(cyan.toCMYKString()).toBe('device-cmyk(100% 0% 0% 0%)');
+        const magenta = new Color('#ff00ff');
+        expect(cmykToString(magenta.toCMYK())).toBe('device-cmyk(0% 100% 0% 0%)');
+        expect(magenta.toCMYKString()).toBe('device-cmyk(0% 100% 0% 0%)');
+        const custom = new Color('#abc123');
+        expect(cmykToString(custom.toCMYK())).toBe('device-cmyk(11% 0% 82% 24%)');
+        expect(custom.toCMYKString()).toBe('device-cmyk(11% 0% 82% 24%)');
+    });
+    it('rounds cmyk components to three decimals', () => {
+        expect(cmykToString({ c: 12.3456, m: 0.9876, y: 54.321, k: 10.5555 })).toBe('device-cmyk(12.346% 0.988% 54.321% 10.556%)');
+    });
+});
+describe('labToString', () => {
+    it('generates lab strings', () => {
+        const black = new Color('#000000');
+        expect(labToString(black.toLAB())).toBe('lab(0% 0 0)');
+        expect(black.toLABString()).toBe('lab(0% 0 0)');
+        const white = new Color('#ffffff');
+        expect(labToString(white.toLAB())).toBe('lab(100% 0.005 -0.01)');
+        expect(white.toLABString()).toBe('lab(100% 0.005 -0.01)');
+        const gray = new Color('#808080');
+        expect(labToString(gray.toLAB())).toBe('lab(53.585% 0.003 -0.006)');
+        expect(gray.toLABString()).toBe('lab(53.585% 0.003 -0.006)');
+        const red = new Color('#ff0000');
+        expect(labToString(red.toLAB())).toBe('lab(53.233% 80.109 67.22)');
+        expect(red.toLABString()).toBe('lab(53.233% 80.109 67.22)');
+        const green = new Color('#00ff00');
+        expect(labToString(green.toLAB())).toBe('lab(87.737% -86.185 83.181)');
+        expect(green.toLABString()).toBe('lab(87.737% -86.185 83.181)');
+        const blue = new Color('#0000ff');
+        expect(labToString(blue.toLAB())).toBe('lab(32.303% 79.197 -107.864)');
+        expect(blue.toLABString()).toBe('lab(32.303% 79.197 -107.864)');
+        const custom = new Color('#abc123');
+        expect(labToString(custom.toLAB())).toBe('lab(74.138% -26.201 69.136)');
+        expect(custom.toLABString()).toBe('lab(74.138% -26.201 69.136)');
+    });
+    it('rounds lab components to three decimals', () => {
+        expect(labToString({ l: 12.3456, a: -7.654321, b: 123.4567 })).toBe('lab(12.346% -7.654 123.457)');
+    });
+});
+describe('lchToString', () => {
+    it('generates lch strings', () => {
+        const black = new Color('#000000');
+        expect(lchToString(black.toLCH())).toBe('lch(0% 0 0)');
+        expect(black.toLCHString()).toBe('lch(0% 0 0)');
+        const white = new Color('#ffffff');
+        expect(lchToString(white.toLCH())).toBe('lch(100% 0.012 296.813)');
+        expect(white.toLCHString()).toBe('lch(100% 0.012 296.813)');
+        const gray = new Color('#808080');
+        expect(lchToString(gray.toLCH())).toBe('lch(53.585% 0.007 296.813)');
+        expect(gray.toLCHString()).toBe('lch(53.585% 0.007 296.813)');
+        const red = new Color('#ff0000');
+        expect(lchToString(red.toLCH())).toBe('lch(53.233% 104.576 40)');
+        expect(red.toLCHString()).toBe('lch(53.233% 104.576 40)');
+        const green = new Color('#00ff00');
+        expect(lchToString(green.toLCH())).toBe('lch(87.737% 119.779 136.016)');
+        expect(green.toLCHString()).toBe('lch(87.737% 119.779 136.016)');
+        const blue = new Color('#0000ff');
+        expect(lchToString(blue.toLCH())).toBe('lch(32.303% 133.816 306.287)');
+        expect(blue.toLCHString()).toBe('lch(32.303% 133.816 306.287)');
+        const yellow = new Color('#ffff00');
+        expect(lchToString(yellow.toLCH())).toBe('lch(97.138% 96.91 102.852)');
+        expect(yellow.toLCHString()).toBe('lch(97.138% 96.91 102.852)');
+        const cyan = new Color('#00ffff');
+        expect(lchToString(cyan.toLCH())).toBe('lch(91.117% 50.115 196.386)');
+        expect(cyan.toLCHString()).toBe('lch(91.117% 50.115 196.386)');
+        const magenta = new Color('#ff00ff');
+        expect(lchToString(magenta.toLCH())).toBe('lch(60.32% 115.567 328.233)');
+        expect(magenta.toLCHString()).toBe('lch(60.32% 115.567 328.233)');
+        const custom = new Color('#abc123');
+        expect(lchToString(custom.toLCH())).toBe('lch(74.138% 73.934 110.756)');
+        expect(custom.toLCHString()).toBe('lch(74.138% 73.934 110.756)');
+    });
+    it('rounds lch components to three decimals', () => {
+        expect(lchToString({ l: 12.3456, c: 7.654321, h: 123.4567 })).toBe('lch(12.346% 7.654 123.457)');
+    });
+});
+describe('oklabToString', () => {
+    it('generates oklab strings', () => {
+        const black = new Color('#000000');
+        expect(oklabToString(black.toOKLAB())).toBe('oklab(0 0 0)');
+        expect(black.toOKLABString()).toBe('oklab(0 0 0)');
+        const white = new Color('#ffffff');
+        expect(oklabToString(white.toOKLAB())).toBe('oklab(1 0 0)');
+        expect(white.toOKLABString()).toBe('oklab(1 0 0)');
+        const gray = new Color('#808080');
+        expect(oklabToString(gray.toOKLAB())).toBe('oklab(0.599871 0 0)');
+        expect(gray.toOKLABString()).toBe('oklab(0.599871 0 0)');
+        const red = new Color('#ff0000');
+        expect(oklabToString(red.toOKLAB())).toBe('oklab(0.627955 0.224863 0.125846)');
+        expect(red.toOKLABString()).toBe('oklab(0.627955 0.224863 0.125846)');
+    });
+    it('rounds oklab components to six decimals', () => {
+        expect(oklabToString({ l: 0.123456789, a: 0.987654321, b: 0.111213141 })).toBe('oklab(0.123457 0.987654 0.111213)');
+    });
+});
+describe('oklchToString', () => {
+    it('generates oklch strings', () => {
+        const black = new Color('#000000');
+        expect(oklchToString(black.toOKLCH())).toBe('oklch(0 0 0)');
+        expect(black.toOKLCHString()).toBe('oklch(0 0 0)');
+        const white = new Color('#ffffff');
+        expect(oklchToString(white.toOKLCH())).toBe('oklch(1 0 89.876)');
+        expect(white.toOKLCHString()).toBe('oklch(1 0 89.876)');
+        const gray = new Color('#808080');
+        expect(oklchToString(gray.toOKLCH())).toBe('oklch(0.599871 0 89.876)');
+        expect(gray.toOKLCHString()).toBe('oklch(0.599871 0 89.876)');
+        const red = new Color('#ff0000');
+        expect(oklchToString(red.toOKLCH())).toBe('oklch(0.627955 0.257683 29.234)');
+        expect(red.toOKLCHString()).toBe('oklch(0.627955 0.257683 29.234)');
+        const green = new Color('#00ff00');
+        expect(oklchToString(green.toOKLCH())).toBe('oklch(0.86644 0.294827 142.495)');
+        expect(green.toOKLCHString()).toBe('oklch(0.86644 0.294827 142.495)');
+        const blue = new Color('#0000ff');
+        expect(oklchToString(blue.toOKLCH())).toBe('oklch(0.452014 0.313214 264.052)');
+        expect(blue.toOKLCHString()).toBe('oklch(0.452014 0.313214 264.052)');
+        const yellow = new Color('#ffff00');
+        expect(oklchToString(yellow.toOKLCH())).toBe('oklch(0.967983 0.211006 109.769)');
+        expect(yellow.toOKLCHString()).toBe('oklch(0.967983 0.211006 109.769)');
+        const cyan = new Color('#00ffff');
+        expect(oklchToString(cyan.toOKLCH())).toBe('oklch(0.905399 0.15455 194.769)');
+        expect(cyan.toOKLCHString()).toBe('oklch(0.905399 0.15455 194.769)');
+        const magenta = new Color('#ff00ff');
+        expect(oklchToString(magenta.toOKLCH())).toBe('oklch(0.701674 0.322491 328.363)');
+        expect(magenta.toOKLCHString()).toBe('oklch(0.701674 0.322491 328.363)');
+        const custom = new Color('#abc123');
+        expect(oklchToString(custom.toOKLCH())).toBe('oklch(0.768123 0.169623 117.914)');
+        expect(custom.toOKLCHString()).toBe('oklch(0.768123 0.169623 117.914)');
+    });
+    it('rounds oklch components to six decimals', () => {
+        expect(oklchToString({ l: 0.123456789, c: 0.987654321, h: 123.456789 })).toBe('oklch(0.123457 0.987654 123.457)');
+    });
+});
+describe('getColorFormatType', () => {
+    it('detects hex values', () => {
+        expect(getColorFormatType('#000').formatType).toBe('HEX');
+        expect(getColorFormatType('#000')).toEqual({
+            formatType: 'HEX',
+            value: '#000000',
+        });
+        expect(getColorFormatType('#abcdef')).toEqual({
+            formatType: 'HEX',
+            value: '#abcdef',
+        });
+        expect(getColorFormatType('#ABCDEF')).toEqual({
+            formatType: 'HEX',
+            value: '#abcdef',
+        });
+        expect(getColorFormatType('#11223344')).toEqual({
+            formatType: 'HEX8',
+            value: '#11223344',
+        });
+    });
+    it('detects object formats', () => {
+        expect(getColorFormatType({ r: 1, g: 2, b: 3 })).toEqual({
+            formatType: 'RGB',
+            value: { r: 1, g: 2, b: 3 },
+        });
+        expect(getColorFormatType({ r: 1, g: 2, b: 3, a: 0.4 })).toEqual({
+            formatType: 'RGBA',
+            value: { r: 1, g: 2, b: 3, a: 0.4 },
+        });
+        expect(getColorFormatType({ h: 10, s: 20, l: 30 })).toEqual({
+            formatType: 'HSL',
+            value: { h: 10, s: 20, l: 30 },
+        });
+        expect(getColorFormatType({ h: 10, s: 20, l: 30, a: 0.5 })).toEqual({
+            formatType: 'HSLA',
+            value: { h: 10, s: 20, l: 30, a: 0.5 },
+        });
+        expect(getColorFormatType({ h: 10, w: 20, b: 30 })).toEqual({
+            formatType: 'HWB',
+            value: { h: 10, w: 20, b: 30 },
+        });
+        expect(getColorFormatType({ h: 10, w: 20, b: 30, a: 0.5 })).toEqual({
+            formatType: 'HWBA',
+            value: { h: 10, w: 20, b: 30, a: 0.5 },
+        });
+        expect(getColorFormatType({ h: 10, s: 20, v: 30 })).toEqual({
+            formatType: 'HSV',
+            value: { h: 10, s: 20, v: 30 },
+        });
+        expect(getColorFormatType({ h: 10, s: 20, v: 30, a: 0.5 })).toEqual({
+            formatType: 'HSVA',
+            value: { h: 10, s: 20, v: 30, a: 0.5 },
+        });
+        expect(getColorFormatType({ c: 1, m: 2, y: 3, k: 4 })).toEqual({
+            formatType: 'CMYK',
+            value: { c: 1, m: 2, y: 3, k: 4 },
+        });
+        expect(getColorFormatType({ l: 50, a: 10, b: -20 })).toEqual({
+            formatType: 'LAB',
+            value: { l: 50, a: 10, b: -20 },
+        });
+        expect(getColorFormatType({ l: 0.6, a: 0.2, b: -0.1 })).toEqual({
+            formatType: 'OKLAB',
+            value: { l: 0.6, a: 0.2, b: -0.1, format: 'OKLAB' },
+        });
+        expect(getColorFormatType({ l: 0.6, a: 0.2, b: -0.1, format: 'OKLAB' })).toEqual({
+            formatType: 'OKLAB',
+            value: { l: 0.6, a: 0.2, b: -0.1, format: 'OKLAB' },
+        });
+        expect(getColorFormatType({ l: 50, c: 20, h: 100 })).toEqual({
+            formatType: 'LCH',
+            value: { l: 50, c: 20, h: 100, format: 'LCH' },
+        });
+        expect(getColorFormatType({ l: 0.5, c: 0.2, h: 100 })).toEqual({
+            formatType: 'OKLCH',
+            value: { l: 0.5, c: 0.2, h: 100, format: 'OKLCH' },
+        });
+    });
+    it('disambiguates lch and oklch based on expected ranges', () => {
+        expect(getColorFormatType({ l: 0.5, c: 50, h: 120 })).toEqual({
+            formatType: 'OKLCH',
+            value: { l: 0.5, c: 50, h: 120, format: 'OKLCH' },
+        });
+        expect(getColorFormatType({ l: 0.5, c: 50, h: 120, format: 'LCH' })).toEqual({
+            formatType: 'LCH',
+            value: { l: 0.5, c: 50, h: 120, format: 'LCH' },
+        });
+        expect(getColorFormatType({ l: 0.5, c: 0.1, h: 120 })).toEqual({
+            formatType: 'OKLCH',
+            value: { l: 0.5, c: 0.1, h: 120, format: 'OKLCH' },
+        });
+        expect(getColorFormatType({ l: 1, c: 0.4, h: 90 })).toEqual({
+            formatType: 'OKLCH',
+            value: { l: 1, c: 0.4, h: 90, format: 'OKLCH' },
+        });
+        expect(getColorFormatType({ l: 1.0001, c: 0.4, h: 90 })).toEqual({
+            formatType: 'LCH',
+            value: { l: 1.0001, c: 0.4, h: 90, format: 'LCH' },
+        });
+        expect(getColorFormatType({ l: 0.9, c: 0.7, h: 200, format: 'OKLCH' })).toEqual({
+            formatType: 'OKLCH',
+            value: { l: 0.9, c: 0.7, h: 200, format: 'OKLCH' },
+        });
+        expect(getColorFormatType({ l: 99.999, c: 0.6, h: 270 })).toEqual({
+            formatType: 'LCH',
+            value: { l: 99.999, c: 0.6, h: 270, format: 'LCH' },
+        });
+    });
+    it('disambiguates lab and oklab based on expected ranges', () => {
+        expect(getColorFormatType({ l: 0.7, a: 0.1, b: 0.2 })).toEqual({
+            formatType: 'OKLAB',
+            value: { l: 0.7, a: 0.1, b: 0.2, format: 'OKLAB' },
+        });
+        expect(getColorFormatType({ l: 0.7, a: 0.1, b: 0.2, format: 'LAB' })).toEqual({
+            formatType: 'LAB',
+            value: { l: 0.7, a: 0.1, b: 0.2, format: 'LAB' },
+        });
+        expect(getColorFormatType({ l: 75, a: 20, b: -30 })).toEqual({
+            formatType: 'LAB',
+            value: { l: 75, a: 20, b: -30 },
+        });
+    });
+    it('throws on unknown formats', () => {
+        expect(() => getColorFormatType('abc')).toThrow(/unknown color format/);
+        expect(() => getColorFormatType({})).toThrow(/unknown color format/);
+    });
+});

package/dist/src/color/__test__/gradients.test.d.ts

@@ -0,0 +1 @@
+export {};