@zag-js/color-utils 1.34.1 → 1.35.0

package/dist/color.js

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/color.ts
+var color_exports = {};
+__export(color_exports, {
+  Color: () => Color
+});
+module.exports = __toCommonJS(color_exports);
+var import_utils = require("@zag-js/utils");
+var isEqualObject = (a, b) => {
+  if (Object.keys(a).length !== Object.keys(b).length) return false;
+  for (let key in a) if (a[key] !== b[key]) return false;
+  return true;
+};
+var Color = class {
+  toHexInt() {
+    return this.toFormat("rgba").toHexInt();
+  }
+  getChannelValue(channel) {
+    if (channel in this) return this[channel];
+    throw new Error("Unsupported color channel: " + channel);
+  }
+  getChannelValuePercent(channel, valueToCheck) {
+    const value = valueToCheck ?? this.getChannelValue(channel);
+    const { minValue, maxValue } = this.getChannelRange(channel);
+    return (0, import_utils.getValuePercent)(value, minValue, maxValue);
+  }
+  getChannelPercentValue(channel, percentToCheck) {
+    const { minValue, maxValue, step } = this.getChannelRange(channel);
+    const percentValue = (0, import_utils.getPercentValue)(percentToCheck, minValue, maxValue, step);
+    return (0, import_utils.snapValueToStep)(percentValue, minValue, maxValue, step);
+  }
+  withChannelValue(channel, value) {
+    const { minValue, maxValue } = this.getChannelRange(channel);
+    if (channel in this) {
+      let clone = this.clone();
+      clone[channel] = (0, import_utils.clampValue)(value, minValue, maxValue);
+      return clone;
+    }
+    throw new Error("Unsupported color channel: " + channel);
+  }
+  getColorAxes(xyChannels) {
+    let { xChannel, yChannel } = xyChannels;
+    let xCh = xChannel || this.getChannels().find((c) => c !== yChannel);
+    let yCh = yChannel || this.getChannels().find((c) => c !== xCh);
+    let zCh = this.getChannels().find((c) => c !== xCh && c !== yCh);
+    return { xChannel: xCh, yChannel: yCh, zChannel: zCh };
+  }
+  incrementChannel(channel, stepSize) {
+    const { minValue, maxValue, step } = this.getChannelRange(channel);
+    const value = (0, import_utils.snapValueToStep)(
+      (0, import_utils.clampValue)(this.getChannelValue(channel) + stepSize, minValue, maxValue),
+      minValue,
+      maxValue,
+      step
+    );
+    return this.withChannelValue(channel, value);
+  }
+  decrementChannel(channel, stepSize) {
+    return this.incrementChannel(channel, -stepSize);
+  }
+  isEqual(color) {
+    const isSame = isEqualObject(this.toJSON(), color.toJSON());
+    return isSame && this.getChannelValue("alpha") === color.getChannelValue("alpha");
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Color
+});

package/dist/color.mjs

@@ -0,0 +1,64 @@
+import "./chunk-QZ7TP4HQ.mjs";
+
+// src/color.ts
+import { clampValue, getPercentValue, getValuePercent, snapValueToStep } from "@zag-js/utils";
+var isEqualObject = (a, b) => {
+  if (Object.keys(a).length !== Object.keys(b).length) return false;
+  for (let key in a) if (a[key] !== b[key]) return false;
+  return true;
+};
+var Color = class {
+  toHexInt() {
+    return this.toFormat("rgba").toHexInt();
+  }
+  getChannelValue(channel) {
+    if (channel in this) return this[channel];
+    throw new Error("Unsupported color channel: " + channel);
+  }
+  getChannelValuePercent(channel, valueToCheck) {
+    const value = valueToCheck ?? this.getChannelValue(channel);
+    const { minValue, maxValue } = this.getChannelRange(channel);
+    return getValuePercent(value, minValue, maxValue);
+  }
+  getChannelPercentValue(channel, percentToCheck) {
+    const { minValue, maxValue, step } = this.getChannelRange(channel);
+    const percentValue = getPercentValue(percentToCheck, minValue, maxValue, step);
+    return snapValueToStep(percentValue, minValue, maxValue, step);
+  }
+  withChannelValue(channel, value) {
+    const { minValue, maxValue } = this.getChannelRange(channel);
+    if (channel in this) {
+      let clone = this.clone();
+      clone[channel] = clampValue(value, minValue, maxValue);
+      return clone;
+    }
+    throw new Error("Unsupported color channel: " + channel);
+  }
+  getColorAxes(xyChannels) {
+    let { xChannel, yChannel } = xyChannels;
+    let xCh = xChannel || this.getChannels().find((c) => c !== yChannel);
+    let yCh = yChannel || this.getChannels().find((c) => c !== xCh);
+    let zCh = this.getChannels().find((c) => c !== xCh && c !== yCh);
+    return { xChannel: xCh, yChannel: yCh, zChannel: zCh };
+  }
+  incrementChannel(channel, stepSize) {
+    const { minValue, maxValue, step } = this.getChannelRange(channel);
+    const value = snapValueToStep(
+      clampValue(this.getChannelValue(channel) + stepSize, minValue, maxValue),
+      minValue,
+      maxValue,
+      step
+    );
+    return this.withChannelValue(channel, value);
+  }
+  decrementChannel(channel, stepSize) {
+    return this.incrementChannel(channel, -stepSize);
+  }
+  isEqual(color) {
+    const isSame = isEqualObject(this.toJSON(), color.toJSON());
+    return isSame && this.getChannelValue("alpha") === color.getChannelValue("alpha");
+  }
+};
+export {
+  Color
+};

