@tachui/core 0.7.0-alpha1

package/dist/gradients/utils.js

@@ -0,0 +1,385 @@
+import { LinearGradient as i, AngularGradient as P, RadialGradient as v } from "./index.js";
+import { gradientToCSS as f } from "./css-generator.js";
+const e = {
+  /**
+   * Parse hex color to RGB components
+   */
+  hexToRgb: (t) => {
+    const o = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(t);
+    return o ? {
+      r: parseInt(o[1], 16),
+      g: parseInt(o[2], 16),
+      b: parseInt(o[3], 16)
+    } : null;
+  },
+  /**
+   * Convert RGB to hex
+   */
+  rgbToHex: (t, o, r) => "#" + ((1 << 24) + (t << 16) + (o << 8) + r).toString(16).slice(1),
+  /**
+   * Add transparency to a color
+   */
+  withAlpha: (t, o) => {
+    if (t.startsWith("#")) {
+      const r = e.hexToRgb(t);
+      if (r)
+        return `rgba(${r.r}, ${r.g}, ${r.b}, ${o})`;
+    }
+    return t.startsWith("rgb(") ? t.replace("rgb(", "rgba(").replace(")", `, ${o})`) : t.startsWith("rgba(") ? t.replace(/,\s*[\d.]+\)$/, `, ${o})`) : t;
+  },
+  /**
+   * Blend two colors
+   */
+  blendColors: (t, o, r = 0.5) => {
+    const n = e.hexToRgb(t), s = e.hexToRgb(o);
+    if (!n || !s) return t;
+    const l = Math.round(n.r * (1 - r) + s.r * r), p = Math.round(n.g * (1 - r) + s.g * r), u = Math.round(n.b * (1 - r) + s.b * r);
+    return e.rgbToHex(l, p, u);
+  },
+  /**
+   * Generate color variations (lighter/darker)
+   */
+  lighten: (t, o = 0.2) => e.blendColors(t, "#ffffff", o),
+  darken: (t, o = 0.2) => e.blendColors(t, "#000000", o),
+  /**
+   * Generate complementary color
+   */
+  complement: (t) => {
+    const o = e.hexToRgb(t);
+    return o ? e.rgbToHex(255 - o.r, 255 - o.g, 255 - o.b) : t;
+  },
+  /**
+   * Get contrast ratio between two colors
+   */
+  getContrastRatio: (t, o) => {
+    const r = (u) => {
+      const c = e.hexToRgb(u);
+      if (!c) return 0;
+      const [h, b, m] = [c.r, c.g, c.b].map((a) => (a = a / 255, a <= 0.03928 ? a / 12.92 : Math.pow((a + 0.055) / 1.055, 2.4)));
+      return 0.2126 * h + 0.7152 * b + 0.0722 * m;
+    }, n = r(t), s = r(o), l = Math.max(n, s), p = Math.min(n, s);
+    return (l + 0.05) / (p + 0.05);
+  }
+}, d = {
+  /**
+   * Reverse gradient colors
+   */
+  reverse: (t) => {
+    const o = { ...t };
+    return "colors" in o.options && (o.options = {
+      ...o.options,
+      colors: [...o.options.colors].reverse(),
+      stops: o.options.stops ? [...o.options.stops].reverse() : void 0
+    }), o;
+  },
+  /**
+   * Rotate linear gradient direction
+   */
+  rotateLinear: (t, o) => {
+    if (t.type !== "linear") return t;
+    const r = t.options;
+    return {
+      ...t,
+      options: {
+        ...r,
+        angle: (r.angle || 0) + o
+      }
+    };
+  },
+  /**
+   * Scale radial gradient
+   */
+  scaleRadial: (t, o) => {
+    if (t.type !== "radial") return t;
+    const r = t.options;
+    return {
+      ...t,
+      options: {
+        ...r,
+        startRadius: r.startRadius * o,
+        endRadius: r.endRadius * o
+      }
+    };
+  },
+  /**
+   * Add transparency to entire gradient
+   */
+  withOpacity: (t, o) => {
+    const r = { ...t };
+    return "colors" in r.options && (r.options = {
+      ...r.options,
+      colors: r.options.colors.map(
+        (n) => typeof n == "string" ? e.withAlpha(n, o) : n
+      )
+    }), r;
+  },
+  /**
+   * Mirror a linear gradient (swap start and end points)
+   */
+  mirror: (t) => {
+    if (t.type !== "linear") return t;
+    const o = t.options;
+    return {
+      ...t,
+      options: {
+        ...o,
+        startPoint: o.endPoint,
+        endPoint: o.startPoint
+      }
+    };
+  },
+  /**
+   * Convert linear gradient to radial
+   */
+  toRadial: (t, o = 100) => {
+    if (t.type !== "linear") return t;
+    const r = t.options;
+    return v({
+      colors: r.colors,
+      stops: r.stops,
+      center: "center",
+      startRadius: 0,
+      endRadius: o
+    });
+  },
+  /**
+   * Convert to angular/conic gradient
+   */
+  toAngular: (t) => "colors" in t.options ? P({
+    colors: t.options.colors,
+    stops: t.options.stops,
+    center: "center",
+    startAngle: 0,
+    endAngle: 360
+  }) : t
+}, g = {
+  /**
+   * Get gradient color count
+   */
+  getColorCount: (t) => "colors" in t.options ? t.options.colors.length : 0,
+  /**
+   * Extract colors from gradient
+   */
+  extractColors: (t) => "colors" in t.options ? [...t.options.colors] : [],
+  /**
+   * Get gradient complexity score (for performance optimization)
+   */
+  getComplexityScore: (t) => {
+    let o = 0;
+    switch ("colors" in t.options && (o += t.options.colors.length * 2, o += t.options.stops ? t.options.stops.length : 0), t.type) {
+      case "linear":
+        o += 1;
+        break;
+      case "radial":
+        o += 3;
+        break;
+      case "angular":
+        o += 4;
+        break;
+      case "repeating-linear":
+        o += 5;
+        break;
+      case "repeating-radial":
+        o += 6;
+        break;
+    }
+    return o;
+  },
+  /**
+   * Check if gradient has transparency
+   */
+  hasTransparency: (t) => "colors" in t.options ? t.options.colors.some(
+    (o) => typeof o == "string" && (o.includes("rgba") || o.includes("transparent") || o.includes("hsla"))
+  ) : !1,
+  /**
+   * Estimate rendering performance impact
+   */
+  getPerformanceImpact: (t) => {
+    const o = g.getComplexityScore(t);
+    return o <= 5 ? "low" : o <= 10 ? "medium" : "high";
+  }
+}, y = {
+  /**
+   * Generate rainbow gradient
+   */
+  rainbow: (t = 6) => {
+    const o = [];
+    for (let r = 0; r < t; r++) {
+      const n = r * 360 / t;
+      o.push(`hsl(${n}, 100%, 50%)`);
+    }
+    return i({
+      colors: o,
+      startPoint: "leading",
+      endPoint: "trailing"
+    });
+  },
+  /**
+   * Generate monochromatic gradient
+   */
+  monochromatic: (t, o = 5) => {
+    const r = [];
+    for (let n = 0; n < o; n++) {
+      const s = n / (o - 1);
+      s < 0.5 ? r.push(e.lighten(t, 0.4 - s * 0.8)) : r.push(e.darken(t, (s - 0.5) * 0.8));
+    }
+    return i({
+      colors: r,
+      startPoint: "top",
+      endPoint: "bottom"
+    });
+  },
+  /**
+   * Generate analogous color gradient
+   */
+  analogous: (t, o = 60) => i({
+    colors: [t, e.lighten(t, 0.2), e.darken(t, 0.2)],
+    startPoint: "topLeading",
+    endPoint: "bottomTrailing"
+  }),
+  /**
+   * Generate complementary gradient
+   */
+  complementary: (t, o) => {
+    const r = o || e.complement(t);
+    return i({
+      colors: [t, r],
+      startPoint: "topLeading",
+      endPoint: "bottomTrailing"
+    });
+  },
+  /**
+   * Generate sunset gradient
+   */
+  sunset: () => i({
+    colors: ["#ff7e5f", "#feb47b", "#ff6b6b", "#c44569"],
+    startPoint: "top",
+    endPoint: "bottom"
+  }),
+  /**
+   * Generate ocean gradient
+   */
+  ocean: () => i({
+    colors: ["#667eea", "#764ba2", "#667eea"],
+    startPoint: "topLeading",
+    endPoint: "bottomTrailing"
+  })
+}, S = {
+  /**
+   * Create hover effect gradient
+   */
+  createHoverEffect: (t, o = 0.1) => {
+    const r = d.withOpacity(
+      d.reverse(t),
+      1 - o
+    );
+    return {
+      default: t,
+      hover: r,
+      animation: {
+        duration: 200,
+        easing: "ease-out"
+      }
+    };
+  },
+  /**
+   * Create button gradient states
+   */
+  createButtonStates: (t, o = "primary") => {
+    const n = {
+      primary: { base: t, hover: e.lighten(t, 0.1), active: e.darken(t, 0.1) },
+      secondary: { base: "#f8f9fa", hover: "#e9ecef", active: "#dee2e6" },
+      danger: { base: "#dc3545", hover: e.lighten("#dc3545", 0.1), active: e.darken("#dc3545", 0.1) }
+    }[o];
+    return {
+      default: i({
+        colors: [n.base, e.darken(n.base, 0.05)],
+        startPoint: "top",
+        endPoint: "bottom"
+      }),
+      hover: i({
+        colors: [n.hover, e.darken(n.hover, 0.05)],
+        startPoint: "top",
+        endPoint: "bottom"
+      }),
+      active: i({
+        colors: [n.active, e.darken(n.active, 0.05)],
+        startPoint: "top",
+        endPoint: "bottom"
+      }),
+      disabled: "#cccccc",
+      animation: {
+        duration: 150,
+        easing: "ease-out"
+      }
+    };
+  },
+  /**
+   * Create card hover effect
+   */
+  createCardHover: (t = "#ffffff") => ({
+    default: t,
+    hover: i({
+      colors: [
+        e.withAlpha("#ffffff", 0.1),
+        e.withAlpha("#f8f9fa", 0.1)
+      ],
+      startPoint: "topLeading",
+      endPoint: "bottomTrailing"
+    }),
+    animation: {
+      duration: 200,
+      easing: "ease"
+    }
+  })
+}, x = {
+  /**
+   * Generate CSS custom properties for gradient
+   */
+  toCustomProperties: (t, o = "gradient") => {
+    const r = f(t);
+    return {
+      [`--${o}-background`]: r
+    };
+  },
+  /**
+   * Generate fallback CSS for older browsers
+   */
+  withFallback: (t, o) => {
+    const r = f(t);
+    return `background: ${o}; background: ${r};`;
+  },
+  /**
+   * Optimize CSS for performance
+   */
+  optimize: (t) => t.replace(/\s+/g, " ").replace(/,\s+/g, ",").replace(/:\s+/g, ":").trim()
+}, R = {
+  ...e,
+  ...d,
+  ...g,
+  ...y,
+  ...S,
+  ...x,
+  /**
+   * Convert any background value to CSS
+   */
+  toCSS: (t) => typeof t == "string" ? t : "resolve" in t && typeof t.resolve == "function" ? t.resolve() : "type" in t && "options" in t ? f(t) : "default" in t ? R.toCSS(t.default) : "transparent",
+  /**
+   * Deep clone gradient definition
+   */
+  clone: (t) => JSON.parse(JSON.stringify(t)),
+  /**
+   * Compare two gradients for equality
+   */
+  equals: (t, o) => JSON.stringify(t) === JSON.stringify(o)
+};
+export {
+  x as CSSUtils,
+  e as ColorUtils,
+  g as GradientAnalysis,
+  y as GradientGenerators,
+  d as GradientTransforms,
+  R as GradientUtils,
+  S as StateGradientUtils
+};
+//# sourceMappingURL=utils.js.map

