@dxyl/utils 1.0.0 → 1.1.0

package/types/color/colord/src/colorModels/hslString.d.ts

@@ -0,0 +1,7 @@
+import { RgbaColor } from '../types';
+/**
+ * Parses a valid HSL[A] CSS color function/string
+ * https://www.w3.org/TR/css-color-4/#the-hsl-notation
+ */
+export declare const parseHslaString: (input: string) => RgbaColor | null;
+export declare const rgbaToHslaString: (rgba: RgbaColor) => string;

package/types/color/colord/src/colorModels/hsv.d.ts

@@ -0,0 +1,6 @@
+import { InputObject, RgbaColor, HsvaColor } from '../types';
+export declare const clampHsva: (hsva: HsvaColor) => HsvaColor;
+export declare const roundHsva: (hsva: HsvaColor) => HsvaColor;
+export declare const parseHsva: ({ h, s, v, a }: InputObject) => RgbaColor | null;
+export declare const rgbaToHsva: ({ r, g, b, a }: RgbaColor) => HsvaColor;
+export declare const hsvaToRgba: ({ h, s, v, a }: HsvaColor) => RgbaColor;

package/types/color/colord/src/colorModels/hwb.d.ts

@@ -0,0 +1,6 @@
+import { RgbaColor, HwbaColor, InputObject } from '../types';
+export declare const clampHwba: (hwba: HwbaColor) => HwbaColor;
+export declare const roundHwba: (hwba: HwbaColor) => HwbaColor;
+export declare const rgbaToHwba: (rgba: RgbaColor) => HwbaColor;
+export declare const hwbaToRgba: (hwba: HwbaColor) => RgbaColor;
+export declare const parseHwba: ({ h, w, b, a }: InputObject) => RgbaColor | null;

package/types/color/colord/src/colorModels/hwbString.d.ts

@@ -0,0 +1,7 @@
+import { RgbaColor } from '../types';
+/**
+ * Parses a valid HWB[A] CSS color function/string
+ * https://www.w3.org/TR/css-color-4/#the-hwb-notation
+ */
+export declare const parseHwbaString: (input: string) => RgbaColor | null;
+export declare const rgbaToHwbaString: (rgba: RgbaColor) => string;

package/types/color/colord/src/colorModels/lab.d.ts

@@ -0,0 +1,18 @@
+import { RgbaColor, LabaColor, InputObject } from '../types';
+/**
+ * Clamps LAB axis values as defined in CSS Color Level 4 specs.
+ * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ */
+export declare const clampLaba: (laba: LabaColor) => LabaColor;
+export declare const roundLaba: (laba: LabaColor) => LabaColor;
+export declare const parseLaba: ({ l, a, b, alpha }: InputObject) => RgbaColor | null;
+/**
+ * Performs RGB → CIEXYZ → LAB color conversion
+ * https://www.w3.org/TR/css-color-4/#color-conversion-code
+ */
+export declare const rgbaToLaba: (rgba: RgbaColor) => LabaColor;
+/**
+ * Performs LAB → CIEXYZ → RGB color conversion
+ * https://www.w3.org/TR/css-color-4/#color-conversion-code
+ */
+export declare const labaToRgba: (laba: LabaColor) => RgbaColor;

package/types/color/colord/src/colorModels/lch.d.ts

@@ -0,0 +1,19 @@
+import { RgbaColor, InputObject, LchaColor } from '../types';
+/**
+ * Limits LCH axis values.
+ * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ * https://lea.verou.me/2020/04/lch-colors-in-css-what-why-and-how/#how-does-lch-work
+ */
+export declare const clampLcha: (laba: LchaColor) => LchaColor;
+export declare const roundLcha: (laba: LchaColor) => LchaColor;
+export declare const parseLcha: ({ l, c, h, a }: InputObject) => RgbaColor | null;
+/**
+ * Performs RGB → CIEXYZ → CIELAB → CIELCH color conversion
+ * https://www.w3.org/TR/css-color-4/#color-conversion-code
+ */
+export declare const rgbaToLcha: (rgba: RgbaColor) => LchaColor;
+/**
+ * Performs CIELCH → CIELAB → CIEXYZ → RGB color conversion
+ * https://www.w3.org/TR/css-color-4/#color-conversion-code
+ */
+export declare const lchaToRgba: (lcha: LchaColor) => RgbaColor;

