vlite3 1.4.8 → 1.4.10

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "description": "A Vue 3 UI component library built with Tailwind CSS.",
   "license": "MIT",
-  "version": "1.4.8",
+  "version": "1.4.10",
   "type": "module",
   "main": "index.js",
   "module": "index.js",

package/utils/colorUtils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generic color utilities used by the theme system.
+ *
+ * These are intentionally pure functions with no Vue / DOM dependencies so they
+ * can be reused in both client and server contexts (SSR / Nuxt / Node tooling)
+ * and unit-tested without a renderer.
+ *
+ * Conventions:
+ *  - All inputs are 3- or 6-digit hex strings, with or without the leading `#`.
+ *  - Outputs are 7-character hex strings (`#rrggbb`) with the leading `#`.
+ */
+/**
+ * Convert a hex color to HSL.
+ *
+ * @example
+ *   hexToHSL('#ff3b30')   // → { h: 3, s: 100, l: 59 }
+ *   hexToHSL('f00')       // → { h: 0, s: 100, l: 50 }
+ */
+export declare function hexToHSL(hex: string): {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * Mix two hex colors by linearly interpolating their RGB channels.
+ *
+ * @param color1  Base color (weight = 0 keeps this color).
+ * @param color2  Mix target  (weight = 1 returns this color).
+ * @param weight  Mix ratio in `[0, 1]`. Values outside the range are clamped.
+ *
+ * @example
+ *   mixColorHex('#000000', '#ffffff', 0.5)  // → '#7f7f7f'
+ */
+export declare function mixColorHex(color1: string, color2: string, weight: number): string;
+/**
+ * Decide whether a hex color is "dark" (luminance < 50%).
+ *
+ * Useful for picking a contrasting foreground color or for selecting between
+ * light and dark theme palettes without inspecting CSS at runtime.
+ */
+export declare function isDarkColor(hex: string): boolean;

package/utils/colorUtils.js

@@ -0,0 +1,36 @@
+function b(i) {
+  let t = i.replace(/^#/, "");
+  t.length === 3 && (t = t.split("").map((e) => e + e).join(""));
+  const r = parseInt(t.slice(0, 2), 16) / 255, n = parseInt(t.slice(2, 4), 16) / 255, s = parseInt(t.slice(4, 6), 16) / 255, c = Math.max(r, n, s), o = Math.min(r, n, s), p = (c + o) / 2;
+  let a = 0, h = 0;
+  if (c !== o) {
+    const e = c - o;
+    switch (h = p > 0.5 ? e / (2 - c - o) : e / (c + o), c) {
+      case r:
+        a = (n - s) / e + (n < s ? 6 : 0);
+        break;
+      case n:
+        a = (s - r) / e + 2;
+        break;
+      case s:
+        a = (r - n) / e + 4;
+        break;
+    }
+    a /= 6;
+  }
+  return { h: a * 360, s: h * 100, l: p * 100 };
+}
+function f(i, t, r) {
+  const n = i.replace(/^#/, ""), s = t.replace(/^#/, ""), c = parseInt(n.slice(0, 2), 16), o = parseInt(n.slice(2, 4), 16), p = parseInt(n.slice(4, 6), 16), a = parseInt(s.slice(0, 2), 16), h = parseInt(s.slice(2, 4), 16), e = parseInt(s.slice(4, 6), 16), l = Math.min(1, Math.max(0, r)), u = Math.round(c * (1 - l) + a * l), m = Math.round(o * (1 - l) + h * l), I = Math.round(p * (1 - l) + e * l);
+  return "#" + (1 << 24 | u << 16 | m << 8 | I).toString(16).slice(1);
+}
+function M(i) {
+  if (!i) return !1;
+  const { l: t } = b(i);
+  return t < 50;
+}
+export {
+  b as hexToHSL,
+  M as isDarkColor,
+  f as mixColorHex
+};

package/utils/index.d.ts

@@ -4,3 +4,4 @@ export * from './search.util';
 export * from './env';
 export * from './i18n';
 export * from './configUtils';
+export * from './colorUtils';