@fluixi/utils 1.0.0-alpha.100

package/dist/lib/color/utils.mjs

@@ -0,0 +1,939 @@
+// src/lib/color/constants.ts
+var NAMED_COLORS = {
+  // Basic colors
+  aliceblue: "#f0f8ff",
+  antiquewhite: "#faebd7",
+  aqua: "#00ffff",
+  aquamarine: "#7fffd4",
+  azure: "#f0ffff",
+  beige: "#f5f5dc",
+  bisque: "#ffe4c4",
+  black: "#000000",
+  blanchedalmond: "#ffebcd",
+  blue: "#0000ff",
+  blueviolet: "#8a2be2",
+  brown: "#a52a2a",
+  burlywood: "#deb887",
+  cadetblue: "#5f9ea0",
+  chartreuse: "#7fff00",
+  chocolate: "#d2691e",
+  coral: "#ff7f50",
+  cornflowerblue: "#6495ed",
+  cornsilk: "#fff8dc",
+  crimson: "#dc143c",
+  cyan: "#00ffff",
+  darkblue: "#00008b",
+  darkcyan: "#008b8b",
+  darkgoldenrod: "#b8860b",
+  darkgray: "#a9a9a9",
+  darkgreen: "#006400",
+  darkgrey: "#a9a9a9",
+  darkkhaki: "#bdb76b",
+  darkmagenta: "#8b008b",
+  darkolivegreen: "#556b2f",
+  darkorange: "#ff8c00",
+  darkorchid: "#9932cc",
+  darkred: "#8b0000",
+  darksalmon: "#e9967a",
+  darkseagreen: "#8fbc8f",
+  darkslateblue: "#483d8b",
+  darkslategray: "#2f4f4f",
+  darkslategrey: "#2f4f4f",
+  darkturquoise: "#00ced1",
+  darkviolet: "#9400d3",
+  deeppink: "#ff1493",
+  deepskyblue: "#00bfff",
+  dimgray: "#696969",
+  dimgrey: "#696969",
+  dodgerblue: "#1e90ff",
+  firebrick: "#b22222",
+  floralwhite: "#fffaf0",
+  forestgreen: "#228b22",
+  fuchsia: "#ff00ff",
+  gainsboro: "#dcdcdc",
+  ghostwhite: "#f8f8ff",
+  gold: "#ffd700",
+  goldenrod: "#daa520",
+  gray: "#808080",
+  green: "#008000",
+  greenyellow: "#adff2f",
+  grey: "#808080",
+  honeydew: "#f0fff0",
+  hotpink: "#ff69b4",
+  indianred: "#cd5c5c",
+  indigo: "#4b0082",
+  ivory: "#fffff0",
+  khaki: "#f0e68c",
+  lavender: "#e6e6fa",
+  lavenderblush: "#fff0f5",
+  lawngreen: "#7cfc00",
+  lemonchiffon: "#fffacd",
+  lightblue: "#add8e6",
+  lightcoral: "#f08080",
+  lightcyan: "#e0ffff",
+  lightgoldenrodyellow: "#fafad2",
+  lightgray: "#d3d3d3",
+  lightgreen: "#90ee90",
+  lightgrey: "#d3d3d3",
+  lightpink: "#ffb6c1",
+  lightsalmon: "#ffa07a",
+  lightseagreen: "#20b2aa",
+  lightskyblue: "#87cefa",
+  lightslategray: "#778899",
+  lightslategrey: "#778899",
+  lightsteelblue: "#b0c4de",
+  lightyellow: "#ffffe0",
+  lime: "#00ff00",
+  limegreen: "#32cd32",
+  linen: "#faf0e6",
+  magenta: "#ff00ff",
+  maroon: "#800000",
+  mediumaquamarine: "#66cdaa",
+  mediumblue: "#0000cd",
+  mediumorchid: "#ba55d3",
+  mediumpurple: "#9370db",
+  mediumseagreen: "#3cb371",
+  mediumslateblue: "#7b68ee",
+  mediumspringgreen: "#00fa9a",
+  mediumturquoise: "#48d1cc",
+  mediumvioletred: "#c71585",
+  midnightblue: "#191970",
+  mintcream: "#f5fffa",
+  mistyrose: "#ffe4e1",
+  moccasin: "#ffe4b5",
+  navajowhite: "#ffdead",
+  navy: "#000080",
+  oldlace: "#fdf5e6",
+  olive: "#808000",
+  olivedrab: "#6b8e23",
+  orange: "#ffa500",
+  orangered: "#ff4500",
+  orchid: "#da70d6",
+  palegoldenrod: "#eee8aa",
+  palegreen: "#98fb98",
+  paleturquoise: "#afeeee",
+  palevioletred: "#db7093",
+  papayawhip: "#ffefd5",
+  peachpuff: "#ffdab9",
+  peru: "#cd853f",
+  pink: "#ffc0cb",
+  plum: "#dda0dd",
+  powderblue: "#b0e0e6",
+  purple: "#800080",
+  rebeccapurple: "#663399",
+  red: "#ff0000",
+  rosybrown: "#bc8f8f",
+  royalblue: "#4169e1",
+  saddlebrown: "#8b4513",
+  salmon: "#fa8072",
+  sandybrown: "#f4a460",
+  seagreen: "#2e8b57",
+  seashell: "#fff5ee",
+  sienna: "#a0522d",
+  silver: "#c0c0c0",
+  skyblue: "#87ceeb",
+  slateblue: "#6a5acd",
+  slategray: "#708090",
+  slategrey: "#708090",
+  snow: "#fffafa",
+  springgreen: "#00ff7f",
+  steelblue: "#4682b4",
+  tan: "#d2b48c",
+  teal: "#008080",
+  thistle: "#d8bfd8",
+  tomato: "#ff6347",
+  transparent: "transparent",
+  turquoise: "#40e0d0",
+  violet: "#ee82ee",
+  wheat: "#f5deb3",
+  white: "#ffffff",
+  whitesmoke: "#f5f5f5",
+  yellow: "#ffff00",
+  yellowgreen: "#9acd32",
+  // Additional modern colors
+  zinc: "#71717a",
+  stone: "#78716c",
+  neutral: "#737373",
+  slate: "#64748b",
+  gray50: "#f9fafb",
+  gray100: "#f3f4f6",
+  gray200: "#e5e7eb",
+  gray300: "#d1d5db",
+  gray400: "#9ca3af",
+  gray500: "#6b7280",
+  gray600: "#4b5563",
+  gray700: "#374151",
+  gray800: "#1f2937",
+  gray900: "#111827",
+  gray950: "#030712",
+  red50: "#fef2f2",
+  red100: "#fee2e2",
+  red200: "#fecaca",
+  red300: "#fca5a5",
+  red400: "#f87171",
+  red500: "#ef4444",
+  red600: "#dc2626",
+  red700: "#b91c1c",
+  red800: "#991b1b",
+  red900: "#7f1d1d",
+  red950: "#450a0a",
+  orange50: "#fff7ed",
+  orange100: "#ffedd5",
+  orange200: "#fed7aa",
+  orange300: "#fdba74",
+  orange400: "#fb923c",
+  orange500: "#f97316",
+  orange600: "#ea580c",
+  orange700: "#c2410c",
+  orange800: "#9a3412",
+  orange900: "#7c2d12",
+  orange950: "#431407",
+  amber50: "#fffbeb",
+  amber100: "#fef3c7",
+  amber200: "#fde68a",
+  amber300: "#fcd34d",
+  amber400: "#fbbf24",
+  amber500: "#f59e0b",
+  amber600: "#d97706",
+  amber700: "#b45309",
+  amber800: "#92400e",
+  amber900: "#78350f",
+  amber950: "#451a03",
+  yellow50: "#fefce8",
+  yellow100: "#fef9c3",
+  yellow200: "#fef08a",
+  yellow300: "#fde047",
+  yellow400: "#facc15",
+  yellow500: "#eab308",
+  yellow600: "#ca8a04",
+  yellow700: "#a16207",
+  yellow800: "#854d0e",
+  yellow900: "#713f12",
+  yellow950: "#422006",
+  lime50: "#f7fee7",
+  lime100: "#ecfccb",
+  lime200: "#d9f99d",
+  lime300: "#bef264",
+  lime400: "#a3e635",
+  lime500: "#84cc16",
+  lime600: "#65a30d",
+  lime700: "#4d7c0f",
+  lime800: "#3f6212",
+  lime900: "#365314",
+  lime950: "#1a2e05",
+  green50: "#f0fdf4",
+  green100: "#dcfce7",
+  green200: "#bbf7d0",
+  green300: "#86efac",
+  green400: "#4ade80",
+  green500: "#22c55e",
+  green600: "#16a34a",
+  green700: "#15803d",
+  green800: "#166534",
+  green900: "#14532d",
+  green950: "#052e16",
+  emerald50: "#ecfdf5",
+  emerald100: "#d1fae5",
+  emerald200: "#a7f3d0",
+  emerald300: "#6ee7b7",
+  emerald400: "#34d399",
+  emerald500: "#10b981",
+  emerald600: "#059669",
+  emerald700: "#047857",
+  emerald800: "#065f46",
+  emerald900: "#064e3b",
+  emerald950: "#022c22",
+  teal50: "#f0fdfa",
+  teal100: "#ccfbf1",
+  teal200: "#99f6e4",
+  teal300: "#5eead4",
+  teal400: "#2dd4bf",
+  teal500: "#14b8a6",
+  teal600: "#0d9488",
+  teal700: "#0f766e",
+  teal800: "#115e59",
+  teal900: "#134e4a",
+  teal950: "#042f2e",
+  cyan50: "#ecfeff",
+  cyan100: "#cffafe",
+  cyan200: "#a5f3fc",
+  cyan300: "#67e8f9",
+  cyan400: "#22d3ee",
+  cyan500: "#06b6d4",
+  cyan600: "#0891b2",
+  cyan700: "#0e7490",
+  cyan800: "#155e75",
+  cyan900: "#164e63",
+  cyan950: "#083344",
+  sky50: "#f0f9ff",
+  sky100: "#e0f2fe",
+  sky200: "#bae6fd",
+  sky300: "#7dd3fc",
+  sky400: "#38bdf8",
+  sky500: "#0ea5e9",
+  sky600: "#0284c7",
+  sky700: "#0369a1",
+  sky800: "#075985",
+  sky900: "#0c4a6e",
+  sky950: "#082f49",
+  blue50: "#eff6ff",
+  blue100: "#dbeafe",
+  blue200: "#bfdbfe",
+  blue300: "#93c5fd",
+  blue400: "#60a5fa",
+  blue500: "#3b82f6",
+  blue600: "#2563eb",
+  blue700: "#1d4ed8",
+  blue800: "#1e40af",
+  blue900: "#1e3a8a",
+  blue950: "#172554",
+  indigo50: "#eef2ff",
+  indigo100: "#e0e7ff",
+  indigo200: "#c7d2fe",
+  indigo300: "#a5b4fc",
+  indigo400: "#818cf8",
+  indigo500: "#6366f1",
+  indigo600: "#4f46e5",
+  indigo700: "#4338ca",
+  indigo800: "#3730a3",
+  indigo900: "#312e81",
+  indigo950: "#1e1b4b",
+  violet50: "#f5f3ff",
+  violet100: "#ede9fe",
+  violet200: "#ddd6fe",
+  violet300: "#c4b5fd",
+  violet400: "#a78bfa",
+  violet500: "#8b5cf6",
+  violet600: "#7c3aed",
+  violet700: "#6d28d9",
+  violet800: "#5b21b6",
+  violet900: "#4c1d95",
+  violet950: "#2e1065",
+  purple50: "#faf5ff",
+  purple100: "#f3e8ff",
+  purple200: "#e9d5ff",
+  purple300: "#d8b4fe",
+  purple400: "#c084fc",
+  purple500: "#a855f7",
+  purple600: "#9333ea",
+  purple700: "#7e22ce",
+  purple800: "#6b21a8",
+  purple900: "#581c87",
+  purple950: "#3b0764",
+  fuchsia50: "#fdf4ff",
+  fuchsia100: "#fae8ff",
+  fuchsia200: "#f5d0fe",
+  fuchsia300: "#f0abfc",
+  fuchsia400: "#e879f9",
+  fuchsia500: "#d946ef",
+  fuchsia600: "#c026d3",
+  fuchsia700: "#a21caf",
+  fuchsia800: "#86198f",
+  fuchsia900: "#701a75",
+  fuchsia950: "#4a044e",
+  pink50: "#fdf2f8",
+  pink100: "#fce7f3",
+  pink200: "#fbcfe8",
+  pink300: "#f9a8d4",
+  pink400: "#f472b6",
+  pink500: "#ec4899",
+  pink600: "#db2777",
+  pink700: "#be185d",
+  pink800: "#9d174d",
+  pink900: "#831843",
+  pink950: "#500724",
+  rose50: "#fff1f2",
+  rose100: "#ffe4e6",
+  rose200: "#fecdd3",
+  rose300: "#fda4af",
+  rose400: "#fb7185",
+  rose500: "#f43f5e",
+  rose600: "#e11d48",
+  rose700: "#be123c",
+  rose800: "#9f1239",
+  rose900: "#881337",
+  rose950: "#4c0519"
+};
+
+// src/lib/color/utils.ts
+var RGB_PATTERNS = {
+  /**
+   * Matches legacy comma-separated RGB
+   * @example rgb(255, 0, 0)
+   */
+  LEGACY_RGB: /^rgb\(\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*,\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*,\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*\)$/i,
+  /**
+   * Matches modern space-separated RGB
+   * @example rgb(255 0 0)
+   */
+  MODERN_RGB: /^rgb\(\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s+(\d{1,3}|\.\d+|\d+\.\d+%?)\s+(\d{1,3}|\.\d+|\d+\.\d+%?)\s*\)$/i,
+  /**
+   * Matches legacy comma-separated RGBA
+   * @example rgba(255, 0, 0, 0.5)
+   * @example rgba(255, 0, 0, 50%)
+   */
+  LEGACY_RGBA: /^rgba\(\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*,\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*,\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s*,\s*(0|1|0?\.\d+|\d{1,3}%?|\.\d+%?)\s*\)$/i,
+  /**
+   * Matches modern space-separated RGBA with slash
+   * @example rgb(255 0 0 / 0.5)
+   * @example rgb(255 0 0 / 50%)
+   * @example rgba(255 0 0 / 0.5)
+   */
+  MODERN_RGBA: /^rgba?\(\s*(\d{1,3}|\.\d+|\d+\.\d+%?)\s+(\d{1,3}|\.\d+|\d+\.\d+%?)\s+(\d{1,3}|\.\d+|\d+\.\d+%?)\s*\/\s*(0|1|0?\.\d+|\d{1,3}%?|\.\d+%?)\s*\)$/i,
+  /**
+   * Combined pattern that matches all RGB/RGBA variations
+   * Supports:
+   * - Legacy comma-separated: rgb(255, 0, 0), rgba(255, 0, 0, 0.5)
+   * - Modern space-separated: rgb(255 0 0), rgb(255 0 0 / 0.5)
+   * - Mixed separators: rgb(255,0,0), rgb(255 0 0)
+   * - Percentages: rgb(100% 0% 0%), rgb(100% 0% 0% / 50%)
+   * - Decimal numbers: rgb(255.5 0 0), rgba(255, 0, 0, 0.5)
+   * - CSS variables: rgb(var(--red) var(--green) var(--blue))
+   */
+  COMPREHENSIVE: /^rgba?\(\s*((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\)))\s*(?:[,\s]\s*((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\))))?\s*(?:[,\s]\s*((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\))))?\s*(?:(?:\s*[,\s]?\s*\/?\s*|\s*\/\s*)((?:0|1|0?\.\d+|\.\d+|\d{1,3}%?|var\([^)]+\))))?\s*\)$/i,
+  /**
+   * Strict RGB pattern with validation
+   * Matches integers (0-255) or percentages (0-100%)
+   */
+  STRICT_RGB: /^rgb\(\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*,\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*,\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*\)$/i,
+  /**
+   * Strict RGBA pattern with validation
+   */
+  STRICT_RGBA: /^rgba\(\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*,\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*,\s*((?:\d{1,2}|1\d{2}|2[0-4]\d|25[0-5]|\d{1,2}(?:\.\d+)?%|100%|\.\d+%?|var\([^)]+\)))\s*,\s*((?:0|1|0?\.\d+|\.\d+|\d{1,2}(?:\.\d+)?%|100%|var\([^)]+\)))\s*\)$/i,
+  /**
+   * Modern RGB with optional alpha
+   */
+  MODERN_RGB_ALPHA: /^rgba?\(\s*((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\)))\s+((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\)))\s+((?:\d{1,3}(?:\.\d+)?%?|\.\d+%?|var\([^)]+\)))\s*(?:\/\s*((?:0|1|0?\.\d+|\.\d+|\d{1,3}%?|var\([^)]+\))))?\s*\)$/i
+};
+var parseRgbaColor = (colorString) => {
+  const str = colorString.trim().toLowerCase();
+  if (!str || str.includes("var(")) {
+    return null;
+  }
+  const parseComponent = (component) => {
+    if (!component) return null;
+    const trimmed = component.trim();
+    if (!trimmed || trimmed.includes("var(")) return null;
+    if (trimmed.endsWith("%")) {
+      const percent = parseFloat(trimmed);
+      if (isNaN(percent)) return null;
+      const clamped = Math.max(0, Math.min(100, percent));
+      return Math.round(clamped * 255 / 100);
+    }
+    const num = parseFloat(trimmed);
+    if (isNaN(num)) return null;
+    return Math.round(Math.max(0, Math.min(255, num)));
+  };
+  const parseAlpha = (alpha) => {
+    if (!alpha) return 1;
+    const trimmed = alpha.trim();
+    if (!trimmed || trimmed.includes("var(")) return 1;
+    if (trimmed.endsWith("%")) {
+      const percent = parseFloat(trimmed);
+      if (isNaN(percent)) return 1;
+      return Math.max(0, Math.min(100, percent)) / 100;
+    }
+    const num = parseFloat(trimmed);
+    if (isNaN(num)) return 1;
+    return Math.max(0, Math.min(1, num));
+  };
+  const legacyCommaPattern = /^rgba?\(\s*([^,]+)\s*,\s*([^,]+)\s*,\s*([^,]+)\s*(?:,\s*([^\)]+))?\s*\)$/;
+  let match = str.match(legacyCommaPattern);
+  if (match) {
+    const r = parseComponent(match[1]);
+    const g = parseComponent(match[2]);
+    const b = parseComponent(match[3]);
+    const a = parseAlpha(match[4]);
+    if (r !== null && g !== null && b !== null) {
+      return [r, g, b, a];
+    }
+  }
+  const modernSlashPattern = /^rgba?\(\s*([^\s\/]+)\s+([^\s\/]+)\s+([^\s\/]+)\s*(?:\/\s*([^\)]+))?\s*\)$/;
+  match = str.match(modernSlashPattern);
+  if (match) {
+    const r = parseComponent(match[1]);
+    const g = parseComponent(match[2]);
+    const b = parseComponent(match[3]);
+    const a = parseAlpha(match[4]);
+    if (r !== null && g !== null && b !== null) {
+      return [r, g, b, a];
+    }
+  }
+  const modernSpacePattern = /^rgb\(\s*([^\s,]+)\s+([^\s,]+)\s+([^\s,]+)\s*\)$/;
+  match = str.match(modernSpacePattern);
+  if (match) {
+    const r = parseComponent(match[1]);
+    const g = parseComponent(match[2]);
+    const b = parseComponent(match[3]);
+    if (r !== null && g !== null && b !== null) {
+      return [r, g, b, 1];
+    }
+  }
+  return null;
+};
+var COLOR_PATTERNS = {
+  // Hex patterns (unchanged)
+  HEX: /^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/,
+  // RGB patterns (enhanced)
+  RGB: RGB_PATTERNS.COMPREHENSIVE,
+  // HSL patterns (supports both hsl and hsla)
+  HSL: /^hsla?\(\s*(\d+(?:\.\d+)?)(?:deg|rad|grad|turn)?\s*,\s*(\d+(?:\.\d+)?)%\s*,\s*(\d+(?:\.\d+)?)%(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // OKLCH pattern
+  OKLCH: /^oklch\(\s*(\d+(?:\.\d+)?%?)\s+(\d+(?:\.\d+)?)\s+(\d+(?:\.\d+)?)(?:\s+[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // OKLAB pattern
+  OKLAB: /^oklab\(\s*(\d+(?:\.\d+)?%?)\s+([+-]?\d+(?:\.\d+)?)\s+([+-]?\d+(?:\.\d+)?)(?:\s+[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // HSV pattern
+  HSV: /^hsv\(\s*(\d+(?:\.\d+)?)(?:deg|rad|grad|turn)?\s*,\s*(\d+(?:\.\d+)?)%\s*,\s*(\d+(?:\.\d+)?)%(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // CMYK pattern
+  CMYK: /^cmyk\(\s*(\d+(?:\.\d+)?)%\s*,\s*(\d+(?:\.\d+)?)%\s*,\s*(\d+(?:\.\d+)?)%\s*,\s*(\d+(?:\.\d+)?)%(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // CSS color() function
+  COLOR_FUNCTION: /^color\(\s*([a-z]+)\s+((?:\d+(?:\.\d+)?%?\s+)*\d+(?:\.\d+)?%?)(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // Lab color
+  LAB: /^lab\(\s*(\d+(?:\.\d+)?%?)\s+([+-]?\d+(?:\.\d+)?)\s+([+-]?\d+(?:\.\d+)?)(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i,
+  // LCH color
+  LCH: /^lch\(\s*(\d+(?:\.\d+)?%?)\s+(\d+(?:\.\d+)?)\s+(\d+(?:\.\d+)?)(?:\s*[,\s/]\s*(\d*\.?\d+%?))?\s*\)$/i
+};
+var testRgbaPatterns = (colorString) => {
+  const matches = [];
+  const str = colorString.trim();
+  Object.entries(RGB_PATTERNS).forEach(([name, pattern]) => {
+    if (pattern.test(str)) {
+      matches.push(name);
+    }
+  });
+  return matches;
+};
+var parseColor = (color) => {
+  if (!color || typeof color !== "string") {
+    return null;
+  }
+  const str = color.trim().toLowerCase();
+  if (!str) {
+    return null;
+  }
+  if (str === "transparent") {
+    return [0, 0, 0, 0];
+  }
+  const namedColor = str;
+  if (NAMED_COLORS[namedColor]) {
+    return parseColor(NAMED_COLORS[namedColor]);
+  }
+  const rgba = parseRgbaColor(str);
+  if (rgba) {
+    return rgba;
+  }
+  const hexMatch = str.match(COLOR_PATTERNS.HEX);
+  if (hexMatch) {
+    let hex = hexMatch[1];
+    if (hex.length === 3 || hex.length === 4) {
+      hex = hex.split("").map((c) => c + c).join("");
+    }
+    const r = parseInt(hex.substring(0, 2), 16);
+    const g = parseInt(hex.substring(2, 4), 16);
+    const b = parseInt(hex.substring(4, 6), 16);
+    const a = hex.length === 8 ? parseInt(hex.substring(6, 8), 16) / 255 : 1;
+    if (!isNaN(r) && !isNaN(g) && !isNaN(b) && !isNaN(a)) {
+      return [r, g, b, a];
+    }
+  }
+  const hslMatch = str.match(COLOR_PATTERNS.HSL);
+  if (hslMatch) {
+    const h = parseFloat(hslMatch[1]);
+    const s = parseFloat(hslMatch[2]) / 100;
+    const l = parseFloat(hslMatch[3]) / 100;
+    const a = hslMatch[4] ? parsePercentage(hslMatch[4]) : 1;
+    if (!isNaN(h) && !isNaN(s) && !isNaN(l) && !isNaN(a)) {
+      return hslToRgb(h, s, l, a);
+    }
+  }
+  const oklchMatch = str.match(COLOR_PATTERNS.OKLCH);
+  if (oklchMatch) {
+    const L = parsePercentage(oklchMatch[1]);
+    const C = parseFloat(oklchMatch[2]);
+    const H = parseFloat(oklchMatch[3]);
+    const a = oklchMatch[4] ? parsePercentage(oklchMatch[4]) : 1;
+    if (!isNaN(L) && !isNaN(C) && !isNaN(H) && !isNaN(a)) {
+      return oklchToRgb(L, C, H, a);
+    }
+  }
+  return null;
+};
+var hslToRgb = (h, s, l, a = 1) => {
+  h = h % 360;
+  if (h < 0) h += 360;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  const m = l - c / 2;
+  let r = 0, g = 0, b = 0;
+  if (h >= 0 && h < 60) {
+    [r, g, b] = [c, x, 0];
+  } else if (h >= 60 && h < 120) {
+    [r, g, b] = [x, c, 0];
+  } else if (h >= 120 && h < 180) {
+    [r, g, b] = [0, c, x];
+  } else if (h >= 180 && h < 240) {
+    [r, g, b] = [0, x, c];
+  } else if (h >= 240 && h < 300) {
+    [r, g, b] = [x, 0, c];
+  } else if (h >= 300 && h < 360) {
+    [r, g, b] = [c, 0, x];
+  }
+  return [
+    Math.round((r + m) * 255),
+    Math.round((g + m) * 255),
+    Math.round((b + m) * 255),
+    a
+  ];
+};
+var oklchToRgb = (L, C, H, a = 1) => {
+  const hue = H % 360;
+  const saturation = Math.min(100, C * 100);
+  const lightness = L * 100;
+  return hslToRgb(hue, saturation / 100, lightness / 100, a);
+};
+var formatRgba = (r, g, b, a = 1) => {
+  const isVariable = (value) => typeof value === "string" && value.includes("var(");
+  const isAlphaVariable = isVariable(a);
+  const hasAlpha = isAlphaVariable || typeof a === "number" && a !== 1;
+  if (hasAlpha) {
+    return `rgba(${r} ${g} ${b} / ${a})`;
+  }
+  return `rgb(${r} ${g} ${b})`;
+};
+var numToHex = (value) => {
+  const hex = Math.round(value).toString(16);
+  return hex.length === 1 ? `0${hex}` : hex;
+};
+var parsePercentage = (value) => {
+  if (value.endsWith("%")) {
+    return parseFloat(value) / 100;
+  }
+  return parseFloat(value);
+};
+var isValidColor = (color) => {
+  if (color.toLowerCase() in NAMED_COLORS) {
+    return true;
+  }
+  if (color.toLowerCase().trim().startsWith("rgb")) {
+    return parseRgbaColor(color) !== null;
+  }
+  const { RGB, ...otherPatterns } = COLOR_PATTERNS;
+  return Object.values(otherPatterns).some((pattern) => pattern.test(color));
+};
+var rgbaToHex = (r, g, b, a = 1) => {
+  const hex = `#${numToHex(r)}${numToHex(g)}${numToHex(b)}`;
+  return a < 1 ? `${hex}${numToHex(Math.round(a * 255))}` : hex;
+};
+var rgbaToHsl = (r, g, b, a = 1) => {
+  const rNorm = r / 255;
+  const gNorm = g / 255;
+  const bNorm = b / 255;
+  const max = Math.max(rNorm, gNorm, bNorm);
+  const min = Math.min(rNorm, gNorm, bNorm);
+  let h = 0;
+  let s = 0;
+  const l = (max + min) / 2;
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    switch (max) {
+      case rNorm:
+        h = (gNorm - bNorm) / d + (gNorm < bNorm ? 6 : 0);
+        break;
+      case gNorm:
+        h = (bNorm - rNorm) / d + 2;
+        break;
+      case bNorm:
+        h = (rNorm - gNorm) / d + 4;
+        break;
+    }
+    h /= 6;
+  }
+  h = Math.round(h * 360);
+  s = Math.round(s * 100);
+  const lPercent = Math.round(l * 100);
+  if (a === 1) {
+    return `hsl(${h}, ${s}%, ${lPercent}%)`;
+  }
+  return `hsla(${h}, ${s}%, ${lPercent}%, ${a})`;
+};
+var rgbaToHsv = (r, g, b, a = 1) => {
+  const rNorm = r / 255;
+  const gNorm = g / 255;
+  const bNorm = b / 255;
+  const max = Math.max(rNorm, gNorm, bNorm);
+  const min = Math.min(rNorm, gNorm, bNorm);
+  const d = max - min;
+  let h = 0;
+  if (d !== 0) {
+    switch (max) {
+      case rNorm:
+        h = (gNorm - bNorm) / d + (gNorm < bNorm ? 6 : 0);
+        break;
+      case gNorm:
+        h = (bNorm - rNorm) / d + 2;
+        break;
+      case bNorm:
+        h = (rNorm - gNorm) / d + 4;
+        break;
+    }
+    h /= 6;
+  }
+  const s = max === 0 ? 0 : d / max;
+  const v = max;
+  h = Math.round(h * 360);
+  const sPercent = Math.round(s * 100);
+  const vPercent = Math.round(v * 100);
+  if (a === 1) {
+    return `hsv(${h}, ${sPercent}%, ${vPercent}%)`;
+  }
+  return `hsva(${h}, ${sPercent}%, ${vPercent}%, ${a})`;
+};
+var rgbaToCmyk = (r, g, b, a = 1) => {
+  if (r === 0 && g === 0 && b === 0) {
+    return `cmyk(0%, 0%, 0%, 100%)`;
+  }
+  const rNorm = r / 255;
+  const gNorm = g / 255;
+  const bNorm = b / 255;
+  const k = 1 - Math.max(rNorm, gNorm, bNorm);
+  const c = (1 - rNorm - k) / (1 - k);
+  const m = (1 - gNorm - k) / (1 - k);
+  const y = (1 - bNorm - k) / (1 - k);
+  const cPercent = Math.round(c * 100);
+  const mPercent = Math.round(m * 100);
+  const yPercent = Math.round(y * 100);
+  const kPercent = Math.round(k * 100);
+  return `cmyk(${cPercent}%, ${mPercent}%, ${yPercent}%, ${kPercent}%)`;
+};
+var calculateLuminance = (r, g, b) => {
+  const [rs, gs, bs] = [r, g, b].map((c) => {
+    c = c / 255;
+    return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+  });
+  return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+};
+var calculateContrastRatio = (color1, color2) => {
+  const rgb1 = parseColor(color1);
+  const rgb2 = parseColor(color2);
+  if (!rgb1 || !rgb2) {
+    return 1;
+  }
+  const l1 = calculateLuminance(rgb1[0], rgb1[1], rgb1[2]);
+  const l2 = calculateLuminance(rgb2[0], rgb2[1], rgb2[2]);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
+};
+var adjustColor = (color, options) => {
+  const rgb = parseColor(color);
+  if (!rgb) return color;
+  let [r, g, b, a] = rgb;
+  if (options.alpha !== void 0) {
+    a = Math.max(0, Math.min(1, options.alpha));
+  }
+  let h = 0, s = 0, l = 0;
+  if (options.lightness !== void 0 || options.saturation !== void 0 || options.hue !== void 0) {
+    const rNorm = r / 255;
+    const gNorm = g / 255;
+    const bNorm = b / 255;
+    const max = Math.max(rNorm, gNorm, bNorm);
+    const min = Math.min(rNorm, gNorm, bNorm);
+    l = (max + min) / 2;
+    if (max !== min) {
+      const d = max - min;
+      s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+      switch (max) {
+        case rNorm:
+          h = (gNorm - bNorm) / d + (gNorm < bNorm ? 6 : 0);
+          break;
+        case gNorm:
+          h = (bNorm - rNorm) / d + 2;
+          break;
+        case bNorm:
+          h = (rNorm - gNorm) / d + 4;
+          break;
+      }
+      h /= 6;
+    }
+    h *= 360;
+    s *= 100;
+    l *= 100;
+    if (options.hue !== void 0) {
+      h = (h + options.hue) % 360;
+      if (h < 0) h += 360;
+    }
+    if (options.saturation !== void 0) {
+      s = Math.max(0, Math.min(100, s + options.saturation));
+    }
+    if (options.lightness !== void 0) {
+      l = Math.max(0, Math.min(100, l + options.lightness));
+    }
+    const hNorm = h / 360;
+    const sNorm = s / 100;
+    const lNorm = l / 100;
+    const chroma = (1 - Math.abs(2 * lNorm - 1)) * sNorm;
+    const x = chroma * (1 - Math.abs(hNorm * 6 % 2 - 1));
+    const m = lNorm - chroma / 2;
+    let rNorm2 = 0, gNorm2 = 0, bNorm2 = 0;
+    if (hNorm < 1 / 6) {
+      [rNorm2, gNorm2, bNorm2] = [chroma, x, 0];
+    } else if (hNorm < 2 / 6) {
+      [rNorm2, gNorm2, bNorm2] = [x, chroma, 0];
+    } else if (hNorm < 3 / 6) {
+      [rNorm2, gNorm2, bNorm2] = [0, chroma, x];
+    } else if (hNorm < 4 / 6) {
+      [rNorm2, gNorm2, bNorm2] = [0, x, chroma];
+    } else if (hNorm < 5 / 6) {
+      [rNorm2, gNorm2, bNorm2] = [x, 0, chroma];
+    } else {
+      [rNorm2, gNorm2, bNorm2] = [chroma, 0, x];
+    }
+    r = Math.round((rNorm2 + m) * 255);
+    g = Math.round((gNorm2 + m) * 255);
+    b = Math.round((bNorm2 + m) * 255);
+  }
+  if (options.contrast !== void 0) {
+    const factor = options.contrast / 100 * 2.55;
+    const avg = (r + g + b) / 3;
+    r = Math.round(avg + (r - avg) * (1 + factor));
+    g = Math.round(avg + (g - avg) * (1 + factor));
+    b = Math.round(avg + (b - avg) * (1 + factor));
+    r = Math.max(0, Math.min(255, r));
+    g = Math.max(0, Math.min(255, g));
+    b = Math.max(0, Math.min(255, b));
+  }
+  return rgbaToHex(r, g, b, a);
+};
+var mixColors = (options) => {
+  const {
+    color,
+    with: mixColor = "transparent",
+    percentage = 50,
+    colorSpace = "srgb"
+  } = options;
+  const rgb1 = parseColor(color);
+  const rgb2 = parseColor(mixColor);
+  if (!rgb1 || !rgb2) {
+    return color;
+  }
+  const factor = percentage / 100;
+  let [r1, g1, b1, a1] = rgb1;
+  let [r2, g2, b2, a2] = rgb2;
+  if (options.opacity !== void 0) {
+    a1 = typeof options.opacity === "number" ? options.opacity : parsePercentage(options.opacity);
+  }
+  if (options.withOpacity !== void 0) {
+    a2 = typeof options.withOpacity === "number" ? options.withOpacity : parsePercentage(options.withOpacity);
+  }
+  switch (colorSpace) {
+    case "srgb":
+    default:
+      const r = Math.round(r1 + (r2 - r1) * factor);
+      const g = Math.round(g1 + (g2 - g1) * factor);
+      const b = Math.round(b1 + (b2 - b1) * factor);
+      const a = a1 + (a2 - a1) * factor;
+      return rgbaToHex(r, g, b, a);
+    case "hsl":
+      const hsl1 = parseColor(rgbaToHsl(r1, g1, b1, a1));
+      const hsl2 = parseColor(rgbaToHsl(r2, g2, b2, a2));
+      if (!hsl1 || !hsl2) {
+        return color;
+      }
+      const h = (hsl1[0] + (hsl2[0] - hsl1[0]) * factor) % 360;
+      const s = hsl1[1] + (hsl2[1] - hsl1[1]) * factor;
+      const l = hsl1[2] + (hsl2[2] - hsl1[2]) * factor;
+      return `hsl(${h}, ${s}%, ${l}%)`;
+  }
+};
+var generatePalette = (baseColor, options = {}) => {
+  const rgb = parseColor(baseColor);
+  if (!rgb) return {};
+  const shades = options.shades || 10;
+  const lightnessFactor = options.lightnessFactor || 0.1;
+  const saturationFactor = options.saturationFactor || 0.05;
+  const palette = {};
+  for (let i = 0; i < shades; i++) {
+    const position = i / (shades - 1);
+    const lightnessAdjustment = (position - 0.5) * 2 * lightnessFactor * 100;
+    const shadeColor = adjustColor(baseColor, {
+      lightness: lightnessAdjustment,
+      saturation: (position - 0.5) * 2 * saturationFactor * 100
+    });
+    const key = i === 0 ? "50" : `${i * 100}`;
+    palette[key] = shadeColor;
+  }
+  if (options.includeComplementary) {
+    const hsl = parseColor(rgbaToHsl(rgb[0], rgb[1], rgb[2]));
+    if (hsl) {
+      let h = hsl[0];
+      h = (h + 180) % 360;
+      palette.complementary = `hsl(${h}, ${hsl[1]}%, ${hsl[2]}%)`;
+    }
+  }
+  if (options.includeAnalogous) {
+    const hsl = parseColor(rgbaToHsl(rgb[0], rgb[1], rgb[2]));
+    if (hsl) {
+      let h = hsl[0];
+      palette.analogous1 = `hsl(${(h - 30 + 360) % 360}, ${hsl[1]}%, ${hsl[2]}%)`;
+      palette.analogous2 = `hsl(${(h + 30) % 360}, ${hsl[1]}%, ${hsl[2]}%)`;
+    }
+  }
+  if (options.includeTriadic) {
+    const hsl = parseColor(rgbaToHsl(rgb[0], rgb[1], rgb[2]));
+    if (hsl) {
+      let h = hsl[0];
+      palette.triadic1 = `hsl(${(h + 120) % 360}, ${hsl[1]}%, ${hsl[2]}%)`;
+      palette.triadic2 = `hsl(${(h + 240) % 360}, ${hsl[1]}%, ${hsl[2]}%)`;
+    }
+  }
+  return palette;
+};
+var createContrastColor = (color, options = {}) => {
+  const {
+    lightColor = "#ffffff",
+    darkColor = "#000000",
+    targetRatio = 4.5,
+    fallbackColor = "#000000"
+  } = options;
+  const rgb = parseColor(color);
+  if (!rgb) return fallbackColor;
+  const luminance = calculateLuminance(rgb[0], rgb[1], rgb[2]);
+  const lightLuminance = calculateLuminance(
+    ...parseColor(lightColor).slice(0, 3)
+  );
+  const darkLuminance = calculateLuminance(
+    ...parseColor(darkColor).slice(0, 3)
+  );
+  const lightContrast = (Math.max(luminance, lightLuminance) + 0.05) / (Math.min(luminance, lightLuminance) + 0.05);
+  const darkContrast = (Math.max(luminance, darkLuminance) + 0.05) / (Math.min(luminance, darkLuminance) + 0.05);
+  if (lightContrast >= targetRatio && darkContrast >= targetRatio) {
+    return lightContrast > darkContrast ? lightColor : darkColor;
+  } else if (lightContrast >= targetRatio) {
+    return lightColor;
+  } else if (darkContrast >= targetRatio) {
+    return darkColor;
+  }
+  return lightContrast > darkContrast ? lightColor : darkColor;
+};
+export {
+  COLOR_PATTERNS,
+  RGB_PATTERNS,
+  adjustColor,
+  calculateContrastRatio,
+  calculateLuminance,
+  createContrastColor,
+  formatRgba,
+  generatePalette,
+  hslToRgb,
+  isValidColor,
+  mixColors,
+  oklchToRgb,
+  parseColor,
+  parseRgbaColor,
+  rgbaToCmyk,
+  rgbaToHex,
+  rgbaToHsl,
+  rgbaToHsv,
+  testRgbaPatterns
+};