@aviala-design/color 0.2.2 → 0.3.0

package/dist/index.mjs

@@ -1,340 +1,480 @@
-import m from "color";
-function U(n) {
-  return m(n).rgb().round().color.join(",");
+import w from "color";
+function K(t) {
+  return w(t).rgb().round().color.join(",");
 }
-const P = ["hex", "rgb", "hsl"];
-function z(n) {
-  return !n || P.indexOf(n) < 0 ? "hex" : n;
+const k = ["hex", "rgb", "hsl"];
+function z(t) {
+  return !t || !k.includes(
+    /** @type {any} */
+    t
+  ) ? "hex" : (
+    /** @type {'hex' | 'rgb' | 'hsl'} */
+    t
+  );
 }
-function F(n, o) {
-  const a = z(o);
-  return a === "hex" ? n[a]().toLowerCase() : n[a]().round().string();
+function L(t, n) {
+  const c = z(n);
+  return c === "hex" ? t[c]().toLowerCase() : t[c]().round().string();
 }
-function E(n, o, a) {
-  const e = m(n), t = e.hue(), r = e.saturationv(), s = e.value(), c = ((b) => b >= 60 && b <= 240 ? 2.5 : b >= 0 && b < 60 || b > 300 && b <= 360 ? 1.5 : 2)(t), l = 100, f = 9, u = 100, h = 30;
-  function d(b, w) {
+function D(t, n, c) {
+  const r = w(t), o = r.hue(), s = r.saturationv(), e = r.value(), a = ((p) => p >= 60 && p <= 240 ? 2.5 : p >= 0 && p < 60 || p > 300 && p <= 360 ? 1.5 : 2)(o), l = 100, f = 9, u = 100, h = 30;
+  function d(p, b) {
     let x;
-    return t >= 60 && t <= 240 ? x = b ? t - c * w : t + c * w : x = b ? t + c * w : t - c * w, x < 0 ? x += 360 : x >= 360 && (x -= 360), Math.round(x);
+    return o >= 60 && o <= 240 ? x = p ? o - a * b : o + a * b : x = p ? o + a * b : o - a * b, x < 0 ? x += 360 : x >= 360 && (x -= 360), Math.round(x);
   }
-  function g(b, w) {
+  function M(p, b) {
     let x;
-    if (b)
-      x = r <= f ? r : r - (r - f) / 5.5 * Math.pow(w, 1.05);
+    if (p)
+      x = s <= f ? s : s - (s - f) / 5.5 * Math.pow(b, 1.05);
     else {
-      const A = Math.min(l, r + 30);
-      x = r + (A - r) / 4.2 * Math.pow(w, 0.95);
+      const v = Math.min(l, s + 30);
+      x = s + (v - s) / 4.2 * Math.pow(b, 0.95);
     }
     return Math.max(0, Math.min(100, x));
   }
-  function p(b, w) {
-    return b ? Math.min(u, s + (u - s) / 5.2 * Math.pow(w, 0.9)) : s <= h ? s : Math.max(h, s - (s - h) / 4.2 * Math.pow(w, 1.05));
+  function g(p, b) {
+    return p ? Math.min(u, e + (u - e) / 5.2 * Math.pow(b, 0.9)) : e <= h ? e : Math.max(h, e - (e - h) / 4.2 * Math.pow(b, 1.05));
   }
-  const M = o < 6, S = M ? 6 - o : o - 6, y = o === 6 ? e : m({
-    h: d(M, S),
-    s: g(M, S),
-    v: p(M, S)
+  const m = n < 6, E = m ? 6 - n : n - 6, y = n === 6 ? r : w({
+    h: d(m, E),
+    s: M(m, E),
+    v: g(m, E)
   });
-  return F(y, a);
+  return L(y, c);
 }
-function v(n, o, a) {
-  const e = m(E(n, 10 - o + 1)), t = m(n), r = t.hue(), s = t.saturationv(), c = m({
-    h: t.hue(),
-    s: u(6),
-    v: t.value()
-  }).saturationv(), l = Math.ceil((c - 9) / 4), f = Math.ceil((100 - c) / 5);
-  function u(d) {
+function H(t, n, c) {
+  const r = w(D(t, 10 - n + 1, "hex")), o = w(t), s = o.hue(), e = o.saturationv();
+  function i(d) {
     if (d < 6)
-      return c + (6 - d) * f;
+      return l + (6 - d) * u;
     if (d === 6) {
-      if (r >= 0 && r < 50)
-        return s - 15;
-      if (r >= 50 && r < 191)
-        return s - 20;
-      if (r >= 191 && r <= 360)
-        return s - 15;
+      if (s >= 0 && s < 50)
+        return e - 15;
+      if (s >= 50 && s < 191)
+        return e - 20;
+      if (s >= 191 && s <= 360)
+        return e - 15;
     }
-    return c - l * (d - 6);
+    return l - f * (d - 6);
   }
-  const h = m({
-    h: e.hue(),
-    s: u(o),
-    v: e.value()
+  const l = w({
+    h: o.hue(),
+    s: i(6),
+    v: o.value()
+  }).saturationv(), f = Math.ceil((l - 9) / 4), u = Math.ceil((100 - l) / 5), h = w({
+    h: r.hue(),
+    s: i(n),
+    v: r.value()
   });
-  return F(h, a);
+  return L(h, c);
 }
-function I(n, o = {}) {
-  const { dark: a, list: e, index: t = 6, format: r = "hex" } = o;
-  if (e) {
-    const s = [], i = a ? v : E;
-    for (let c = 1; c <= 10; c++)
-      s.push(i(n, c, r));
-    return s;
+function B(t, n = {}) {
+  const { dark: c, list: r, index: o = 6, format: s = "hex" } = n;
+  if (r) {
+    const e = [], i = c ? H : D;
+    for (let a = 1; a <= 10; a++)
+      e.push(i(t, a, s));
+    return e;
   }
-  return a ? v(n, t, r) : E(n, t, r);
+  return c ? H(t, o, s) : D(t, o, s);
 }
-async function B(n) {
+async function P(t) {
   try {
-    const o = await k(n), a = V(o);
-    return G(a);
-  } catch (o) {
-    throw console.error("提取图片颜色失败:", o), o;
+    const n = await O(t), c = G(n);
+    return V(c);
+  } catch (n) {
+    throw console.error("提取图片颜色失败:", n), n;
   }
 }
-async function k(n) {
-  return new Promise((o, a) => {
+async function O(t) {
+  return new Promise((n, c) => {
     try {
-      const e = document.createElement("canvas"), t = e.getContext("2d"), r = Math.min(n.width, 100), s = Math.min(n.height, 100), i = Math.min(r / n.width, s / n.height);
-      e.width = n.width * i, e.height = n.height * i, t.drawImage(n, 0, 0, e.width, e.height);
-      const c = t.getImageData(0, 0, e.width, e.height);
-      o(c);
-    } catch (e) {
-      a(e);
+      if (typeof document > "u") {
+        c(new Error("图像颜色提取功能仅在浏览器环境中可用"));
+        return;
+      }
+      const r = document.createElement("canvas"), o = r.getContext("2d");
+      if (!o) {
+        c(new Error("无法获取canvas 2d context"));
+        return;
+      }
+      const s = Math.min(t.width, 100), e = Math.min(t.height, 100), i = Math.min(s / t.width, e / t.height);
+      r.width = t.width * i, r.height = t.height * i, o.drawImage(t, 0, 0, r.width, r.height);
+      const a = o.getImageData(0, 0, r.width, r.height);
+      n(a);
+    } catch (r) {
+      c(r);
     }
   });
 }
-function V(n) {
-  const o = n.data, a = /* @__PURE__ */ new Map();
-  for (let t = 0; t < o.length; t += 4) {
-    const r = o[t], s = o[t + 1], i = o[t + 2];
-    if (o[t + 3] < 128) continue;
-    const l = Math.round(r / 16) * 16, f = Math.round(s / 16) * 16, u = Math.round(i / 16) * 16, h = `${l},${f},${u}`;
-    a.has(h) ? a.set(h, a.get(h) + 1) : a.set(h, 1);
+function G(t) {
+  const n = t.data, c = /* @__PURE__ */ new Map();
+  for (let o = 0; o < n.length; o += 4) {
+    const s = n[o], e = n[o + 1], i = n[o + 2];
+    if (n[o + 3] < 128) continue;
+    const l = Math.round(s / 16) * 16, f = Math.round(e / 16) * 16, u = Math.round(i / 16) * 16, h = `${l},${f},${u}`;
+    c.has(h) ? c.set(h, c.get(h) + 1) : c.set(h, 1);
   }
-  const e = [];
-  return a.forEach((t, r) => {
-    const [s, i, c] = r.split(",").map(Number);
-    e.push({ r: s, g: i, b: c, count: t });
-  }), e;
+  const r = [];
+  return c.forEach((o, s) => {
+    const [e, i, a] = s.split(",").map(Number);
+    r.push({ r: e, g: i, b: a, count: o });
+  }), r;
 }
-function G(n) {
-  n.sort((t, r) => r.count - t.count);
-  const o = n.filter((t) => {
-    const { r, g: s, b: i } = t, c = Math.max(r, s, i), l = Math.min(r, s, i), f = c - l, u = c === 0 ? 0 : f / c, h = c / 255;
+function V(t) {
+  t.sort((o, s) => s.count - o.count);
+  const n = t.filter((o) => {
+    const { r: s, g: e, b: i } = o, a = Math.max(s, e, i), l = Math.min(s, e, i), f = a - l, u = a === 0 ? 0 : f / a, h = a / 255;
     return u > 0.15 && h > 0.2 && h < 0.8;
-  }), a = o.length > 0 ? o[0] : n[0];
-  return m({ r: a.r, g: a.g, b: a.b }).hex();
+  }), c = n.length > 0 ? n[0] : t[0];
+  return w({ r: c.r, g: c.g, b: c.b }).hex();
 }
-function K(n) {
-  return new Promise((o, a) => {
-    if (!n.type.startsWith("image/")) {
-      a(new Error("请选择图片文件"));
+function W(t) {
+  return new Promise((n, c) => {
+    if (typeof FileReader > "u" || typeof Image > "u") {
+      c(new Error("文件读取功能仅在浏览器环境中可用"));
+      return;
+    }
+    if (!t.type.startsWith("image/")) {
+      c(new Error("请选择图片文件"));
       return;
     }
-    const e = new FileReader();
-    e.onload = async (t) => {
+    const r = new FileReader();
+    r.onload = async (o) => {
+      var s;
       try {
-        const r = new Image();
-        r.onload = async () => {
+        const e = new Image();
+        e.onload = async () => {
           try {
-            const s = await B(r);
-            o(s);
-          } catch (s) {
-            a(s);
+            const a = await P(e);
+            n(a);
+          } catch (a) {
+            c(a);
           }
-        }, r.onerror = () => a(new Error("图片加载失败")), r.src = t.target.result;
-      } catch (r) {
-        a(r);
+        }, e.onerror = () => c(new Error("图片加载失败"));
+        const i = (s = o.target) == null ? void 0 : s.result;
+        typeof i == "string" ? e.src = i : c(new Error("无法读取图片数据"));
+      } catch (e) {
+        c(e);
       }
-    }, e.onerror = () => a(new Error("文件读取失败")), e.readAsDataURL(n);
+    }, r.onerror = () => c(new Error("文件读取失败")), r.readAsDataURL(t);
   });
 }
-function $(n, o, a = {}) {
-  const { steps: e = 10, format: t = "hex", includeEnds: r = !0 } = a;
-  if (e < 2)
+function $(t, n, c = {}) {
+  const { steps: r = 10, format: o = "hex", includeEnds: s = !0 } = c;
+  if (r < 2)
     throw new Error("步数必须至少为2");
-  const s = m(n), i = m(o), c = [], l = r ? e : e + 2, f = 1 / (l - 1);
+  const e = w(t), i = w(n), a = [], l = s ? r : r + 2, f = 1 / (l - 1);
   for (let u = 0; u < l; u++) {
-    const h = u * f, d = Math.round(s.red() + (i.red() - s.red()) * h), g = Math.round(s.green() + (i.green() - s.green()) * h), p = Math.round(s.blue() + (i.blue() - s.blue()) * h), M = m({ r: d, g, b: p });
-    !r && (u === 0 || u === l - 1) || c.push(F(M, t));
+    const h = u * f, d = Math.round(e.red() + (i.red() - e.red()) * h), M = Math.round(e.green() + (i.green() - e.green()) * h), g = Math.round(e.blue() + (i.blue() - e.blue()) * h), m = w({ r: d, g: M, b: g });
+    !s && (u === 0 || u === l - 1) || a.push(L(m, o));
   }
-  return c;
+  return a;
 }
-function W(n = {}) {
+function J(t = {}) {
   const {
-    startGray: o = "#ffffff",
-    endGray: a = "#000000",
-    steps: e = 10,
-    format: t = "hex"
-  } = n;
-  return $(o, a, { steps: e, format: t, includeEnds: !0 });
+    startGray: n = "#ffffff",
+    endGray: c = "#000000",
+    steps: r = 10,
+    format: o = "hex"
+  } = t;
+  return $(n, c, { steps: r, format: o, includeEnds: !0 });
 }
-function J(n, o = {}) {
-  const { steps: a = 10, format: e = "hex", lightnessRange: t = 80 } = o, s = m(n).hsl(), i = s.lightness(), c = Math.min(95, i + t / 2), l = Math.max(5, i - t / 2), f = m({
-    h: s.hue(),
-    s: s.saturationl(),
-    l: c
-  }), u = m({
-    h: s.hue(),
-    s: s.saturationl(),
+function j(t, n = {}) {
+  const {
+    steps: c = 10,
+    format: r = "hex",
+    lightnessRange: o = 80,
+    minLightness: s = null,
+    maxLightness: e = null
+  } = n, i = w(t);
+  let a, l;
+  if (s !== null && e !== null) {
+    if (s > e)
+      throw new Error("minLightness 不能大于 maxLightness");
+    a = Math.max(0, Math.min(100, e)), l = Math.max(0, Math.min(100, s));
+  } else {
+    const h = i.lightness();
+    a = Math.min(95, h + o / 2), l = Math.max(5, h - o / 2);
+  }
+  const f = w({
+    h: i.hue(),
+    s: i.saturationl(),
+    l: a
+  }), u = w({
+    h: i.hue(),
+    s: i.saturationl(),
     l
   });
-  return $(f.hex(), u.hex(), { steps: a, format: e, includeEnds: !0 });
+  return $(f.hex(), u.hex(), { steps: c, format: r, includeEnds: !0 });
 }
-function Q(n, o, a = {}) {
-  const { steps: e = 10, format: t = "hex", includeEnds: r = !0 } = a;
-  if (e < 2)
+function Q(t, n, c = {}) {
+  const { steps: r = 10, format: o = "hex", includeEnds: s = !0 } = c;
+  if (r < 2)
     throw new Error("步数必须至少为2");
-  const s = m(n).hsl(), i = m(o).hsl(), c = [], l = r ? e : e + 2, f = 1 / (l - 1);
-  let u = s.hue() || 0, h = i.hue() || 0;
+  const e = w(t), i = w(n), a = [], l = s ? r : r + 2, f = 1 / (l - 1);
+  let u = e.hue() || 0, h = i.hue() || 0;
   const d = h - u;
   Math.abs(d) > 180 && (d > 0 ? u += 360 : h += 360);
-  for (let g = 0; g < l; g++) {
-    const p = g * f;
-    let M = u + (h - u) * p;
-    const S = s.saturationl() + (i.saturationl() - s.saturationl()) * p, y = s.lightness() + (i.lightness() - s.lightness()) * p;
-    M = M % 360, M < 0 && (M += 360);
-    const b = m({ h: M, s: S, l: y });
-    !r && (g === 0 || g === l - 1) || c.push(F(b, t));
+  const M = e.saturationl(), g = i.saturationl(), m = e.lightness(), E = i.lightness();
+  for (let y = 0; y < l; y++) {
+    const p = y * f;
+    let b = u + (h - u) * p;
+    const x = M + (g - M) * p, v = m + (E - m) * p;
+    b = b % 360, b < 0 && (b += 360);
+    const A = w({ h: b, s: x, l: v });
+    !s && (y === 0 || y === l - 1) || a.push(L(A, o));
   }
-  return c;
+  return a;
 }
-function C(n) {
-  const o = n.replace("#", ""), a = parseInt(o.substr(0, 2), 16) / 255, e = parseInt(o.substr(2, 2), 16) / 255, t = parseInt(o.substr(4, 2), 16) / 255, r = Math.max(a, e, t), s = Math.min(a, e, t), i = r - s;
-  let c = 0;
-  i !== 0 && (r === a ? c = (e - t) / i % 6 : r === e ? c = (t - a) / i + 2 : c = (a - e) / i + 4), c = Math.round(c * 60), c < 0 && (c += 360);
-  const l = Math.round((0.299 * a + 0.587 * e + 0.114 * t) * 100), f = (r + s) / 2, u = i === 0 ? 0 : i / (1 - Math.abs(2 * f - 1)), h = Math.round(u * Math.min(l, 100 - l));
-  return { h: c, c: h, t: l };
+function S(t) {
+  if (!t || typeof t != "string")
+    throw new Error("Invalid RGB color: must be a string");
+  let n = t.replace("#", "");
+  if (n.length === 8 && (n = n.substring(0, 6)), !/^[0-9A-Fa-f]{6}$/.test(n))
+    throw new Error("Invalid RGB color format: must be #rrggbb or rrggbb");
+  const c = parseInt(n.slice(0, 2), 16) / 255, r = parseInt(n.slice(2, 4), 16) / 255, o = parseInt(n.slice(4, 6), 16) / 255, s = Math.max(c, r, o), e = Math.min(c, r, o), i = s - e;
+  let a = 0;
+  i !== 0 && (s === c ? a = (r - o) / i % 6 : s === r ? a = (o - c) / i + 2 : a = (c - r) / i + 4), a = Math.round(a * 60), a < 0 && (a += 360);
+  const l = Math.round((0.299 * c + 0.587 * r + 0.114 * o) * 100), f = (s + e) / 2;
+  let u = 0;
+  i !== 0 && f !== 0 && f !== 1 && (u = i / (1 - Math.abs(2 * f - 1)));
+  let h = 0;
+  return l > 0 && l < 100 && (h = Math.round(u * Math.min(l, 100 - l))), { h: a, c: Math.max(0, h), t: Math.max(0, Math.min(100, l)) };
 }
-function D(n) {
-  const { h: o, c: a, t: e } = n, t = (o % 360 + 360) % 360, r = Math.max(0, Math.min(150, a)), s = Math.max(0, Math.min(100, e)), i = s / 100, c = s === 0 || s === 100 ? 0 : r / Math.min(s, 100 - s), l = (1 - Math.abs(2 * i - 1)) * Math.min(1, c), f = l * (1 - Math.abs(t / 60 % 2 - 1)), u = i - l / 2;
-  let h, d, g;
-  t >= 0 && t < 60 ? [h, d, g] = [l, f, 0] : t >= 60 && t < 120 ? [h, d, g] = [f, l, 0] : t >= 120 && t < 180 ? [h, d, g] = [0, l, f] : t >= 180 && t < 240 ? [h, d, g] = [0, f, l] : t >= 240 && t < 300 ? [h, d, g] = [f, 0, l] : [h, d, g] = [l, 0, f];
-  const p = (M) => {
-    const S = Math.max(0, Math.min(1, M + u)), y = Math.round(S * 255).toString(16);
-    return y.length === 1 ? "0" + y : y;
+function R(t, n = {}) {
+  if (!t || typeof t != "object" || t.h === void 0 || t.c === void 0 || t.t === void 0)
+    throw new Error("Invalid HCT color: must be an object with h, c, t properties");
+  const { h: c, c: r, t: o } = t, { maxChroma: s = 200 } = n, e = (c % 360 + 360) % 360, i = Math.max(0, Math.min(s, r)), a = Math.max(0, Math.min(100, o)), l = a / 100;
+  let f = 0;
+  if (a > 0 && a < 100 && i > 0) {
+    const y = Math.min(a, 100 - a);
+    f = y > 0 ? i / y : 0;
+  }
+  const u = (1 - Math.abs(2 * l - 1)) * Math.min(1, f), h = u * (1 - Math.abs(e / 60 % 2 - 1)), d = l - u / 2;
+  let M, g, m;
+  e >= 0 && e < 60 ? [M, g, m] = [u, h, 0] : e >= 60 && e < 120 ? [M, g, m] = [h, u, 0] : e >= 120 && e < 180 ? [M, g, m] = [0, u, h] : e >= 180 && e < 240 ? [M, g, m] = [0, h, u] : e >= 240 && e < 300 ? [M, g, m] = [h, 0, u] : [M, g, m] = [u, 0, h];
+  const E = (y) => {
+    const p = Math.max(0, Math.min(1, y + d)), b = Math.round(p * 255).toString(16);
+    return b.length === 1 ? "0" + b : b;
   };
-  return `#${p(h)}${p(d)}${p(g)}`;
+  return `#${E(M)}${E(g)}${E(m)}`;
 }
-function R(n, o, a = 0.5) {
-  const e = C(n), t = C(o);
-  let r = e.h, s = t.h, i = s - r;
-  Math.abs(i) > 180 && (i > 0 ? r += 360 : s += 360);
-  const c = (r + (s - r) * a) % 360, l = e.c + (t.c - e.c) * a, f = e.t + (t.t - e.t) * a;
-  return D({
-    h: c < 0 ? c + 360 : c,
-    c: Math.max(0, Math.round(l)),
-    t: Math.max(0, Math.min(100, Math.round(f)))
+function F(t, n, c = 0.5) {
+  if (!t || !n)
+    throw new Error("Both colors are required for blending");
+  const r = Math.max(0, Math.min(1, c)), o = S(t), s = S(n);
+  let e = o.h, i = s.h, a = i - e;
+  Math.abs(a) > 180 && (a > 0 ? e += 360 : i += 360, a = i - e);
+  const l = (e + a * r) % 360, f = o.c + (s.c - o.c) * r, u = o.t + (s.t - o.t) * r;
+  return R({
+    h: l < 0 ? l + 360 : l,
+    c: Math.max(0, Math.round(f)),
+    t: Math.max(0, Math.min(100, Math.round(u)))
   });
 }
-function X(n, o, a = 0.15) {
-  const e = C(n), t = C(o);
-  let r = t.h, s = e.h, i = s - r;
-  Math.abs(i) > 180 && (i > 0 ? r += 360 : s += 360, i = s - r);
-  const c = (r + i * a) % 360;
-  return D({
-    h: c < 0 ? c + 360 : c,
-    c: t.c,
+function X(t, n, c = 0.15) {
+  if (!t || !n)
+    throw new Error("Both theme color and target color are required");
+  const r = Math.max(0, Math.min(1, c)), o = S(t), s = S(n);
+  let e = s.h, i = o.h, a = i - e;
+  Math.abs(a) > 180 && (a > 0 ? e += 360 : i += 360, a = i - e);
+  const l = (e + a * r) % 360;
+  return R({
+    h: l < 0 ? l + 360 : l,
+    c: s.c,
     // 保持原有色度
-    t: t.t
+    t: s.t
     // 保持原有色调
   });
 }
-function O(n, o = [10, 20, 30, 40, 50, 60, 70, 80, 90]) {
-  const a = C(n);
-  let e;
-  return Array.isArray(o) ? e = o : o && o.tones && Array.isArray(o.tones) ? e = o.tones : e = [10, 20, 30, 40, 50, 60, 70, 80, 90], e.map((t) => D({
-    h: a.h,
-    c: a.c,
-    t
+function Y(t, n) {
+  if (!t)
+    throw new Error("Theme color is required");
+  const c = S(t);
+  let r;
+  if (Array.isArray(n) ? r = n : n && n.tones && Array.isArray(n.tones) ? r = n.tones : r = [10, 20, 30, 40, 50, 60, 70, 80, 90], !Array.isArray(r) || r.length === 0)
+    throw new Error("Tone steps must be a non-empty array");
+  const o = r.filter((s) => typeof s == "number" && s >= 0 && s <= 100);
+  if (o.length === 0)
+    throw new Error("No valid tone values found (must be numbers between 0-100)");
+  return o.map((s) => R({
+    h: c.h,
+    c: c.c,
+    t: s
   }));
 }
-function T(n, o, a = 0.2) {
-  const e = {};
-  for (const [t, r] of Object.entries(o))
-    e[t] = R(n, r, a);
-  return e;
+function N(t, n, c = 0.2) {
+  if (!t)
+    throw new Error("Theme color is required");
+  if (!n || typeof n != "object")
+    throw new Error("UI colors must be an object");
+  const r = Math.max(0, Math.min(1, c)), o = {};
+  for (const [s, e] of Object.entries(n))
+    try {
+      o[s] = F(t, e, r);
+    } catch (i) {
+      console.warn(`Failed to blend color for key "${s}": ${/** @type {Error} */
+      i.message}`), o[s] = e;
+    }
+  return o;
 }
-function N(n, o = {}) {
-  const { baseGray: a = "#666666" } = o, { blendRatio: e = 0.08, isDark: t = !1 } = o, r = C(a), s = {};
-  return (t ? [95, 90, 85, 80, 70, 60, 50, 40, 30, 20, 15, 10] : [10, 15, 20, 30, 40, 50, 60, 70, 80, 85, 90, 95]).forEach((c, l) => {
-    const f = { h: r.h, c: r.c, t: c }, u = R(D(f), n, e);
-    s[`gray-${l + 1}`] = u;
-  }), s;
+function I(t, n = {}) {
+  if (!t)
+    throw new Error("Theme color is required");
+  const {
+    baseGray: c = "#989898",
+    blendRatio: r = 0.08,
+    isDark: o = !1,
+    steps: s = 12,
+    // 默认 12 个等级，可以增加到 24、36 等以获得更细腻的梯度
+    lightnessRange: e = 85,
+    // 亮度变化范围（中心扩展模式），默认 85
+    minLightness: i = null,
+    // 最小亮度（固定端点模式），优先级高于 lightnessRange
+    maxLightness: a = null
+    // 最大亮度（固定端点模式），优先级高于 lightnessRange
+  } = n, l = Math.max(0, Math.min(1, r)), f = Math.max(2, Math.min(100, Math.round(s))), u = F(c, t, l), h = {
+    steps: f,
+    format: "hex"
+  };
+  if (i !== null && a !== null)
+    h.minLightness = i, h.maxLightness = a;
+  else {
+    const m = Math.max(20, Math.min(95, e));
+    h.lightnessRange = m;
+  }
+  const d = j(u, h), M = o ? d.reverse() : d, g = {};
+  return M.forEach((m, E) => {
+    g[`gray-${E + 1}`] = m;
+  }), g;
 }
-function L(n, o = {}) {
+function T(t, n = {}) {
+  if (!t)
+    throw new Error("Theme color is required");
   const {
-    semanticColors: a = {
+    semanticColors: c = {
       success: "#52c41a",
       warning: "#faad14",
       error: "#ff4d4f",
       info: "#1890ff"
     },
-    blendRatio: e = 0.12,
-    isDark: t = !1
-  } = o, r = {};
-  return Object.entries(a).forEach(([s, i]) => {
-    const c = {}, l = C(i);
-    (t ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((u, h) => {
-      const d = { h: l.h, c: l.c, t: u }, g = R(D(d), n, e);
-      c[`${s}-${h + 1}`] = g;
-    }), Object.assign(r, c);
-  }), r;
+    blendRatio: r = 0,
+    isDark: o = !1
+  } = n;
+  if (!c || typeof c != "object")
+    throw new Error("Semantic colors must be an object");
+  const s = Math.max(0, Math.min(1, r)), e = {};
+  return Object.entries(c).forEach(([i, a]) => {
+    if (!a || typeof a != "string") {
+      console.warn(`Invalid color for semantic color "${i}": ${a}`);
+      return;
+    }
+    try {
+      const l = {}, f = S(a);
+      (o ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((h, d) => {
+        const M = { h: f.h, c: f.c, t: h }, g = F(R(M), t, s);
+        l[`${i}-${d + 1}`] = g;
+      }), Object.assign(e, l);
+    } catch (l) {
+      console.warn(`Failed to generate variants for semantic color "${i}": ${/** @type {Error} */
+      l.message}`);
+    }
+  }), e;
 }
-function q(n, o = {}) {
-  const { isDark: a = !1 } = o, e = C(n), t = {};
-  return (a ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((s, i) => {
-    const c = { h: e.h, c: e.c, t: s };
-    t[`theme-${i + 1}`] = D(c);
-  }), t;
+function q(t, n = {}) {
+  if (!t)
+    throw new Error("Theme color is required");
+  const { isDark: c = !1 } = n, r = S(t), o = {};
+  return (c ? [90, 80, 70, 60, 50, 40, 30, 25, 20, 15] : [15, 25, 35, 45, 55, 65, 75, 85, 90, 95]).forEach((e, i) => {
+    const a = { h: r.h, c: r.c, t: e };
+    o[`theme-${i + 1}`] = R(a);
+  }), o;
 }
-function Y(n, o = {}) {
+function Z(t, n = {}) {
+  if (!t)
+    throw new Error("Theme color is required");
   const {
-    baseGray: a = "#666666",
-    isDark: e = !1,
-    semanticColors: t,
-    controlBlendRatio: r = 0.08,
-    semanticBlendRatio: s = 0.12
-  } = o;
-  return {
-    // 1. 基础控件颜色（灰色系1-12）
-    controls: N(n, {
-      baseGray: a,
-      blendRatio: r,
-      isDark: e
-    }),
+    baseGray: c = "#666666",
+    isDark: r = !1,
+    semanticColors: o,
+    controlBlendRatio: s = 0.08,
+    semanticBlendRatio: e = 0.12,
+    controlSteps: i = 12,
+    // 控件色灰度等级数
+    controlLightnessRange: a = 85,
+    // 控件色亮度变化范围（中心扩展模式）
+    controlMinLightness: l = null,
+    // 控件色最小亮度（固定端点模式）
+    controlMaxLightness: f = null
+    // 控件色最大亮度（固定端点模式）
+  } = n, u = Math.max(0, Math.min(1, s)), h = Math.max(0, Math.min(1, e)), d = {
+    baseGray: c,
+    blendRatio: u,
+    isDark: r,
+    steps: i
+  };
+  return l !== null && f !== null ? (d.minLightness = l, d.maxLightness = f) : d.lightnessRange = a, {
+    // 1. 基础控件颜色（灰色系1-12或更多）
+    controls: I(t, d),
     // 2. 表意色（1-10）
-    semantic: L(n, {
-      semanticColors: t,
-      blendRatio: s,
-      isDark: e
+    semantic: T(t, {
+      semanticColors: o,
+      blendRatio: h,
+      isDark: r
     }),
     // 3. 主题色（1-10）
-    theme: q(n, { isDark: e })
+    theme: q(t, { isDark: r })
   };
 }
-function Z(n, o = {}) {
+function _(t, n = {}) {
+  if (!t)
+    throw new Error("Theme color is required");
   const {
-    semanticColors: a = {
+    semanticColors: c = {
       success: "#52c41a",
       warning: "#faad14",
       error: "#ff4d4f",
       info: "#1890ff"
     },
-    uiColors: e = {
+    uiColors: r = {
       background: "#ffffff",
       surface: "#fafafa",
       border: "#d9d9d9",
       disabled: "#f5f5f5"
     },
-    harmonizeRatio: t = 0.15,
-    blendRatio: r = 0.12,
-    generateVariants: s = !0
-  } = o, i = L(n, { semanticColors: a, blendRatio: t }), c = {};
-  Object.entries(a).forEach(([f]) => {
-    c[f] = {};
-    for (let u = 1; u <= 10; u++) {
-      const h = `${f}-${u}`;
-      i[h] && (c[f][u] = i[h]);
+    harmonizeRatio: o = 0.15,
+    blendRatio: s = 0.12,
+    isDark: e = !1
+  } = (
+    /** @type {any} */
+    n
+  ), i = Math.max(0, Math.min(1, o)), a = Math.max(0, Math.min(1, s)), l = q(t, { isDark: e }), f = I(t, {
+    blendRatio: a * 0.5,
+    // 中性色混合比例稍低
+    isDark: e
+  }), u = T(t, {
+    semanticColors: c,
+    blendRatio: i,
+    isDark: e
+  }), h = {};
+  return Object.entries(c).forEach(([M]) => {
+    h[M] = {};
+    for (let g = 1; g <= 10; g++) {
+      const m = `${M}-${g}`;
+      u[m] && (h[M][g] = u[m]);
     }
-  });
-  const l = {
-    theme: n,
-    semantic: c,
-    ui: T(n, e, r)
+  }), {
+    theme: l,
+    // 主题色阶 theme-1 到 theme-10
+    controls: f,
+    // 中性色阶 gray-1 到 gray-12
+    semantic: h,
+    // 功能色系
+    ui: N(t, r, a)
   };
-  return s && (l.variants = O(n)), l;
 }
-const H = {
+const C = {
   red: "#F53F3F",
   orangered: "#F77234",
   orange: "#FF7D00",
@@ -349,11 +489,20 @@ const H = {
   pinkpurple: "#D91AD9",
   magenta: "#F5319D"
 };
-function _() {
-  const n = {};
-  return Object.keys(H).forEach((o) => {
-    n[o] = {}, n[o].light = I(H[o], { list: !0 }), n[o].dark = I(H[o], { list: !0, dark: !0 }), n[o].primary = H[o];
-  }), n.gray = {}, n.gray.light = [
+function tt() {
+  const t = {};
+  return Object.keys(C).forEach((n) => {
+    t[n] = {}, t[n].light = B(C[
+      /** @type {keyof typeof colorList} */
+      n
+    ], { list: !0 }), t[n].dark = B(C[
+      /** @type {keyof typeof colorList} */
+      n
+    ], { list: !0, dark: !0 }), t[n].primary = C[
+      /** @type {keyof typeof colorList} */
+      n
+    ];
+  }), t.gray = {}, t.gray.light = [
     "#f7f8fa",
     "#f2f3f5",
     "#e5e6eb",
@@ -364,7 +513,7 @@ function _() {
     "#4e5969",
     "#272e3b",
     "#1d2129"
-  ], n.gray.dark = [
+  ], t.gray.dark = [
     "#17171a",
     "#2e2e30",
     "#484849",
@@ -375,28 +524,28 @@ function _() {
     "#c5c5c5",
     "#dfdfdf",
     "#f6f6f6"
-  ], n.gray.primary = n.gray.light[6], n;
+  ], t.gray.primary = t.gray.light[6], t;
 }
 export {
-  R as blendInHct,
-  T as blendUIColors,
-  H as colorList,
-  K as extractColorFromFile,
-  B as extractColorFromImage,
-  I as generate,
-  N as generateControlColors,
-  W as generateGrayLinear,
-  Y as generateInterfaceColorSystem,
+  F as blendInHct,
+  N as blendUIColors,
+  C as colorList,
+  W as extractColorFromFile,
+  P as extractColorFromImage,
+  B as generate,
+  I as generateControlColors,
+  J as generateGrayLinear,
+  Z as generateInterfaceColorSystem,
   $ as generateLinear,
   Q as generateLinearHSL,
-  J as generateMonochromeLinear,
-  L as generateSemanticColors,
+  j as generateMonochromeLinear,
+  T as generateSemanticColors,
   q as generateThemeColors,
-  Z as generateThemePalette,
-  O as generateThemeVariants,
-  _ as getPresetColors,
-  U as getRgbStr,
+  _ as generateThemePalette,
+  Y as generateThemeVariants,
+  tt as getPresetColors,
+  K as getRgbStr,
   X as harmonizeColor,
-  D as hctToRgb,
-  C as rgbToHct
+  R as hctToRgb,
+  S as rgbToHct
 };