@idealyst/theme 1.0.83 → 1.0.84

package/src/README.md

@@ -1,138 +0,0 @@
-# Theme System Components
-
-This directory contains the core components of the @idealyst/theme system. Each file serves a specific purpose in the theming architecture.
-
-## File Overview
-
-| File | Purpose | Key Exports |
-|------|---------|-------------|
-| **[themeBuilder.ts](themeBuilder.md)** | Core theme creation utilities | `createTheme`, `extendTheme`, `generateColorPalette` |
-| **[defaultThemes.ts](defaultThemes.md)** | Pre-built light and dark themes | `defaultLightTheme`, `defaultDarkTheme` |
-| **[colors.ts](colors.md)** | Base color palette definitions | `colorPalettes` (8 palettes × 10 shades) |
-| **[colorResolver.ts](colorResolver.md)** | Color resolution and utilities | Color manipulation functions |
-| **[variants.ts](variants.md)** | Type definitions for color variants | `ColorVariant`, `IntentVariant` types |
-| **[variantHelpers.ts](variantHelpers.md)** | Variant utility functions | Helper functions for variants |
-| **[breakpoints.ts](breakpoints.md)** | Responsive design breakpoints | `breakpoints` object |
-| **[common.ts](common.md)** | Shared theme properties | Typography, spacing, shadows |
-| **[unistyles.ts](unistyles.md)** | Unistyles integration | Theme registration utilities |
-
-## Architecture Overview
-
-### Core Theme Creation Flow
-
-1. **Color Palettes** (`colors.ts`) - Base color definitions
-2. **Color Resolution** (`colorResolver.ts`) - Color manipulation and generation
-3. **Theme Builder** (`themeBuilder.ts`) - Combines palettes into complete themes
-4. **Default Themes** (`defaultThemes.ts`) - Pre-configured light/dark themes
-5. **Unistyles Integration** (`unistyles.ts`) - Registration with styling system
-
-### Type System
-
-1. **Variants** (`variants.ts`) - Core type definitions
-2. **Variant Helpers** (`variantHelpers.ts`) - Utility functions for types
-3. **Common Properties** (`common.ts`) - Shared theme structure
-
-### Responsive System
-
-1. **Breakpoints** (`breakpoints.ts`) - Screen size definitions
-2. **Theme Builder** - Integrates breakpoints into themes
-
-## Usage Patterns
-
-### Creating a Custom Theme
-
-```tsx
-import { createTheme, generateColorPalette } from './themeBuilder';
-
-const customTheme = createTheme({
-  palettes: {
-    brand: generateColorPalette('#8b5cf6'),
-    // ... other palettes
-  },
-  intents: {
-    primary: 'brand',
-    // ... other intents
-  },
-});
-```
-
-### Extending Existing Themes
-
-```tsx
-import { extendTheme } from './themeBuilder';
-import { defaultLightTheme } from './defaultThemes';
-
-const brandedTheme = extendTheme(defaultLightTheme, {
-  palettes: {
-    brand: generateColorPalette('#8b5cf6'),
-  },
-});
-```
-
-### Using Color Utilities
-
-```tsx
-import { lighten, darken } from './colorResolver';
-
-const lighterBlue = lighten('#3b82f6', 0.2);
-const darkerBlue = darken('#3b82f6', 0.2);
-```
-
-## Key Concepts
-
-### Color Palettes
-Each color palette contains 10 shades (50-900) with 500 being the base color.
-
-### Intent System
-Semantic color mappings that provide consistent meaning across components:
-- `primary` - Main brand actions
-- `success` - Positive actions
-- `error` - Destructive actions
-- `warning` - Caution actions
-- `neutral` - Secondary actions
-
-### Component Color System
-Structured color mapping for UI components:
-- `text` - Text colors for different contexts
-- `surface` - Background colors for surfaces
-- `border` - Border colors for different states
-- `interactive` - Colors for interactive states
-
-### Theme Structure
-```tsx
-interface AppTheme {
-  palettes: Record<string, ThemeColorPalette>;
-  intents: Record<string, ResolvedIntent>;
-  colors: ThemeColorSystem;
-  typography: TypographySystem;
-  spacing: SpacingSystem;
-  borderRadius: BorderRadiusSystem;
-  shadows: ShadowSystem;
-  transitions: TransitionSystem;
-  breakpoints: BreakpointSystem;
-}
-```
-
-## Best Practices
-
-1. **Use Intent Colors**: Prefer intent-based colors over direct palette access
-2. **Leverage Color Generation**: Use `generateColorPalette` for consistent color scales
-3. **Extend Don't Replace**: Use `extendTheme` to modify existing themes
-4. **Type Safety**: Leverage TypeScript for theme validation
-5. **Responsive Design**: Use breakpoints for screen-size adaptations
-6. **Accessibility**: Ensure sufficient contrast ratios in custom themes
-
-## Performance Considerations
-
-- Themes are computed once and cached
-- Color generation is optimized for minimal computation
-- Type checking happens at build time, not runtime
-- Unistyles provides efficient style updates
-
-## Development Workflow
-
-1. **Theme Creation**: Start with `themeBuilder.ts` functions
-2. **Color Customization**: Modify palettes in `colors.ts` or use generators
-3. **Component Integration**: Use structured color system from themes
-4. **Responsive Design**: Leverage breakpoints for adaptive layouts
-5. **Testing**: Validate themes in both light and dark modes