package/types/color/colord/src/colorModels/lchString.d.ts

@@ -0,0 +1,7 @@
+import { RgbaColor } from '../types';
+/**
+ * Parses a valid LCH CSS color function/string
+ * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ */
+export declare const parseLchaString: (input: string) => RgbaColor | null;
+export declare const rgbaToLchaString: (rgba: RgbaColor) => string;

package/types/color/colord/src/colorModels/rgb.d.ts

@@ -0,0 +1,13 @@
+import { InputObject, RgbaColor } from '../types';
+export declare const clampRgba: (rgba: RgbaColor) => RgbaColor;
+export declare const roundRgba: (rgba: RgbaColor) => RgbaColor;
+export declare const parseRgba: ({ r, g, b, a }: InputObject) => RgbaColor | null;
+/**
+ * Converts an RGB channel [0-255] to its linear light (un-companded) form [0-1].
+ * Linearized RGB values are widely used for color space conversions and contrast calculations
+ */
+export declare const linearizeRgbChannel: (value: number) => number;
+/**
+ * Converts an linear-light sRGB channel [0-1] back to its gamma corrected form [0-255]
+ */
+export declare const unlinearizeRgbChannel: (ratio: number) => number;

package/types/color/colord/src/colorModels/rgbString.d.ts

@@ -0,0 +1,7 @@
+import { RgbaColor } from '../types';
+/**
+ * Parses a valid RGB[A] CSS color function/string
+ * https://www.w3.org/TR/css-color-4/#rgb-functions
+ */
+export declare const parseRgbaString: (input: string) => RgbaColor | null;
+export declare const rgbaToRgbaString: (rgba: RgbaColor) => string;

package/types/color/colord/src/colorModels/xyz.d.ts