package/dist/hsb-color.d.mts

@@ -0,0 +1,35 @@
+import { Color } from './color.mjs';
+import { ColorStringFormat, ColorFormat, ColorType, ColorChannel, ColorChannelRange } from './types.mjs';
+
+declare class HSBColor extends Color {
+    private hue;
+    private saturation;
+    private brightness;
+    private alpha;
+    constructor(hue: number, saturation: number, brightness: number, alpha: number);
+    static parse(value: string): HSBColor | void;
+    toString(format?: ColorStringFormat): string;
+    toFormat(format: ColorFormat): ColorType;
+    /**
+     * Converts a HSB color to HSL.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_HSL.
+     * @returns An HSLColor object.
+     */
+    private toHSL;
+    /**
+     * Converts a HSV color value to RGB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_RGB_alternative.
+     * @returns An RGBColor object.
+     */
+    private toRGB;
+    clone(): ColorType;
+    getChannelFormatOptions(channel: ColorChannel): Intl.NumberFormatOptions;
+    formatChannelValue(channel: ColorChannel, locale: string): string;
+    getChannelRange(channel: ColorChannel): ColorChannelRange;
+    toJSON(): Record<"h" | "s" | "b" | "a", number>;
+    getFormat(): ColorFormat;
+    private static colorChannels;
+    getChannels(): [ColorChannel, ColorChannel, ColorChannel];
+}
+
+export { HSBColor };

package/dist/hsb-color.d.ts

@@ -0,0 +1,35 @@
+import { Color } from './color.js';
+import { ColorStringFormat, ColorFormat, ColorType, ColorChannel, ColorChannelRange } from './types.js';
+
+declare class HSBColor extends Color {
+    private hue;
+    private saturation;
+    private brightness;
+    private alpha;
+    constructor(hue: number, saturation: number, brightness: number, alpha: number);
+    static parse(value: string): HSBColor | void;
+    toString(format?: ColorStringFormat): string;
+    toFormat(format: ColorFormat): ColorType;
+    /**
+     * Converts a HSB color to HSL.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_HSL.
+     * @returns An HSLColor object.
+     */
+    private toHSL;
+    /**
+     * Converts a HSV color value to RGB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_RGB_alternative.
+     * @returns An RGBColor object.
+     */
+    private toRGB;
+    clone(): ColorType;
+    getChannelFormatOptions(channel: ColorChannel): Intl.NumberFormatOptions;
+    formatChannelValue(channel: ColorChannel, locale: string): string;
+    getChannelRange(channel: ColorChannel): ColorChannelRange;
+    toJSON(): Record<"h" | "s" | "b" | "a", number>;
+    getFormat(): ColorFormat;
+    private static colorChannels;
+    getChannels(): [ColorChannel, ColorChannel, ColorChannel];
+}
+
+export { HSBColor };

package/dist/hsb-color.js

