@shohojdhara/atomix 0.3.2 → 0.3.4

package/src/lib/theme/generators/TypeGenerator.ts

@@ -1,228 +0,0 @@
-/**
- * TypeScript Type Generator
- * 
- * Generates TypeScript type definitions from theme objects
- */
-
-import type { Theme } from '../types';
-
-/**
- * Type generation options
- */
-export interface TypeGeneratorOptions {
-  /** Module name for generated types */
-  moduleName?: string;
-  /** Include JSDoc comments */
-  includeComments?: boolean;
-  /** Export style */
-  exportStyle?: 'named' | 'default' | 'both';
-  /** Include theme interface augmentation */
-  includeAugmentation?: boolean;
-}
-
-/**
- * TypeScript Type Generator
- * 
- * Generates TypeScript definitions for theme objects
- */
-export class TypeGenerator {
-  private options: Required<TypeGeneratorOptions>;
-
-  constructor(options: TypeGeneratorOptions = {}) {
-    this.options = {
-      moduleName: options.moduleName || 'Theme',
-      includeComments: options.includeComments ?? true,
-      exportStyle: options.exportStyle || 'named',
-      includeAugmentation: options.includeAugmentation ?? false,
-    };
-  }
-
-  /**
-   * Generate TypeScript definitions from theme
-   */
-  generate(theme: Theme): string {
-    let output = '';
-
-    if (this.options.includeComments) {
-      output += this.generateHeader();
-    }
-
-    output += this.generateImports();
-    output += this.generateThemeInterface(theme);
-
-    if (this.options.includeAugmentation) {
-      output += this.generateAugmentation();
-    }
-
-    return output;
-  }
-
-  /**
-   * Generate file header
-   */
-  private generateHeader(): string {
-    return `/**
- * Generated Theme Types
- * 
- * Auto-generated TypeScript definitions for ${this.options.moduleName}
- * Do not edit this file directly.
- */
-
-`;
-  }
-
-  /**
-   * Generate imports
-   */
-  private generateImports(): string {
-    return `import type { Theme as BaseTheme } from '@shohojdhara/atomix/theme';
-
-`;
-  }
-
-  /**
-   * Generate theme interface
-   */
-  private generateThemeInterface(theme: Theme): string {
-    let output = '';
-
-    if (this.options.includeComments) {
-      output += `/**
- * ${theme.name || 'Custom'} Theme Interface
- */
-`;
-    }
-
-    output += `export interface ${this.options.moduleName} extends BaseTheme {\n`;
-    output += `  name: '${theme.name}';\n`;
-    
-    if (theme.class) {
-      output += `  class: '${theme.class}';\n`;
-    }
-
-    // Generate palette types
-    output += this.generatePaletteTypes(theme.palette);
-
-    // Generate typography types
-    output += this.generateTypographyTypes(theme.typography);
-
-    // Generate custom properties if any
-    if (Object.keys(theme.custom).length > 0) {
-      output += this.generateCustomTypes(theme.custom);
-    }
-
-    output += '}\n\n';
-
-    // Generate exports
-    if (this.options.exportStyle === 'default' || this.options.exportStyle === 'both') {
-      output += `declare const theme: ${this.options.moduleName};\n`;
-      output += `export default theme;\n\n`;
-    }
-
-    if (this.options.exportStyle === 'named' || this.options.exportStyle === 'both') {
-      output += `export type { ${this.options.moduleName} };\n`;
-    }
-
-    return output;
-  }
-
-  /**
-   * Generate palette types
-   */
-  private generatePaletteTypes(palette: Theme['palette']): string {
-    let output = '  palette: {\n';
-
-    const colors = ['primary', 'secondary', 'error', 'warning', 'info', 'success'] as const;
-    for (const color of colors) {
-      const colorObj = palette[color];
-      if (colorObj) {
-        output += `    ${color}: {\n`;
-        output += `      main: '${colorObj.main}';\n`;
-        if (colorObj.light) output += `      light: '${colorObj.light}';\n`;
-        if (colorObj.dark) output += `      dark: '${colorObj.dark}';\n`;
-        if (colorObj.contrastText) output += `      contrastText: '${colorObj.contrastText}';\n`;
-        output += '    };\n';
-      }
-    }
-
-    // Background
-    if (palette.background) {
-      output += '    background: {\n';
-      output += `      default: '${palette.background.default}';\n`;
-      output += `      paper: '${palette.background.paper}';\n`;
-      output += `      subtle: '${palette.background.subtle}';\n`;
-      output += '    };\n';
-    }
-
-    // Text
-    if (palette.text) {
-      output += '    text: {\n';
-      output += `      primary: '${palette.text.primary}';\n`;
-      output += `      secondary: '${palette.text.secondary}';\n`;
-      output += `      disabled: '${palette.text.disabled}';\n`;
-      output += '    };\n';
-    }
-
-    output += '  };\n';
-    return output;
-  }
-
-  /**
-   * Generate typography types
-   */
-  private generateTypographyTypes(typography: Theme['typography']): string {
-    let output = '  typography: {\n';
-    output += `    fontFamily: '${typography.fontFamily}';\n`;
-    output += `    fontSize: ${typography.fontSize};\n`;
-
-    // Font weights
-    if (typography.fontWeightLight) output += `    fontWeightLight: ${typography.fontWeightLight};\n`;
-    if (typography.fontWeightRegular) output += `    fontWeightRegular: ${typography.fontWeightRegular};\n`;
-    if (typography.fontWeightMedium) output += `    fontWeightMedium: ${typography.fontWeightMedium};\n`;
-    if (typography.fontWeightSemiBold) output += `    fontWeightSemiBold: ${typography.fontWeightSemiBold};\n`;
-    if (typography.fontWeightBold) output += `    fontWeightBold: ${typography.fontWeightBold};\n`;
-
-    output += '  };\n';
-    return output;
-  }
-
-  /**
-   * Generate custom property types
-   */
-  private generateCustomTypes(custom: Theme['custom']): string {
-    let output = '  custom: {\n';
-
-    for (const [key, value] of Object.entries(custom)) {
-      const type = typeof value === 'string' ? `'${value}'` : typeof value;
-      output += `    ${key}: ${type};\n`;
-    }
-
-    output += '  };\n';
-    return output;
-  }
-
-  /**
-   * Generate module augmentation
-   */
-  private generateAugmentation(): string {
-    return `
-declare module '@shohojdhara/atomix/theme' {
-  interface ThemeCustomProperties {
-    ${this.options.moduleName}: ${this.options.moduleName};
-  }
-}
-`;
-  }
-}
-
-/**
- * Generate TypeScript types from theme
- * 
- * @param theme - Theme object
- * @param options - Generation options
- * @returns TypeScript definition string
- */
-export function generateTypes(theme: Theme, options: TypeGeneratorOptions = {}): string {
-  const generator = new TypeGenerator(options);
-  return generator.generate(theme);
-}

