@rakeyshgidwani/roger-ui-bank-theme-stan-design 0.1.4 → 0.1.5

package/src/themes/base-themes.ts

@@ -0,0 +1,55 @@
+// Base Theme Definitions
+// This file imports and exports all theme configurations with inheritance support
+
+import { MultiThemeConfig } from './types';
+import { applyThemeInheritance } from './inheritance';
+import { stanDesignTheme as stanDesignThemeRaw } from './themes/stan-design';
+import { harveyTheme as harveyThemeRaw } from './themes/harvey';
+import { defaultTheme } from './themes/default';
+
+// Apply inheritance to ensure all themes have complete configurations
+export const stanDesignTheme = applyThemeInheritance(stanDesignThemeRaw);
+export const harveyTheme = applyThemeInheritance(harveyThemeRaw);
+
+// Export the default theme for reference
+export { defaultTheme };
+
+/**
+ * Default themes map
+ */
+export const defaultThemes: Record<string, MultiThemeConfig> = {
+  'default': defaultTheme,
+  'stan-design': stanDesignTheme,
+  'harvey': harveyTheme
+};
+
+/**
+ * Theme categories for organization
+ */
+export const themeCategories = {
+  brand: ['stan-design'],
+  creative: ['harvey'],
+  custom: [],
+  accessibility: []
+} as const;
+
+/**
+ * Get theme by name
+ */
+export function getTheme(name: string): MultiThemeConfig | undefined {
+  return defaultThemes[name];
+}
+
+/**
+ * Get all available theme names
+ */
+export function getAvailableThemes(): string[] {
+  return Object.keys(defaultThemes);
+}
+
+/**
+ * Check if theme exists
+ */
+export function themeExists(name: string): boolean {
+  return name in defaultThemes;
+}

package/src/themes/colorManager.ts