@@ -0,0 +1,30 @@
+import { InputObject, RgbaColor, XyzColor, XyzaColor } from '../types';
+export declare const D50: {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Limits XYZ axis values assuming XYZ is relative to D50.
+ */
+export declare const clampXyza: (xyza: XyzaColor) => XyzaColor;
+export declare const roundXyza: (xyza: XyzaColor) => XyzaColor;
+export declare const parseXyza: ({ x, y, z, a }: InputObject) => RgbaColor | null;
+/**
+ * Performs Bradford chromatic adaptation from D65 to D50
+ */
+export declare const adaptXyzaToD50: (xyza: XyzaColor) => XyzaColor;
+/**
+ * Performs Bradford chromatic adaptation from D50 to D65
+ */
+export declare const adaptXyzToD65: (xyza: XyzColor) => XyzColor;
+/**
+ * Converts an CIE XYZ color (D50) to RGBA color space (D65)
+ * https://www.w3.org/TR/css-color-4/#color-conversion-code
+ */
+export declare const xyzaToRgba: (sourceXyza: XyzaColor) => RgbaColor;
+/**
+ * Converts an RGB color (D65) to CIE XYZ (D50)
+ * https://image-engineering.de/library/technotes/958-how-to-convert-between-srgb-and-ciexyz
+ */
+export declare const rgbaToXyza: (rgba: RgbaColor) => XyzaColor;

package/types/color/colord/src/colord.d.ts

@@ -0,0 +1,103 @@
+import { AnyColor, RgbaColor, HslaColor, HsvaColor } from './types';
+export declare class Colord {
+    private readonly parsed;
+    readonly rgba: RgbaColor;
+    constructor(input: AnyColor);
+    /**
+     * Returns a boolean indicating whether or not an input has been parsed successfully.
+     * Note: If parsing is unsuccessful, Colord defaults to black (does not throws an error).
+     */
+    isValid(): boolean;
+    /**
+     * Returns the brightness of a color (from 0 to 1).
+     * The calculation logic is modified from WCAG.
+     * https://www.w3.org/TR/AERT/#color-contrast
+     */
+    brightness(): number;
+    /**
+     * Same as calling `brightness() < 0.5`.
+     */
+    isDark(): boolean;
+    /**
+     * Same as calling `brightness() >= 0.5`.
+     * */
+    isLight(): boolean;
+    /**
+     * Returns the hexadecimal representation of a color.
+     * When the alpha channel value of the color is less than 1,
+     * it outputs #rrggbbaa format instead of #rrggbb.
+     */
+    toHex(): string;
+    /**
+     * Converts a color to RGB color space and returns an object.
+     * Always includes an alpha value from 0 to 1.
+     */
+    toRgb(): RgbaColor;
+    /**
+     * Converts a color to RGB color space and returns a string representation.
+     * Outputs an alpha value only if it is less than 1.
+     */
+    toRgbString(): string;
+    /**
+     * Converts a color to HSL color space and returns an object.
+     * Always includes an alpha value from 0 to 1.
+     */
+    toHsl(): HslaColor;
+    /**
+     * Converts a color to HSL color space and returns a string representation.
+     * Always includes an alpha value from 0 to 1.
+     */
+    toHslString(): string;
+    /**
+     * Converts a color to HSV color space and returns an object.
+     * Always includes an alpha value from 0 to 1.
+     */
+    toHsv(): HsvaColor;
+    /**
+     * Creates a new instance containing an inverted (opposite) version of the color.
+     */
+    invert(): Colord;
+    /**
+     * Increases the HSL saturation of a color by the given amount.
+     */
+    saturate(amount?: number): Colord;
+    /**
+     * Decreases the HSL saturation of a color by the given amount.
+     */
+    desaturate(amount?: number): Colord;
+    /**
+     * Makes a gray color with the same lightness as a source color.
+     */
+    grayscale(): Colord;
+    /**
+     * Increases the HSL lightness of a color by the given amount.
+     */
+    lighten(amount?: number): Colord;
+    /**
+     * Increases the HSL lightness of a color by the given amount.
+     */
+    darken(amount?: number): Colord;
+    /**
+     * Changes the HSL hue of a color by the given amount.
+     */
+    rotate(amount?: number): Colord;
+    /**
+     * Allows to get or change an alpha channel value.
+     */
+    alpha(): number;
+    alpha(value: number): Colord;
+    /**
+     * Allows to get or change a hue value.
+     */
+    hue(): number;
+    hue(value: number): Colord;
+    /**
+     * Determines whether two values are the same color.
+     */
+    isEqual(color: AnyColor | Colord): boolean;
+}
+/**
+ * Parses the given input color and creates a new `Colord` instance.
+ * See accepted input formats: https://github.com/omgovich/colord#color-parsing
+ */
+export declare const colord: (input: AnyColor | Colord) => Colord;

package/types/color/colord/src/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * We used to work with 2 digits after the decimal point, but it wasn't accurate enough,
+ * so the library produced colors that were perceived differently.
+ */
+export declare const ALPHA_PRECISION = 3;
+/**
+ * Valid CSS <angle> units.
+ * https://developer.mozilla.org/en-US/docs/Web/CSS/angle
+ */
+export declare const ANGLE_UNITS: Record<string, number>;

package/types/color/colord/src/extend.d.ts

@@ -0,0 +1,4 @@
+import { Colord } from './colord';
+import { Parsers } from './types';
+export type Plugin = (ColordClass: typeof Colord, parsers: Parsers) => void;
+export declare const extend: (plugins: Plugin[]) => void;

package/types/color/colord/src/get/getBrightness.d.ts

@@ -0,0 +1,7 @@
+import { RgbaColor } from '../types';
+/**
+ * Returns the brightness of a color [0-1].
+ * https://www.w3.org/TR/AERT/#color-contrast
+ * https://en.wikipedia.org/wiki/YIQ
+ */
+export declare const getBrightness: (rgba: RgbaColor) => number;

package/types/color/colord/src/get/getContrast.d.ts

@@ -0,0 +1,6 @@
+import { RgbaColor } from '../types';
+/**
+ * Returns a contrast ratio for a color pair [1-21].
+ * http://www.w3.org/TR/WCAG20/#contrast-ratiodef
+ */
+export declare const getContrast: (rgb1: RgbaColor, rgb2: RgbaColor) => number;

package/types/color/colord/src/get/getLuminance.d.ts

@@ -0,0 +1,6 @@
+import { RgbaColor } from '../types';
+/**
+ * Returns the perceived luminance of a color [0-1] according to WCAG 2.0.
+ * https://www.w3.org/TR/WCAG20/#relativeluminancedef
+ */
+export declare const getLuminance: (rgba: RgbaColor) => number;

package/types/color/colord/src/get/getPerceivedDifference.d.ts

@@ -0,0 +1,24 @@
+import { LabaColor } from '../types';
+/**
+ * Calculates the perceived color difference according to [Delta E2000](https://en.wikipedia.org/wiki/Color_difference#CIEDE2000).
+ *
+ * ΔE - (Delta E, dE) The measure of change in visual perception of two given colors.
+ *
+ * Delta E is a metric for understanding how the human eye perceives color difference.
+ * The term delta comes from mathematics, meaning change in a variable or function.
+ * The suffix E references the German word Empfindung, which broadly means sensation.
+ *
+ * On a typical scale, the Delta E value will range from 0 to 100.
+ *
+ * | Delta E | Perception                             |
+ * |---------|----------------------------------------|
+ * | <= 1.0  | Not perceptible by human eyes          |
+ * | 1 - 2   | Perceptible through close observation  |
+ * | 2 - 10  | Perceptible at a glance                |
+ * | 11 - 49 | Colors are more similar than opposite  |
+ * | 100     | Colors are exact opposite              |
+ *
+ * [Source](http://www.brucelindbloom.com/index.html?Eqn_DeltaE_CIE2000.html)
+ * [Read about Delta E](https://zschuessler.github.io/DeltaE/learn/#toc-delta-e-2000)
+ */
+export declare function getDeltaE00(color1: LabaColor, color2: LabaColor): number;

package/types/color/colord/src/helpers.d.ts

@@ -0,0 +1,20 @@
+export declare const isPresent: (value: unknown) => boolean;
+export declare const round: (number: number, digits?: number, base?: number) => number;
+export declare const floor: (number: number, digits?: number, base?: number) => number;
+/**
+ * Clamps a value between an upper and lower bound.
+ * We use ternary operators because it makes the minified code
+ * is 2 times shorter then `Math.min(Math.max(a,b),c)`
+ * NaN is clamped to the lower bound
+ */
+export declare const clamp: (number: number, min?: number, max?: number) => number;
+/**
+ * Processes and clamps a degree (angle) value properly.
+ * Any `NaN` or `Infinity` will be converted to `0`.
+ * Examples: -1 => 359, 361 => 1
+ */
+export declare const clampHue: (degrees: number) => number;
+/**
+ * Converts a hue value to degrees from 0 to 360 inclusive.
+ */
+export declare const parseHue: (value: string, unit?: string) => number;

package/types/color/colord/src/index.d.ts

@@ -0,0 +1,5 @@
+export { colord, Colord } from './colord';
+export { extend, Plugin } from './extend';
+export { getFormat } from './parse';
+export { random } from './random';
+export { HslColor, HslaColor, HsvColor, HsvaColor, HwbColor, HwbaColor, LabColor, LabaColor, LchColor, LchaColor, RgbColor, RgbaColor, XyzColor, XyzaColor, AnyColor, } from './types';

package/types/color/colord/src/manipulate/changeAlpha.d.ts

@@ -0,0 +1,2 @@
+import { RgbaColor } from '../types';
+export declare const changeAlpha: (rgba: RgbaColor, a: number) => RgbaColor;

package/types/color/colord/src/manipulate/invert.d.ts

@@ -0,0 +1,2 @@
+import { RgbaColor } from '../types';
+export declare const invert: (rgba: RgbaColor) => RgbaColor;

package/types/color/colord/src/manipulate/lighten.d.ts

@@ -0,0 +1,2 @@
+import { HslaColor, RgbaColor } from '../types';
+export declare const lighten: (rgba: RgbaColor, amount: number) => HslaColor;

package/types/color/colord/src/manipulate/mix.d.ts

@@ -0,0 +1,2 @@
+import { RgbaColor } from '../types';
+export declare const mix: (rgba1: RgbaColor, rgba2: RgbaColor, ratio: number) => RgbaColor;

package/types/color/colord/src/manipulate/saturate.d.ts

@@ -0,0 +1,2 @@
+import { HslaColor, RgbaColor } from '../types';
+export declare const saturate: (rgba: RgbaColor, amount: number) => HslaColor;

package/types/color/colord/src/parse.d.ts

@@ -0,0 +1,8 @@
+import { Parsers, ParseResult, Input, Format } from './types';
+export declare const parsers: Parsers;
+/** Tries to convert an incoming value into RGBA color by going through all color model parsers */
+export declare const parse: (input: Input) => ParseResult | [null, undefined];
+/**
+ * Returns a color model name for the input passed to the function.
+ */
+export declare const getFormat: (input: Input) => Format | undefined;

package/types/color/colord/src/plugins/a11y.d.ts

@@ -0,0 +1,38 @@
+import { AnyColor } from '../types';
+import { Plugin } from '../extend';
+interface ReadabilityOptions {
+    level?: "AA" | "AAA";
+    size?: "normal" | "large";
+}
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Returns the relative luminance of a color,
+         * normalized to 0 for darkest black and 1 for lightest white.
+         * https://www.w3.org/TR/WCAG20/#relativeluminancedef
+         * https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_Colors_and_Luminance
+         */
+        luminance(): number;
+        /**
+         * Calculates a contrast ratio for a color pair.
+         * This luminance difference is expressed as a ratio ranging
+         * from 1 (e.g. white on white) to 21 (e.g., black on a white).
+         * WCAG requires a ratio of at least 4.5 for normal text and 3 for large text.
+         * https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html
+         * https://webaim.org/articles/contrast/
+         */
+        contrast(color2?: AnyColor | Colord): number;
+        /**
+         * Checks that a background and text color pair conforms to WCAG 2.0 requirements.
+         * https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html
+         */
+        isReadable(color2?: AnyColor | Colord, options?: ReadabilityOptions): boolean;
+    }
+}
+/**
+ * A plugin adding accessibility and color contrast utilities.
+ * Follows Web Content Accessibility Guidelines 2.0.
+ * https://www.w3.org/TR/WCAG20/
+ */
+declare const a11yPlugin: Plugin;
+export default a11yPlugin;

