@promptbook/color 0.100.0-48

package/umd/index.umd.js

@@ -0,0 +1,1074 @@
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+    typeof define === 'function' && define.amd ? define(['exports'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-color"] = {}));
+})(this, (function (exports) { 'use strict';
+
+    // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
+    /**
+     * The version of the Book language
+     *
+     * @generated
+     * @see https://github.com/webgptorg/book
+     */
+    const BOOK_LANGUAGE_VERSION = '1.0.0';
+    /**
+     * The version of the Promptbook engine
+     *
+     * @generated
+     * @see https://github.com/webgptorg/promptbook
+     */
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-48';
+    /**
+     * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * @private util of `@promptbook/color`
+     * @de
+     */
+    class TakeChain {
+        constructor(value) {
+            this.value = value;
+        }
+        then(callback) {
+            const newValue = callback(this.value);
+            return take(newValue);
+        }
+    }
+
+    /**
+     * A function that takes an initial value and returns a proxy object with chainable methods.
+     *
+     * @param {*} initialValue - The initial value.
+     * @returns {Proxy<WithTake<TValue>>} - A proxy object with a `take` method.
+     *
+     * @private util of `@promptbook/color`
+     * @deprecated [🤡] Use some better functional library instead of `TakeChain`
+     */
+    function take(initialValue) {
+        if (initialValue instanceof TakeChain) {
+            return initialValue;
+        }
+        return new Proxy(new TakeChain(initialValue), {
+            get(target, property, receiver) {
+                if (Reflect.has(target, property)) {
+                    return Reflect.get(target, property, receiver);
+                }
+                else if (Reflect.has(initialValue, property)) {
+                    return Reflect.get(initialValue, property, receiver);
+                }
+                else {
+                    return undefined;
+                }
+            },
+        });
+    }
+
+    /**
+     * 🎨 List of all 140 color names which are supported by CSS
+     *
+     * @public exported from `@promptbook/color`
+     */
+    const CSS_COLORS = {
+        transparent: 'rgba(0,0,0,0)',
+        aliceblue: '#f0f8ff',
+        antiquewhite: '#faebd7',
+        aqua: '#00ffff',
+        aquamarine: '#7fffd4',
+        azure: '#f0ffff',
+        beige: '#f5f5dc',
+        bisque: '#ffe4c4',
+        black: '#000000',
+        blanchedalmond: '#ffebcd',
+        blue: '#0000ff',
+        blueviolet: '#8a2be2',
+        brown: '#a52a2a',
+        burlywood: '#deb887',
+        cadetblue: '#5f9ea0',
+        chartreuse: '#7fff00',
+        chocolate: '#d2691e',
+        coral: '#ff7f50',
+        cornflowerblue: '#6495ed',
+        cornsilk: '#fff8dc',
+        crimson: '#dc143c',
+        cyan: '#00ffff',
+        darkblue: '#00008b',
+        darkcyan: '#008b8b',
+        darkgoldenrod: '#b8860b',
+        darkgray: '#a9a9a9',
+        darkgrey: '#a9a9a9',
+        darkgreen: '#006400',
+        darkkhaki: '#bdb76b',
+        darkmagenta: '#8b008b',
+        darkolivegreen: '#556b2f',
+        darkorange: '#ff8c00',
+        darkorchid: '#9932cc',
+        darkred: '#8b0000',
+        darksalmon: '#e9967a',
+        darkseagreen: '#8fbc8f',
+        darkslateblue: '#483d8b',
+        darkslategray: '#2f4f4f',
+        darkslategrey: '#2f4f4f',
+        darkturquoise: '#00ced1',
+        darkviolet: '#9400d3',
+        deeppink: '#ff1493',
+        deepskyblue: '#00bfff',
+        dimgray: '#696969',
+        dimgrey: '#696969',
+        dodgerblue: '#1e90ff',
+        firebrick: '#b22222',
+        floralwhite: '#fffaf0',
+        forestgreen: '#228b22',
+        fuchsia: '#ff00ff',
+        gainsboro: '#dcdcdc',
+        ghostwhite: '#f8f8ff',
+        gold: '#ffd700',
+        goldenrod: '#daa520',
+        gray: '#808080',
+        grey: '#808080',
+        green: '#008000',
+        greenyellow: '#adff2f',
+        honeydew: '#f0fff0',
+        hotpink: '#ff69b4',
+        indianred: '#cd5c5c',
+        indigo: '#4b0082',
+        ivory: '#fffff0',
+        khaki: '#f0e68c',
+        lavender: '#e6e6fa',
+        lavenderblush: '#fff0f5',
+        lawngreen: '#7cfc00',
+        lemonchiffon: '#fffacd',
+        lightblue: '#add8e6',
+        lightcoral: '#f08080',
+        lightcyan: '#e0ffff',
+        lightgoldenrodyellow: '#fafad2',
+        lightgray: '#d3d3d3',
+        lightgrey: '#d3d3d3',
+        lightgreen: '#90ee90',
+        lightpink: '#ffb6c1',
+        lightsalmon: '#ffa07a',
+        lightseagreen: '#20b2aa',
+        lightskyblue: '#87cefa',
+        lightslategray: '#778899',
+        lightslategrey: '#778899',
+        lightsteelblue: '#b0c4de',
+        lightyellow: '#ffffe0',
+        lime: '#00ff00',
+        limegreen: '#32cd32',
+        linen: '#faf0e6',
+        magenta: '#ff00ff',
+        maroon: '#800000',
+        mediumaquamarine: '#66cdaa',
+        mediumblue: '#0000cd',
+        mediumorchid: '#ba55d3',
+        mediumpurple: '#9370db',
+        mediumseagreen: '#3cb371',
+        mediumslateblue: '#7b68ee',
+        mediumspringgreen: '#00fa9a',
+        mediumturquoise: '#48d1cc',
+        mediumvioletred: '#c71585',
+        midnightblue: '#191970',
+        mintcream: '#f5fffa',
+        mistyrose: '#ffe4e1',
+        moccasin: '#ffe4b5',
+        navajowhite: '#ffdead',
+        navy: '#000080',
+        oldlace: '#fdf5e6',
+        olive: '#808000',
+        olivedrab: '#6b8e23',
+        orange: '#ffa500',
+        orangered: '#ff4500',
+        orchid: '#da70d6',
+        palegoldenrod: '#eee8aa',
+        palegreen: '#98fb98',
+        paleturquoise: '#afeeee',
+        palevioletred: '#db7093',
+        papayawhip: '#ffefd5',
+        peachpuff: '#ffdab9',
+        peru: '#cd853f',
+        pink: '#ffc0cb',
+        plum: '#dda0dd',
+        powderblue: '#b0e0e6',
+        purple: '#800080',
+        rebeccapurple: '#663399',
+        red: '#ff0000',
+        rosybrown: '#bc8f8f',
+        royalblue: '#4169e1',
+        saddlebrown: '#8b4513',
+        salmon: '#fa8072',
+        sandybrown: '#f4a460',
+        seagreen: '#2e8b57',
+        seashell: '#fff5ee',
+        sienna: '#a0522d',
+        silver: '#c0c0c0',
+        skyblue: '#87ceeb',
+        slateblue: '#6a5acd',
+        slategray: '#708090',
+        slategrey: '#708090',
+        snow: '#fffafa',
+        springgreen: '#00ff7f',
+        steelblue: '#4682b4',
+        tan: '#d2b48c',
+        teal: '#008080',
+        thistle: '#d8bfd8',
+        tomato: '#ff6347',
+        turquoise: '#40e0d0',
+        violet: '#ee82ee',
+        wheat: '#f5deb3',
+        white: '#ffffff',
+        whitesmoke: '#f5f5f5',
+        yellow: '#ffff00',
+        yellowgreen: '#9acd32',
+    };
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * Validates that a channel value is a valid number within the range of 0 to 255.
+     * Throws an error if the value is not valid.
+     *
+     * @param channelName - The name of the channel being validated.
+     * @param value - The value of the channel to validate.
+     * @throws Will throw an error if the value is not a valid channel number.
+     *
+     * @private util of `@promptbook/color`
+     */
+    function checkChannelValue(channelName, value) {
+        if (typeof value !== 'number') {
+            throw new Error(`${channelName} channel value is not number but ${typeof value}`);
+        }
+        if (isNaN(value)) {
+            throw new Error(`${channelName} channel value is NaN`);
+        }
+        if (Math.round(value) !== value) {
+            throw new Error(`${channelName} channel is not whole number, it is ${value}`);
+        }
+        if (value < 0) {
+            throw new Error(`${channelName} channel is lower than 0, it is ${value}`);
+        }
+        if (value > 255) {
+            throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
+        }
+    }
+    /**
+     * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
+     */
+
+    /**
+     * Color object represents an RGB color with alpha channel
+     *
+     * Note: There is no fromObject/toObject because the most logical way to serialize color is as a hex string (#009edd)
+     *
+     * @public exported from `@promptbook/color`
+     */
+    class Color {
+        /**
+         * Creates a new Color instance from miscellaneous formats
+         * - It can receive Color instance and just return the same instance
+         * - It can receive color in string format for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`
+         *
+         * Note: This is not including fromImage because detecting color from an image is heavy task which requires async stuff and we cannot safely determine with overloading if return value will be a promise
+         *
+         * @param color
+         * @returns Color object
+         */
+        static from(color) {
+            if (color instanceof Color) {
+                return take(color);
+            }
+            else if (typeof color === 'string') {
+                return Color.fromString(color);
+            }
+            else {
+                console.error({ color });
+                throw new Error(`Can not create color from given object`);
+            }
+        }
+        /**
+         * Creates a new Color instance from miscellaneous string formats
+         *
+         * @param color as a string for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`, `red`, `darkgrey`,...
+         * @returns Color object
+         */
+        static fromString(color) {
+            if (CSS_COLORS[color]) {
+                return Color.fromString(CSS_COLORS[color]);
+                // -----
+            }
+            else if (/^#(?:[0-9a-fA-F]{3}){1,2}$/.test(color)) {
+                return Color.fromHex(color);
+                // -----
+            }
+            else if (/^hsl\(\s*(\d+)\s*,\s*(\d+(?:\.\d+)?%)\s*,\s*(\d+(?:\.\d+)?%)\)$/.test(color)) {
+                return Color.fromHsl(color);
+                // -----
+            }
+            else if (/^rgb\((\s*[0-9-.%]+\s*,?){3}\)$/.test(color)) {
+                // TODO: [0] Should be fromRgbString and fromRgbaString one or two functions
+                return Color.fromRgbString(color);
+                // -----
+            }
+            else if (/^rgba\((\s*[0-9-.%]+\s*,?){4}\)$/.test(color)) {
+                return Color.fromRgbaString(color);
+                // -----
+            }
+            else {
+                throw new Error(`Can not create a new Color instance from string "${color}".`);
+            }
+        }
+        /**
+         * Gets common color
+         *
+         * @param key as a css string like `midnightblue`
+         * @returns Color object
+         */
+        static get(key) {
+            if (!CSS_COLORS[key]) {
+                throw new Error(`"${key}" is not a common css color.`);
+            }
+            return Color.fromString(CSS_COLORS[key]);
+        }
+        /**
+         * Creates a new Color instance from average color of given image
+         *
+         * @param image as a source for example `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAA1JREFUGFdjYJh39z8ABJgCe/ZvAS4AAAAASUVORK5CYII=`
+         * @returns Color object
+         */
+        static async fromImage(image) {
+            return Color.fromHex(`#009edd`);
+        }
+        /**
+         * Creates a new Color instance from color in hex format
+         *
+         * @param color in hex for example `#009edd`, `009edd`, `#555`,...
+         * @returns Color object
+         */
+        static fromHex(hex) {
+            const hexOriginal = hex;
+            if (hex.startsWith('#')) {
+                hex = hex.substring(1);
+            }
+            if (hex.length === 3) {
+                return Color.fromHex3(hex);
+            }
+            if (hex.length === 6) {
+                return Color.fromHex6(hex);
+            }
+            if (hex.length === 8) {
+                return Color.fromHex8(hex);
+            }
+            throw new Error(`Can not parse color from hex string "${hexOriginal}"`);
+        }
+        /**
+         * Creates a new Color instance from color in hex format with 3 color digits (without alpha channel)
+         *
+         * @param color in hex for example `09d`
+         * @returns Color object
+         */
+        static fromHex3(hex) {
+            const r = parseInt(hex.substr(0, 1), 16) * 16;
+            const g = parseInt(hex.substr(1, 1), 16) * 16;
+            const b = parseInt(hex.substr(2, 1), 16) * 16;
+            return take(new Color(r, g, b));
+        }
+        /**
+         * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
+         *
+         * @param color in hex for example `009edd`
+         * @returns Color object
+         */
+        static fromHex6(hex) {
+            const r = parseInt(hex.substr(0, 2), 16);
+            const g = parseInt(hex.substr(2, 2), 16);
+            const b = parseInt(hex.substr(4, 2), 16);
+            return take(new Color(r, g, b));
+        }
+        /**
+         * Creates a new Color instance from color in hex format with 8 color digits (with alpha channel)
+         *
+         * @param color in hex for example `009edd`
+         * @returns Color object
+         */
+        static fromHex8(hex) {
+            const r = parseInt(hex.substr(0, 2), 16);
+            const g = parseInt(hex.substr(2, 2), 16);
+            const b = parseInt(hex.substr(4, 2), 16);
+            const a = parseInt(hex.substr(6, 2), 16);
+            return take(new Color(r, g, b, a));
+        }
+        /**
+         * Creates a new Color instance from color in hsl format
+         *
+         * @param color as a hsl for example `hsl(197.1,100%,43.3%)`
+         * @returns Color object
+         */
+        static fromHsl(hsl) {
+            // TODO: Implement + Add samples here [👠]
+            throw new Error(`Can not create a new Color instance from supposed hsl formatted string "${hsl}".`);
+        }
+        /**
+         * Creates a new Color instance from color in rgb format
+         *
+         * @param color as a rgb for example `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`
+         * @returns Color object
+         */
+        static fromRgbString(rgb) {
+            // TODO: [0] Should be fromRgbString and fromRgbaString one or two functions
+            // TODO: Implement + Add samples here [👠]
+            throw new Error(`Can not create a new Color instance from supposed rgb formatted string "${rgb}".`);
+        }
+        /**
+         * Creates a new Color instance from color in rbga format
+         *
+         * @param color as a rgba for example `rgba(0,158,221,0.5)`, `rgb(0%,62%,86.7%,50%)`
+         * @returns Color object
+         */
+        static fromRgbaString(rgba) {
+            // TODO: [0] Should be fromRgbString and fromRgbaString one or two functions
+            // TODO: Implement + Add samples here [👠]
+            throw new Error(`Can not create a new Color instance from supposed rgba formatted string "${rgba}".`);
+        }
+        /**
+         * Creates a new Color for color channels values
+         *
+         * @param red number from 0 to 255
+         * @param green number from 0 to 255
+         * @param blue number from 0 to 255
+         * @param alpha number from 0 (transparent) to 255 (opaque = default)
+         * @returns Color object
+         */
+        static fromValues(red, green, blue, alpha = 255) {
+            return take(new Color(red, green, blue, alpha));
+        }
+        /**
+         * Checks if the given value is a valid Color object.
+         *
+         * @param {unknown} value - The value to check.
+         * @return {value is WithTake<Color>} Returns true if the value is a valid Color object, false otherwise.
+         */
+        static isColor(value) {
+            if (typeof value !== 'object') {
+                return false;
+            }
+            if (value === null) {
+                return false;
+            }
+            if (typeof value.red !== 'number' ||
+                typeof value.green !== 'number' ||
+                typeof value.blue !== 'number' ||
+                typeof value.alpha !== 'number') {
+                return false;
+            }
+            if (typeof value.then !== 'function') {
+                return false;
+            }
+            return true;
+        }
+        /**
+         * Creates new Color object
+         *
+         * Note: Consider using one of static methods like `from` or `fromString`
+         *
+         * @param red number from 0 to 255
+         * @param green number from 0 to 255
+         * @param blue number from 0 to 255
+         * @param alpha number from 0 (transparent) to 255 (opaque)
+         */
+        constructor(red, green, blue, alpha = 255) {
+            this.red = red;
+            this.green = green;
+            this.blue = blue;
+            this.alpha = alpha;
+            checkChannelValue('Red', red);
+            checkChannelValue('Green', green);
+            checkChannelValue('Blue', blue);
+            checkChannelValue('Alpha', alpha);
+        }
+        /**
+         * Shortcut for `red` property
+         * Number from 0 to 255
+         * @alias red
+         */
+        get r() {
+            return this.red;
+        }
+        /**
+         * Shortcut for `green` property
+         * Number from 0 to 255
+         * @alias green
+         */
+        get g() {
+            return this.green;
+        }
+        /**
+         * Shortcut for `blue` property
+         * Number from 0 to 255
+         * @alias blue
+         */
+        get b() {
+            return this.blue;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get a() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for `alpha` property
+         * Number from 0 (transparent) to 255 (opaque)
+         * @alias alpha
+         */
+        get opacity() {
+            return this.alpha;
+        }
+        /**
+         * Shortcut for 1-`alpha` property
+         */
+        get transparency() {
+            return 255 - this.alpha;
+        }
+        clone() {
+            return take(new Color(this.red, this.green, this.blue, this.alpha));
+        }
+        toString() {
+            return this.toHex();
+        }
+        toHex() {
+            if (this.alpha === 255) {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}`;
+            }
+            else {
+                return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+                .toString(16)
+                .padStart(2, '0')}${this.alpha.toString(16).padStart(2, '0')}`;
+            }
+        }
+        toRgb() {
+            if (this.alpha === 255) {
+                return `rgb(${this.red}, ${this.green}, ${this.blue})`;
+            }
+            else {
+                return `rgba(${this.red}, ${this.green}, ${this.blue}, ${Math.round((this.alpha / 255) * 100)}%)`;
+            }
+        }
+        toHsl() {
+            throw new Error(`Getting HSL is not implemented`);
+        }
+    }
+    /**
+     * TODO: For each method a corresponding static method should be created
+     *       Like clone can be done by color.clone() OR Color.clone(color)
+     * TODO: Probably as an independent LIB OR add to LIB xyzt (ask @roseckyj)
+     * TODO: !! Transfer back to Collboard (whole directory)
+     * TODO: Maybe [🏌️‍♂️] change ACRY toString => (toHex) toRgb when there will be toRgb and toRgba united
+     * TODO: Convert getters to methods - getters only for values
+     * TODO: Write tests
+     * TODO: Getters for alpha, opacity, transparency, r, b, g, h, s, l, a,...
+     * TODO: [0] Should be fromRgbString and fromRgbaString one or two functions + one or two regex
+     * TODO: Use rgb, rgba, hsl for testing and parsing with the same regex
+     * TODO: Regex for rgb, rgba, hsl does not support all options like deg, rad, turn,...
+     * TODO: Convolution matrix
+     * TODO: Maybe connect with textures
+     */
+
+    /**
+     * Creates a random color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function $randomColor() {
+        return Color.fromHex(Math.floor(Math.random( /* <- TODO: [🐉] Probbably use seed random */) * 16777215)
+            .toString(16)
+            .padStart(6, '0'));
+    }
+    /**
+     * TODO: !! Use Internally Color.fromValues
+     * TODO: !! randomColorWithAlpha
+     */
+
+    /**
+     * Converts HSL values to RGB values
+     *
+     * @param hue [0-1]
+     * @param saturation [0-1]
+     * @param lightness [0-1]
+     * @returns [red, green, blue] [0-255]
+     *
+     * @private util of `@promptbook/color`
+     */
+    function hslToRgb(hue, saturation, lightness) {
+        let red;
+        let green;
+        let blue;
+        if (saturation === 0) {
+            // achromatic
+            red = lightness;
+            green = lightness;
+            blue = lightness;
+        }
+        else {
+            // TODO: Extract to separate function
+            const hue2rgb = (p, q, t) => {
+                if (t < 0)
+                    t += 1;
+                if (t > 1)
+                    t -= 1;
+                if (t < 1 / 6)
+                    return p + (q - p) * 6 * t;
+                if (t < 1 / 2)
+                    return q;
+                if (t < 2 / 3)
+                    return p + (q - p) * (2 / 3 - t) * 6;
+                return p;
+            };
+            const q = lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation;
+            const p = 2 * lightness - q;
+            red = hue2rgb(p, q, hue + 1 / 3);
+            green = hue2rgb(p, q, hue);
+            blue = hue2rgb(p, q, hue - 1 / 3);
+        }
+        return [Math.round(red * 255), Math.round(green * 255), Math.round(blue * 255)];
+    }
+    /**
+     * TODO: Properly name all used internal variables
+     */
+
+    /**
+     * Converts RGB values to HSL values
+     *
+     * @param red [0-255]
+     * @param green [0-255]
+     * @param blue [0-255]
+     * @returns [hue, saturation, lightness] [0-1]
+     *
+     * @private util of `@promptbook/color`
+     */
+    function rgbToHsl(red, green, blue) {
+        red /= 255;
+        green /= 255;
+        blue /= 255;
+        const max = Math.max(red, green, blue);
+        const min = Math.min(red, green, blue);
+        let hue;
+        let saturation;
+        const lightness = (max + min) / 2;
+        if (max === min) {
+            // achromatic
+            hue = 0;
+            saturation = 0;
+        }
+        else {
+            const d = max - min;
+            saturation = lightness > 0.5 ? d / (2 - max - min) : d / (max + min);
+            switch (max) {
+                case red:
+                    hue = (green - blue) / d + (green < blue ? 6 : 0);
+                    break;
+                case green:
+                    hue = (blue - red) / d + 2;
+                    break;
+                case blue:
+                    hue = (red - green) / d + 4;
+                    break;
+                default:
+                    hue = 0;
+            }
+            hue /= 6;
+        }
+        return [hue, saturation, lightness];
+    }
+    /**
+     * TODO: Properly name all used internal variables
+     */
+
+    /**
+     * Makes color transformer which lighten the given color
+     *
+     * @param amount from 0 to 1
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function lighten(amount) {
+        return ({ red, green, blue, alpha }) => {
+            const [h, s, lInitial] = rgbToHsl(red, green, blue);
+            let l = lInitial + amount;
+            l = Math.max(0, Math.min(l, 1)); // Replace lodash clamp with Math.max and Math.min
+            const [r, g, b] = hslToRgb(h, s, l);
+            return Color.fromValues(r, g, b, alpha);
+        };
+    }
+    /**
+     * TODO: Maybe implement by mix+hsl
+     */
+
+    /**
+     * Makes color transformer which darker the given color
+     *
+     * @param amount from 0 to 1
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function darken(amount) {
+        return lighten(-amount);
+    }
+
+    /**
+     * Calculates distance between two colors
+     *
+     * @param color1 first color
+     * @param color2 second color
+     *
+     * Note: This function is inefficient. Use colorDistanceSquared instead if possible.
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorDistance(color1, color2) {
+        const rmean = (color1.red + color2.red) / 2;
+        const r = color1.red - color2.red;
+        const g = color1.green - color2.green;
+        const b = color1.blue - color2.blue;
+        const weightR = 2 + rmean / 256;
+        const weightG = 4.0;
+        const weightB = 2 + (255 - rmean) / 256;
+        const distance = Math.sqrt(weightR * r * r + weightG * g * g + weightB * b * b);
+        return distance;
+    }
+    /**
+     * Calculates distance between two colors without square root
+     *
+     * @param color1 first color
+     * @param color2 second color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorDistanceSquared(color1, color2) {
+        const rmean = (color1.red + color2.red) / 2;
+        const r = color1.red - color2.red;
+        const g = color1.green - color2.green;
+        const b = color1.blue - color2.blue;
+        const weightR = 2 + rmean / 256;
+        const weightG = 4.0;
+        const weightB = 2 + (255 - rmean) / 256;
+        const distance = weightR * r * r + weightG * g * g + weightB * b * b;
+        return distance;
+    }
+
+    /**
+     * Makes color transformer which finds the nearest color from the given list
+     *
+     * @param colors array of colors to choose from
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function nearest(...colors) {
+        return (color) => {
+            const distances = colors.map((c) => colorDistanceSquared(c, color));
+            const minDistance = Math.min(...distances);
+            const minIndex = distances.indexOf(minDistance);
+            const nearestColor = colors[minIndex];
+            return nearestColor;
+        };
+    }
+
+    /**
+     * Color transformer which returns the negative color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function negative(color) {
+        const r = 255 - color.red;
+        const g = 255 - color.green;
+        const b = 255 - color.blue;
+        return Color.fromValues(r, g, b, color.alpha);
+    }
+
+    /**
+     * Makes color transformer which finds the furthest color from the given list
+     *
+     * @param colors array of colors to choose from
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function furthest(...colors) {
+        return (color) => {
+            const furthestColor = negative(nearest(...colors.map(negative))(color));
+            return furthestColor;
+        };
+    }
+    /**
+     * Makes color transformer which finds the best text color (black or white) for the given background color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    const textColor = furthest(Color.get('white'), Color.from('black'));
+
+    /**
+     * Makes color transformer which returns a grayscale version of the color
+     *
+     * @param amount from 0 to 1
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function grayscale(amount) {
+        return ({ red, green, blue, alpha }) => {
+            const average = (red + green + blue) / 3;
+            red = Math.round(average * amount + red * (1 - amount));
+            green = Math.round(average * amount + green * (1 - amount));
+            blue = Math.round(average * amount + blue * (1 - amount));
+            return Color.fromValues(red, green, blue, alpha);
+        };
+    }
+
+    /**
+     * Makes color transformer which returns a mix of two colors based on a ratio
+     *
+     * @param ratio the ratio of the first color to the second color, from 0 to 1
+     * @param additionalColor the second color to mix with the first color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function mixWithColor(ratio, additionalColor) {
+        return (baseColor) => {
+            const r = Math.round(baseColor.red * (1 - ratio) + additionalColor.red * ratio);
+            const g = Math.round(baseColor.green * (1 - ratio) + additionalColor.green * ratio);
+            const b = Math.round(baseColor.blue * (1 - ratio) + additionalColor.blue * ratio);
+            const a = baseColor.alpha;
+            return Color.fromValues(r, g, b, a);
+        };
+    }
+
+    /**
+     * Color transformer which returns the negative color but preserves hue and saturation
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function negativeLightness(color) {
+        const { red, green, blue, alpha } = color;
+        // eslint-disable-next-line prefer-const
+        let [h, s, l] = rgbToHsl(red, green, blue);
+        l = 1 - l;
+        const [r, g, b] = hslToRgb(h, s, l);
+        return Color.fromValues(r, g, b, alpha);
+    }
+
+    /**
+     * Makes color transformer which sets alpha channel to given color
+     *
+     * @param alpha number from 0 (transparent) to 1 (opaque)
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function withAlpha(alpha) {
+        return ({ red, green, blue }) => {
+            return Color.fromValues(red, green, blue, Math.round(alpha * 255));
+        };
+    }
+
+    /**
+     * Compares two colors to determine if they are equal based on their RGB values.
+     *
+     * @param color1 - The first color to compare.
+     * @param color2 - The second color to compare.
+     * @returns {boolean} True if the colors are equal, false otherwise.
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function areColorsEqual(color1, color2) {
+        return color1.red === color2.red && color1.green === color2.green && color1.blue === color2.blue;
+    }
+    /**
+     * TODO: [🥎] Implement for N colors
+     */
+
+    /**
+     * Calculates hue of the color
+     *
+     * @returns hue in degrees <0-360)
+     *
+     * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Hue_and_chroma
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorHue(color) {
+        const { r, g, b } = color;
+        const max = Math.max(r, g, b);
+        const min = Math.min(r, g, b);
+        const delta = max - min;
+        let hue = 0;
+        if (delta !== 0) {
+            if (max === r) {
+                hue = ((g - b) / delta) % 6;
+            }
+            else if (max === g) {
+                hue = (b - r) / delta + 2;
+            }
+            else {
+                hue = (r - g) / delta + 4;
+            }
+            hue *= 60;
+            if (hue < 0) {
+                hue += 360;
+            }
+        }
+        return hue;
+    }
+
+    /**
+     * Calculates hue distance of two colors
+     *
+     * @returns hue distance in degrees <0-180)
+     *
+     * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Hue_and_chroma
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorHueDistance(color1, color2) {
+        const hue1 = colorHue(color1);
+        const hue2 = colorHue(color2);
+        const delta = Math.abs(hue1 - hue2);
+        const distance = delta > 180 ? 360 - delta : delta;
+        return distance;
+    }
+
+    /**
+     * Calculates luminance of the color
+     *
+     * @see https://en.wikipedia.org/wiki/Relative_luminance
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorLuminance(color) {
+        const { r, g, b } = color;
+        return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+    }
+
+    /**
+     * Calculates saturation of the color
+     *
+     * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Saturation
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorSaturation(color) {
+        const { r, g, b } = color;
+        const max = Math.max(r, g, b);
+        const min = Math.min(r, g, b);
+        const delta = max - min;
+        if (max === 0) {
+            return 0;
+        }
+        else {
+            return delta / max;
+        }
+    }
+
+    /**
+     * Calculates saturation*luminance of the color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorSatulightion(color) {
+        // TODO: !! There is some flaw in rgbToHsl because [1] not work but [2] works - light vs luminance?
+        //[1]> const [hue, saturation, light] = rgbToHsl(color.red, color.green, color.blue);
+        //[1]> return saturation * light;
+        //[2]:
+        return colorSaturation(color) * colorLuminance(color);
+    }
+
+    /**
+     * Makes data url from color
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function colorToDataUrl(color) {
+        return rgbDataURL(color.red, color.green, color.blue);
+    }
+    /**
+     * Pixel GIF code adapted from https://stackoverflow.com/a/33919020/266535
+     *
+     * @private util of `colorToDataUrl`
+     */
+    const keyStr = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+    /**
+     * Generates a base64-encoded triplet string
+     *
+     * @param e1 - The first element in the triplet.
+     * @param e2 - The second element in the triplet.
+     * @param e3 - The third element in the triplet.
+     * @returns The base64-encoded triplet string.
+     *
+     * @private util of `colorToDataUrl`
+     */
+    const triplet = (e1, e2, e3) => keyStr.charAt(e1 >> 2) +
+        keyStr.charAt(((e1 & 3) << 4) | (e2 >> 4)) +
+        keyStr.charAt(((e2 & 15) << 2) | (e3 >> 6)) +
+        keyStr.charAt(e3 & 63);
+    /**
+     * Converts RGB values to a data URL string
+     *
+     * @param r - The red channel value.
+     * @param g - The green channel value.
+     * @param b - The blue channel value.
+     * @returns The RGB data URL string.
+     *
+     * @private util of `@promptbook/color`
+     */
+    const rgbDataURL = (r, g, b) => `data:image/gif;base64,R0lGODlhAQABAPAA${triplet(0, r, g) + triplet(b, 255, 255)}/yH5BAAAAAAALAAAAAABAAEAAAICRAEAOw==`;
+    /**
+     * TODO: Make as functions NOT const
+     */
+
+    /**
+     * Mixes an array of colors and returns the average color
+     *
+     * @param {...Color} colors - The array of colors to be mixed.
+     * @returns {WithTake<Color>} - The mixed color.
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function mixColors(...colors) {
+        const red = colors.reduce((sum, color) => sum + color.red, 0) / colors.length;
+        const green = colors.reduce((sum, color) => sum + color.green, 0) / colors.length;
+        const blue = colors.reduce((sum, color) => sum + color.blue, 0) / colors.length;
+        const alpha = colors.reduce((sum, color) => sum + color.alpha, 0) / colors.length;
+        return Color.fromValues(red, green, blue, alpha);
+    }
+
+    exports.$randomColor = $randomColor;
+    exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
+    exports.CSS_COLORS = CSS_COLORS;
+    exports.Color = Color;
+    exports.PROMPTBOOK_ENGINE_VERSION = PROMPTBOOK_ENGINE_VERSION;
+    exports.areColorsEqual = areColorsEqual;
+    exports.colorDistance = colorDistance;
+    exports.colorDistanceSquared = colorDistanceSquared;
+    exports.colorHue = colorHue;
+    exports.colorHueDistance = colorHueDistance;
+    exports.colorLuminance = colorLuminance;
+    exports.colorSatulightion = colorSatulightion;
+    exports.colorSaturation = colorSaturation;
+    exports.colorToDataUrl = colorToDataUrl;
+    exports.darken = darken;
+    exports.furthest = furthest;
+    exports.grayscale = grayscale;
+    exports.lighten = lighten;
+    exports.mixColors = mixColors;
+    exports.mixWithColor = mixWithColor;
+    exports.nearest = nearest;
+    exports.negative = negative;
+    exports.negativeLightness = negativeLightness;
+    exports.textColor = textColor;
+    exports.withAlpha = withAlpha;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=index.umd.js.map