@@ -0,0 +1,165 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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;
+};
+var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: true }), mod2);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/hsb-color.ts
+var hsb_color_exports = {};
+__export(hsb_color_exports, {
+  HSBColor: () => HSBColor
+});
+module.exports = __toCommonJS(hsb_color_exports);
+var import_utils = require("@zag-js/utils");
+var import_color = require("./color.cjs");
+var import_hsl_color = require("./hsl-color.cjs");
+var import_rgb_color = require("./rgb-color.cjs");
+var HSB_REGEX = /hsb\(([-+]?\d+(?:.\d+)?\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d+(?:.\d+)?%)\)|hsba\(([-+]?\d+(?:.\d+)?\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d(.\d+)?)\)/;
+var _HSBColor = class _HSBColor extends import_color.Color {
+  constructor(hue, saturation, brightness, alpha) {
+    super();
+    this.hue = hue;
+    this.saturation = saturation;
+    this.brightness = brightness;
+    this.alpha = alpha;
+  }
+  static parse(value) {
+    let m;
+    if (m = value.match(HSB_REGEX)) {
+      const [h, s, b, a] = (m[1] ?? m[2]).split(",").map((n) => Number(n.trim().replace("%", "")));
+      return new _HSBColor((0, import_utils.mod)(h, 360), (0, import_utils.clampValue)(s, 0, 100), (0, import_utils.clampValue)(b, 0, 100), (0, import_utils.clampValue)(a ?? 1, 0, 1));
+    }
+  }
+  toString(format = "css") {
+    switch (format) {
+      case "css":
+        return this.toHSL().toString("css");
+      case "hex":
+        return this.toRGB().toString("hex");
+      case "hexa":
+        return this.toRGB().toString("hexa");
+      case "hsb":
+        return `hsb(${this.hue}, ${(0, import_utils.toFixedNumber)(this.saturation, 2)}%, ${(0, import_utils.toFixedNumber)(this.brightness, 2)}%)`;
+      case "hsba":
+        return `hsba(${this.hue}, ${(0, import_utils.toFixedNumber)(this.saturation, 2)}%, ${(0, import_utils.toFixedNumber)(this.brightness, 2)}%, ${this.alpha})`;
+      case "hsl":
+        return this.toHSL().toString("hsl");
+      case "rgb":
+        return this.toRGB().toString("rgb");
+      default:
+        return this.toFormat(format).toString(format);
+    }
+  }
+  toFormat(format) {
+    switch (format) {
+      case "hsba":
+        return this;
+      case "hsla":
+        return this.toHSL();
+      case "rgba":
+        return this.toRGB();
+      default:
+        throw new Error("Unsupported color conversion: hsb -> " + format);
+    }
+  }
+  /**
+   * Converts a HSB color to HSL.
+   * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_HSL.
+   * @returns An HSLColor object.
+   */
+  toHSL() {
+    let saturation = this.saturation / 100;
+    let brightness = this.brightness / 100;
+    let lightness = brightness * (1 - saturation / 2);
+    saturation = lightness === 0 || lightness === 1 ? 0 : (brightness - lightness) / Math.min(lightness, 1 - lightness);
+    return new import_hsl_color.HSLColor(
+      (0, import_utils.toFixedNumber)(this.hue, 2),
+      (0, import_utils.toFixedNumber)(saturation * 100, 2),
+      (0, import_utils.toFixedNumber)(lightness * 100, 2),
+      (0, import_utils.toFixedNumber)(this.alpha, 2)
+    );
+  }
+  /**
+   * Converts a HSV color value to RGB.
+   * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_RGB_alternative.
+   * @returns An RGBColor object.
+   */
+  toRGB() {
+    let hue = this.hue;
+    let saturation = this.saturation / 100;
+    let brightness = this.brightness / 100;
+    let fn = (n, k = (n + hue / 60) % 6) => brightness - saturation * brightness * Math.max(Math.min(k, 4 - k, 1), 0);
+    return new import_rgb_color.RGBColor(
+      Math.round(fn(5) * 255),
+      Math.round(fn(3) * 255),
+      Math.round(fn(1) * 255),
+      (0, import_utils.toFixedNumber)(this.alpha, 2)
+    );
+  }
+  clone() {
+    return new _HSBColor(this.hue, this.saturation, this.brightness, this.alpha);
+  }
+  getChannelFormatOptions(channel) {
+    switch (channel) {
+      case "hue":
+        return { style: "unit", unit: "degree", unitDisplay: "narrow" };
+      case "saturation":
+      case "brightness":
+      case "alpha":
+        return { style: "percent" };
+      default:
+        throw new Error("Unknown color channel: " + channel);
+    }
+  }
+  formatChannelValue(channel, locale) {
+    let options = this.getChannelFormatOptions(channel);
+    let value = this.getChannelValue(channel);
+    if (channel === "saturation" || channel === "brightness") {
+      value /= 100;
+    }
+    return new Intl.NumberFormat(locale, options).format(value);
+  }
+  getChannelRange(channel) {
+    switch (channel) {
+      case "hue":
+        return { minValue: 0, maxValue: 360, step: 1, pageSize: 15 };
+      case "saturation":
+      case "brightness":
+        return { minValue: 0, maxValue: 100, step: 1, pageSize: 10 };
+      case "alpha":
+        return { minValue: 0, maxValue: 1, step: 0.01, pageSize: 0.1 };
+      default:
+        throw new Error("Unknown color channel: " + channel);
+    }
+  }
+  toJSON() {
+    return { h: this.hue, s: this.saturation, b: this.brightness, a: this.alpha };
+  }
+  getFormat() {
+    return "hsba";
+  }
+  getChannels() {
+    return _HSBColor.colorChannels;
+  }
+};
+__publicField(_HSBColor, "colorChannels", ["hue", "saturation", "brightness"]);
+var HSBColor = _HSBColor;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HSBColor
+});