package/types/color/colord/src/plugins/cmyk.d.ts

@@ -0,0 +1,24 @@
+import { CmykaColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Converts a color to CMYK color space and returns an object.
+         * https://drafts.csswg.org/css-color/#cmyk-colors
+         * https://lea.verou.me/2009/03/cmyk-colors-in-css-useful-or-useless/
+         */
+        toCmyk(): CmykaColor;
+        /**
+         * Converts a color to CMYK color space and returns a string.
+         * https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/device-cmyk()
+         */
+        toCmykString(): string;
+    }
+}
+/**
+ * A plugin adding support for CMYK color space.
+ * https://lea.verou.me/2009/03/cmyk-colors-in-css-useful-or-useless/
+ * https://en.wikipedia.org/wiki/CMYK_color_model
+ */
+declare const cmykPlugin: Plugin;
+export default cmykPlugin;

package/types/color/colord/src/plugins/harmonies.d.ts

@@ -0,0 +1,16 @@
+import { Plugin } from '../extend';
+export type HarmonyType = "analogous" | "complementary" | "double-split-complementary" | "rectangle" | "split-complementary" | "tetradic" | "triadic";
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Returns an array of harmony colors as `Colord` instances.
+         */
+        harmonies(type?: HarmonyType): Colord[];
+    }
+}
+/**
+ * A plugin adding functionality to generate harmony colors.
+ * https://en.wikipedia.org/wiki/Harmony_(color)
+ */
+declare const harmoniesPlugin: Plugin;
+export default harmoniesPlugin;

