@tachui/cli 0.8.0-alpha → 0.8.5-alpha

package/dist/core/src/gradients/utils.js

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

package/dist/core/src/gradients/utils.js.map

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

package/dist/core/src/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