@unicom-cloud/utils 0.1.10 → 0.1.12

package/tinycolor/src/format-input.js

@@ -0,0 +1,77 @@
+import { rgbToRgb as S, hsvToRgb as v, hslToRgb as E, cmykToRgb as F, convertHexToDecimal as A, parseIntFromHex as s } from "./conversion.js";
+import { names as R } from "./css-color-names.js";
+import { convertToPercentage as g, boundAlpha as T } from "./util.js";
+function N(t) {
+  let a = { r: 0, g: 0, b: 0 }, e = 1, m = null, b = null, p = null, r = !1, i = !1;
+  return typeof t == "string" && (t = w(t)), typeof t == "object" && (n(t.r) && n(t.g) && n(t.b) ? (a = S(t.r, t.g, t.b), r = !0, i = String(t.r).slice(-1) === "%" ? "prgb" : "rgb") : n(t.h) && n(t.s) && n(t.v) ? (m = g(t.s), b = g(t.v), a = v(t.h, m, b), r = !0, i = "hsv") : n(t.h) && n(t.s) && n(t.l) ? (m = g(t.s), p = g(t.l), a = E(t.h, m, p), r = !0, i = "hsl") : n(t.c) && n(t.m) && n(t.y) && n(t.k) && (a = F(t.c, t.m, t.y, t.k), r = !0, i = "cmyk"), Object.prototype.hasOwnProperty.call(t, "a") && (e = t.a)), e = T(e), {
+    ok: r,
+    format: t.format || i,
+    r: Math.min(255, Math.max(a.r, 0)),
+    g: Math.min(255, Math.max(a.g, 0)),
+    b: Math.min(255, Math.max(a.b, 0)),
+    a: e
+  };
+}
+const y = "[-\\+]?\\d+%?", M = "[-\\+]?\\d*\\.\\d+%?", h = "(?:" + M + ")|(?:" + y + ")", u = "[\\s|\\(]+(" + h + ")[,|\\s]+(" + h + ")[,|\\s]+(" + h + ")\\s*\\)?", x = (
+  // eslint-disable-next-line prettier/prettier
+  "[\\s|\\(]+(" + h + ")[,|\\s]+(" + h + ")[,|\\s]+(" + h + ")[,|\\s]+(" + h + ")\\s*\\)?"
+), f = {
+  CSS_UNIT: new RegExp(h),
+  rgb: new RegExp("rgb" + u),
+  rgba: new RegExp("rgba" + x),
+  hsl: new RegExp("hsl" + u),
+  hsla: new RegExp("hsla" + x),
+  hsv: new RegExp("hsv" + u),
+  hsva: new RegExp("hsva" + x),
+  cmyk: new RegExp("cmyk" + x),
+  hex3: /^#?([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})$/,
+  hex6: /^#?([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/,
+  hex4: /^#?([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})$/,
+  hex8: /^#?([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/
+};
+function w(t) {
+  if (t = t.trim().toLowerCase(), t.length === 0)
+    return !1;
+  let a = !1;
+  if (R[t])
+    t = R[t], a = !0;
+  else if (t === "transparent")
+    return { r: 0, g: 0, b: 0, a: 0, format: "name" };
+  let e = f.rgb.exec(t);
+  return e ? { r: e[1], g: e[2], b: e[3] } : (e = f.rgba.exec(t), e ? { r: e[1], g: e[2], b: e[3], a: e[4] } : (e = f.hsl.exec(t), e ? { h: e[1], s: e[2], l: e[3] } : (e = f.hsla.exec(t), e ? { h: e[1], s: e[2], l: e[3], a: e[4] } : (e = f.hsv.exec(t), e ? { h: e[1], s: e[2], v: e[3] } : (e = f.hsva.exec(t), e ? { h: e[1], s: e[2], v: e[3], a: e[4] } : (e = f.cmyk.exec(t), e ? {
+    c: e[1],
+    m: e[2],
+    y: e[3],
+    k: e[4]
+  } : (e = f.hex8.exec(t), e ? {
+    r: s(e[1]),
+    g: s(e[2]),
+    b: s(e[3]),
+    a: A(e[4]),
+    format: a ? "name" : "hex8"
+  } : (e = f.hex6.exec(t), e ? {
+    r: s(e[1]),
+    g: s(e[2]),
+    b: s(e[3]),
+    format: a ? "name" : "hex"
+  } : (e = f.hex4.exec(t), e ? {
+    r: s(e[1] + e[1]),
+    g: s(e[2] + e[2]),
+    b: s(e[3] + e[3]),
+    a: A(e[4] + e[4]),
+    format: a ? "name" : "hex8"
+  } : (e = f.hex3.exec(t), e ? {
+    r: s(e[1] + e[1]),
+    g: s(e[2] + e[2]),
+    b: s(e[3] + e[3]),
+    format: a ? "name" : "hex"
+  } : !1))))))))));
+}
+function n(t) {
+  return typeof t == "number" ? !Number.isNaN(t) : f.CSS_UNIT.test(t);
+}
+export {
+  N as inputToRGB,
+  n as isValidCSSUnit,
+  w as stringInputToObject
+};