package/dist/hsb-color.mjs

@@ -0,0 +1,142 @@
+import {
+  __publicField
+} from "./chunk-QZ7TP4HQ.mjs";
+
+// src/hsb-color.ts
+import { clampValue, mod, toFixedNumber } from "@zag-js/utils";
+import { Color } from "./color.mjs";
+import { HSLColor } from "./hsl-color.mjs";
+import { RGBColor } from "./rgb-color.mjs";
+var HSB_REGEX = /hsb\(([-+]?\d+(?:.\d+)?\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d+(?:.\d+)?%)\)|hsba\(([-+]?\d+(?:.\d+)?\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d+(?:.\d+)?%\s*,\s*[-+]?\d(.\d+)?)\)/;
+var _HSBColor = class _HSBColor extends Color {
+  constructor(hue, saturation, brightness, alpha) {
+    super();
+    this.hue = hue;
+    this.saturation = saturation;
+    this.brightness = brightness;
+    this.alpha = alpha;
+  }
+  static parse(value) {
+    let m;
+    if (m = value.match(HSB_REGEX)) {
+      const [h, s, b, a] = (m[1] ?? m[2]).split(",").map((n) => Number(n.trim().replace("%", "")));
+      return new _HSBColor(mod(h, 360), clampValue(s, 0, 100), clampValue(b, 0, 100), clampValue(a ?? 1, 0, 1));
+    }
+  }
+  toString(format = "css") {
+    switch (format) {
+      case "css":
+        return this.toHSL().toString("css");
+      case "hex":
+        return this.toRGB().toString("hex");
+      case "hexa":
+        return this.toRGB().toString("hexa");
+      case "hsb":
+        return `hsb(${this.hue}, ${toFixedNumber(this.saturation, 2)}%, ${toFixedNumber(this.brightness, 2)}%)`;
+      case "hsba":
+        return `hsba(${this.hue}, ${toFixedNumber(this.saturation, 2)}%, ${toFixedNumber(this.brightness, 2)}%, ${this.alpha})`;
+      case "hsl":
+        return this.toHSL().toString("hsl");
+      case "rgb":
+        return this.toRGB().toString("rgb");
+      default:
+        return this.toFormat(format).toString(format);
+    }
+  }
+  toFormat(format) {
+    switch (format) {
+      case "hsba":
+        return this;
+      case "hsla":
+        return this.toHSL();
+      case "rgba":
+        return this.toRGB();
+      default:
+        throw new Error("Unsupported color conversion: hsb -> " + format);
+    }
+  }
+  /**
+   * Converts a HSB color to HSL.
+   * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_HSL.
+   * @returns An HSLColor object.
+   */
+  toHSL() {
+    let saturation = this.saturation / 100;
+    let brightness = this.brightness / 100;
+    let lightness = brightness * (1 - saturation / 2);
+    saturation = lightness === 0 || lightness === 1 ? 0 : (brightness - lightness) / Math.min(lightness, 1 - lightness);
+    return new HSLColor(
+      toFixedNumber(this.hue, 2),
+      toFixedNumber(saturation * 100, 2),
+      toFixedNumber(lightness * 100, 2),
+      toFixedNumber(this.alpha, 2)
+    );
+  }
+  /**
+   * Converts a HSV color value to RGB.
+   * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSV_to_RGB_alternative.
+   * @returns An RGBColor object.
+   */
+  toRGB() {
+    let hue = this.hue;
+    let saturation = this.saturation / 100;
+    let brightness = this.brightness / 100;
+    let fn = (n, k = (n + hue / 60) % 6) => brightness - saturation * brightness * Math.max(Math.min(k, 4 - k, 1), 0);
+    return new RGBColor(
+      Math.round(fn(5) * 255),
+      Math.round(fn(3) * 255),
+      Math.round(fn(1) * 255),
+      toFixedNumber(this.alpha, 2)
+    );
+  }
+  clone() {
+    return new _HSBColor(this.hue, this.saturation, this.brightness, this.alpha);
+  }
+  getChannelFormatOptions(channel) {
+    switch (channel) {
+      case "hue":
+        return { style: "unit", unit: "degree", unitDisplay: "narrow" };
+      case "saturation":
+      case "brightness":
+      case "alpha":
+        return { style: "percent" };
+      default:
+        throw new Error("Unknown color channel: " + channel);
+    }
+  }
+  formatChannelValue(channel, locale) {
+    let options = this.getChannelFormatOptions(channel);
+    let value = this.getChannelValue(channel);
+    if (channel === "saturation" || channel === "brightness") {
+      value /= 100;
+    }
+    return new Intl.NumberFormat(locale, options).format(value);
+  }
+  getChannelRange(channel) {
+    switch (channel) {
+      case "hue":
+        return { minValue: 0, maxValue: 360, step: 1, pageSize: 15 };
+      case "saturation":
+      case "brightness":
+        return { minValue: 0, maxValue: 100, step: 1, pageSize: 10 };
+      case "alpha":
+        return { minValue: 0, maxValue: 1, step: 0.01, pageSize: 0.1 };
+      default:
+        throw new Error("Unknown color channel: " + channel);
+    }
+  }
+  toJSON() {
+    return { h: this.hue, s: this.saturation, b: this.brightness, a: this.alpha };
+  }
+  getFormat() {
+    return "hsba";
+  }
+  getChannels() {
+    return _HSBColor.colorChannels;
+  }
+};
+__publicField(_HSBColor, "colorChannels", ["hue", "saturation", "brightness"]);
+var HSBColor = _HSBColor;
+export {
+  HSBColor
+};