package/types/color/colord/src/plugins/hwb.d.ts

@@ -0,0 +1,23 @@
+import { HwbaColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Converts a color to HWB (Hue-Whiteness-Blackness) color space and returns an object.
+         * https://en.wikipedia.org/wiki/HWB_color_model
+         */
+        toHwb(): HwbaColor;
+        /**
+         * Converts a color to HWB (Hue-Whiteness-Blackness) color space and returns a string.
+         * https://www.w3.org/TR/css-color-4/#the-hwb-notation
+         */
+        toHwbString(): string;
+    }
+}
+/**
+ * A plugin adding support for HWB (Hue-Whiteness-Blackness) color model.
+ * https://en.wikipedia.org/wiki/HWB_color_model
+ * https://www.w3.org/TR/css-color-4/#the-hwb-notation
+ */
+declare const hwbPlugin: Plugin;
+export default hwbPlugin;

package/types/color/colord/src/plugins/lab.d.ts

@@ -0,0 +1,23 @@
+import { LabaColor, AnyColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Converts a color to CIELAB color space and returns an object.
+         * The object always includes `alpha` value [0, 1].
+         */
+        toLab(): LabaColor;
+        /**
+         * Calculates the perceived color difference for two colors according to
+         * [Delta E2000](https://en.wikipedia.org/wiki/Color_difference#CIEDE2000).
+         * Returns a value in [0, 1] range.
+         */
+        delta(color?: AnyColor | Colord): number;
+    }
+}
+/**
+ * A plugin adding support for CIELAB color space.
+ * https://en.wikipedia.org/wiki/CIELAB_color_space
+ */
+declare const labPlugin: Plugin;
+export default labPlugin;

