@hairy/palette 1.46.0 → 1.49.0

package/LICENSE.md

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-PRESENT Hairyf <https://github.com/antfu>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025-PRESENT Hairyf <https://github.com/antfu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,36 +1,36 @@
-# @hairy/palette
-
-[![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![bundle][bundle-src]][bundle-href]
-[![JSDocs][jsdocs-src]][jsdocs-href]
-[![License][license-src]][license-href]
-
-## Install
-
-```
-ni @hairy/palette
-```
-
-## CDN
-
-```html
-<script src="https://unpkg.com/@hairy/palette"></script>
-```
-
-## License
-
-[MIT](./LICENSE) License © [Hairyf](https://github.com/hairyf)
-
-<!-- Badges -->
-
-[npm-version-src]: https://img.shields.io/npm/v/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669
-[npm-version-href]: https://npmjs.com/package/@hairy/palette
-[npm-downloads-src]: https://img.shields.io/npm/dm/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669
-[npm-downloads-href]: https://npmjs.com/package/@hairy/palette
-[bundle-src]: https://img.shields.io/bundlephobia/minzip/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669&label=minzip
-[bundle-href]: https://bundlephobia.com/result?p=@hairy/palette
-[license-src]: https://img.shields.io/github/license/hairyf/hairylib.svg?style=flat&colorA=080f12&colorB=1fa669
-[license-href]: https://github.com/hairyf/hairylib/blob/main/LICENSE
-[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
-[jsdocs-href]: https://www.jsdocs.io/package/@hairy/palette
+# @hairy/palette
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![bundle][bundle-src]][bundle-href]
+[![JSDocs][jsdocs-src]][jsdocs-href]
+[![License][license-src]][license-href]
+
+## Install
+
+```
+ni @hairy/palette
+```
+
+## CDN
+
+```html
+<script src="https://unpkg.com/@hairy/palette"></script>
+```
+
+## License
+
+[MIT](./LICENSE) License © [Hairyf](https://github.com/hairyf)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/@hairy/palette
+[npm-downloads-src]: https://img.shields.io/npm/dm/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/@hairy/palette
+[bundle-src]: https://img.shields.io/bundlephobia/minzip/@hairy/palette?style=flat&colorA=080f12&colorB=1fa669&label=minzip
+[bundle-href]: https://bundlephobia.com/result?p=@hairy/palette
+[license-src]: https://img.shields.io/github/license/hairyf/hairylib.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/hairyf/hairylib/blob/main/LICENSE
+[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
+[jsdocs-href]: https://www.jsdocs.io/package/@hairy/palette

package/dist/index.cjs

@@ -1,152 +1,241 @@
-"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let colord = require("colord");
+let colord_plugins_a11y = require("colord/plugins/a11y");
+colord_plugins_a11y = __toESM(colord_plugins_a11y);
+let colord_plugins_mix = require("colord/plugins/mix");
+colord_plugins_mix = __toESM(colord_plugins_mix);
 
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  blend: () => blend,
-  brightness: () => brightness,
-  changeAlpha: () => changeAlpha,
-  colorPalette: () => colorPalette,
-  hexToRgb: () => hexToRgb,
-  hsvToRgb: () => hsvToRgb,
-  lighten: () => lighten,
-  luminance: () => luminance,
-  rgbToHex: () => rgbToHex,
-  rgbToHsv: () => rgbToHsv,
-  textToRgb: () => textToRgb
-});
-module.exports = __toCommonJS(index_exports);
-var import_colord = require("colord");
-var import_a11y = __toESM(require("colord/plugins/a11y"), 1);
-var import_mix = __toESM(require("colord/plugins/mix"), 1);
-(0, import_colord.extend)([import_a11y.default, import_mix.default]);
+//#region src/index.ts
+(0, colord.extend)([colord_plugins_a11y.default, colord_plugins_mix.default]);
+/**
+* Converts a RGB/A color
+*
+* Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`)
+*
+* to its HEX/A representation as a
+*
+* String (`#RRGGBB<AA>`).
+*
+* If Alpha channel is present in the original object it will be present also in the output.
+*/
 function rgbToHex({ r, g, b, a }) {
-  return (0, import_colord.colord)({ r, g, b, a }).toHex();
+	return (0, colord.colord)({
+		r,
+		g,
+		b,
+		a
+	}).toHex();
 }
+/**
+* Converts a HEX/A color
+*
+* String (`#RRGGBB<AA>`) or a RGB/A color String(`rgb(R, G, B<, A>)`)
+*
+* to its RGB/A representation as an
+*
+* Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`).
+*
+* If Alpha channel is present in the original object it will be present also in the output.
+*/
 function hexToRgb(hex) {
-  return (0, import_colord.colord)(hex).toRgb();
+	return (0, colord.colord)(hex).toRgb();
 }
+/**
+* Converts a HEX/A color
+*
+* String (`#RRGGBB<AA>`)
+*
+* to its RGB/A representation as an
+*
+* Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`) .
+*
+* If Alpha channel is present in the original object it will be present also in the output.
+*/
 function hsvToRgb({ h, s, v, a }) {
-  return (0, import_colord.colord)({ h, s, v, a }).toRgb();
+	return (0, colord.colord)({
+		h,
+		s,
+		v,
+		a
+	}).toRgb();
 }
+/**
+* Converts a RGB/A color
+*
+* Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`)
+*
+* to its HSV/A representation as an
+*
+* Object (`{ h: [0-360], s: [0-100], v: [0-100}, a: [0-1]}`).
+*
+* If Alpha channel is present in the original object it will be present also in the output.
+*/
 function rgbToHsv({ r, g, b, a }) {
-  return (0, import_colord.colord)({ r, b, g, a }).toHsv();
+	return (0, colord.colord)({
+		r,
+		b,
+		g,
+		a
+	}).toHsv();
 }
+/**
+* Converts a HEX/A color
+*
+* String (`#RRGGBB<AA>`) or a RGB/A color String(`rgb(R, G, B<, A>)`)
+*
+* to its RGB/A representation as an
+*
+* Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`).
+*
+* If Alpha channel is present in the original object it will be present also in the output.
+*/
 function textToRgb(str) {
-  return (0, import_colord.colord)(str).toRgb();
+	return (0, colord.colord)(str).toRgb();
 }
+/**
+* Lighten the `color` (if `percent` is positive) or darken it (if `percent` is negative).
+*
+* Accepts a HEX/A String or a RGB/A String as color and a percent (0 to 1 or -1 to 0) of lighten/darken to be applied to the   `color`. Returns a HEX String representation of the calculated `color`.
+*/
 function lighten(color, percent) {
-  return (0, import_colord.colord)(color).lighten(percent).toHex();
+	return (0, colord.colord)(color).lighten(percent).toHex();
 }
+/**
+* Calculates the [relative luminance](https://www.w3.org/TR/WCAG20/#relativeluminancedef) of the `color`.
+*
+* Accepts a HEX/A String, a RGB/A String or a RGB/A Object as `color`. Returns a value between 0 and 1.
+*/
 function luminance(color) {
-  return (0, import_colord.colord)(color).luminance();
+	return (0, colord.colord)(color).luminance();
 }
+/**
+* Calculates the [color contrast](https://www.w3.org/TR/AERT/#color-contrast) of the `color`.
+*
+* Accepts a HEX/A String, a RGB/A String or a RGB/A Object as `color`. Returns a value between 0 and 1.
+*/
 function brightness(color) {
-  return (0, import_colord.colord)(color).brightness();
+	return (0, colord.colord)(color).brightness();
 }
+/**
+* Calculates the [blend](https://www.w3.org/TR/compositing-1/#simplealphacompositing) of two colors.
+*
+* Accepts a HEX/A String or a RGB/A Object as `fgColor`/`bgColor`. If the alpha channel of the `fgColor` is completely opaque, then the result will be the `fgColor`. If the alpha channel of the `bgColor` is completely opaque, then the resulting blended color will also be opaque. Returns the same type as input for fgColor.
+*/
 function blend(fgColor, bgColor) {
-  return (0, import_colord.colord)(fgColor).mix(bgColor);
+	return (0, colord.colord)(fgColor).mix(bgColor);
 }
+/**
+* Change color transparency
+*/
 function changeAlpha(color, alpha) {
-  return (0, import_colord.colord)(color).alpha(alpha).toHex();
+	return (0, colord.colord)(color).alpha(alpha).toHex();
 }
-var hueStep = 2;
-var saturationStep = 16;
-var saturationStep2 = 5;
-var brightnessStep1 = 5;
-var brightnessStep2 = 15;
-var lightColorCount = 5;
-var darkColorCount = 4;
+const hueStep = 2;
+const saturationStep = 16;
+const saturationStep2 = 5;
+const brightnessStep1 = 5;
+const brightnessStep2 = 15;
+const lightColorCount = 5;
+const darkColorCount = 4;
+/**
+* Obtain palette colors based on color (from left to right, from light to dark, with 6 as the main color number)
+* @param color - Color
+* @param index - The corresponding color number of the color palette (6 as the main color number)
+* @description algorithm implementation draws inspiration from ant design palette algorithm https://github.com/ant-design/ant-design/blob/master/components/style/color/colorPalette.less
+*/
 function colorPalette(color, index) {
-  if (typeof color !== "string" && (!color || color.r === void 0))
-    throw new TypeError("Expected a string or a {r, g, b} object as color");
-  const rgb = typeof color === "string" ? textToRgb(color) : color;
-  const oldHsv = (0, import_colord.colord)(rgb).toHsv();
-  if (index === 6)
-    return rgbToHex(rgb);
-  const light = index < 6;
-  const i = light ? lightColorCount + 1 - index : index - lightColorCount - 1;
-  const newHsv = {
-    h: hue(oldHsv, i, light),
-    s: saturation(oldHsv, i, light),
-    v: value(oldHsv, i, light),
-    a: oldHsv.a
-  };
-  return (0, import_colord.colord)(newHsv).toHex();
+	if (typeof color !== "string" && (!color || color.r === void 0)) throw new TypeError("Expected a string or a {r, g, b} object as color");
+	const rgb = typeof color === "string" ? textToRgb(color) : color;
+	const oldHsv = (0, colord.colord)(rgb).toHsv();
+	if (index === 6) return rgbToHex(rgb);
+	const light = index < 6;
+	const i = light ? lightColorCount + 1 - index : index - lightColorCount - 1;
+	return (0, colord.colord)({
+		h: hue(oldHsv, i, light),
+		s: saturation(oldHsv, i, light),
+		v: value(oldHsv, i, light),
+		a: oldHsv.a
+	}).toHex();
 }
+/**
+* Obtain color gradient
+* @param hsv - Color values in HSV format
+* @param i - relative distance to 6
+* @param isLight - Is it a bright color
+*/
 function hue(hsv, i, isLight) {
-  let hue2;
-  if (hsv.h >= 60 && hsv.h <= 240) {
-    hue2 = isLight ? hsv.h - hueStep * i : hsv.h + hueStep * i;
-  } else {
-    hue2 = isLight ? hsv.h + hueStep * i : hsv.h - hueStep * i;
-  }
-  if (hue2 < 0)
-    hue2 += 360;
-  else if (hue2 >= 360)
-    hue2 -= 360;
-  return hue2;
+	let hue;
+	if (hsv.h >= 60 && hsv.h <= 240) hue = isLight ? hsv.h - hueStep * i : hsv.h + hueStep * i;
+	else hue = isLight ? hsv.h + hueStep * i : hsv.h - hueStep * i;
+	if (hue < 0) hue += 360;
+	else if (hue >= 360) hue -= 360;
+	return hue;
 }
+/**
+* Obtain saturation gradient
+* @param hsv - Color values in HSV format
+* @param i - relative distance to 6
+* @param isLight - Is it a bright color
+*/
 function saturation(hsv, i, isLight) {
-  let saturation2;
-  if (isLight)
-    saturation2 = hsv.s - saturationStep * i;
-  else if (i === darkColorCount)
-    saturation2 = hsv.s + saturationStep;
-  else saturation2 = hsv.s + saturationStep2 * i;
-  if (saturation2 > 100)
-    saturation2 = 100;
-  if (isLight && i === lightColorCount && saturation2 > 10)
-    saturation2 = 10;
-  if (saturation2 < 6)
-    saturation2 = 6;
-  return saturation2;
+	let saturation;
+	if (isLight) saturation = hsv.s - saturationStep * i;
+	else if (i === darkColorCount) saturation = hsv.s + saturationStep;
+	else saturation = hsv.s + saturationStep2 * i;
+	if (saturation > 100) saturation = 100;
+	if (isLight && i === lightColorCount && saturation > 10) saturation = 10;
+	if (saturation < 6) saturation = 6;
+	return saturation;
 }
+/**
+* Obtain brightness gradient
+* @param hsv - Color values in HSV format
+* @param i - relative distance to 6
+* @param isLight - Is it a bright color
+*/
 function value(hsv, i, isLight) {
-  let value2;
-  value2 = isLight ? hsv.v + brightnessStep1 * i : hsv.v - brightnessStep2 * i;
-  if (value2 > 100)
-    value2 = 100;
-  return value2;
+	let value;
+	value = isLight ? hsv.v + brightnessStep1 * i : hsv.v - brightnessStep2 * i;
+	if (value > 100) value = 100;
+	return value;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  blend,
-  brightness,
-  changeAlpha,
-  colorPalette,
-  hexToRgb,
-  hsvToRgb,
-  lighten,
-  luminance,
-  rgbToHex,
-  rgbToHsv,
-  textToRgb
-});
+
+//#endregion
+exports.blend = blend;
+exports.brightness = brightness;
+exports.changeAlpha = changeAlpha;
+exports.colorPalette = colorPalette;
+exports.hexToRgb = hexToRgb;
+exports.hsvToRgb = hsvToRgb;
+exports.lighten = lighten;
+exports.luminance = luminance;
+exports.rgbToHex = rgbToHex;
+exports.rgbToHsv = rgbToHsv;
+exports.textToRgb = textToRgb;

package/dist/{index.d.ts → index.d.cts}

@@ -1,9 +1,10 @@
-import * as colord from 'colord';
-import { RgbaColor, HsvaColor, AnyColor } from 'colord';
+import * as colord from "colord";
+import { AnyColor, HsvaColor, RgbaColor } from "colord";
 
+//#region src/index.d.ts
 type RGBA = Record<'r' | 'g' | 'b' | 'a', number>;
 type RGB = Record<'r' | 'g' | 'b', number> & {
-    a?: number;
+  a?: number;
 };
 type HexColor = string;
 type HSVA = Record<'h' | 's' | 'v' | 'a', number>;
@@ -23,7 +24,12 @@ type PALETTE_INDEXES = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
  *
  * If Alpha channel is present in the original object it will be present also in the output.
  */
-declare function rgbToHex({ r, g, b, a }: RgbaColor): HexColor;
+declare function rgbToHex({
+  r,
+  g,
+  b,
+  a
+}: RgbaColor): HexColor;
 /**
  * Converts a HEX/A color
  *
@@ -47,7 +53,12 @@ declare function hexToRgb(hex: HexColor): RgbaColor;
  *
  * If Alpha channel is present in the original object it will be present also in the output.
  */
-declare function hsvToRgb({ h, s, v, a }: HsvaColor): RgbaColor;
+declare function hsvToRgb({
+  h,
+  s,
+  v,
+  a
+}: HsvaColor): RgbaColor;
 /**
  * Converts a RGB/A color
  *
@@ -59,7 +70,12 @@ declare function hsvToRgb({ h, s, v, a }: HsvaColor): RgbaColor;
  *
  * If Alpha channel is present in the original object it will be present also in the output.
  */
-declare function rgbToHsv({ r, g, b, a }: RgbaColor): HsvaColor;
+declare function rgbToHsv({
+  r,
+  g,
+  b,
+  a
+}: RgbaColor): HsvaColor;
 /**
  * Converts a HEX/A color
  *
@@ -107,5 +123,5 @@ declare function changeAlpha(color: COLOR, alpha: number): string;
  * @description algorithm implementation draws inspiration from ant design palette algorithm https://github.com/ant-design/ant-design/blob/master/components/style/color/colorPalette.less
  */
 declare function colorPalette(color: string | RgbaColor, index: PALETTE_INDEXES): string;
-
-export { type COLOR, type HEX_TEXT, type HSVA, type HSVA_TEXT, type HexColor, type PALETTE_INDEXES, type RGB, type RGBA, type RGBA_TEXT, blend, brightness, changeAlpha, colorPalette, hexToRgb, hsvToRgb, lighten, luminance, rgbToHex, rgbToHsv, textToRgb };
+//#endregion
+export { COLOR, HEX_TEXT, HSVA, HSVA_TEXT, HexColor, PALETTE_INDEXES, RGB, RGBA, RGBA_TEXT, blend, brightness, changeAlpha, colorPalette, hexToRgb, hsvToRgb, lighten, luminance, rgbToHex, rgbToHsv, textToRgb };

package/dist/index.d.mts

@@ -0,0 +1,127 @@
+import * as colord$1 from "colord";
+import { AnyColor, HsvaColor, RgbaColor } from "colord";
+
+//#region src/index.d.ts
+type RGBA = Record<'r' | 'g' | 'b' | 'a', number>;
+type RGB = Record<'r' | 'g' | 'b', number> & {
+  a?: number;
+};
+type HexColor = string;
+type HSVA = Record<'h' | 's' | 'v' | 'a', number>;
+type RGBA_TEXT = string;
+type HEX_TEXT = string;
+type HSVA_TEXT = string;
+type COLOR = RGBA_TEXT | HEX_TEXT | HSVA_TEXT;
+type PALETTE_INDEXES = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+/**
+ * Converts a RGB/A color
+ *
+ * Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`)
+ *
+ * to its HEX/A representation as a
+ *
+ * String (`#RRGGBB<AA>`).
+ *
+ * If Alpha channel is present in the original object it will be present also in the output.
+ */
+declare function rgbToHex({
+  r,
+  g,
+  b,
+  a
+}: RgbaColor): HexColor;
+/**
+ * Converts a HEX/A color
+ *
+ * String (`#RRGGBB<AA>`) or a RGB/A color String(`rgb(R, G, B<, A>)`)
+ *
+ * to its RGB/A representation as an
+ *
+ * Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`).
+ *
+ * If Alpha channel is present in the original object it will be present also in the output.
+ */
+declare function hexToRgb(hex: HexColor): RgbaColor;
+/**
+ * Converts a HEX/A color
+ *
+ * String (`#RRGGBB<AA>`)
+ *
+ * to its RGB/A representation as an
+ *
+ * Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`) .
+ *
+ * If Alpha channel is present in the original object it will be present also in the output.
+ */
+declare function hsvToRgb({
+  h,
+  s,
+  v,
+  a
+}: HsvaColor): RgbaColor;
+/**
+ * Converts a RGB/A color
+ *
+ * Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`)
+ *
+ * to its HSV/A representation as an
+ *
+ * Object (`{ h: [0-360], s: [0-100], v: [0-100}, a: [0-1]}`).
+ *
+ * If Alpha channel is present in the original object it will be present also in the output.
+ */
+declare function rgbToHsv({
+  r,
+  g,
+  b,
+  a
+}: RgbaColor): HsvaColor;
+/**
+ * Converts a HEX/A color
+ *
+ * String (`#RRGGBB<AA>`) or a RGB/A color String(`rgb(R, G, B<, A>)`)
+ *
+ * to its RGB/A representation as an
+ *
+ * Object (`{ r: [0-255], g: [0-255], b: [0-255}<, a: [0-100]>}`).
+ *
+ * If Alpha channel is present in the original object it will be present also in the output.
+ */
+declare function textToRgb(str: AnyColor): RgbaColor;
+/**
+ * Lighten the `color` (if `percent` is positive) or darken it (if `percent` is negative).
+ *
+ * Accepts a HEX/A String or a RGB/A String as color and a percent (0 to 1 or -1 to 0) of lighten/darken to be applied to the   `color`. Returns a HEX String representation of the calculated `color`.
+ */
+declare function lighten(color: AnyColor, percent: number): string;
+/**
+ * Calculates the [relative luminance](https://www.w3.org/TR/WCAG20/#relativeluminancedef) of the `color`.
+ *
+ * Accepts a HEX/A String, a RGB/A String or a RGB/A Object as `color`. Returns a value between 0 and 1.
+ */
+declare function luminance(color: AnyColor): number;
+/**
+ * Calculates the [color contrast](https://www.w3.org/TR/AERT/#color-contrast) of the `color`.
+ *
+ * Accepts a HEX/A String, a RGB/A String or a RGB/A Object as `color`. Returns a value between 0 and 1.
+ */
+declare function brightness(color: AnyColor): number;
+/**
+ * Calculates the [blend](https://www.w3.org/TR/compositing-1/#simplealphacompositing) of two colors.
+ *
+ * Accepts a HEX/A String or a RGB/A Object as `fgColor`/`bgColor`. If the alpha channel of the `fgColor` is completely opaque, then the result will be the `fgColor`. If the alpha channel of the `bgColor` is completely opaque, then the resulting blended color will also be opaque. Returns the same type as input for fgColor.
+ */
+declare function blend(fgColor: AnyColor, bgColor: AnyColor): colord$1.Colord;
+/**
+ * Change color transparency
+ */
+declare function changeAlpha(color: COLOR, alpha: number): string;
+/**
+ * Obtain palette colors based on color (from left to right, from light to dark, with 6 as the main color number)
+ * @param color - Color
+ * @param index - The corresponding color number of the color palette (6 as the main color number)
+ * @description algorithm implementation draws inspiration from ant design palette algorithm https://github.com/ant-design/ant-design/blob/master/components/style/color/colorPalette.less
+ */
+declare function colorPalette(color: string | RgbaColor, index: PALETTE_INDEXES): string;
+//#endregion
+export { COLOR, HEX_TEXT, HSVA, HSVA_TEXT, HexColor, PALETTE_INDEXES, RGB, RGBA, RGBA_TEXT, blend, brightness, changeAlpha, colorPalette, hexToRgb, hsvToRgb, lighten, luminance, rgbToHex, rgbToHsv, textToRgb };