@@ -0,0 +1,380 @@
+/**
+ * Color Management System
+ * Handles color generation, validation, and accessibility checking
+ */
+
+import { 
+  ColorScale, 
+  SemanticColors, 
+  ColorAccessibility, 
+  ColorGenerationConfig,
+  ColorPalette 
+} from './types';
+
+export class ColorManager {
+  /**
+   * Generate a complete color scale from a base color
+   */
+  static generateColorScale(config: ColorGenerationConfig): ColorScale {
+             const { baseColor, hueShift: _hueShift = 0, saturationAdjust = 0, lightnessAdjust = 0 } = config;
+    
+    // Parse the base color
+    const hsl = this.hexToHsl(baseColor);
+    if (!hsl) {
+      throw new Error(`Invalid color format: ${baseColor}`);
+    }
+
+             // Generate the scale - preserve base color at 500
+         const scale: ColorScale = {
+           50: this.adjustHsl(hsl, 0, saturationAdjust, 95 + lightnessAdjust),
+           100: this.adjustHsl(hsl, 0, saturationAdjust, 90 + lightnessAdjust),
+           200: this.adjustHsl(hsl, 0, saturationAdjust, 80 + lightnessAdjust),
+           300: this.adjustHsl(hsl, 0, saturationAdjust, 70 + lightnessAdjust),
+           400: this.adjustHsl(hsl, 0, saturationAdjust, 60 + lightnessAdjust),
+           500: baseColor, // Keep original base color
+           600: this.adjustHsl(hsl, 0, saturationAdjust, 40 + lightnessAdjust),
+           700: this.adjustHsl(hsl, 0, saturationAdjust, 30 + lightnessAdjust),
+           800: this.adjustHsl(hsl, 0, saturationAdjust, 20 + lightnessAdjust),
+           900: this.adjustHsl(hsl, 0, saturationAdjust, 10 + lightnessAdjust)
+         };
+
+    // Add optional variations
+    if (config.generateShades) {
+      scale.light = this.adjustHsl(hsl, 0, saturationAdjust, 98 + lightnessAdjust);
+      scale.dark = this.adjustHsl(hsl, 0, saturationAdjust, 5 + lightnessAdjust);
+    }
+
+    if (config.generateContrast) {
+      scale.contrast = this.generateContrastColor(baseColor);
+    }
+
+    return scale;
+  }
+
+  /**
+   * Generate semantic colors based on a primary color
+   */
+  static generateSemanticColors(primaryColor: string): SemanticColors {
+    const primaryHsl = this.hexToHsl(primaryColor);
+    if (!primaryHsl) {
+      throw new Error(`Invalid primary color: ${primaryColor}`);
+    }
+
+    // Generate semantic colors with appropriate hues
+    const successHue = 120; // Green
+    const warningHue = 45;  // Yellow/Orange
+    const errorHue = 0;     // Red
+    const infoHue = 210;    // Blue
+
+    return {
+      success: this.hslToHex(successHue, 70, 50),
+      warning: this.hslToHex(warningHue, 90, 50),
+      error: this.hslToHex(errorHue, 80, 50),
+      info: this.hslToHex(infoHue, 80, 50),
+      
+      // Light variants
+      successLight: this.hslToHex(successHue, 70, 90),
+      warningLight: this.hslToHex(warningHue, 90, 90),
+      errorLight: this.hslToHex(errorHue, 80, 90),
+      infoLight: this.hslToHex(infoHue, 80, 90),
+      
+      // Dark variants
+      successDark: this.hslToHex(successHue, 70, 30),
+      warningDark: this.hslToHex(warningHue, 90, 30),
+      errorDark: this.hslToHex(errorHue, 80, 30),
+      infoDark: this.hslToHex(infoHue, 80, 30)
+    };
+  }
+
+  /**
+   * Generate neutral color scale
+   */
+  static generateNeutralColors(baseColor: string = '#6b7280'): ColorScale {
+    const hsl = this.hexToHsl(baseColor);
+    if (!hsl) {
+      throw new Error(`Invalid neutral color: ${baseColor}`);
+    }
+
+             return {
+           50: this.hslToHex(hsl.h, 5, 97),
+           100: this.hslToHex(hsl.h, 5, 90),
+           200: this.hslToHex(hsl.h, 5, 80),
+           300: this.hslToHex(hsl.h, 5, 70),
+           400: this.hslToHex(hsl.h, 5, 60),
+           500: baseColor, // Keep original base color
+           600: this.hslToHex(hsl.h, 5, 40),
+           700: this.hslToHex(hsl.h, 5, 30),
+           800: this.hslToHex(hsl.h, 5, 20),
+           900: this.hslToHex(hsl.h, 5, 10)
+         };
+  }
+
+  /**
+   * Check color contrast for accessibility
+   */
+  static checkColorContrast(foreground: string, background: string): ColorAccessibility {
+    const ratio = this.calculateContrastRatio(foreground, background);
+    
+    const aa = ratio >= 4.5; // WCAG AA standard for normal text
+    const aaa = ratio >= 7;  // WCAG AAA standard for normal text
+    
+    const recommendations: string[] = [];
+    if (!aa) {
+      recommendations.push('Increase contrast to meet WCAG AA standards (4.5:1)');
+    }
+    if (!aaa) {
+      recommendations.push('Increase contrast to meet WCAG AAA standards (7:1)');
+    }
+    if (ratio < 3) {
+      recommendations.push('Consider using a different color combination for better readability');
+    }
+
+    return {
+      aa,
+      aaa,
+      contrastRatio: ratio,
+      recommended: recommendations
+    };
+  }
+
+  /**
+   * Validate color format
+   */
+  static isValidColor(color: string): boolean {
+    // Check hex format
+    if (/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color)) {
+      return true;
+    }
+    
+             // Check rgb format with valid range (0-255)
+         const rgbMatch = color.match(/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/);
+         if (rgbMatch) {
+           const [, r, g, b] = rgbMatch;
+           return parseInt(r) <= 255 && parseInt(g) <= 255 && parseInt(b) <= 255;
+         }
+    
+             // Check hsl format with valid ranges (h: 0-360, s: 0-100%, l: 0-100%)
+         const hslMatch = color.match(/^hsl\(\s*(\d+)\s*,\s*(\d+)%\s*,\s*(\d+)%\s*\)$/);
+         if (hslMatch) {
+           const [, h, s, l] = hslMatch;
+           return parseInt(h) <= 360 && parseInt(s) <= 100 && parseInt(l) <= 100;
+         }
+    
+    // Check named colors (basic set)
+    const namedColors = [
+      'black', 'white', 'red', 'green', 'blue', 'yellow', 'cyan', 'magenta',
+      'gray', 'grey', 'orange', 'purple', 'pink', 'brown', 'navy', 'teal'
+    ];
+    
+    return namedColors.includes(color.toLowerCase());
+  }
+
+  /**
+   * Convert hex color to HSL
+   */
+  private static hexToHsl(hex: string): { h: number; s: number; l: number } | null {
+    try {
+      // Remove # if present
+      hex = hex.replace('#', '');
+      
+      // Convert 3-digit hex to 6-digit
+      if (hex.length === 3) {
+        hex = hex.split('').map(char => char + char).join('');
+      }
+      
+      if (hex.length !== 6) {
+        return null;
+      }
+      
+      const r = parseInt(hex.substr(0, 2), 16) / 255;
+      const g = parseInt(hex.substr(2, 2), 16) / 255;
+      const b = parseInt(hex.substr(4, 2), 16) / 255;
+      
+      const max = Math.max(r, g, b);
+      const min = Math.min(r, g, b);
+      let h = 0;
+      let s = 0;
+      const l = (max + min) / 2;
+      
+      if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        
+        switch (max) {
+          case r:
+            h = (g - b) / d + (g < b ? 6 : 0);
+            break;
+          case g:
+            h = (b - r) / d + 2;
+            break;
+          case b:
+            h = (r - g) / d + 4;
+            break;
+        }
+        h /= 6;
+      }
+      
+      return {
+        h: Math.round(h * 360),
+        s: Math.round(s * 100),
+        l: Math.round(l * 100)
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Convert HSL to hex color
+   */
+  private static hslToHex(h: number, s: number, l: number): string {
+    h = h / 360;
+    s = s / 100;
+    l = l / 100;
+    
+    const hue2rgb = (p: number, q: number, t: number): number => {
+      if (t < 0) t += 1;
+      if (t > 1) t -= 1;
+      if (t < 1/6) return p + (q - p) * 6 * t;
+      if (t < 1/2) return q;
+      if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
+      return p;
+    };
+    
+    let r: number, g: number, b: number;
+    
+    if (s === 0) {
+      r = g = b = l;
+    } else {
+      const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+      const p = 2 * l - q;
+      r = hue2rgb(p, q, h + 1/3);
+      g = hue2rgb(p, q, h);
+      b = hue2rgb(p, q, h - 1/3);
+    }
+    
+    const toHex = (c: number): string => {
+      const hex = Math.round(c * 255).toString(16);
+      return hex.length === 1 ? '0' + hex : hex;
+    };
+    
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+  }
+
+  /**
+   * Adjust HSL values
+   */
+  private static adjustHsl(
+    base: { h: number; s: number; l: number },
+    hShift: number,
+    sAdjust: number,
+    lValue: number
+  ): string {
+    const h = (base.h + hShift) % 360;
+    const s = Math.max(0, Math.min(100, base.s + sAdjust));
+    const l = Math.max(0, Math.min(100, lValue));
+    
+    return this.hslToHex(h, s, l);
+  }
+
+  /**
+   * Calculate contrast ratio between two colors
+   */
+  private static calculateContrastRatio(color1: string, color2: string): number {
+    const luminance1 = this.calculateLuminance(color1);
+    const luminance2 = this.calculateLuminance(color2);
+    
+    const lighter = Math.max(luminance1, luminance2);
+    const darker = Math.min(luminance1, luminance2);
+    
+    return (lighter + 0.05) / (darker + 0.05);
+  }
+
+  /**
+   * Calculate relative luminance of a color
+   */
+  private static calculateLuminance(color: string): number {
+    const rgb = this.hexToRgb(color);
+    if (!rgb) return 0;
+    
+    const { r, g, b } = rgb;
+    
+    const [rs, gs, bs] = [r, g, b].map(c => {
+      c = c / 255;
+      return c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+    });
+    
+    return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
+  }
+
+  /**
+   * Convert hex to RGB
+   */
+  private static hexToRgb(hex: string): { r: number; g: number; b: number } | null {
+    try {
+      hex = hex.replace('#', '');
+      
+      if (hex.length === 3) {
+        hex = hex.split('').map(char => char + char).join('');
+      }
+      
+      if (hex.length !== 6) {
+        return null;
+      }
+      
+      return {
+        r: parseInt(hex.substr(0, 2), 16),
+        g: parseInt(hex.substr(2, 2), 16),
+        b: parseInt(hex.substr(4, 2), 16)
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Generate a high contrast color
+   */
+  private static generateContrastColor(baseColor: string): string {
+    const hsl = this.hexToHsl(baseColor);
+    if (!hsl) return '#000000';
+    
+    // Generate a contrasting color by shifting hue by 180 degrees
+    const contrastHue = (hsl.h + 180) % 360;
+    
+    // Use high saturation and appropriate lightness for contrast
+    return this.hslToHex(contrastHue, 80, hsl.l > 50 ? 20 : 80);
+  }
+
+  /**
+   * Create a color palette with accessibility information
+   */
+  static createColorPalette(
+    name: string,
+    baseColor: string,
+    description: string,
+    tags: string[] = []
+  ): ColorPalette {
+    const colors = this.generateColorScale({
+      baseColor,
+      generateShades: true,
+      generateContrast: true
+    });
+    
+    const accessibility = this.checkColorContrast(colors[500], '#ffffff');
+    
+    return {
+      name,
+      description,
+      colors,
+      accessibility,
+      usage: ['primary', 'accent', 'brand'],
+      tags: [...tags, 'generated', 'accessible']
+    };
+  }
+}
+
+/**
+ * Default color manager instance
+ */
+export const colorManager = new ColorManager();

package/src/themes/examples/dark-theme.ts

@@ -0,0 +1,154 @@
+import { createTheme, overrideTheme, PartialThemeConfig } from '../inheritance';
+import { stanDesignTheme } from '../base-themes';
+
+/**
+ * Example: Dark Theme using inheritance
+ * This theme overrides colors for a dark mode while keeping other properties
+ */
+const darkThemeConfig: PartialThemeConfig = {
+  meta: {
+    name: 'Dark Mode',
+    description: 'Dark variant with inheritance from default theme',
+    author: 'Theme Examples',
+    version: '1.0.0',
+    category: 'custom',
+    tags: ['dark', 'night', 'inheritance'],
+    preview: '/themes/dark-preview.png',
+    createdAt: '2024-12-01T00:00:00.000Z',
+    updatedAt: '2024-12-01T00:00:00.000Z'
+  },
+  colors: {
+    primary: {
+      50: '#0f172a',
+      100: '#1e293b',
+      200: '#334155',
+      300: '#475569',
+      400: '#64748b',
+      500: '#94a3b8',
+      600: '#cbd5e1',
+      700: '#e2e8f0',
+      800: '#f1f5f9',
+      900: '#f8fafc',
+      '500-rgb': '148, 163, 184',
+      '600-rgb': '203, 213, 225',
+      '700-rgb': '226, 232, 240'
+    },
+    secondary: {
+      50: '#f8fafc',
+      100: '#f1f5f9',
+      200: '#e2e8f0',
+      300: '#cbd5e1',
+      400: '#94a3b8',
+      500: '#64748b',
+      600: '#475569',
+      700: '#334155',
+      800: '#1e293b',
+      900: '#0f172a'
+    },
+    semantic: {
+      success: '#10b981',
+      warning: '#f59e0b',
+      error: '#ef4444',
+      info: '#3b82f6',
+      successRgb: '16, 185, 129',
+      warningRgb: '245, 158, 11',
+      errorRgb: '239, 68, 68',
+      infoRgb: '59, 130, 246',
+      'success-rgb': '16, 185, 129',
+      'warning-rgb': '245, 158, 11',
+      'error-rgb': '239, 68, 68',
+      'info-rgb': '59, 130, 246'
+    },
+    neutral: {
+      50: '#fafafa',
+      100: '#f5f5f5',
+      200: '#e5e5e5',
+      300: '#d4d4d4',
+      400: '#a3a3a3',
+      500: '#737373',
+      600: '#525252',
+      700: '#404040',
+      800: '#262626',
+      900: '#171717'
+    },
+    surface: {
+      background: '#0f172a',
+      surface: '#1e293b',
+      border: '#334155',
+      divider: '#475569'
+    },
+    text: {
+      primary: '#f8fafc',
+      secondary: '#e2e8f0',
+      muted: '#cbd5e1',
+      inverse: '#0f172a',
+      onPrimary: '#0f172a',
+      onSecondary: '#0f172a',
+      onSurface: '#f8fafc'
+    },
+    interactive: {
+      hover: '#1e293b',
+      active: '#334155',
+      focus: '#94a3b8',
+      disabled: '#475569'
+    },
+    // Additional dark mode colors
+    'bg-primary': '#0f172a',
+    'bg-secondary': '#1e293b',
+    'surface-bg': '#1e293b',
+    'text-primary': '#f8fafc',
+    'text-secondary': '#e2e8f0'
+  }
+  // All other properties (fonts, navigation, spacing, etc.) inherit from default
+};
+
+/**
+ * Create dark theme with full inheritance
+ */
+export const darkTheme = createTheme(darkThemeConfig);
+
+/**
+ * Example: Override an existing theme (Stan Design) to create a dark variant
+ */
+export const stanDesignDarkTheme = overrideTheme(stanDesignTheme, {
+  meta: {
+    name: 'Stan Design Dark',
+    description: 'Dark variant of Stan Design theme',
+    author: 'Theme Examples',
+    version: '1.0.0',
+    category: 'custom',
+    tags: ['dark', 'stan-design', 'professional'],
+    preview: '/themes/stan-design-dark-preview.png',
+    createdAt: '2024-12-01T00:00:00.000Z',
+    updatedAt: '2024-12-01T00:00:00.000Z'
+  },
+  colors: darkThemeConfig.colors
+});
+
+/**
+ * Example: Partial override for quick customizations
+ */
+export const quickDarkVariant = overrideTheme(stanDesignTheme, {
+  colors: {
+    primary: stanDesignTheme.colors.primary,
+    secondary: stanDesignTheme.colors.secondary,
+    semantic: stanDesignTheme.colors.semantic,
+    neutral: stanDesignTheme.colors.neutral,
+    surface: {
+      background: '#0f172a',
+      surface: '#1e293b',
+      border: '#334155',
+      divider: '#475569'
+    },
+    text: {
+      primary: '#f8fafc',
+      secondary: '#e2e8f0',
+      muted: '#cbd5e1',
+      inverse: '#0f172a',
+      onPrimary: '#0f172a',
+      onSecondary: '#0f172a',
+      onSurface: '#f8fafc'
+    },
+    interactive: stanDesignTheme.colors.interactive
+  }
+});

package/src/themes/examples/minimal-theme.ts

@@ -0,0 +1,108 @@
+import { createTheme, PartialThemeConfig } from '../inheritance';
+
+/**
+ * Example: Minimal Theme using inheritance
+ * This theme only defines the properties it wants to override.
+ * All other values will be inherited from the default theme.
+ */
+const minimalThemeConfig: PartialThemeConfig = {
+  meta: {
+    name: 'Minimal Blue',
+    description: 'A minimal theme that only overrides primary colors',
+    author: 'Theme Examples',
+    version: '1.0.0',
+    category: 'custom',
+    tags: ['minimal', 'blue', 'simple'],
+    preview: '/themes/minimal-blue-preview.png',
+    createdAt: '2024-12-01T00:00:00.000Z',
+    updatedAt: '2024-12-01T00:00:00.000Z'
+  },
+  colors: {
+    primary: {
+      50: '#eff6ff',
+      100: '#dbeafe',
+      200: '#bfdbfe',
+      300: '#93c5fd',
+      400: '#60a5fa',
+      500: '#2563eb', // Only override the main primary color
+      600: '#1d4ed8',
+      700: '#1e40af',
+      800: '#1e3a8a',
+      900: '#1e3a8a'
+      // All other primary colors will come from default theme
+    },
+    secondary: {
+      50: '#f8fafc',
+      100: '#f1f5f9',
+      200: '#e2e8f0',
+      300: '#cbd5e1',
+      400: '#94a3b8',
+      500: '#64748b',
+      600: '#475569',
+      700: '#334155',
+      800: '#1e293b',
+      900: '#0f172a'
+    },
+    semantic: {
+      success: '#10b981',
+      warning: '#f59e0b',
+      error: '#ef4444',
+      info: '#2563eb' // Override info color to match primary
+      // success, warning, error will come from default theme
+    },
+    neutral: {
+      50: '#fafafa',
+      100: '#f5f5f5',
+      200: '#e5e5e5',
+      300: '#d4d4d4',
+      400: '#a3a3a3',
+      500: '#737373',
+      600: '#525252',
+      700: '#404040',
+      800: '#262626',
+      900: '#171717'
+    },
+    surface: {
+      background: '#ffffff',
+      surface: '#f8fafc',
+      border: '#e2e8f0',
+      divider: '#cbd5e1'
+    },
+    text: {
+      primary: '#0f172a',
+      secondary: '#475569',
+      muted: '#64748b',
+      inverse: '#ffffff',
+      onPrimary: '#ffffff',
+      onSecondary: '#ffffff',
+      onSurface: '#0f172a'
+    },
+    interactive: {
+      hover: '#f1f5f9',
+      active: '#e2e8f0',
+      focus: '#3b82f6',
+      disabled: '#cbd5e1'
+    }
+    // All other colors will be inherited from default theme
+  }
+  // fonts, navigation, spacing, shadows, transitions will all come from default theme
+};
+
+/**
+ * Create the theme with inheritance applied
+ * This will have ALL properties filled in, using defaults where not specified
+ */
+export const minimalTheme = createTheme(minimalThemeConfig);
+
+/**
+ * Example of checking theme completeness
+ */
+import { themeInheritanceManager } from '../inheritance';
+
+// This will return an empty array since inheritance fills in all missing values
+const missingProperties = themeInheritanceManager.validateCompleteness(minimalTheme);
+console.log('Missing properties:', missingProperties); // Should be []
+
+// This will return true since all properties are present
+const hasCompleteInheritance = themeInheritanceManager.hasInheritance(minimalTheme);
+console.log('Has complete inheritance:', hasCompleteInheritance); // Should be true