package/types/color/colord/src/plugins/lch.d.ts

@@ -0,0 +1,24 @@
+import { LchaColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Converts a color to CIELCH (Lightness-Chroma-Hue) color space and returns an object.
+         * https://lea.verou.me/2020/04/lch-colors-in-css-what-why-and-how/
+         * https://en.wikipedia.org/wiki/CIELAB_color_space#Cylindrical_model
+         */
+        toLch(): LchaColor;
+        /**
+         * Converts a color to CIELCH (Lightness-Chroma-Hue) color space and returns a string.
+         * https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/lch()
+         */
+        toLchString(): string;
+    }
+}
+/**
+ * A plugin adding support for CIELCH color space.
+ * https://lea.verou.me/2020/04/lch-colors-in-css-what-why-and-how/
+ * https://en.wikipedia.org/wiki/CIELAB_color_space#Cylindrical_model
+ */
+declare const lchPlugin: Plugin;
+export default lchPlugin;

package/types/color/colord/src/plugins/minify.d.ts

@@ -0,0 +1,20 @@
+import { Plugin } from '../extend';
+interface MinificationOptions {
+    hex?: boolean;
+    alphaHex?: boolean;
+    rgb?: boolean;
+    hsl?: boolean;
+    name?: boolean;
+    transparent?: boolean;
+}
+declare module "../colord" {
+    interface Colord {
+        /** Returns the shortest string representation of the color */
+        minify(options?: MinificationOptions): string;
+    }
+}
+/**
+ * A plugin adding a color minification utilities.
+ */
+declare const minifyPlugin: Plugin;
+export default minifyPlugin;

package/types/color/colord/src/plugins/mix.d.ts

@@ -0,0 +1,27 @@
+import { AnyColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        /**
+         * Produces a mixture of two colors through CIE LAB color space and returns a new Colord instance.
+         */
+        mix(color2: AnyColor | Colord, ratio?: number): Colord;
+        /**
+         * Generates a tints palette based on original color.
+         */
+        tints(count?: number): Colord[];
+        /**
+         * Generates a shades palette based on original color.
+         */
+        shades(count?: number): Colord[];
+        /**
+         * Generates a tones palette based on original color.
+         */
+        tones(count?: number): Colord[];
+    }
+}
+/**
+ * A plugin adding a color mixing utilities.
+ */
+declare const mixPlugin: Plugin;
+export default mixPlugin;

package/types/color/colord/src/plugins/names.d.ts

@@ -0,0 +1,19 @@
+import { Plugin } from '../extend';
+interface ConvertOptions {
+    closest?: boolean;
+}
+declare module "../colord" {
+    interface Colord {
+        /** Finds CSS color keyword that matches with the color value */
+        toName(options?: ConvertOptions): string | undefined;
+    }
+}
+/**
+ * Plugin to work with named colors.
+ * Adds a parser to read CSS color names and `toName` method.
+ * See https://www.w3.org/TR/css-color-4/#named-colors
+ * Supports 'transparent' string as defined in
+ * https://drafts.csswg.org/css-color/#transparent-color
+ */
+declare const namesPlugin: Plugin;
+export default namesPlugin;

package/types/color/colord/src/plugins/xyz.d.ts

@@ -0,0 +1,14 @@
+import { XyzaColor } from '../types';
+import { Plugin } from '../extend';
+declare module "../colord" {
+    interface Colord {
+        toXyz(): XyzaColor;
+    }
+}
+/**
+ * A plugin adding support for CIE XYZ colorspace.
+ * Wikipedia: https://en.wikipedia.org/wiki/CIE_1931_color_space
+ * Helpful article: https://www.sttmedia.com/colormodel-xyz
+ */
+declare const xyzPlugin: Plugin;
+export default xyzPlugin;

package/types/color/colord/src/random.d.ts

@@ -0,0 +1,2 @@
+import { Colord } from './colord';
+export declare const random: () => Colord;