package/src/breakpoints.ts

@@ -1,8 +0,0 @@
-export const breakpoints = {
-  xs: 0,
-  sm: 400,
-  md: 768,
-  lg: 1024,
-  xl: 1280,
-} as const;
-

package/src/colorResolver.ts

@@ -1,218 +0,0 @@
-import { 
-  colorPalettes, 
-  intentMappings, 
-  colorMappings, 
-  darkThemeOverrides,
-  type ColorPalette,
-  type ColorShade,
-  type IntentName,
-  type ColorName
-} from './colors';
-
-// Type for color references
-export type ColorReference = 
-  | string // Direct hex color like '#ffffff'
-  | `${ColorPalette}.${ColorShade}` // Palette reference like 'blue.500'
-  | IntentName // Intent reference like 'primary'
-  | `intent.${IntentName}.${keyof typeof intentMappings.primary}` // Intent property like 'intent.primary.main'
-  | `color.${ColorName}` // Color mapping like 'color.text.primary'
-  | keyof typeof colorMappings; // Direct color mapping like 'primary'
-
-// Theme context for color resolution
-export interface ThemeContext {
-  isDark: boolean;
-  colorPalettes: typeof colorPalettes;
-  intentMappings: any; // Use any to allow theme overrides
-  colorMappings: any;  // Use any to allow theme overrides
-}
-
-// Create theme context
-export function createThemeContext(isDark: boolean = false): ThemeContext {
-  const baseIntentMappings = isDark 
-    ? { ...intentMappings, ...darkThemeOverrides.intentMappings }
-    : intentMappings;
-    
-  const baseColorMappings = isDark
-    ? { ...colorMappings, ...darkThemeOverrides.colorMappings }
-    : colorMappings;
-
-  return {
-    isDark,
-    colorPalettes,
-    intentMappings: baseIntentMappings,
-    colorMappings: baseColorMappings,
-  };
-}
-
-// Resolve a color reference to a hex color
-export function resolveColor(
-  colorRef: ColorReference,
-  context: ThemeContext
-): string {
-  // If it's already a hex color, return as is
-  if (typeof colorRef === 'string' && colorRef.startsWith('#')) {
-    return colorRef;
-  }
-
-  // Handle palette references like 'blue.500'
-  if (typeof colorRef === 'string' && colorRef.includes('.')) {
-    const [paletteOrCategory, property] = colorRef.split('.');
-    
-    // Handle palette references
-    if (paletteOrCategory in context.colorPalettes) {
-      const palette = context.colorPalettes[paletteOrCategory as ColorPalette];
-      if (property in palette) {
-        return palette[property as unknown as ColorShade];
-      }
-    }
-    
-    // Handle color mappings like 'text.primary'
-    if (paletteOrCategory in context.colorMappings) {
-      const colorCategory = context.colorMappings[paletteOrCategory as keyof typeof context.colorMappings];
-      if (typeof colorCategory === 'object' && property in colorCategory) {
-        const nestedRef = colorCategory[property as keyof typeof colorCategory];
-        return resolveColor(nestedRef as ColorReference, context);
-      }
-    }
-  }
-
-  // Handle intent references like 'intent.primary.main'
-  if (typeof colorRef === 'string' && colorRef.startsWith('intent.')) {
-    const parts = colorRef.split('.');
-    if (parts.length === 3) {
-      const [, intentName, property] = parts;
-      return resolveIntentColor(
-        intentName as IntentName, 
-        property as keyof typeof intentMappings.primary, 
-        context
-      );
-    }
-  }
-
-  // Handle color mappings like 'color.text.primary'
-  if (typeof colorRef === 'string' && colorRef.startsWith('color.')) {
-    const path = colorRef.substring(6); // Remove 'color.' prefix
-    const [category, property] = path.split('.');
-    
-    if (category in context.colorMappings) {
-      const colorCategory = context.colorMappings[category as keyof typeof context.colorMappings];
-      if (typeof colorCategory === 'object' && property in colorCategory) {
-        const nestedRef = colorCategory[property as keyof typeof colorCategory];
-        return resolveColor(nestedRef as ColorReference, context);
-      }
-    }
-  }
-
-  // Handle direct intent references like 'primary'
-  if (typeof colorRef === 'string' && colorRef in context.intentMappings) {
-    return resolveIntentColor(colorRef as IntentName, 'main', context);
-  }
-
-  // Handle direct color mappings like 'primary' (when it's in colorMappings)
-  if (typeof colorRef === 'string' && colorRef in context.colorMappings) {
-    const mapping = context.colorMappings[colorRef as keyof typeof context.colorMappings];
-    return resolveColor(mapping as ColorReference, context);
-  }
-
-  // If we can't resolve it, return it as is (might be a CSS variable or other valid color)
-  console.warn(`Could not resolve color reference: ${colorRef}`);
-  return colorRef as string;
-}
-
-// Resolve a specific intent color property
-export function resolveIntentColor(
-  intentName: IntentName,
-  property: keyof typeof intentMappings.primary,
-  context: ThemeContext
-): string {
-  const intent = context.intentMappings[intentName];
-  if (!intent) {
-    console.warn(`Intent ${intentName} not found`);
-    return '#000000'; // Fallback color
-  }
-
-  const value = intent[property];
-  
-  // Handle palette references
-  if (typeof value === 'number') {
-    const palette = context.colorPalettes[intent.palette];
-    const shade = value as ColorShade;
-    if (shade in palette) {
-      return palette[shade];
-    }
-  }
-  
-  // Handle string references (like 'gray.900')
-  if (typeof value === 'string') {
-    return resolveColor(value, context);
-  }
-
-  // If we can't resolve it, return it as is
-  return value as string;
-}
-
-// Helper function to get all colors for an intent
-export function getIntentColors(intentName: IntentName, context: ThemeContext) {
-  const intent = context.intentMappings[intentName];
-  if (!intent) {
-    return {};
-  }
-
-  const colors: Record<string, string> = {};
-  
-  // Resolve all properties of the intent
-  for (const [key, value] of Object.entries(intent)) {
-    if (key === 'palette') continue; // Skip the palette reference
-    
-    colors[key] = resolveIntentColor(
-      intentName, 
-      key as keyof typeof intentMappings.primary, 
-      context
-    );
-  }
-
-  return colors;
-}
-
-// Helper function to get all colors for a palette
-export function getPaletteColors(paletteName: ColorPalette, context: ThemeContext) {
-  const palette = context.colorPalettes[paletteName];
-  if (!palette) {
-    return {};
-  }
-
-  return { ...palette };
-}
-
-// Helper function to validate color references
-export function isValidColorReference(colorRef: string, context: ThemeContext): boolean {
-  try {
-    const resolved = resolveColor(colorRef as ColorReference, context);
-    return resolved !== colorRef || colorRef.startsWith('#');
-  } catch {
-    return false;
-  }
-}
-
-// Helper function to get color with opacity
-export function getColorWithOpacity(colorRef: ColorReference, opacity: number, context: ThemeContext): string {
-  const resolvedColor = resolveColor(colorRef, context);
-  
-  // Convert hex to rgba
-  if (resolvedColor.startsWith('#')) {
-    const hex = resolvedColor.slice(1);
-    const r = parseInt(hex.slice(0, 2), 16);
-    const g = parseInt(hex.slice(2, 4), 16);
-    const b = parseInt(hex.slice(4, 6), 16);
-    
-    return `rgba(${r}, ${g}, ${b}, ${opacity})`;
-  }
-  
-  // For non-hex colors, return as is with opacity warning
-  console.warn(`Cannot add opacity to non-hex color: ${resolvedColor}`);
-  return resolvedColor;
-}
-
-// Export commonly used theme contexts
-export const lightThemeContext = createThemeContext(false);
-export const darkThemeContext = createThemeContext(true);