package/dist/gradients/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../src/gradients/utils.ts"],"sourcesContent":["/**\n * Gradient Utility Functions and Helper Methods\n * \n * Comprehensive utilities for gradient manipulation, analysis, and transformation.\n */\n\nimport type { Asset } from '../assets/types'\nimport type {\n  GradientDefinition,\n  LinearGradientOptions,\n  RadialGradientOptions,\n  StateGradientOptions,\n  StatefulBackgroundValue\n} from './types'\nimport { LinearGradient, RadialGradient, AngularGradient } from './index'\nimport { gradientToCSS } from './css-generator'\n\n/**\n * Color manipulation utilities\n */\nexport const ColorUtils = {\n  /**\n   * Parse hex color to RGB components\n   */\n  hexToRgb: (hex: string): { r: number; g: number; b: number } | null => {\n    const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex)\n    return result ? {\n      r: parseInt(result[1], 16),\n      g: parseInt(result[2], 16),\n      b: parseInt(result[3], 16)\n    } : null\n  },\n\n  /**\n   * Convert RGB to hex\n   */\n  rgbToHex: (r: number, g: number, b: number): string => {\n    return \"#\" + ((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1)\n  },\n\n  /**\n   * Add transparency to a color\n   */\n  withAlpha: (color: string, alpha: number): string => {\n    if (color.startsWith('#')) {\n      const rgb = ColorUtils.hexToRgb(color)\n      if (rgb) {\n        return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${alpha})`\n      }\n    }\n    if (color.startsWith('rgb(')) {\n      return color.replace('rgb(', 'rgba(').replace(')', `, ${alpha})`)\n    }\n    if (color.startsWith('rgba(')) {\n      // Replace existing alpha\n      return color.replace(/,\\s*[\\d.]+\\)$/, `, ${alpha})`)\n    }\n    return color\n  },\n\n  /**\n   * Blend two colors\n   */\n  blendColors: (color1: string, color2: string, ratio: number = 0.5): string => {\n    const rgb1 = ColorUtils.hexToRgb(color1)\n    const rgb2 = ColorUtils.hexToRgb(color2)\n    \n    if (!rgb1 || !rgb2) return color1\n    \n    const r = Math.round(rgb1.r * (1 - ratio) + rgb2.r * ratio)\n    const g = Math.round(rgb1.g * (1 - ratio) + rgb2.g * ratio)\n    const b = Math.round(rgb1.b * (1 - ratio) + rgb2.b * ratio)\n    \n    return ColorUtils.rgbToHex(r, g, b)\n  },\n\n  /**\n   * Generate color variations (lighter/darker)\n   */\n  lighten: (color: string, amount: number = 0.2): string => {\n    return ColorUtils.blendColors(color, '#ffffff', amount)\n  },\n\n  darken: (color: string, amount: number = 0.2): string => {\n    return ColorUtils.blendColors(color, '#000000', amount)\n  },\n\n  /**\n   * Generate complementary color\n   */\n  complement: (color: string): string => {\n    const rgb = ColorUtils.hexToRgb(color)\n    if (!rgb) return color\n    \n    return ColorUtils.rgbToHex(255 - rgb.r, 255 - rgb.g, 255 - rgb.b)\n  },\n\n  /**\n   * Get contrast ratio between two colors\n   */\n  getContrastRatio: (color1: string, color2: string): number => {\n    const getLuminance = (color: string): number => {\n      const rgb = ColorUtils.hexToRgb(color)\n      if (!rgb) return 0\n      \n      const [r, g, b] = [rgb.r, rgb.g, rgb.b].map(c => {\n        c = c / 255\n        return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4)\n      })\n      \n      return 0.2126 * r + 0.7152 * g + 0.0722 * b\n    }\n    \n    const lum1 = getLuminance(color1)\n    const lum2 = getLuminance(color2)\n    const brightest = Math.max(lum1, lum2)\n    const darkest = Math.min(lum1, lum2)\n    \n    return (brightest + 0.05) / (darkest + 0.05)\n  }\n} as const\n\n/**\n * Gradient transformation utilities\n */\nexport const GradientTransforms = {\n  /**\n   * Reverse gradient colors\n   */\n  reverse: <T extends GradientDefinition>(gradient: T): T => {\n    const newGradient = { ...gradient }\n    if ('colors' in newGradient.options) {\n      newGradient.options = {\n        ...newGradient.options,\n        colors: [...newGradient.options.colors].reverse(),\n        stops: newGradient.options.stops ? [...newGradient.options.stops].reverse() : undefined\n      }\n    }\n    return newGradient\n  },\n\n  /**\n   * Rotate linear gradient direction\n   */\n  rotateLinear: (gradient: GradientDefinition, degrees: number): GradientDefinition => {\n    if (gradient.type !== 'linear') return gradient\n    \n    const options = gradient.options as LinearGradientOptions\n    return {\n      ...gradient,\n      options: {\n        ...options,\n        angle: (options.angle || 0) + degrees\n      }\n    }\n  },\n\n  /**\n   * Scale radial gradient\n   */\n  scaleRadial: (gradient: GradientDefinition, scale: number): GradientDefinition => {\n    if (gradient.type !== 'radial') return gradient\n    \n    const options = gradient.options as RadialGradientOptions\n    return {\n      ...gradient,\n      options: {\n        ...options,\n        startRadius: options.startRadius * scale,\n        endRadius: options.endRadius * scale\n      }\n    }\n  },\n\n  /**\n   * Add transparency to entire gradient\n   */\n  withOpacity: (gradient: GradientDefinition, opacity: number): GradientDefinition => {\n    const newGradient = { ...gradient }\n    if ('colors' in newGradient.options) {\n      newGradient.options = {\n        ...newGradient.options,\n        colors: newGradient.options.colors.map(color => \n          typeof color === 'string' ? ColorUtils.withAlpha(color, opacity) : color\n        )\n      }\n    }\n    return newGradient\n  },\n\n  /**\n   * Mirror a linear gradient (swap start and end points)\n   */\n  mirror: (gradient: GradientDefinition): GradientDefinition => {\n    if (gradient.type !== 'linear') return gradient\n    \n    const options = gradient.options as LinearGradientOptions\n    return {\n      ...gradient,\n      options: {\n        ...options,\n        startPoint: options.endPoint,\n        endPoint: options.startPoint\n      }\n    }\n  },\n\n  /**\n   * Convert linear gradient to radial\n   */\n  toRadial: (gradient: GradientDefinition, radius: number = 100): GradientDefinition => {\n    if (gradient.type !== 'linear') return gradient\n    \n    const options = gradient.options as LinearGradientOptions\n    return RadialGradient({\n      colors: options.colors,\n      stops: options.stops,\n      center: 'center',\n      startRadius: 0,\n      endRadius: radius\n    })\n  },\n\n  /**\n   * Convert to angular/conic gradient\n   */\n  toAngular: (gradient: GradientDefinition): GradientDefinition => {\n    if ('colors' in gradient.options) {\n      return AngularGradient({\n        colors: gradient.options.colors,\n        stops: gradient.options.stops,\n        center: 'center',\n        startAngle: 0,\n        endAngle: 360\n      })\n    }\n    return gradient\n  }\n} as const\n\n/**\n * Gradient analysis utilities\n */\nexport const GradientAnalysis = {\n  /**\n   * Get gradient color count\n   */\n  getColorCount: (gradient: GradientDefinition): number => {\n    if ('colors' in gradient.options) {\n      return gradient.options.colors.length\n    }\n    return 0\n  },\n\n  /**\n   * Extract colors from gradient\n   */\n  extractColors: (gradient: GradientDefinition): (string | Asset)[] => {\n    if ('colors' in gradient.options) {\n      return [...gradient.options.colors]\n    }\n    return []\n  },\n\n  /**\n   * Get gradient complexity score (for performance optimization)\n   */\n  getComplexityScore: (gradient: GradientDefinition): number => {\n    let score = 0\n    \n    if ('colors' in gradient.options) {\n      score += gradient.options.colors.length * 2\n      score += gradient.options.stops ? gradient.options.stops.length : 0\n    }\n    \n    // Add complexity for gradient type\n    switch (gradient.type) {\n      case 'linear': score += 1; break\n      case 'radial': score += 3; break\n      case 'angular': score += 4; break\n      case 'repeating-linear': score += 5; break\n      case 'repeating-radial': score += 6; break\n    }\n    \n    return score\n  },\n\n  /**\n   * Check if gradient has transparency\n   */\n  hasTransparency: (gradient: GradientDefinition): boolean => {\n    if ('colors' in gradient.options) {\n      return gradient.options.colors.some(color => \n        typeof color === 'string' && (\n          color.includes('rgba') || \n          color.includes('transparent') ||\n          color.includes('hsla')\n        )\n      )\n    }\n    return false\n  },\n\n  /**\n   * Estimate rendering performance impact\n   */\n  getPerformanceImpact: (gradient: GradientDefinition): 'low' | 'medium' | 'high' => {\n    const complexity = GradientAnalysis.getComplexityScore(gradient)\n    \n    if (complexity <= 5) return 'low'\n    if (complexity <= 10) return 'medium'\n    return 'high'\n  }\n} as const\n\n/**\n * Gradient generation utilities\n */\nexport const GradientGenerators = {\n  /**\n   * Generate rainbow gradient\n   */\n  rainbow: (steps: number = 6): GradientDefinition => {\n    const colors: string[] = []\n    for (let i = 0; i < steps; i++) {\n      const hue = (i * 360) / steps\n      colors.push(`hsl(${hue}, 100%, 50%)`)\n    }\n    \n    return LinearGradient({\n      colors,\n      startPoint: 'leading',\n      endPoint: 'trailing'\n    })\n  },\n\n  /**\n   * Generate monochromatic gradient\n   */\n  monochromatic: (baseColor: string, steps: number = 5): GradientDefinition => {\n    const colors: string[] = []\n    \n    for (let i = 0; i < steps; i++) {\n      const ratio = i / (steps - 1)\n      if (ratio < 0.5) {\n        // Lighter variants\n        colors.push(ColorUtils.lighten(baseColor, 0.4 - ratio * 0.8))\n      } else {\n        // Darker variants\n        colors.push(ColorUtils.darken(baseColor, (ratio - 0.5) * 0.8))\n      }\n    }\n    \n    return LinearGradient({\n      colors,\n      startPoint: 'top',\n      endPoint: 'bottom'\n    })\n  },\n\n  /**\n   * Generate analogous color gradient\n   */\n  analogous: (baseColor: string, _range: number = 60): GradientDefinition => {\n    // This would require HSL color manipulation\n    // Placeholder implementation\n    return LinearGradient({\n      colors: [baseColor, ColorUtils.lighten(baseColor, 0.2), ColorUtils.darken(baseColor, 0.2)],\n      startPoint: 'topLeading',\n      endPoint: 'bottomTrailing'\n    })\n  },\n\n  /**\n   * Generate complementary gradient\n   */\n  complementary: (color1: string, color2?: string): GradientDefinition => {\n    const secondColor = color2 || ColorUtils.complement(color1)\n    \n    return LinearGradient({\n      colors: [color1, secondColor],\n      startPoint: 'topLeading',\n      endPoint: 'bottomTrailing'\n    })\n  },\n\n  /**\n   * Generate sunset gradient\n   */\n  sunset: (): GradientDefinition => {\n    return LinearGradient({\n      colors: ['#ff7e5f', '#feb47b', '#ff6b6b', '#c44569'],\n      startPoint: 'top',\n      endPoint: 'bottom'\n    })\n  },\n\n  /**\n   * Generate ocean gradient\n   */\n  ocean: (): GradientDefinition => {\n    return LinearGradient({\n      colors: ['#667eea', '#764ba2', '#667eea'],\n      startPoint: 'topLeading',\n      endPoint: 'bottomTrailing'\n    })\n  }\n} as const\n\n/**\n * State gradient utilities\n */\nexport const StateGradientUtils = {\n  /**\n   * Create hover effect gradient\n   */\n  createHoverEffect: (\n    baseGradient: GradientDefinition,\n    intensity: number = 0.1\n  ): StateGradientOptions => {\n    const hoverGradient = GradientTransforms.withOpacity(\n      GradientTransforms.reverse(baseGradient),\n      1 - intensity\n    )\n    \n    return {\n      default: baseGradient,\n      hover: hoverGradient,\n      animation: {\n        duration: 200,\n        easing: 'ease-out'\n      }\n    }\n  },\n\n  /**\n   * Create button gradient states\n   */\n  createButtonStates: (\n    baseColor: string,\n    type: 'primary' | 'secondary' | 'danger' = 'primary'\n  ): StateGradientOptions => {\n    const colorMap = {\n      primary: { base: baseColor, hover: ColorUtils.lighten(baseColor, 0.1), active: ColorUtils.darken(baseColor, 0.1) },\n      secondary: { base: '#f8f9fa', hover: '#e9ecef', active: '#dee2e6' },\n      danger: { base: '#dc3545', hover: ColorUtils.lighten('#dc3545', 0.1), active: ColorUtils.darken('#dc3545', 0.1) }\n    }\n    \n    const colors = colorMap[type]\n    \n    return {\n      default: LinearGradient({\n        colors: [colors.base, ColorUtils.darken(colors.base, 0.05)],\n        startPoint: 'top',\n        endPoint: 'bottom'\n      }),\n      hover: LinearGradient({\n        colors: [colors.hover, ColorUtils.darken(colors.hover, 0.05)],\n        startPoint: 'top',\n        endPoint: 'bottom'\n      }),\n      active: LinearGradient({\n        colors: [colors.active, ColorUtils.darken(colors.active, 0.05)],\n        startPoint: 'top',\n        endPoint: 'bottom'\n      }),\n      disabled: '#cccccc',\n      animation: {\n        duration: 150,\n        easing: 'ease-out'\n      }\n    }\n  },\n\n  /**\n   * Create card hover effect\n   */\n  createCardHover: (backgroundColor: string = '#ffffff'): StateGradientOptions => {\n    return {\n      default: backgroundColor,\n      hover: LinearGradient({\n        colors: [\n          ColorUtils.withAlpha('#ffffff', 0.1),\n          ColorUtils.withAlpha('#f8f9fa', 0.1)\n        ],\n        startPoint: 'topLeading',\n        endPoint: 'bottomTrailing'\n      }),\n      animation: {\n        duration: 200,\n        easing: 'ease'\n      }\n    }\n  }\n} as const\n\n/**\n * CSS utility functions\n */\nexport const CSSUtils = {\n  /**\n   * Generate CSS custom properties for gradient\n   */\n  toCustomProperties: (gradient: GradientDefinition, prefix: string = 'gradient'): Record<string, string> => {\n    const css = gradientToCSS(gradient)\n    return {\n      [`--${prefix}-background`]: css\n    }\n  },\n\n  /**\n   * Generate fallback CSS for older browsers\n   */\n  withFallback: (gradient: GradientDefinition, fallbackColor: string): string => {\n    const gradientCSS = gradientToCSS(gradient)\n    return `background: ${fallbackColor}; background: ${gradientCSS};`\n  },\n\n  /**\n   * Optimize CSS for performance\n   */\n  optimize: (css: string): string => {\n    // Remove unnecessary spaces and optimize\n    return css\n      .replace(/\\s+/g, ' ')\n      .replace(/,\\s+/g, ',')\n      .replace(/:\\s+/g, ':')\n      .trim()\n  }\n} as const\n\n/**\n * Main gradient utilities export\n */\nexport const GradientUtils = {\n  ...ColorUtils,\n  ...GradientTransforms,\n  ...GradientAnalysis,\n  ...GradientGenerators,\n  ...StateGradientUtils,\n  ...CSSUtils,\n\n  /**\n   * Convert any background value to CSS\n   */\n  toCSS: (background: StatefulBackgroundValue): string => {\n    if (typeof background === 'string') {\n      return background\n    }\n    \n    if ('resolve' in background && typeof background.resolve === 'function') {\n      return background.resolve() as string\n    }\n    \n    if ('type' in background && 'options' in background) {\n      return gradientToCSS(background as GradientDefinition)\n    }\n    \n    if ('default' in background) {\n      return GradientUtils.toCSS(background.default)\n    }\n    \n    return 'transparent'\n  },\n\n  /**\n   * Deep clone gradient definition\n   */\n  clone: <T extends GradientDefinition>(gradient: T): T => {\n    return JSON.parse(JSON.stringify(gradient))\n  },\n\n  /**\n   * Compare two gradients for equality\n   */\n  equals: (a: GradientDefinition, b: GradientDefinition): boolean => {\n    return JSON.stringify(a) === JSON.stringify(b)\n  }\n} as const"],"names":["ColorUtils","hex","result","r","g","b","color","alpha","rgb","color1","color2","ratio","rgb1","rgb2","amount","getLuminance","c","lum1","lum2","brightest","darkest","GradientTransforms","gradient","newGradient","degrees","options","scale","opacity","radius","RadialGradient","AngularGradient","GradientAnalysis","score","complexity","GradientGenerators","steps","colors","i","hue","LinearGradient","baseColor","_range","secondColor","StateGradientUtils","baseGradient","intensity","hoverGradient","type","backgroundColor","CSSUtils","prefix","css","gradientToCSS","fallbackColor","gradientCSS","GradientUtils","background","a"],"mappings":"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"}

