@tachui/core 0.7.0-alpha1

package/dist/gradients/state-gradient-asset.js

@@ -0,0 +1,111 @@
+import { Asset as r } from "../assets/Asset.js";
+import { gradientToCSS as a } from "./css-generator.js";
+var o = Object.defineProperty, d = (e, t, i) => t in e ? o(e, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : e[t] = i, n = (e, t, i) => d(e, typeof t != "symbol" ? t + "" : t, i);
+class h extends r {
+  constructor(t, i) {
+    super(t), this.stateGradients = i, n(this, "currentState", "default"), n(this, "animationOptions"), n(this, "resolvedGradientCache", /* @__PURE__ */ new Map()), n(this, "isTransitioning", !1), this.animationOptions = i.animation || {
+      duration: 300,
+      easing: "ease",
+      delay: 0
+    }, this.preResolveGradients();
+  }
+  /**
+   * Set the current interaction state
+   */
+  setState(t) {
+    t !== this.currentState && this.stateGradients[t] && !this.isTransitioning && (this.currentState = t, this.animationOptions.duration && this.animationOptions.duration > 0 && (this.isTransitioning = !0, setTimeout(() => {
+      this.isTransitioning = !1;
+    }, this.animationOptions.duration + (this.animationOptions.delay || 0))));
+  }
+  /**
+   * Get the current state
+   */
+  getState() {
+    return this.currentState;
+  }
+  /**
+   * Resolve the current gradient to CSS
+   */
+  resolve() {
+    const t = this.currentState;
+    if (this.resolvedGradientCache.has(t))
+      return this.resolvedGradientCache.get(t);
+    const i = this.stateGradients[this.currentState] || this.stateGradients.default, s = this.resolveGradientValue(i);
+    return this.resolvedGradientCache.set(t, s), s;
+  }
+  /**
+   * Get gradient for a specific state without changing current state
+   */
+  getStateGradient(t) {
+    const i = this.stateGradients[t] || this.stateGradients.default;
+    return this.resolveGradientValue(i);
+  }
+  /**
+   * Get animation CSS properties for transitions
+   */
+  getAnimationCSS() {
+    const { duration: t, easing: i, delay: s } = this.animationOptions;
+    return `transition: background ${t}ms ${i} ${s || 0}ms;`;
+  }
+  /**
+   * Get all available states
+   */
+  getAvailableStates() {
+    return Object.keys(this.stateGradients).filter(
+      (t) => this.stateGradients[t] !== void 0
+    );
+  }
+  /**
+   * Check if a state is available
+   */
+  hasState(t) {
+    return t in this.stateGradients && this.stateGradients[t] !== void 0;
+  }
+  /**
+   * Update animation options
+   */
+  setAnimation(t) {
+    this.animationOptions = { ...this.animationOptions, ...t };
+  }
+  resolveGradientValue(t) {
+    return typeof t == "string" ? t : this.isAsset(t) ? t.resolve() : this.isGradientDefinition(t) ? a(t) : "";
+  }
+  isAsset(t) {
+    return t && typeof t == "object" && typeof t.resolve == "function";
+  }
+  isGradientDefinition(t) {
+    return t && typeof t == "object" && "type" in t && "options" in t;
+  }
+  /**
+   * Pre-resolve all gradients to improve runtime performance
+   */
+  preResolveGradients() {
+    Object.keys(this.stateGradients).forEach((t) => {
+      const i = t;
+      if (i !== "animation" && this.stateGradients[i]) {
+        const s = this.resolveGradientValue(this.stateGradients[i]);
+        this.resolvedGradientCache.set(i, s);
+      }
+    });
+  }
+  /**
+   * Clear the gradient cache (useful when gradients change dynamically)
+   */
+  clearCache() {
+    this.resolvedGradientCache.clear(), this.preResolveGradients();
+  }
+  /**
+   * Force update animation options and clear cache if needed
+   */
+  updateStateGradients(t) {
+    this.stateGradients = t, this.animationOptions = t.animation || this.animationOptions, this.clearCache();
+  }
+}
+function l(e, t) {
+  return new h(e, t);
+}
+export {
+  l as StateGradient,
+  h as StateGradientAsset
+};
+//# sourceMappingURL=state-gradient-asset.js.map

package/dist/gradients/state-gradient-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-gradient-asset.js","sources":["../../src/gradients/state-gradient-asset.ts"],"sourcesContent":["import { Asset } from '../assets/Asset'\nimport type { \n  StateGradientOptions, \n  GradientDefinition, \n  GradientAnimationOptions \n} from './types'\nimport { gradientToCSS } from './css-generator'\n\n/**\n * State-aware gradient asset that manages different gradients for interaction states\n * \n * Provides hover, active, focus, and disabled state support with smooth transitions.\n */\nexport class StateGradientAsset extends Asset<string> {\n  private currentState: keyof StateGradientOptions = 'default'\n  private animationOptions: GradientAnimationOptions\n  private resolvedGradientCache: Map<string, string> = new Map()\n  private isTransitioning: boolean = false\n\n  constructor(\n    name: string,\n    private stateGradients: StateGradientOptions\n  ) {\n    super(name)\n    this.animationOptions = stateGradients.animation || {\n      duration: 300,\n      easing: 'ease',\n      delay: 0\n    }\n    \n    // Pre-resolve all gradients for performance\n    this.preResolveGradients()\n  }\n\n  /**\n   * Set the current interaction state\n   */\n  setState(state: keyof StateGradientOptions): void {\n    if (state !== this.currentState && this.stateGradients[state] && !this.isTransitioning) {\n      this.currentState = state\n      \n      // Set transition flag to prevent rapid state changes during animation\n      if (this.animationOptions.duration && this.animationOptions.duration > 0) {\n        this.isTransitioning = true\n        setTimeout(() => {\n          this.isTransitioning = false\n        }, this.animationOptions.duration + (this.animationOptions.delay || 0))\n      }\n    }\n  }\n\n  /**\n   * Get the current state\n   */\n  getState(): keyof StateGradientOptions {\n    return this.currentState\n  }\n\n  /**\n   * Resolve the current gradient to CSS\n   */\n  resolve(): string {\n    // Use cached result if available\n    const cacheKey = this.currentState\n    if (this.resolvedGradientCache.has(cacheKey)) {\n      return this.resolvedGradientCache.get(cacheKey)!\n    }\n    \n    const gradient = this.stateGradients[this.currentState] || this.stateGradients.default\n    const resolved = this.resolveGradientValue(gradient as GradientDefinition | string | Asset)\n    \n    // Cache the result\n    this.resolvedGradientCache.set(cacheKey, resolved)\n    return resolved\n  }\n\n  /**\n   * Get gradient for a specific state without changing current state\n   */\n  getStateGradient(state: keyof StateGradientOptions): string {\n    const gradient = this.stateGradients[state] || this.stateGradients.default\n    return this.resolveGradientValue(gradient as GradientDefinition | string | Asset)\n  }\n\n  /**\n   * Get animation CSS properties for transitions\n   */\n  getAnimationCSS(): string {\n    const { duration, easing, delay } = this.animationOptions\n    return `transition: background ${duration}ms ${easing} ${delay || 0}ms;`\n  }\n\n  /**\n   * Get all available states\n   */\n  getAvailableStates(): (keyof StateGradientOptions)[] {\n    return Object.keys(this.stateGradients).filter(\n      key => this.stateGradients[key as keyof StateGradientOptions] !== undefined\n    ) as (keyof StateGradientOptions)[]\n  }\n\n  /**\n   * Check if a state is available\n   */\n  hasState(state: keyof StateGradientOptions): boolean {\n    return state in this.stateGradients && this.stateGradients[state] !== undefined\n  }\n\n  /**\n   * Update animation options\n   */\n  setAnimation(options: Partial<GradientAnimationOptions>): void {\n    this.animationOptions = { ...this.animationOptions, ...options }\n  }\n\n  private resolveGradientValue(value: GradientDefinition | string | Asset): string {\n    if (typeof value === 'string') {\n      return value\n    }\n\n    if (this.isAsset(value)) {\n      return value.resolve() as string\n    }\n\n    if (this.isGradientDefinition(value)) {\n      return gradientToCSS(value)\n    }\n\n    return ''\n  }\n\n  private isAsset(value: any): value is Asset {\n    return value && typeof value === 'object' && typeof value.resolve === 'function'\n  }\n\n  private isGradientDefinition(value: any): value is GradientDefinition {\n    return value && typeof value === 'object' && 'type' in value && 'options' in value\n  }\n\n  /**\n   * Pre-resolve all gradients to improve runtime performance\n   */\n  private preResolveGradients(): void {\n    Object.keys(this.stateGradients).forEach(stateKey => {\n      const state = stateKey as keyof StateGradientOptions\n      if (state !== 'animation' && this.stateGradients[state]) {\n        const resolved = this.resolveGradientValue(this.stateGradients[state]!)\n        this.resolvedGradientCache.set(state, resolved)\n      }\n    })\n  }\n\n  /**\n   * Clear the gradient cache (useful when gradients change dynamically)\n   */\n  clearCache(): void {\n    this.resolvedGradientCache.clear()\n    this.preResolveGradients()\n  }\n\n  /**\n   * Force update animation options and clear cache if needed\n   */\n  updateStateGradients(newGradients: StateGradientOptions): void {\n    this.stateGradients = newGradients\n    this.animationOptions = newGradients.animation || this.animationOptions\n    this.clearCache()\n  }\n}\n\n/**\n * Create a state-based gradient asset\n */\nexport function StateGradient(\n  name: string,\n  gradients: StateGradientOptions\n): StateGradientAsset {\n  return new StateGradientAsset(name, gradients)\n}"],"names":["StateGradientAsset","Asset","name","stateGradients","__publicField","state","cacheKey","gradient","resolved","duration","easing","delay","key","options","value","gradientToCSS","stateKey","newGradients","StateGradient","gradients"],"mappings":"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"}

package/dist/gradients/types.d.ts

@@ -0,0 +1,94 @@
+import type { Asset } from '../assets/types';
+export interface GradientColors {
+    colors: (string | Asset)[];
+    stops?: number[];
+}
+export type GradientStartPoint = 'top' | 'topLeading' | 'leading' | 'bottomLeading' | 'bottom' | 'bottomTrailing' | 'trailing' | 'topTrailing' | 'center';
+export type GradientCenter = 'center' | 'top' | 'bottom' | 'leading' | 'trailing' | [number, number];
+export interface LinearGradientOptions extends GradientColors {
+    startPoint: GradientStartPoint;
+    endPoint: GradientStartPoint;
+    angle?: number;
+}
+export interface RadialGradientOptions extends GradientColors {
+    center: GradientCenter;
+    startRadius: number;
+    endRadius: number;
+    shape?: 'circle' | 'ellipse';
+}
+export interface AngularGradientOptions extends GradientColors {
+    center: GradientCenter;
+    startAngle: number;
+    endAngle: number;
+}
+export interface RepeatingLinearGradientOptions extends GradientColors {
+    direction: string;
+    colorStops: string[];
+}
+export interface RepeatingRadialGradientOptions extends GradientColors {
+    center: GradientCenter;
+    shape?: 'circle' | 'ellipse';
+    colorStops: string[];
+}
+export interface ConicGradientOptions extends GradientColors {
+    center: GradientCenter;
+    startAngle: number;
+    endAngle?: number;
+}
+export interface EllipticalGradientOptions extends GradientColors {
+    center: GradientCenter;
+    radiusX: number;
+    radiusY: number;
+}
+export type GradientType = 'linear' | 'radial' | 'angular' | 'conic' | 'repeating-linear' | 'repeating-radial' | 'elliptical';
+export interface GradientDefinition {
+    type: GradientType;
+    options: LinearGradientOptions | RadialGradientOptions | AngularGradientOptions | ConicGradientOptions | RepeatingLinearGradientOptions | RepeatingRadialGradientOptions | EllipticalGradientOptions;
+}
+export interface TransitionOptions {
+    duration: number;
+    easing?: string;
+}
+export interface GradientAssetDefinitions {
+    light: GradientDefinition;
+    dark: GradientDefinition;
+    [key: string]: GradientDefinition;
+}
+/**
+ * Animation configuration for gradient transitions
+ */
+export interface GradientAnimationOptions {
+    duration?: number;
+    easing?: 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear' | string;
+    delay?: number;
+}
+/**
+ * State-based gradient configuration
+ */
+export interface StateGradientOptions {
+    default: GradientDefinition | string | Asset;
+    hover?: GradientDefinition | string | Asset;
+    active?: GradientDefinition | string | Asset;
+    focus?: GradientDefinition | string | Asset;
+    disabled?: GradientDefinition | string | Asset;
+    animation?: GradientAnimationOptions;
+}
+/**
+ * Enhanced background value supporting state-based gradients
+ */
+export type StatefulBackgroundValue = string | GradientDefinition | Asset | StateGradientOptions;
+export type HorizontalGradient = GradientDefinition & {
+    type: 'linear';
+    options: LinearGradientOptions & {
+        startPoint: 'leading' | 'trailing';
+        endPoint: 'trailing' | 'leading';
+    };
+};
+export type VerticalGradient = GradientDefinition & {
+    type: 'linear';
+    options: LinearGradientOptions & {
+        startPoint: 'top' | 'bottom';
+        endPoint: 'bottom' | 'top';
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/gradients/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gradients/types.ts"],"names":[],"mappings":"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"}

package/dist/gradients/utils.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./index.cjs"),d=require("./css-generator.cjs"),n={hexToRgb:t=>{const e=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(t);return e?{r:parseInt(e[1],16),g:parseInt(e[2],16),b:parseInt(e[3],16)}:null},rgbToHex:(t,e,r)=>"#"+((1<<24)+(t<<16)+(e<<8)+r).toString(16).slice(1),withAlpha:(t,e)=>{if(t.startsWith("#")){const r=n.hexToRgb(t);if(r)return`rgba(${r.r}, ${r.g}, ${r.b}, ${e})`}return t.startsWith("rgb(")?t.replace("rgb(","rgba(").replace(")",`, ${e})`):t.startsWith("rgba(")?t.replace(/,\s*[\d.]+\)$/,`, ${e})`):t},blendColors:(t,e,r=.5)=>{const o=n.hexToRgb(t),i=n.hexToRgb(e);if(!o||!i)return t;const p=Math.round(o.r*(1-r)+i.r*r),u=Math.round(o.g*(1-r)+i.g*r),f=Math.round(o.b*(1-r)+i.b*r);return n.rgbToHex(p,u,f)},lighten:(t,e=.2)=>n.blendColors(t,"#ffffff",e),darken:(t,e=.2)=>n.blendColors(t,"#000000",e),complement:t=>{const e=n.hexToRgb(t);return e?n.rgbToHex(255-e.r,255-e.g,255-e.b):t},getContrastRatio:(t,e)=>{const r=f=>{const c=n.hexToRgb(f);if(!c)return 0;const[y,G,P]=[c.r,c.g,c.b].map(a=>(a=a/255,a<=.03928?a/12.92:Math.pow((a+.055)/1.055,2.4)));return .2126*y+.7152*G+.0722*P},o=r(t),i=r(e),p=Math.max(o,i),u=Math.min(o,i);return(p+.05)/(u+.05)}},l={reverse:t=>{const e={...t};return"colors"in e.options&&(e.options={...e.options,colors:[...e.options.colors].reverse(),stops:e.options.stops?[...e.options.stops].reverse():void 0}),e},rotateLinear:(t,e)=>{if(t.type!=="linear")return t;const r=t.options;return{...t,options:{...r,angle:(r.angle||0)+e}}},scaleRadial:(t,e)=>{if(t.type!=="radial")return t;const r=t.options;return{...t,options:{...r,startRadius:r.startRadius*e,endRadius:r.endRadius*e}}},withOpacity:(t,e)=>{const r={...t};return"colors"in r.options&&(r.options={...r.options,colors:r.options.colors.map(o=>typeof o=="string"?n.withAlpha(o,e):o)}),r},mirror:t=>{if(t.type!=="linear")return t;const e=t.options;return{...t,options:{...e,startPoint:e.endPoint,endPoint:e.startPoint}}},toRadial:(t,e=100)=>{if(t.type!=="linear")return t;const r=t.options;return s.RadialGradient({colors:r.colors,stops:r.stops,center:"center",startRadius:0,endRadius:e})},toAngular:t=>"colors"in t.options?s.AngularGradient({colors:t.options.colors,stops:t.options.stops,center:"center",startAngle:0,endAngle:360}):t},g={getColorCount:t=>"colors"in t.options?t.options.colors.length:0,extractColors:t=>"colors"in t.options?[...t.options.colors]:[],getComplexityScore:t=>{let e=0;switch("colors"in t.options&&(e+=t.options.colors.length*2,e+=t.options.stops?t.options.stops.length:0),t.type){case"linear":e+=1;break;case"radial":e+=3;break;case"angular":e+=4;break;case"repeating-linear":e+=5;break;case"repeating-radial":e+=6;break}return e},hasTransparency:t=>"colors"in t.options?t.options.colors.some(e=>typeof e=="string"&&(e.includes("rgba")||e.includes("transparent")||e.includes("hsla"))):!1,getPerformanceImpact:t=>{const e=g.getComplexityScore(t);return e<=5?"low":e<=10?"medium":"high"}},h={rainbow:(t=6)=>{const e=[];for(let r=0;r<t;r++){const o=r*360/t;e.push(`hsl(${o}, 100%, 50%)`)}return s.LinearGradient({colors:e,startPoint:"leading",endPoint:"trailing"})},monochromatic:(t,e=5)=>{const r=[];for(let o=0;o<e;o++){const i=o/(e-1);i<.5?r.push(n.lighten(t,.4-i*.8)):r.push(n.darken(t,(i-.5)*.8))}return s.LinearGradient({colors:r,startPoint:"top",endPoint:"bottom"})},analogous:(t,e=60)=>s.LinearGradient({colors:[t,n.lighten(t,.2),n.darken(t,.2)],startPoint:"topLeading",endPoint:"bottomTrailing"}),complementary:(t,e)=>{const r=e||n.complement(t);return s.LinearGradient({colors:[t,r],startPoint:"topLeading",endPoint:"bottomTrailing"})},sunset:()=>s.LinearGradient({colors:["#ff7e5f","#feb47b","#ff6b6b","#c44569"],startPoint:"top",endPoint:"bottom"}),ocean:()=>s.LinearGradient({colors:["#667eea","#764ba2","#667eea"],startPoint:"topLeading",endPoint:"bottomTrailing"})},b={createHoverEffect:(t,e=.1)=>{const r=l.withOpacity(l.reverse(t),1-e);return{default:t,hover:r,animation:{duration:200,easing:"ease-out"}}},createButtonStates:(t,e="primary")=>{const o={primary:{base:t,hover:n.lighten(t,.1),active:n.darken(t,.1)},secondary:{base:"#f8f9fa",hover:"#e9ecef",active:"#dee2e6"},danger:{base:"#dc3545",hover:n.lighten("#dc3545",.1),active:n.darken("#dc3545",.1)}}[e];return{default:s.LinearGradient({colors:[o.base,n.darken(o.base,.05)],startPoint:"top",endPoint:"bottom"}),hover:s.LinearGradient({colors:[o.hover,n.darken(o.hover,.05)],startPoint:"top",endPoint:"bottom"}),active:s.LinearGradient({colors:[o.active,n.darken(o.active,.05)],startPoint:"top",endPoint:"bottom"}),disabled:"#cccccc",animation:{duration:150,easing:"ease-out"}}},createCardHover:(t="#ffffff")=>({default:t,hover:s.LinearGradient({colors:[n.withAlpha("#ffffff",.1),n.withAlpha("#f8f9fa",.1)],startPoint:"topLeading",endPoint:"bottomTrailing"}),animation:{duration:200,easing:"ease"}})},m={toCustomProperties:(t,e="gradient")=>{const r=d.gradientToCSS(t);return{[`--${e}-background`]:r}},withFallback:(t,e)=>{const r=d.gradientToCSS(t);return`background: ${e}; background: ${r};`},optimize:t=>t.replace(/\s+/g," ").replace(/,\s+/g,",").replace(/:\s+/g,":").trim()},S={...n,...l,...g,...h,...b,...m,toCSS:t=>typeof t=="string"?t:"resolve"in t&&typeof t.resolve=="function"?t.resolve():"type"in t&&"options"in t?d.gradientToCSS(t):"default"in t?S.toCSS(t.default):"transparent",clone:t=>JSON.parse(JSON.stringify(t)),equals:(t,e)=>JSON.stringify(t)===JSON.stringify(e)};exports.CSSUtils=m;exports.ColorUtils=n;exports.GradientAnalysis=g;exports.GradientGenerators=h;exports.GradientTransforms=l;exports.GradientUtils=S;exports.StateGradientUtils=b;
+//# sourceMappingURL=utils.cjs.map

package/dist/gradients/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","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/utils.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Gradient Utility Functions and Helper Methods
+ *
+ * Comprehensive utilities for gradient manipulation, analysis, and transformation.
+ */
+import type { Asset } from '../assets/types';
+import type { GradientDefinition, StateGradientOptions, StatefulBackgroundValue } from './types';
+/**
+ * Color manipulation utilities
+ */
+export declare const ColorUtils: {
+    /**
+     * Parse hex color to RGB components
+     */
+    readonly hexToRgb: (hex: string) => {
+        r: number;
+        g: number;
+        b: number;
+    } | null;
+    /**
+     * Convert RGB to hex
+     */
+    readonly rgbToHex: (r: number, g: number, b: number) => string;
+    /**
+     * Add transparency to a color
+     */
+    readonly withAlpha: (color: string, alpha: number) => string;
+    /**
+     * Blend two colors
+     */
+    readonly blendColors: (color1: string, color2: string, ratio?: number) => string;
+    /**
+     * Generate color variations (lighter/darker)
+     */
+    readonly lighten: (color: string, amount?: number) => string;
+    readonly darken: (color: string, amount?: number) => string;
+    /**
+     * Generate complementary color
+     */
+    readonly complement: (color: string) => string;
+    /**
+     * Get contrast ratio between two colors
+     */
+    readonly getContrastRatio: (color1: string, color2: string) => number;
+};
+/**
+ * Gradient transformation utilities
+ */
+export declare const GradientTransforms: {
+    /**
+     * Reverse gradient colors
+     */
+    readonly reverse: <T extends GradientDefinition>(gradient: T) => T;
+    /**
+     * Rotate linear gradient direction
+     */
+    readonly rotateLinear: (gradient: GradientDefinition, degrees: number) => GradientDefinition;
+    /**
+     * Scale radial gradient
+     */
+    readonly scaleRadial: (gradient: GradientDefinition, scale: number) => GradientDefinition;
+    /**
+     * Add transparency to entire gradient
+     */
+    readonly withOpacity: (gradient: GradientDefinition, opacity: number) => GradientDefinition;
+    /**
+     * Mirror a linear gradient (swap start and end points)
+     */
+    readonly mirror: (gradient: GradientDefinition) => GradientDefinition;
+    /**
+     * Convert linear gradient to radial
+     */
+    readonly toRadial: (gradient: GradientDefinition, radius?: number) => GradientDefinition;
+    /**
+     * Convert to angular/conic gradient
+     */
+    readonly toAngular: (gradient: GradientDefinition) => GradientDefinition;
+};
+/**
+ * Gradient analysis utilities
+ */
+export declare const GradientAnalysis: {
+    /**
+     * Get gradient color count
+     */
+    readonly getColorCount: (gradient: GradientDefinition) => number;
+    /**
+     * Extract colors from gradient
+     */
+    readonly extractColors: (gradient: GradientDefinition) => (string | Asset)[];
+    /**
+     * Get gradient complexity score (for performance optimization)
+     */
+    readonly getComplexityScore: (gradient: GradientDefinition) => number;
+    /**
+     * Check if gradient has transparency
+     */
+    readonly hasTransparency: (gradient: GradientDefinition) => boolean;
+    /**
+     * Estimate rendering performance impact
+     */
+    readonly getPerformanceImpact: (gradient: GradientDefinition) => "low" | "medium" | "high";
+};
+/**
+ * Gradient generation utilities
+ */
+export declare const GradientGenerators: {
+    /**
+     * Generate rainbow gradient
+     */
+    readonly rainbow: (steps?: number) => GradientDefinition;
+    /**
+     * Generate monochromatic gradient
+     */
+    readonly monochromatic: (baseColor: string, steps?: number) => GradientDefinition;
+    /**
+     * Generate analogous color gradient
+     */
+    readonly analogous: (baseColor: string, _range?: number) => GradientDefinition;
+    /**
+     * Generate complementary gradient
+     */
+    readonly complementary: (color1: string, color2?: string) => GradientDefinition;
+    /**
+     * Generate sunset gradient
+     */
+    readonly sunset: () => GradientDefinition;
+    /**
+     * Generate ocean gradient
+     */
+    readonly ocean: () => GradientDefinition;
+};
+/**
+ * State gradient utilities
+ */
+export declare const StateGradientUtils: {
+    /**
+     * Create hover effect gradient
+     */
+    readonly createHoverEffect: (baseGradient: GradientDefinition, intensity?: number) => StateGradientOptions;
+    /**
+     * Create button gradient states
+     */
+    readonly createButtonStates: (baseColor: string, type?: "primary" | "secondary" | "danger") => StateGradientOptions;
+    /**
+     * Create card hover effect
+     */
+    readonly createCardHover: (backgroundColor?: string) => StateGradientOptions;
+};
+/**
+ * CSS utility functions
+ */
+export declare const CSSUtils: {
+    /**
+     * Generate CSS custom properties for gradient
+     */
+    readonly toCustomProperties: (gradient: GradientDefinition, prefix?: string) => Record<string, string>;
+    /**
+     * Generate fallback CSS for older browsers
+     */
+    readonly withFallback: (gradient: GradientDefinition, fallbackColor: string) => string;
+    /**
+     * Optimize CSS for performance
+     */
+    readonly optimize: (css: string) => string;
+};
+/**
+ * Main gradient utilities export
+ */
+export declare const GradientUtils: {
+    /**
+     * Convert any background value to CSS
+     */
+    readonly toCSS: (background: StatefulBackgroundValue) => string;
+    /**
+     * Deep clone gradient definition
+     */
+    readonly clone: <T extends GradientDefinition>(gradient: T) => T;
+    /**
+     * Compare two gradients for equality
+     */
+    readonly equals: (a: GradientDefinition, b: GradientDefinition) => boolean;
+    /**
+     * Generate CSS custom properties for gradient
+     */
+    readonly toCustomProperties: (gradient: GradientDefinition, prefix?: string) => Record<string, string>;
+    /**
+     * Generate fallback CSS for older browsers
+     */
+    readonly withFallback: (gradient: GradientDefinition, fallbackColor: string) => string;
+    /**
+     * Optimize CSS for performance
+     */
+    readonly optimize: (css: string) => string;
+    /**
+     * Create hover effect gradient
+     */
+    readonly createHoverEffect: (baseGradient: GradientDefinition, intensity?: number) => StateGradientOptions;
+    /**
+     * Create button gradient states
+     */
+    readonly createButtonStates: (baseColor: string, type?: "primary" | "secondary" | "danger") => StateGradientOptions;
+    /**
+     * Create card hover effect
+     */
+    readonly createCardHover: (backgroundColor?: string) => StateGradientOptions;
+    /**
+     * Generate rainbow gradient
+     */
+    readonly rainbow: (steps?: number) => GradientDefinition;
+    /**
+     * Generate monochromatic gradient
+     */
+    readonly monochromatic: (baseColor: string, steps?: number) => GradientDefinition;
+    /**
+     * Generate analogous color gradient
+     */
+    readonly analogous: (baseColor: string, _range?: number) => GradientDefinition;
+    /**
+     * Generate complementary gradient
+     */
+    readonly complementary: (color1: string, color2?: string) => GradientDefinition;
+    /**
+     * Generate sunset gradient
+     */
+    readonly sunset: () => GradientDefinition;
+    /**
+     * Generate ocean gradient
+     */
+    readonly ocean: () => GradientDefinition;
+    /**
+     * Get gradient color count
+     */
+    readonly getColorCount: (gradient: GradientDefinition) => number;
+    /**
+     * Extract colors from gradient
+     */
+    readonly extractColors: (gradient: GradientDefinition) => (string | Asset)[];
+    /**
+     * Get gradient complexity score (for performance optimization)
+     */
+    readonly getComplexityScore: (gradient: GradientDefinition) => number;
+    /**
+     * Check if gradient has transparency
+     */
+    readonly hasTransparency: (gradient: GradientDefinition) => boolean;
+    /**
+     * Estimate rendering performance impact
+     */
+    readonly getPerformanceImpact: (gradient: GradientDefinition) => "low" | "medium" | "high";
+    /**
+     * Reverse gradient colors
+     */
+    readonly reverse: <T extends GradientDefinition>(gradient: T) => T;
+    /**
+     * Rotate linear gradient direction
+     */
+    readonly rotateLinear: (gradient: GradientDefinition, degrees: number) => GradientDefinition;
+    /**
+     * Scale radial gradient
+     */
+    readonly scaleRadial: (gradient: GradientDefinition, scale: number) => GradientDefinition;
+    /**
+     * Add transparency to entire gradient
+     */
+    readonly withOpacity: (gradient: GradientDefinition, opacity: number) => GradientDefinition;
+    /**
+     * Mirror a linear gradient (swap start and end points)
+     */
+    readonly mirror: (gradient: GradientDefinition) => GradientDefinition;
+    /**
+     * Convert linear gradient to radial
+     */
+    readonly toRadial: (gradient: GradientDefinition, radius?: number) => GradientDefinition;
+    /**
+     * Convert to angular/conic gradient
+     */
+    readonly toAngular: (gradient: GradientDefinition) => GradientDefinition;
+    /**
+     * Parse hex color to RGB components
+     */
+    readonly hexToRgb: (hex: string) => {
+        r: number;
+        g: number;
+        b: number;
+    } | null;
+    /**
+     * Convert RGB to hex
+     */
+    readonly rgbToHex: (r: number, g: number, b: number) => string;
+    /**
+     * Add transparency to a color
+     */
+    readonly withAlpha: (color: string, alpha: number) => string;
+    /**
+     * Blend two colors
+     */
+    readonly blendColors: (color1: string, color2: string, ratio?: number) => string;
+    /**
+     * Generate color variations (lighter/darker)
+     */
+    readonly lighten: (color: string, amount?: number) => string;
+    readonly darken: (color: string, amount?: number) => string;
+    /**
+     * Generate complementary color
+     */
+    readonly complement: (color: string) => string;
+    /**
+     * Get contrast ratio between two colors
+     */
+    readonly getContrastRatio: (color1: string, color2: string) => number;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/gradients/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/gradients/utils.ts"],"names":[],"mappings":"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"}