package/src/lib/theme/generators/index.ts

@@ -1,21 +0,0 @@
-/**
- * Theme Generators Module
- * 
- * Code generation utilities for themes
- */
-
-export { CSSGenerator, generateCSS } from './CSSGenerator';
-export { TypeGenerator, generateTypes } from './TypeGenerator';
-export { ConfigGenerator, generateConfigTemplate } from './ConfigGenerator';
-
-export type {
-  CSSGeneratorOptions,
-} from './CSSGenerator';
-
-export type {
-  TypeGeneratorOptions,
-} from './TypeGenerator';
-
-export type {
-  ConfigGeneratorOptions,
-} from './ConfigGenerator';

package/src/lib/theme/monitoring/ThemeAnalytics.ts

@@ -1,409 +0,0 @@
-/**
- * Theme Analytics and Performance Monitoring
- * 
- * Tracks theme usage, performance metrics, and provides analytics
- */
-
-import { getLogger } from '../errors';
-
-/**
- * Theme analytics event types
- */
-export type ThemeAnalyticsEvent = 
-  | 'theme_load'
-  | 'theme_switch'
-  | 'theme_error'
-  | 'theme_revert'
-  | 'css_load'
-  | 'performance_metric';
-
-/**
- * Theme analytics event
- */
-export interface ThemeAnalyticsEventData {
-  /** Event type */
-  type: ThemeAnalyticsEvent;
-  /** Event timestamp */
-  timestamp: number;
-  /** Theme name */
-  themeName?: string;
-  /** Additional event data */
-  data?: Record<string, any>;
-}
-
-/**
- * Performance metric
- */
-export interface PerformanceMetric {
-  /** Metric name */
-  name: string;
-  /** Metric value */
-  value: number;
-  /** Unit */
-  unit: 'ms' | 'bytes' | 'count';
-  /** Timestamp */
-  timestamp: number;
-}
-
-/**
- * Analytics configuration
- */
-export interface AnalyticsConfig {
-  /** Enable analytics */
-  enabled?: boolean;
-  /** Enable performance tracking */
-  trackPerformance?: boolean;
-  /** Enable error tracking */
-  trackErrors?: boolean;
-  /** Custom event handler */
-  onEvent?: (event: ThemeAnalyticsEventData) => void;
-  /** Custom performance handler */
-  onPerformance?: (metric: PerformanceMetric) => void;
-  /** Buffer size for events */
-  bufferSize?: number;
-  /** Flush interval (ms) */
-  flushInterval?: number;
-}
-
-/**
- * Default analytics configuration
- */
-const DEFAULT_CONFIG: Required<Omit<AnalyticsConfig, 'onEvent' | 'onPerformance'>> = {
-  enabled: true,
-  trackPerformance: true,
-  trackErrors: true,
-  bufferSize: 100,
-  flushInterval: 5000,
-};
-
-/**
- * Theme Analytics Manager
- * 
- * Tracks theme usage, performance, and errors
- */
-export class ThemeAnalytics {
-  private config: Required<Omit<AnalyticsConfig, 'onEvent' | 'onPerformance'>> & {
-    onEvent?: AnalyticsConfig['onEvent'];
-    onPerformance?: AnalyticsConfig['onPerformance'];
-  };
-  private events: ThemeAnalyticsEventData[] = [];
-  private metrics: PerformanceMetric[] = [];
-  private flushTimer: ReturnType<typeof setInterval> | null = null;
-  private logger = getLogger();
-
-  constructor(config: AnalyticsConfig = {}) {
-    this.config = {
-      ...DEFAULT_CONFIG,
-      ...config,
-    };
-
-    if (this.config.enabled) {
-      this.startFlushTimer();
-    }
-  }
-
-  /**
-   * Track theme load event
-   */
-  trackThemeLoad(themeName: string, loadTime?: number): void {
-    if (!this.config.enabled) {
-      return;
-    }
-
-    const event: ThemeAnalyticsEventData = {
-      type: 'theme_load',
-      timestamp: Date.now(),
-      themeName,
-      data: loadTime ? { loadTime } : undefined,
-    };
-
-    this.addEvent(event);
-
-    if (loadTime !== undefined) {
-      this.trackPerformance('theme_load_time', loadTime, 'ms');
-    }
-  }
-
-  /**
-   * Track theme switch event
-   */
-  trackThemeSwitch(fromTheme: string, toTheme: string, switchTime?: number): void {
-    if (!this.config.enabled) {
-      return;
-    }
-
-    const event: ThemeAnalyticsEventData = {
-      type: 'theme_switch',
-      timestamp: Date.now(),
-      themeName: toTheme,
-      data: {
-        fromTheme,
-        toTheme,
-        ...(switchTime ? { switchTime } : {}),
-      },
-    };
-
-    this.addEvent(event);
-
-    if (switchTime !== undefined) {
-      this.trackPerformance('theme_switch_time', switchTime, 'ms');
-    }
-  }
-
-  /**
-   * Track theme error
-   */
-  trackError(themeName: string, error: Error | string): void {
-    if (!this.config.enabled || !this.config.trackErrors) {
-      return;
-    }
-
-    const event: ThemeAnalyticsEventData = {
-      type: 'theme_error',
-      timestamp: Date.now(),
-      themeName,
-      data: {
-        error: error instanceof Error ? error.message : error,
-        stack: error instanceof Error ? error.stack : undefined,
-      },
-    };
-
-    this.addEvent(event);
-  }
-
-  /**
-   * Track theme revert
-   */
-  trackThemeRevert(attemptedTheme: string, revertedToTheme: string | null, error: Error): void {
-    if (!this.config.enabled || !this.config.trackErrors) {
-      return;
-    }
-
-    const event: ThemeAnalyticsEventData = {
-      type: 'theme_revert',
-      timestamp: Date.now(),
-      themeName: attemptedTheme,
-      data: {
-        attemptedTheme,
-        revertedToTheme,
-        error: error.message,
-        stack: error.stack,
-      },
-    };
-
-    this.addEvent(event);
-  }
-
-  /**
-   * Track CSS load
-   */
-  trackCSSLoad(themeName: string, loadTime: number, size?: number): void {
-    if (!this.config.enabled) {
-      return;
-    }
-
-    const event: ThemeAnalyticsEventData = {
-      type: 'css_load',
-      timestamp: Date.now(),
-      themeName,
-      data: {
-        loadTime,
-        ...(size ? { size } : {}),
-      },
-    };
-
-    this.addEvent(event);
-
-    this.trackPerformance('css_load_time', loadTime, 'ms');
-    if (size !== undefined) {
-      this.trackPerformance('css_size', size, 'bytes');
-    }
-  }
-
-  /**
-   * Track performance metric
-   */
-  trackPerformance(name: string, value: number, unit: PerformanceMetric['unit'] = 'ms'): void {
-    if (!this.config.enabled || !this.config.trackPerformance) {
-      return;
-    }
-
-    const metric: PerformanceMetric = {
-      name,
-      value,
-      unit,
-      timestamp: Date.now(),
-    };
-
-    this.metrics.push(metric);
-
-    // Keep only last N metrics
-    if (this.metrics.length > this.config.bufferSize) {
-      this.metrics.shift();
-    }
-
-    // Notify handler
-    if (this.config.onPerformance) {
-      try {
-        this.config.onPerformance(metric);
-      } catch (error) {
-        this.logger.error(
-          'Error in performance handler',
-          error instanceof Error ? error : new Error(String(error)),
-          { metric }
-        );
-      }
-    }
-  }
-
-  /**
-   * Add event to buffer
-   */
-  private addEvent(event: ThemeAnalyticsEventData): void {
-    this.events.push(event);
-
-    // Keep only last N events
-    if (this.events.length > this.config.bufferSize) {
-      this.events.shift();
-    }
-
-    // Notify handler immediately
-    if (this.config.onEvent) {
-      try {
-        this.config.onEvent(event);
-      } catch (error) {
-        this.logger.error(
-          'Error in event handler',
-          error instanceof Error ? error : new Error(String(error)),
-          { event }
-        );
-      }
-    }
-  }
-
-  /**
-   * Get all events
-   */
-  getEvents(): ThemeAnalyticsEventData[] {
-    return [...this.events];
-  }
-
-  /**
-   * Get all metrics
-   */
-  getMetrics(): PerformanceMetric[] {
-    return [...this.metrics];
-  }
-
-  /**
-   * Get events by type
-   */
-  getEventsByType(type: ThemeAnalyticsEvent): ThemeAnalyticsEventData[] {
-    return this.events.filter(event => event.type === type);
-  }
-
-  /**
-   * Get metrics by name
-   */
-  getMetricsByName(name: string): PerformanceMetric[] {
-    return this.metrics.filter(metric => metric.name === name);
-  }
-
-  /**
-   * Get average performance metric
-   */
-  getAverageMetric(name: string): number | null {
-    const metrics = this.getMetricsByName(name);
-    if (metrics.length === 0) {
-      return null;
-    }
-
-    const sum = metrics.reduce((acc, metric) => acc + metric.value, 0);
-    return sum / metrics.length;
-  }
-
-  /**
-   * Clear all events and metrics
-   */
-  clear(): void {
-    this.events = [];
-    this.metrics = [];
-  }
-
-  /**
-   * Start flush timer
-   */
-  private startFlushTimer(): void {
-    if (this.flushTimer) {
-      return;
-    }
-
-    this.flushTimer = setInterval(() => {
-      // Auto-flush can be implemented here if needed
-      // For now, events are sent immediately via onEvent callback
-    }, this.config.flushInterval);
-  }
-
-  /**
-   * Stop flush timer
-   */
-  private stopFlushTimer(): void {
-    if (this.flushTimer) {
-      clearInterval(this.flushTimer);
-      this.flushTimer = null;
-    }
-  }
-
-  /**
-   * Enable analytics
-   */
-  enable(): void {
-    this.config.enabled = true;
-    this.startFlushTimer();
-  }
-
-  /**
-   * Disable analytics
-   */
-  disable(): void {
-    this.config.enabled = false;
-    this.stopFlushTimer();
-  }
-
-  /**
-   * Destroy analytics instance
-   */
-  destroy(): void {
-    this.stopFlushTimer();
-    this.clear();
-  }
-}
-
-/**
- * Create theme analytics instance
- */
-export function createThemeAnalytics(config?: AnalyticsConfig): ThemeAnalytics {
-  return new ThemeAnalytics(config);
-}
-
-/**
- * Global analytics instance (optional)
- */
-let globalAnalytics: ThemeAnalytics | null = null;
-
-/**
- * Get or create global analytics instance
- */
-export function getGlobalAnalytics(): ThemeAnalytics {
-  if (!globalAnalytics) {
-    globalAnalytics = createThemeAnalytics();
-  }
-  return globalAnalytics;
-}
-
-/**
- * Set global analytics instance
- */
-export function setGlobalAnalytics(analytics: ThemeAnalytics): void {
-  globalAnalytics = analytics;
-}

package/src/lib/theme/monitoring/index.ts

@@ -1,17 +0,0 @@
-/**
- * Theme Monitoring and Analytics Module
- */
-
-export * from './ThemeAnalytics';
-export {
-  ThemeAnalytics,
-  createThemeAnalytics,
-  getGlobalAnalytics,
-  setGlobalAnalytics,
-} from './ThemeAnalytics';
-export type {
-  ThemeAnalyticsEvent,
-  ThemeAnalyticsEventData,
-  PerformanceMetric,
-  AnalyticsConfig,
-} from './ThemeAnalytics';