package/dist/gradients/validation.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n={isGradientDefinition(e){if(!e||typeof e!="object")return!1;const t=e;return typeof t.type=="string"&&["linear","radial","angular","conic","repeating-linear","repeating-radial","elliptical"].includes(t.type)&&t.options!==void 0&&typeof t.options=="object"&&t.options!==null},isLinearGradient(e){return this.isGradientDefinition(e)&&e.type==="linear"},isRadialGradient(e){return this.isGradientDefinition(e)&&e.type==="radial"},isAngularGradient(e){return this.isGradientDefinition(e)&&e.type==="angular"},isStateGradientOptions(e){if(!e||typeof e!="object")return!1;const t=e;return"default"in t&&t.default!==void 0},isStatefulBackgroundValue(e){return!!(typeof e=="string"||this.isGradientDefinition(e)||this.isAsset(e)||this.isStateGradientOptions(e))},isAsset(e){return e!==null&&typeof e=="object"&&"resolve"in e&&typeof e.resolve=="function"},isGradientStartPoint(e){return typeof e=="string"&&["top","bottom","leading","trailing","center","topLeading","topTrailing","bottomLeading","bottomTrailing"].includes(e)},isGradientCenter(e){return typeof e=="string"?["center","top","bottom","leading","trailing"].includes(e):Array.isArray(e)?e.length===2&&typeof e[0]=="number"&&typeof e[1]=="number":!1}},s={validateColor(e){return n.isAsset(e)?{valid:!0}:typeof e!="string"?{valid:!1,error:"Color must be a string or Asset"}:/^(transparent|inherit|initial|unset|currentcolor)$/i.test(e)?{valid:!0}:/^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(e)?{valid:!0}:/^rgba?\(\s*(\d+(?:\.\d+)?%?)\s*,\s*(\d+(?:\.\d+)?%?)\s*,\s*(\d+(?:\.\d+)?%?)\s*(?:,\s*(\d+(?:\.\d+)?%?))?\s*\)$/i.test(e)?{valid:!0}:/^hsla?\(\s*(\d+(?:\.\d+)?)\s*,\s*(\d+(?:\.\d+)?%)\s*,\s*(\d+(?:\.\d+)?%)\s*(?:,\s*(\d+(?:\.\d+)?%?))?\s*\)$/i.test(e)?{valid:!0}:/^var\(--[a-zA-Z][a-zA-Z0-9-]*\)$/.test(e)?{valid:!0}:{valid:!1,error:`Invalid color format: ${e}`}},validateColors(e){const t=[];return Array.isArray(e)?e.length<2?{valid:!1,errors:["Gradient must have at least 2 colors"]}:(e.forEach((r,a)=>{const i=this.validateColor(r);i.valid||t.push(`Color at index ${a}: ${i.error}`)}),{valid:t.length===0,errors:t}):{valid:!1,errors:["Colors must be an array"]}},validateStops(e,t){if(!Array.isArray(e))return{valid:!1,error:"Stops must be an array"};if(e.length!==t)return{valid:!1,error:"Stops array length must match colors array length"};for(let r=0;r<e.length;r++){const a=e[r];if(typeof a!="number")return{valid:!1,error:`Stop at index ${r} must be a number`};if(a<0||a>100)return{valid:!1,error:`Stop at index ${r} must be between 0 and 100`};if(r>0&&a<e[r-1])return{valid:!1,error:`Stops must be in ascending order. Stop at index ${r} (${a}) is less than previous stop (${e[r-1]})`}}return{valid:!0}},validateLinearGradient(e){const t=[],r=this.validateColors(e.colors);if(r.valid||t.push(...r.errors),e.stops){const a=this.validateStops(e.stops,e.colors.length);a.valid||t.push(a.error)}return n.isGradientStartPoint(e.startPoint)||t.push(`Invalid startPoint: ${e.startPoint}`),n.isGradientStartPoint(e.endPoint)||t.push(`Invalid endPoint: ${e.endPoint}`),e.angle!==void 0&&(typeof e.angle!="number"?t.push("Angle must be a number"):(e.angle<0||e.angle>360)&&t.push("Angle must be between 0 and 360 degrees")),{valid:t.length===0,errors:t}},validateRadialGradient(e){const t=[],r=this.validateColors(e.colors);if(r.valid||t.push(...r.errors),e.stops){const a=this.validateStops(e.stops,e.colors.length);a.valid||t.push(a.error)}return n.isGradientCenter(e.center)||t.push(`Invalid center: ${e.center}`),(typeof e.startRadius!="number"||e.startRadius<0)&&t.push("startRadius must be a non-negative number"),(typeof e.endRadius!="number"||e.endRadius<0)&&t.push("endRadius must be a non-negative number"),e.startRadius>=e.endRadius&&t.push("endRadius must be greater than startRadius"),e.shape&&!["circle","ellipse"].includes(e.shape)&&t.push(`Invalid shape: ${e.shape}. Must be 'circle' or 'ellipse'`),{valid:t.length===0,errors:t}},validateAngularGradient(e){const t=[],r=this.validateColors(e.colors);return r.valid||t.push(...r.errors),n.isGradientCenter(e.center)||t.push(`Invalid center: ${e.center}`),typeof e.startAngle!="number"&&t.push("startAngle must be a number"),typeof e.endAngle!="number"&&t.push("endAngle must be a number"),{valid:t.length===0,errors:t}},validateAnimationOptions(e){const t=[];return e.duration!==void 0&&(typeof e.duration!="number"||e.duration<0)&&t.push("Duration must be a non-negative number"),e.delay!==void 0&&(typeof e.delay!="number"||e.delay<0)&&t.push("Delay must be a non-negative number"),e.easing!==void 0&&typeof e.easing!="string"&&t.push("Easing must be a string"),{valid:t.length===0,errors:t}},validateStateGradientOptions(e){const t=[];if(e.default||t.push("Default state is required"),["default","hover","active","focus","disabled"].forEach(a=>{const i=e[a];i&&!n.isStatefulBackgroundValue(i)&&t.push(`Invalid ${a} state value`)}),e.animation){const a=this.validateAnimationOptions(e.animation);a.valid||t.push(...a.errors.map(i=>`Animation: ${i}`))}return{valid:t.length===0,errors:t}},validateGradient(e){if(!n.isGradientDefinition(e))return{valid:!1,errors:["Invalid gradient definition structure"]};switch(e.type){case"linear":return this.validateLinearGradient(e.options);case"radial":return this.validateRadialGradient(e.options);case"angular":case"conic":return this.validateAngularGradient(e.options);default:return{valid:!1,errors:[`Unsupported gradient type: ${e.type}`]}}}},d=e=>{const t=s.validateGradient(e);if(!t.valid)throw new Error(`Invalid gradient: ${t.errors.join(", ")}`);return e},l=e=>{const t=s.validateStateGradientOptions(e);if(!t.valid)throw new Error(`Invalid state gradient: ${t.errors.join(", ")}`);return e},o={assertValidGradient(e){if(process.env.NODE_ENV==="development"){const t=s.validateGradient(e);if(!t.valid)throw console.error("Invalid gradient:",e),console.error("Validation errors:",t.errors),new Error(`Invalid gradient: ${t.errors.join(", ")}`)}},warnGradientIssues(e){process.env.NODE_ENV==="development"&&"colors"in e.options&&e.options.colors.length>5&&console.warn("Gradient has many colors which may impact performance:",e)}};exports.DevValidation=o;exports.GradientTypeGuards=n;exports.GradientValidation=s;exports.createValidatedGradient=d;exports.createValidatedStateGradient=l;
+//# sourceMappingURL=validation.cjs.map