package/dist/hsl-color.d.mts

@@ -0,0 +1,36 @@
+import { Color } from './color.mjs';
+import { ColorStringFormat, ColorFormat, ColorType, ColorChannel, ColorChannelRange } from './types.mjs';
+
+declare const HSL_REGEX: RegExp;
+declare class HSLColor extends Color {
+    private hue;
+    private saturation;
+    private lightness;
+    private alpha;
+    constructor(hue: number, saturation: number, lightness: number, alpha: number);
+    static parse(value: string): HSLColor | void;
+    toString(format?: ColorStringFormat): string;
+    toFormat(format: ColorFormat): ColorType;
+    /**
+     * Converts a HSL color to HSB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSL_to_HSV.
+     * @returns An HSBColor object.
+     */
+    private toHSB;
+    /**
+     * Converts a HSL color to RGB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSL_to_RGB_alternative.
+     * @returns An RGBColor object.
+     */
+    private toRGB;
+    clone(): ColorType;
+    getChannelFormatOptions(channel: ColorChannel): Intl.NumberFormatOptions;
+    formatChannelValue(channel: ColorChannel, locale: string): string;
+    getChannelRange(channel: ColorChannel): ColorChannelRange;
+    toJSON(): Record<"h" | "s" | "l" | "a", number>;
+    getFormat(): ColorFormat;
+    private static colorChannels;
+    getChannels(): [ColorChannel, ColorChannel, ColorChannel];
+}
+
+export { HSLColor, HSL_REGEX };

package/dist/hsl-color.d.ts

@@ -0,0 +1,36 @@
+import { Color } from './color.js';
+import { ColorStringFormat, ColorFormat, ColorType, ColorChannel, ColorChannelRange } from './types.js';
+
+declare const HSL_REGEX: RegExp;
+declare class HSLColor extends Color {
+    private hue;
+    private saturation;
+    private lightness;
+    private alpha;
+    constructor(hue: number, saturation: number, lightness: number, alpha: number);
+    static parse(value: string): HSLColor | void;
+    toString(format?: ColorStringFormat): string;
+    toFormat(format: ColorFormat): ColorType;
+    /**
+     * Converts a HSL color to HSB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSL_to_HSV.
+     * @returns An HSBColor object.
+     */
+    private toHSB;
+    /**
+     * Converts a HSL color to RGB.
+     * Conversion formula adapted from https://en.wikipedia.org/wiki/HSL_and_HSV#HSL_to_RGB_alternative.
+     * @returns An RGBColor object.
+     */
+    private toRGB;
+    clone(): ColorType;
+    getChannelFormatOptions(channel: ColorChannel): Intl.NumberFormatOptions;
+    formatChannelValue(channel: ColorChannel, locale: string): string;
+    getChannelRange(channel: ColorChannel): ColorChannelRange;
+    toJSON(): Record<"h" | "s" | "l" | "a", number>;
+    getFormat(): ColorFormat;
+    private static colorChannels;
+    getChannels(): [ColorChannel, ColorChannel, ColorChannel];
+}
+
+export { HSLColor, HSL_REGEX };