package/tinycolor/src/from-ratio.js

@@ -0,0 +1,21 @@
+import { TinyColor as e } from "./index.js";
+import { convertToPercentage as o } from "./util.js";
+function c(n, m) {
+  const r = {
+    r: o(n.r),
+    g: o(n.g),
+    b: o(n.b)
+  };
+  return n.a !== void 0 && (r.a = Number(n.a)), new e(r, m);
+}
+function f() {
+  return new e({
+    r: Math.random(),
+    g: Math.random(),
+    b: Math.random()
+  });
+}
+export {
+  c as fromRatio,
+  f as legacyRandom
+};

package/tinycolor/src/index.js

@@ -0,0 +1,404 @@
+import { numberInputToObject as d, rgbToHsv as g, rgbToHsl as u, rgbToHex as b, rgbaToHex as m, rgbToCmyk as c } from "./conversion.js";
+import { names as $ } from "./css-color-names.js";
+import { inputToRGB as f } from "./format-input.js";
+import { boundAlpha as p, clamp01 as a, bound01 as l } from "./util.js";
+class n {
+  /** red */
+  r;
+  /** green */
+  g;
+  /** blue */
+  b;
+  /** alpha */
+  a;
+  /** the format used to create the tinycolor instance */
+  format;
+  /** input passed into the constructer used to create the tinycolor instance */
+  originalInput;
+  /** the color was successfully parsed */
+  isValid;
+  gradientType;
+  /** rounded alpha */
+  roundA;
+  constructor(t = "", s = {}) {
+    if (t instanceof n)
+      return t;
+    typeof t == "number" && (t = d(t)), this.originalInput = t;
+    const r = f(t);
+    this.originalInput = t, this.r = r.r, this.g = r.g, this.b = r.b, this.a = r.a, this.roundA = Math.round(100 * this.a) / 100, this.format = s.format ?? r.format, this.gradientType = s.gradientType, this.r < 1 && (this.r = Math.round(this.r)), this.g < 1 && (this.g = Math.round(this.g)), this.b < 1 && (this.b = Math.round(this.b)), this.isValid = r.ok;
+  }
+  get ok() {
+    return this.isValid;
+  }
+  isDark() {
+    return this.getBrightness() < 128;
+  }
+  isLight() {
+    return !this.isDark();
+  }
+  /**
+   * Returns the perceived brightness of the color, from 0-255.
+   */
+  getBrightness() {
+    const t = this.toRgb();
+    return (t.r * 299 + t.g * 587 + t.b * 114) / 1e3;
+  }
+  /**
+   * Returns the perceived luminance of a color, from 0-1.
+   */
+  getLuminance() {
+    const t = this.toRgb();
+    let s, r, h;
+    const i = t.r / 255, e = t.g / 255, o = t.b / 255;
+    return i <= 0.03928 ? s = i / 12.92 : s = Math.pow((i + 0.055) / 1.055, 2.4), e <= 0.03928 ? r = e / 12.92 : r = Math.pow((e + 0.055) / 1.055, 2.4), o <= 0.03928 ? h = o / 12.92 : h = Math.pow((o + 0.055) / 1.055, 2.4), 0.2126 * s + 0.7152 * r + 0.0722 * h;
+  }
+  /**
+   * Returns the alpha value of a color, from 0-1.
+   */
+  getAlpha() {
+    return this.a;
+  }
+  /**
+   * Sets the alpha value on the current color.
+   *
+   * @param alpha - The new alpha value. The accepted range is 0-1.
+   */
+  setAlpha(t) {
+    return this.a = p(t), this.roundA = Math.round(100 * this.a) / 100, this;
+  }
+  /**
+   * Returns whether the color is monochrome.
+   */
+  isMonochrome() {
+    const { s: t } = this.toHsl();
+    return t === 0;
+  }
+  /**
+   * Returns the object as a HSVA object.
+   */
+  toHsv() {
+    const t = g(this.r, this.g, this.b);
+    return { h: t.h * 360, s: t.s, v: t.v, a: this.a };
+  }
+  toHsv_() {
+    const t = g(this.r, this.g, this.b);
+    return { h: t.h, s: t.s, v: t.v, a: this.a };
+  }
+  /**
+   * Returns the hsva values interpolated into a string with the following format:
+   * "hsva(xxx, xxx, xxx, xx)".
+   */
+  toHsvString() {
+    const t = g(this.r, this.g, this.b), s = Math.round(t.h * 360), r = Math.round(t.s * 100), h = Math.round(t.v * 100);
+    return this.a === 1 ? `hsv(${s}, ${r}%, ${h}%)` : `hsva(${s}, ${r}%, ${h}%, ${this.roundA})`;
+  }
+  /**
+   * Returns the object as a HSLA object.
+   */
+  toHsl() {
+    const t = u(this.r, this.g, this.b);
+    return { h: t.h * 360, s: t.s, l: t.l, a: this.a };
+  }
+  /**
+   * Returns the hsla values interpolated into a string with the following format:
+   * "hsla(xxx, xxx, xxx, xx)".
+   */
+  toHslString() {
+    const t = u(this.r, this.g, this.b), s = Math.round(t.h * 360), r = Math.round(t.s * 100), h = Math.round(t.l * 100);
+    return this.a === 1 ? `hsl(${s}, ${r}%, ${h}%)` : `hsla(${s}, ${r}%, ${h}%, ${this.roundA})`;
+  }
+  /**
+   * Returns the hex value of the color.
+   * @param allow3Char will shorten hex value to 3 char if possible
+   */
+  toHex(t = !1) {
+    return b(this.r, this.g, this.b, t);
+  }
+  /**
+   * Returns the hex value of the color -with a # prefixed.
+   * @param allow3Char will shorten hex value to 3 char if possible
+   */
+  toHexString(t = !1) {
+    return `#${this.toHex(t)}`;
+  }
+  /**
+   * Returns the hex 8 value of the color.
+   * @param allow4Char will shorten hex value to 4 char if possible
+   */
+  toHex8(t = !1) {
+    return m(this.r, this.g, this.b, this.a, t);
+  }
+  /**
+   * Returns the hex 8 value of the color -with a # prefixed.
+   * @param allow4Char will shorten hex value to 4 char if possible
+   */
+  toHex8String(t = !1) {
+    return `#${this.toHex8(t)}`;
+  }
+  /**
+   * Returns the shorter hex value of the color depends on its alpha -with a # prefixed.
+   * @param allowShortChar will shorten hex value to 3 or 4 char if possible
+   */
+  toHexShortString(t = !1) {
+    return this.a === 1 ? this.toHexString(t) : this.toHex8String(t);
+  }
+  /**
+   * Returns the object as a RGBA object.
+   */
+  toRgb() {
+    return {
+      r: Math.round(this.r),
+      g: Math.round(this.g),
+      b: Math.round(this.b),
+      a: this.a
+    };
+  }
+  toRgba() {
+    return this.toRgb();
+  }
+  toRgbArray() {
+    const t = this.toRgb();
+    return [t.r, t.g, t.b];
+  }
+  toRgbArrayString() {
+    const t = this.toRgb();
+    return `${t.r},${t.g},${t.b}`;
+  }
+  /**
+   * Returns the RGBA values interpolated into a string with the following format:
+   * "RGBA(xxx, xxx, xxx, xx)".
+   */
+  toRgbString() {
+    const t = Math.round(this.r), s = Math.round(this.g), r = Math.round(this.b);
+    return this.a === 1 ? `rgb(${t}, ${s}, ${r})` : `rgba(${t}, ${s}, ${r}, ${this.roundA})`;
+  }
+  toRgbaString() {
+    const t = Math.round(this.r), s = Math.round(this.g), r = Math.round(this.b);
+    return `rgba(${t}, ${s}, ${r}, ${this.roundA})`;
+  }
+  /**
+   * Returns the object as a RGBA object.
+   */
+  toPercentageRgb() {
+    const t = (s) => `${Math.round(l(s, 255) * 100)}%`;
+    return {
+      r: t(this.r),
+      g: t(this.g),
+      b: t(this.b),
+      a: this.a
+    };
+  }
+  /**
+   * Returns the RGBA relative values interpolated into a string
+   */
+  toPercentageRgbString() {
+    const t = (s) => Math.round(l(s, 255) * 100);
+    return this.a === 1 ? `rgb(${t(this.r)}%, ${t(this.g)}%, ${t(this.b)}%)` : `rgba(${t(this.r)}%, ${t(this.g)}%, ${t(this.b)}%, ${this.roundA})`;
+  }
+  toCmyk() {
+    return {
+      ...c(this.r, this.g, this.b)
+    };
+  }
+  toCmykString() {
+    const { c: t, m: s, y: r, k: h } = c(this.r, this.g, this.b);
+    return `cmyk(${t}, ${s}, ${r}, ${h})`;
+  }
+  /**
+   * The 'real' name of the color -if there is one.
+   */
+  toName() {
+    if (this.a === 0)
+      return "transparent";
+    if (this.a < 1)
+      return !1;
+    const t = `#${b(this.r, this.g, this.b, !1)}`;
+    for (const [s, r] of Object.entries($))
+      if (t === r)
+        return s;
+    return !1;
+  }
+  toString(t) {
+    const s = !!t;
+    t = t ?? this.format;
+    let r = !1;
+    const h = this.a < 1 && this.a >= 0;
+    return !s && h && (t.startsWith("hex") || t === "name") ? t === "name" && this.a === 0 ? this.toName() : this.toRgbString() : (t === "rgb" && (r = this.toRgbString()), t === "prgb" && (r = this.toPercentageRgbString()), (t === "hex" || t === "hex6") && (r = this.toHexString()), t === "hex3" && (r = this.toHexString(!0)), t === "hex4" && (r = this.toHex8String(!0)), t === "hex8" && (r = this.toHex8String()), t === "name" && (r = this.toName()), t === "hsl" && (r = this.toHslString()), t === "hsv" && (r = this.toHsvString()), t === "cmyk" && (r = this.toCmykString()), r || this.toHexString());
+  }
+  toNumber() {
+    return (Math.round(this.r) << 16) + (Math.round(this.g) << 8) + Math.round(this.b);
+  }
+  clone() {
+    return new n(this.toString());
+  }
+  /**
+   * Lighten the color a given amount. Providing 100 will always return white.
+   * @param amount - valid between 1-100
+   */
+  lighten(t = 10) {
+    const s = this.toHsl();
+    return s.l += t / 100, s.l = a(s.l), new n(s);
+  }
+  /**
+   * Brighten the color a given amount, from 0 to 100.
+   * @param amount - valid between 1-100
+   */
+  brighten(t = 10) {
+    const s = this.toRgb();
+    return s.r = Math.max(
+      0,
+      Math.min(255, s.r - Math.round(255 * -(t / 100)))
+    ), s.g = Math.max(
+      0,
+      Math.min(255, s.g - Math.round(255 * -(t / 100)))
+    ), s.b = Math.max(
+      0,
+      Math.min(255, s.b - Math.round(255 * -(t / 100)))
+    ), new n(s);
+  }
+  /**
+   * Darken the color a given amount, from 0 to 100.
+   * Providing 100 will always return black.
+   * @param amount - valid between 1-100
+   */
+  darken(t = 10) {
+    const s = this.toHsl();
+    return s.l -= t / 100, s.l = a(s.l), new n(s);
+  }
+  /**
+   * Mix the color with pure white, from 0 to 100.
+   * Providing 0 will do nothing, providing 100 will always return white.
+   * @param amount - valid between 1-100
+   */
+  tint(t = 10) {
+    return this.mix("white", t);
+  }
+  /**
+   * Mix the color with pure black, from 0 to 100.
+   * Providing 0 will do nothing, providing 100 will always return black.
+   * @param amount - valid between 1-100
+   */
+  shade(t = 10) {
+    return this.mix("black", t);
+  }
+  /**
+   * Desaturate the color a given amount, from 0 to 100.
+   * Providing 100 will is the same as calling greyscale
+   * @param amount - valid between 1-100
+   */
+  desaturate(t = 10) {
+    const s = this.toHsl();
+    return s.s -= t / 100, s.s = a(s.s), new n(s);
+  }
+  /**
+   * Saturate the color a given amount, from 0 to 100.
+   * @param amount - valid between 1-100
+   */
+  saturate(t = 10) {
+    const s = this.toHsl();
+    return s.s += t / 100, s.s = a(s.s), new n(s);
+  }
+  /**
+   * Completely desaturates a color into greyscale.
+   * Same as calling `desaturate(100)`
+   */
+  greyscale() {
+    return this.desaturate(100);
+  }
+  /**
+   * Spin takes a positive or negative amount within [-360, 360] indicating the change of hue.
+   * Values outside of this range will be wrapped into this range.
+   */
+  spin(t) {
+    const s = this.toHsl(), r = (s.h + t) % 360;
+    return s.h = r < 0 ? 360 + r : r, new n(s);
+  }
+  /**
+   * Mix the current color a given amount with another color, from 0 to 100.
+   * 0 means no mixing (return current color).
+   */
+  mix(t, s = 50) {
+    const r = this.toRgb(), h = new n(t).toRgb(), i = s / 100, e = {
+      r: (h.r - r.r) * i + r.r,
+      g: (h.g - r.g) * i + r.g,
+      b: (h.b - r.b) * i + r.b,
+      a: (h.a - r.a) * i + r.a
+    };
+    return new n(e);
+  }
+  analogous(t = 6, s = 30) {
+    const r = this.toHsl(), h = 360 / s, i = [this];
+    for (r.h = (r.h - (h * t >> 1) + 720) % 360; --t; )
+      r.h = (r.h + h) % 360, i.push(new n(r));
+    return i;
+  }
+  /**
+   * taken from https://github.com/infusion/jQuery-xcolor/blob/master/jquery.xcolor.js
+   */
+  complement() {
+    const t = this.toHsl();
+    return t.h = (t.h + 180) % 360, new n(t);
+  }
+  monochromatic(t = 6) {
+    const s = this.toHsv(), { h: r } = s, { s: h } = s;
+    let { v: i } = s;
+    const e = [], o = 1 / t;
+    for (; t--; )
+      e.push(new n({ h: r, s: h, v: i })), i = (i + o) % 1;
+    return e;
+  }
+  splitcomplement() {
+    const t = this.toHsl(), { h: s } = t;
+    return [
+      this,
+      new n({ h: (s + 72) % 360, s: t.s, l: t.l }),
+      new n({ h: (s + 216) % 360, s: t.s, l: t.l })
+    ];
+  }
+  /**
+   * Compute how the color would appear on a background
+   */
+  onBackground(t) {
+    const s = this.toRgb(), r = new n(t).toRgb(), h = s.a + r.a * (1 - s.a);
+    return new n({
+      r: (s.r * s.a + r.r * r.a * (1 - s.a)) / h,
+      g: (s.g * s.a + r.g * r.a * (1 - s.a)) / h,
+      b: (s.b * s.a + r.b * r.a * (1 - s.a)) / h,
+      a: h
+    });
+  }
+  /**
+   * Alias for `polyad(3)`
+   */
+  triad() {
+    return this.polyad(3);
+  }
+  /**
+   * Alias for `polyad(4)`
+   */
+  tetrad() {
+    return this.polyad(4);
+  }
+  /**
+   * Get polyad colors, like (for 1, 2, 3, 4, 5, 6, 7, 8, etc...)
+   * monad, dyad, triad, tetrad, pentad, hexad, heptad, octad, etc...
+   */
+  polyad(t) {
+    const s = this.toHsl(), { h: r } = s, h = [this], i = 360 / t;
+    for (let e = 1; e < t; e++)
+      h.push(
+        new n({ h: (r + e * i) % 360, s: s.s, l: s.l })
+      );
+    return h;
+  }
+  /**
+   * compare color vs current color
+   */
+  equals(t) {
+    const s = new n(t);
+    return this.format === "cmyk" || s.format === "cmyk" ? this.toCmykString() === s.toCmykString() : this.toRgbString() === s.toRgbString();
+  }
+}
+export {
+  n as TinyColor
+};