package/dist/gradients/validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.cjs","sources":["../../src/gradients/validation.ts"],"sourcesContent":["/**\n * Enhanced TypeScript Support and Validation for TachUI Gradients\n * \n * Provides type guards, validation utilities, and enhanced TypeScript inference\n * for gradient configurations.\n */\n\nimport type { Asset } from '../assets/types'\nimport type {\n  GradientDefinition,\n  LinearGradientOptions,\n  RadialGradientOptions,\n  AngularGradientOptions,\n  StateGradientOptions,\n  GradientAnimationOptions,\n  StatefulBackgroundValue,\n  GradientStartPoint,\n  GradientCenter\n} from './types'\n\n/**\n * Enhanced type predicates for runtime type checking\n */\nexport const GradientTypeGuards = {\n  /**\n   * Check if value is a valid gradient definition\n   */\n  isGradientDefinition(value: unknown): value is GradientDefinition {\n    if (!value || typeof value !== 'object') return false\n    \n    const obj = value as Record<string, unknown>\n    return (\n      typeof obj.type === 'string' &&\n      ['linear', 'radial', 'angular', 'conic', 'repeating-linear', 'repeating-radial', 'elliptical'].includes(obj.type) &&\n      obj.options !== undefined &&\n      typeof obj.options === 'object' &&\n      obj.options !== null\n    )\n  },\n\n  /**\n   * Check if value is a linear gradient\n   */\n  isLinearGradient(value: unknown): value is GradientDefinition & { type: 'linear' } {\n    return this.isGradientDefinition(value) && value.type === 'linear'\n  },\n\n  /**\n   * Check if value is a radial gradient\n   */\n  isRadialGradient(value: unknown): value is GradientDefinition & { type: 'radial' } {\n    return this.isGradientDefinition(value) && value.type === 'radial'\n  },\n\n  /**\n   * Check if value is an angular gradient\n   */\n  isAngularGradient(value: unknown): value is GradientDefinition & { type: 'angular' } {\n    return this.isGradientDefinition(value) && value.type === 'angular'\n  },\n\n  /**\n   * Check if value is a state gradient configuration\n   */\n  isStateGradientOptions(value: unknown): value is StateGradientOptions {\n    if (!value || typeof value !== 'object') return false\n    \n    const obj = value as Record<string, unknown>\n    return 'default' in obj && obj.default !== undefined\n  },\n\n  /**\n   * Check if value is a stateful background value\n   */\n  isStatefulBackgroundValue(value: unknown): value is StatefulBackgroundValue {\n    if (typeof value === 'string') return true\n    if (this.isGradientDefinition(value)) return true\n    if (this.isAsset(value)) return true\n    if (this.isStateGradientOptions(value)) return true\n    return false\n  },\n\n  /**\n   * Check if value is an Asset\n   */\n  isAsset(value: unknown): value is Asset {\n    return value !== null && \n           typeof value === 'object' && \n           'resolve' in value && \n           typeof (value as any).resolve === 'function'\n  },\n\n  /**\n   * Check if value is a valid gradient start point\n   */\n  isGradientStartPoint(value: unknown): value is GradientStartPoint {\n    return typeof value === 'string' && [\n      'top', 'bottom', 'leading', 'trailing', 'center',\n      'topLeading', 'topTrailing', 'bottomLeading', 'bottomTrailing'\n    ].includes(value)\n  },\n\n  /**\n   * Check if value is a valid gradient center\n   */\n  isGradientCenter(value: unknown): value is GradientCenter {\n    if (typeof value === 'string') {\n      return ['center', 'top', 'bottom', 'leading', 'trailing'].includes(value)\n    }\n    if (Array.isArray(value)) {\n      return value.length === 2 && \n             typeof value[0] === 'number' && \n             typeof value[1] === 'number'\n    }\n    return false\n  }\n} as const\n\n/**\n * Runtime validation functions\n */\nexport const GradientValidation = {\n  /**\n   * Validate color format (hex, rgb, rgba, hsl, hsla, named colors, CSS custom properties)\n   */\n  validateColor(color: string | Asset): { valid: boolean; error?: string } {\n    if (GradientTypeGuards.isAsset(color)) {\n      return { valid: true } // Assets are validated elsewhere\n    }\n\n    if (typeof color !== 'string') {\n      return { valid: false, error: 'Color must be a string or Asset' }\n    }\n\n    // CSS color name pattern\n    const namedColors = /^(transparent|inherit|initial|unset|currentcolor)$/i\n    if (namedColors.test(color)) {\n      return { valid: true }\n    }\n\n    // Hex color pattern\n    const hexPattern = /^#([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i\n    if (hexPattern.test(color)) {\n      return { valid: true }\n    }\n\n    // RGB/RGBA pattern\n    const rgbPattern = /^rgba?\\(\\s*(\\d+(?:\\.\\d+)?%?)\\s*,\\s*(\\d+(?:\\.\\d+)?%?)\\s*,\\s*(\\d+(?:\\.\\d+)?%?)\\s*(?:,\\s*(\\d+(?:\\.\\d+)?%?))?\\s*\\)$/i\n    if (rgbPattern.test(color)) {\n      return { valid: true }\n    }\n\n    // HSL/HSLA pattern\n    const hslPattern = /^hsla?\\(\\s*(\\d+(?:\\.\\d+)?)\\s*,\\s*(\\d+(?:\\.\\d+)?%)\\s*,\\s*(\\d+(?:\\.\\d+)?%)\\s*(?:,\\s*(\\d+(?:\\.\\d+)?%?))?\\s*\\)$/i\n    if (hslPattern.test(color)) {\n      return { valid: true }\n    }\n\n    // CSS custom property pattern\n    const customPropertyPattern = /^var\\(--[a-zA-Z][a-zA-Z0-9-]*\\)$/\n    if (customPropertyPattern.test(color)) {\n      return { valid: true }\n    }\n\n    return { valid: false, error: `Invalid color format: ${color}` }\n  },\n\n  /**\n   * Validate gradient colors array\n   */\n  validateColors(colors: (string | Asset)[]): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    if (!Array.isArray(colors)) {\n      return { valid: false, errors: ['Colors must be an array'] }\n    }\n\n    if (colors.length < 2) {\n      return { valid: false, errors: ['Gradient must have at least 2 colors'] }\n    }\n\n    colors.forEach((color, index) => {\n      const validation = this.validateColor(color)\n      if (!validation.valid) {\n        errors.push(`Color at index ${index}: ${validation.error}`)\n      }\n    })\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Validate color stops array\n   */\n  validateStops(stops: number[], colorsLength: number): { valid: boolean; error?: string } {\n    if (!Array.isArray(stops)) {\n      return { valid: false, error: 'Stops must be an array' }\n    }\n\n    if (stops.length !== colorsLength) {\n      return { valid: false, error: 'Stops array length must match colors array length' }\n    }\n\n    // Check if stops are in ascending order and within 0-100 range\n    for (let i = 0; i < stops.length; i++) {\n      const stop = stops[i]\n      \n      if (typeof stop !== 'number') {\n        return { valid: false, error: `Stop at index ${i} must be a number` }\n      }\n      \n      if (stop < 0 || stop > 100) {\n        return { valid: false, error: `Stop at index ${i} must be between 0 and 100` }\n      }\n      \n      if (i > 0 && stop < stops[i - 1]) {\n        return { valid: false, error: `Stops must be in ascending order. Stop at index ${i} (${stop}) is less than previous stop (${stops[i - 1]})` }\n      }\n    }\n\n    return { valid: true }\n  },\n\n  /**\n   * Validate linear gradient options\n   */\n  validateLinearGradient(options: LinearGradientOptions): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    // Validate colors\n    const colorsValidation = this.validateColors(options.colors)\n    if (!colorsValidation.valid) {\n      errors.push(...colorsValidation.errors)\n    }\n\n    // Validate stops if provided\n    if (options.stops) {\n      const stopsValidation = this.validateStops(options.stops, options.colors.length)\n      if (!stopsValidation.valid) {\n        errors.push(stopsValidation.error!)\n      }\n    }\n\n    // Validate start and end points\n    if (!GradientTypeGuards.isGradientStartPoint(options.startPoint)) {\n      errors.push(`Invalid startPoint: ${options.startPoint}`)\n    }\n\n    if (!GradientTypeGuards.isGradientStartPoint(options.endPoint)) {\n      errors.push(`Invalid endPoint: ${options.endPoint}`)\n    }\n\n    // Validate angle if provided\n    if (options.angle !== undefined) {\n      if (typeof options.angle !== 'number') {\n        errors.push('Angle must be a number')\n      } else if (options.angle < 0 || options.angle > 360) {\n        errors.push('Angle must be between 0 and 360 degrees')\n      }\n    }\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Validate radial gradient options\n   */\n  validateRadialGradient(options: RadialGradientOptions): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    // Validate colors\n    const colorsValidation = this.validateColors(options.colors)\n    if (!colorsValidation.valid) {\n      errors.push(...colorsValidation.errors)\n    }\n\n    // Validate stops if provided\n    if (options.stops) {\n      const stopsValidation = this.validateStops(options.stops, options.colors.length)\n      if (!stopsValidation.valid) {\n        errors.push(stopsValidation.error!)\n      }\n    }\n\n    // Validate center\n    if (!GradientTypeGuards.isGradientCenter(options.center)) {\n      errors.push(`Invalid center: ${options.center}`)\n    }\n\n    // Validate radii\n    if (typeof options.startRadius !== 'number' || options.startRadius < 0) {\n      errors.push('startRadius must be a non-negative number')\n    }\n\n    if (typeof options.endRadius !== 'number' || options.endRadius < 0) {\n      errors.push('endRadius must be a non-negative number')\n    }\n\n    if (options.startRadius >= options.endRadius) {\n      errors.push('endRadius must be greater than startRadius')\n    }\n\n    // Validate shape if provided\n    if (options.shape && !['circle', 'ellipse'].includes(options.shape)) {\n      errors.push(`Invalid shape: ${options.shape}. Must be 'circle' or 'ellipse'`)\n    }\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Validate angular gradient options\n   */\n  validateAngularGradient(options: AngularGradientOptions): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    // Validate colors\n    const colorsValidation = this.validateColors(options.colors)\n    if (!colorsValidation.valid) {\n      errors.push(...colorsValidation.errors)\n    }\n\n    // Validate center\n    if (!GradientTypeGuards.isGradientCenter(options.center)) {\n      errors.push(`Invalid center: ${options.center}`)\n    }\n\n    // Validate angles\n    if (typeof options.startAngle !== 'number') {\n      errors.push('startAngle must be a number')\n    }\n\n    if (typeof options.endAngle !== 'number') {\n      errors.push('endAngle must be a number')\n    }\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Validate animation options\n   */\n  validateAnimationOptions(options: GradientAnimationOptions): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    if (options.duration !== undefined) {\n      if (typeof options.duration !== 'number' || options.duration < 0) {\n        errors.push('Duration must be a non-negative number')\n      }\n    }\n\n    if (options.delay !== undefined) {\n      if (typeof options.delay !== 'number' || options.delay < 0) {\n        errors.push('Delay must be a non-negative number')\n      }\n    }\n\n    if (options.easing !== undefined) {\n      if (typeof options.easing !== 'string') {\n        errors.push('Easing must be a string')\n      }\n    }\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Validate state gradient options\n   */\n  validateStateGradientOptions(options: StateGradientOptions): { valid: boolean; errors: string[] } {\n    const errors: string[] = []\n\n    // Validate that default state exists\n    if (!options.default) {\n      errors.push('Default state is required')\n    }\n\n    // Validate each state\n    const stateKeys = ['default', 'hover', 'active', 'focus', 'disabled'] as const\n    stateKeys.forEach(key => {\n      const value = options[key]\n      if (value && !GradientTypeGuards.isStatefulBackgroundValue(value)) {\n        errors.push(`Invalid ${key} state value`)\n      }\n    })\n\n    // Validate animation options if provided\n    if (options.animation) {\n      const animationValidation = this.validateAnimationOptions(options.animation)\n      if (!animationValidation.valid) {\n        errors.push(...animationValidation.errors.map(err => `Animation: ${err}`))\n      }\n    }\n\n    return { valid: errors.length === 0, errors }\n  },\n\n  /**\n   * Comprehensive gradient validation\n   */\n  validateGradient(gradient: GradientDefinition): { valid: boolean; errors: string[] } {\n    if (!GradientTypeGuards.isGradientDefinition(gradient)) {\n      return { valid: false, errors: ['Invalid gradient definition structure'] }\n    }\n\n    switch (gradient.type) {\n      case 'linear':\n        return this.validateLinearGradient(gradient.options as LinearGradientOptions)\n      case 'radial':\n        return this.validateRadialGradient(gradient.options as RadialGradientOptions)\n      case 'angular':\n      case 'conic':\n        return this.validateAngularGradient(gradient.options as AngularGradientOptions)\n      default:\n        return { valid: false, errors: [`Unsupported gradient type: ${gradient.type}`] }\n    }\n  }\n} as const\n\n/**\n * Enhanced TypeScript utility types for better inference\n */\nexport type GradientPreset = () => GradientDefinition\nexport type StateGradientPreset = () => StateGradientOptions\n\n/**\n * Branded types for enhanced type safety\n */\nexport type ValidatedGradient<T extends GradientDefinition = GradientDefinition> = T & {\n  readonly __validated: true\n}\n\nexport type ValidatedStateGradient = StateGradientOptions & {\n  readonly __validated: true\n}\n\n/**\n * Validation wrapper functions that return branded types\n */\nexport const createValidatedGradient = <T extends GradientDefinition>(\n  gradient: T\n): ValidatedGradient<T> | never => {\n  const validation = GradientValidation.validateGradient(gradient)\n  if (!validation.valid) {\n    throw new Error(`Invalid gradient: ${validation.errors.join(', ')}`)\n  }\n  return gradient as ValidatedGradient<T>\n}\n\nexport const createValidatedStateGradient = (\n  options: StateGradientOptions\n): ValidatedStateGradient | never => {\n  const validation = GradientValidation.validateStateGradientOptions(options)\n  if (!validation.valid) {\n    throw new Error(`Invalid state gradient: ${validation.errors.join(', ')}`)\n  }\n  return options as ValidatedStateGradient\n}\n\n/**\n * Development-time validation helpers\n */\nexport const DevValidation = {\n  /**\n   * Assert gradient is valid (throws in development, no-op in production)\n   */\n  assertValidGradient(gradient: GradientDefinition): void {\n    if (process.env.NODE_ENV === 'development') {\n      const validation = GradientValidation.validateGradient(gradient)\n      if (!validation.valid) {\n        console.error('Invalid gradient:', gradient)\n        console.error('Validation errors:', validation.errors)\n        throw new Error(`Invalid gradient: ${validation.errors.join(', ')}`)\n      }\n    }\n  },\n\n  /**\n   * Warn about potential gradient issues\n   */\n  warnGradientIssues(gradient: GradientDefinition): void {\n    if (process.env.NODE_ENV === 'development') {\n      // Add performance warnings, accessibility checks, etc.\n      if ('colors' in gradient.options && gradient.options.colors.length > 5) {\n        console.warn('Gradient has many colors which may impact performance:', gradient)\n      }\n    }\n  }\n} as const"],"names":["GradientTypeGuards","value","obj","GradientValidation","color","colors","errors","index","validation","stops","colorsLength","i","stop","options","colorsValidation","stopsValidation","key","animationValidation","err","gradient","createValidatedGradient","createValidatedStateGradient","DevValidation"],"mappings":"gFAuBO,MAAMA,EAAqB,CAIhC,qBAAqBC,EAA6C,CAChE,GAAI,CAACA,GAAS,OAAOA,GAAU,SAAU,MAAO,GAEhD,MAAMC,EAAMD,EACZ,OACE,OAAOC,EAAI,MAAS,UACpB,CAAC,SAAU,SAAU,UAAW,QAAS,mBAAoB,mBAAoB,YAAY,EAAE,SAASA,EAAI,IAAI,GAChHA,EAAI,UAAY,QAChB,OAAOA,EAAI,SAAY,UACvBA,EAAI,UAAY,IAEpB,EAKA,iBAAiBD,EAAkE,CACjF,OAAO,KAAK,qBAAqBA,CAAK,GAAKA,EAAM,OAAS,QAC5D,EAKA,iBAAiBA,EAAkE,CACjF,OAAO,KAAK,qBAAqBA,CAAK,GAAKA,EAAM,OAAS,QAC5D,EAKA,kBAAkBA,EAAmE,CACnF,OAAO,KAAK,qBAAqBA,CAAK,GAAKA,EAAM,OAAS,SAC5D,EAKA,uBAAuBA,EAA+C,CACpE,GAAI,CAACA,GAAS,OAAOA,GAAU,SAAU,MAAO,GAEhD,MAAMC,EAAMD,EACZ,MAAO,YAAaC,GAAOA,EAAI,UAAY,MAC7C,EAKA,0BAA0BD,EAAkD,CAI1E,MAHI,UAAOA,GAAU,UACjB,KAAK,qBAAqBA,CAAK,GAC/B,KAAK,QAAQA,CAAK,GAClB,KAAK,uBAAuBA,CAAK,EAEvC,EAKA,QAAQA,EAAgC,CACtC,OAAOA,IAAU,MACV,OAAOA,GAAU,UACjB,YAAaA,GACb,OAAQA,EAAc,SAAY,UAC3C,EAKA,qBAAqBA,EAA6C,CAChE,OAAO,OAAOA,GAAU,UAAY,CAClC,MAAO,SAAU,UAAW,WAAY,SACxC,aAAc,cAAe,gBAAiB,gBAAA,EAC9C,SAASA,CAAK,CAClB,EAKA,iBAAiBA,EAAyC,CACxD,OAAI,OAAOA,GAAU,SACZ,CAAC,SAAU,MAAO,SAAU,UAAW,UAAU,EAAE,SAASA,CAAK,EAEtE,MAAM,QAAQA,CAAK,EACdA,EAAM,SAAW,GACjB,OAAOA,EAAM,CAAC,GAAM,UACpB,OAAOA,EAAM,CAAC,GAAM,SAEtB,EACT,CACF,EAKaE,EAAqB,CAIhC,cAAcC,EAA2D,CACvE,OAAIJ,EAAmB,QAAQI,CAAK,EAC3B,CAAE,MAAO,EAAA,EAGd,OAAOA,GAAU,SACZ,CAAE,MAAO,GAAO,MAAO,iCAAA,EAIZ,sDACJ,KAAKA,CAAK,EACjB,CAAE,MAAO,EAAA,EAIC,wDACJ,KAAKA,CAAK,EAChB,CAAE,MAAO,EAAA,EAIC,mHACJ,KAAKA,CAAK,EAChB,CAAE,MAAO,EAAA,EAIC,+GACJ,KAAKA,CAAK,EAChB,CAAE,MAAO,EAAA,EAIY,mCACJ,KAAKA,CAAK,EAC3B,CAAE,MAAO,EAAA,EAGX,CAAE,MAAO,GAAO,MAAO,yBAAyBA,CAAK,EAAA,CAC9D,EAKA,eAAeC,EAAkE,CAC/E,MAAMC,EAAmB,CAAA,EAEzB,OAAK,MAAM,QAAQD,CAAM,EAIrBA,EAAO,OAAS,EACX,CAAE,MAAO,GAAO,OAAQ,CAAC,sCAAsC,CAAA,GAGxEA,EAAO,QAAQ,CAACD,EAAOG,IAAU,CAC/B,MAAMC,EAAa,KAAK,cAAcJ,CAAK,EACtCI,EAAW,OACdF,EAAO,KAAK,kBAAkBC,CAAK,KAAKC,EAAW,KAAK,EAAE,CAE9D,CAAC,EAEM,CAAE,MAAOF,EAAO,SAAW,EAAG,OAAAA,CAAA,GAd5B,CAAE,MAAO,GAAO,OAAQ,CAAC,yBAAyB,CAAA,CAe7D,EAKA,cAAcG,EAAiBC,EAA0D,CACvF,GAAI,CAAC,MAAM,QAAQD,CAAK,EACtB,MAAO,CAAE,MAAO,GAAO,MAAO,wBAAA,EAGhC,GAAIA,EAAM,SAAWC,EACnB,MAAO,CAAE,MAAO,GAAO,MAAO,mDAAA,EAIhC,QAASC,EAAI,EAAGA,EAAIF,EAAM,OAAQE,IAAK,CACrC,MAAMC,EAAOH,EAAME,CAAC,EAEpB,GAAI,OAAOC,GAAS,SAClB,MAAO,CAAE,MAAO,GAAO,MAAO,iBAAiBD,CAAC,mBAAA,EAGlD,GAAIC,EAAO,GAAKA,EAAO,IACrB,MAAO,CAAE,MAAO,GAAO,MAAO,iBAAiBD,CAAC,4BAAA,EAGlD,GAAIA,EAAI,GAAKC,EAAOH,EAAME,EAAI,CAAC,EAC7B,MAAO,CAAE,MAAO,GAAO,MAAO,mDAAmDA,CAAC,KAAKC,CAAI,iCAAiCH,EAAME,EAAI,CAAC,CAAC,GAAA,CAE5I,CAEA,MAAO,CAAE,MAAO,EAAA,CAClB,EAKA,uBAAuBE,EAAsE,CAC3F,MAAMP,EAAmB,CAAA,EAGnBQ,EAAmB,KAAK,eAAeD,EAAQ,MAAM,EAM3D,GALKC,EAAiB,OACpBR,EAAO,KAAK,GAAGQ,EAAiB,MAAM,EAIpCD,EAAQ,MAAO,CACjB,MAAME,EAAkB,KAAK,cAAcF,EAAQ,MAAOA,EAAQ,OAAO,MAAM,EAC1EE,EAAgB,OACnBT,EAAO,KAAKS,EAAgB,KAAM,CAEtC,CAGA,OAAKf,EAAmB,qBAAqBa,EAAQ,UAAU,GAC7DP,EAAO,KAAK,uBAAuBO,EAAQ,UAAU,EAAE,EAGpDb,EAAmB,qBAAqBa,EAAQ,QAAQ,GAC3DP,EAAO,KAAK,qBAAqBO,EAAQ,QAAQ,EAAE,EAIjDA,EAAQ,QAAU,SAChB,OAAOA,EAAQ,OAAU,SAC3BP,EAAO,KAAK,wBAAwB,GAC3BO,EAAQ,MAAQ,GAAKA,EAAQ,MAAQ,MAC9CP,EAAO,KAAK,yCAAyC,GAIlD,CAAE,MAAOA,EAAO,SAAW,EAAG,OAAAA,CAAA,CACvC,EAKA,uBAAuBO,EAAsE,CAC3F,MAAMP,EAAmB,CAAA,EAGnBQ,EAAmB,KAAK,eAAeD,EAAQ,MAAM,EAM3D,GALKC,EAAiB,OACpBR,EAAO,KAAK,GAAGQ,EAAiB,MAAM,EAIpCD,EAAQ,MAAO,CACjB,MAAME,EAAkB,KAAK,cAAcF,EAAQ,MAAOA,EAAQ,OAAO,MAAM,EAC1EE,EAAgB,OACnBT,EAAO,KAAKS,EAAgB,KAAM,CAEtC,CAGA,OAAKf,EAAmB,iBAAiBa,EAAQ,MAAM,GACrDP,EAAO,KAAK,mBAAmBO,EAAQ,MAAM,EAAE,GAI7C,OAAOA,EAAQ,aAAgB,UAAYA,EAAQ,YAAc,IACnEP,EAAO,KAAK,2CAA2C,GAGrD,OAAOO,EAAQ,WAAc,UAAYA,EAAQ,UAAY,IAC/DP,EAAO,KAAK,yCAAyC,EAGnDO,EAAQ,aAAeA,EAAQ,WACjCP,EAAO,KAAK,4CAA4C,EAItDO,EAAQ,OAAS,CAAC,CAAC,SAAU,SAAS,EAAE,SAASA,EAAQ,KAAK,GAChEP,EAAO,KAAK,kBAAkBO,EAAQ,KAAK,iCAAiC,EAGvE,CAAE,MAAOP,EAAO,SAAW,EAAG,OAAAA,CAAA,CACvC,EAKA,wBAAwBO,EAAuE,CAC7F,MAAMP,EAAmB,CAAA,EAGnBQ,EAAmB,KAAK,eAAeD,EAAQ,MAAM,EAC3D,OAAKC,EAAiB,OACpBR,EAAO,KAAK,GAAGQ,EAAiB,MAAM,EAInCd,EAAmB,iBAAiBa,EAAQ,MAAM,GACrDP,EAAO,KAAK,mBAAmBO,EAAQ,MAAM,EAAE,EAI7C,OAAOA,EAAQ,YAAe,UAChCP,EAAO,KAAK,6BAA6B,EAGvC,OAAOO,EAAQ,UAAa,UAC9BP,EAAO,KAAK,2BAA2B,EAGlC,CAAE,MAAOA,EAAO,SAAW,EAAG,OAAAA,CAAA,CACvC,EAKA,yBAAyBO,EAAyE,CAChG,MAAMP,EAAmB,CAAA,EAEzB,OAAIO,EAAQ,WAAa,SACnB,OAAOA,EAAQ,UAAa,UAAYA,EAAQ,SAAW,IAC7DP,EAAO,KAAK,wCAAwC,EAIpDO,EAAQ,QAAU,SAChB,OAAOA,EAAQ,OAAU,UAAYA,EAAQ,MAAQ,IACvDP,EAAO,KAAK,qCAAqC,EAIjDO,EAAQ,SAAW,QACjB,OAAOA,EAAQ,QAAW,UAC5BP,EAAO,KAAK,yBAAyB,EAIlC,CAAE,MAAOA,EAAO,SAAW,EAAG,OAAAA,CAAA,CACvC,EAKA,6BAA6BO,EAAqE,CAChG,MAAMP,EAAmB,CAAA,EAiBzB,GAdKO,EAAQ,SACXP,EAAO,KAAK,2BAA2B,EAIvB,CAAC,UAAW,QAAS,SAAU,QAAS,UAAU,EAC1D,QAAQU,GAAO,CACvB,MAAMf,EAAQY,EAAQG,CAAG,EACrBf,GAAS,CAACD,EAAmB,0BAA0BC,CAAK,GAC9DK,EAAO,KAAK,WAAWU,CAAG,cAAc,CAE5C,CAAC,EAGGH,EAAQ,UAAW,CACrB,MAAMI,EAAsB,KAAK,yBAAyBJ,EAAQ,SAAS,EACtEI,EAAoB,OACvBX,EAAO,KAAK,GAAGW,EAAoB,OAAO,IAAIC,GAAO,cAAcA,CAAG,EAAE,CAAC,CAE7E,CAEA,MAAO,CAAE,MAAOZ,EAAO,SAAW,EAAG,OAAAA,CAAA,CACvC,EAKA,iBAAiBa,EAAoE,CACnF,GAAI,CAACnB,EAAmB,qBAAqBmB,CAAQ,EACnD,MAAO,CAAE,MAAO,GAAO,OAAQ,CAAC,uCAAuC,CAAA,EAGzE,OAAQA,EAAS,KAAA,CACf,IAAK,SACH,OAAO,KAAK,uBAAuBA,EAAS,OAAgC,EAC9E,IAAK,SACH,OAAO,KAAK,uBAAuBA,EAAS,OAAgC,EAC9E,IAAK,UACL,IAAK,QACH,OAAO,KAAK,wBAAwBA,EAAS,OAAiC,EAChF,QACE,MAAO,CAAE,MAAO,GAAO,OAAQ,CAAC,8BAA8BA,EAAS,IAAI,EAAE,CAAA,CAAE,CAErF,CACF,EAsBaC,EACXD,GACiC,CACjC,MAAMX,EAAaL,EAAmB,iBAAiBgB,CAAQ,EAC/D,GAAI,CAACX,EAAW,MACd,MAAM,IAAI,MAAM,qBAAqBA,EAAW,OAAO,KAAK,IAAI,CAAC,EAAE,EAErE,OAAOW,CACT,EAEaE,EACXR,GACmC,CACnC,MAAML,EAAaL,EAAmB,6BAA6BU,CAAO,EAC1E,GAAI,CAACL,EAAW,MACd,MAAM,IAAI,MAAM,2BAA2BA,EAAW,OAAO,KAAK,IAAI,CAAC,EAAE,EAE3E,OAAOK,CACT,EAKaS,EAAgB,CAI3B,oBAAoBH,EAAoC,CACtD,GAAI,QAAQ,IAAI,WAAa,cAAe,CAC1C,MAAMX,EAAaL,EAAmB,iBAAiBgB,CAAQ,EAC/D,GAAI,CAACX,EAAW,MACd,cAAQ,MAAM,oBAAqBW,CAAQ,EAC3C,QAAQ,MAAM,qBAAsBX,EAAW,MAAM,EAC/C,IAAI,MAAM,qBAAqBA,EAAW,OAAO,KAAK,IAAI,CAAC,EAAE,CAEvE,CACF,EAKA,mBAAmBW,EAAoC,CACjD,QAAQ,IAAI,WAAa,eAEvB,WAAYA,EAAS,SAAWA,EAAS,QAAQ,OAAO,OAAS,GACnE,QAAQ,KAAK,yDAA0DA,CAAQ,CAGrF,CACF"}

package/dist/gradients/validation.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Enhanced TypeScript Support and Validation for TachUI Gradients
+ *
+ * Provides type guards, validation utilities, and enhanced TypeScript inference
+ * for gradient configurations.
+ */
+import type { Asset } from '../assets/types';
+import type { GradientDefinition, LinearGradientOptions, RadialGradientOptions, AngularGradientOptions, StateGradientOptions, GradientAnimationOptions, StatefulBackgroundValue, GradientStartPoint, GradientCenter } from './types';
+/**
+ * Enhanced type predicates for runtime type checking
+ */
+export declare const GradientTypeGuards: {
+    /**
+     * Check if value is a valid gradient definition
+     */
+    readonly isGradientDefinition: (value: unknown) => value is GradientDefinition;
+    /**
+     * Check if value is a linear gradient
+     */
+    readonly isLinearGradient: (value: unknown) => value is GradientDefinition & {
+        type: "linear";
+    };
+    /**
+     * Check if value is a radial gradient
+     */
+    readonly isRadialGradient: (value: unknown) => value is GradientDefinition & {
+        type: "radial";
+    };
+    /**
+     * Check if value is an angular gradient
+     */
+    readonly isAngularGradient: (value: unknown) => value is GradientDefinition & {
+        type: "angular";
+    };
+    /**
+     * Check if value is a state gradient configuration
+     */
+    readonly isStateGradientOptions: (value: unknown) => value is StateGradientOptions;
+    /**
+     * Check if value is a stateful background value
+     */
+    readonly isStatefulBackgroundValue: (value: unknown) => value is StatefulBackgroundValue;
+    /**
+     * Check if value is an Asset
+     */
+    readonly isAsset: (value: unknown) => value is Asset;
+    /**
+     * Check if value is a valid gradient start point
+     */
+    readonly isGradientStartPoint: (value: unknown) => value is GradientStartPoint;
+    /**
+     * Check if value is a valid gradient center
+     */
+    readonly isGradientCenter: (value: unknown) => value is GradientCenter;
+};
+/**
+ * Runtime validation functions
+ */
+export declare const GradientValidation: {
+    /**
+     * Validate color format (hex, rgb, rgba, hsl, hsla, named colors, CSS custom properties)
+     */
+    readonly validateColor: (color: string | Asset) => {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate gradient colors array
+     */
+    readonly validateColors: (colors: (string | Asset)[]) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate color stops array
+     */
+    readonly validateStops: (stops: number[], colorsLength: number) => {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate linear gradient options
+     */
+    readonly validateLinearGradient: (options: LinearGradientOptions) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate radial gradient options
+     */
+    readonly validateRadialGradient: (options: RadialGradientOptions) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate angular gradient options
+     */
+    readonly validateAngularGradient: (options: AngularGradientOptions) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate animation options
+     */
+    readonly validateAnimationOptions: (options: GradientAnimationOptions) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate state gradient options
+     */
+    readonly validateStateGradientOptions: (options: StateGradientOptions) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Comprehensive gradient validation
+     */
+    readonly validateGradient: (gradient: GradientDefinition) => {
+        valid: boolean;
+        errors: string[];
+    };
+};
+/**
+ * Enhanced TypeScript utility types for better inference
+ */
+export type GradientPreset = () => GradientDefinition;
+export type StateGradientPreset = () => StateGradientOptions;
+/**
+ * Branded types for enhanced type safety
+ */
+export type ValidatedGradient<T extends GradientDefinition = GradientDefinition> = T & {
+    readonly __validated: true;
+};
+export type ValidatedStateGradient = StateGradientOptions & {
+    readonly __validated: true;
+};
+/**
+ * Validation wrapper functions that return branded types
+ */
+export declare const createValidatedGradient: <T extends GradientDefinition>(gradient: T) => ValidatedGradient<T> | never;
+export declare const createValidatedStateGradient: (options: StateGradientOptions) => ValidatedStateGradient | never;
+/**
+ * Development-time validation helpers
+ */
+export declare const DevValidation: {
+    /**
+     * Assert gradient is valid (throws in development, no-op in production)
+     */
+    readonly assertValidGradient: (gradient: GradientDefinition) => void;
+    /**
+     * Warn about potential gradient issues
+     */
+    readonly warnGradientIssues: (gradient: GradientDefinition) => void;
+};
+//# sourceMappingURL=validation.d.ts.map