@tachui/core 0.7.0-alpha1

package/dist/validation/error-reporting.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Enhanced Error Reporting System - Phase 1C
+ *
+ * Rich error message templates, contextual suggestions, fix examples,
+ * and comprehensive developer guidance for validation errors.
+ */
+import type { RecoveryStrategy } from './enhanced-runtime';
+import { EnhancedValidationError } from './enhanced-runtime';
+/**
+ * Error severity levels
+ */
+export type ValidationErrorSeverity = 'critical' | 'error' | 'warning' | 'info';
+/**
+ * Error category for classification
+ */
+export type ValidationErrorCategory = 'component-construction' | 'modifier-usage' | 'prop-validation' | 'lifecycle' | 'performance' | 'accessibility' | 'best-practices';
+/**
+ * Fix suggestion with automated repair capability
+ */
+export interface FixSuggestion {
+    description: string;
+    code: string;
+    autoFix?: () => string;
+    difficulty: 'easy' | 'medium' | 'hard';
+}
+/**
+ * Enhanced error context with rich metadata
+ */
+export interface EnhancedErrorContext {
+    component: string;
+    package?: string;
+    property?: string;
+    category: ValidationErrorCategory;
+    severity: ValidationErrorSeverity;
+    errorCode: string;
+    suggestion: string;
+    documentation: string;
+    fixes: FixSuggestion[];
+    examples: {
+        wrong: string[];
+        correct: string[];
+    };
+    recoveryStrategy: RecoveryStrategy;
+    fallbackValue?: any;
+    autoFix?: () => any;
+    location?: {
+        file?: string;
+        line?: number;
+        column?: number;
+    };
+    relatedErrors?: string[];
+    commonMistakes?: string[];
+}
+/**
+ * Error message template for consistent formatting
+ */
+export interface ErrorMessageTemplate {
+    title: string;
+    description: string;
+    impact: string;
+    quickFix?: string;
+    detailedSolution?: string;
+    prevention?: string;
+    emoji: string;
+    color: 'red' | 'yellow' | 'blue' | 'gray';
+}
+/**
+ * Comprehensive error templates database
+ */
+export declare const ErrorTemplates: Record<string, ErrorMessageTemplate>;
+/**
+ * Error code generator for consistent error identification
+ */
+export declare class ErrorCodeGenerator {
+    private static categories;
+    static generate(category: ValidationErrorCategory, component: string, specific?: string): string;
+}
+/**
+ * Enhanced error reporter with rich formatting
+ */
+export declare class EnhancedErrorReporter {
+    private static instance;
+    private errorHistory;
+    private maxHistorySize;
+    static getInstance(): EnhancedErrorReporter;
+    /**
+     * Create enhanced validation error with rich context
+     */
+    createError(message: string, context: Partial<EnhancedErrorContext>): EnhancedValidationError;
+    /**
+     * Format error message with rich context
+     */
+    formatError(error: EnhancedValidationError): string;
+    /**
+     * Get error template by code or fallback to default
+     */
+    private getTemplate;
+    /**
+     * Substitute variables in template strings
+     */
+    private substituteVariables;
+    /**
+     * Get recovery strategy description
+     */
+    private getRecoveryDescription;
+    /**
+     * Record error in history for analytics
+     */
+    private recordError;
+    /**
+     * Get error statistics
+     */
+    getErrorStats(): {
+        totalErrors: number;
+        categories: {
+            [k: string]: number;
+        };
+        severities: {
+            [k: string]: number;
+        };
+        components: {
+            [k: string]: number;
+        };
+        recentErrors: {
+            code: string;
+            component: string;
+            message: string;
+            timestamp: number;
+        }[];
+    };
+    /**
+     * Clear error history
+     */
+    clearHistory(): void;
+    /**
+     * Export error report for debugging
+     */
+    exportErrorReport(): string;
+}
+/**
+ * Error suggestion engine for intelligent fixes
+ */
+export declare class ErrorSuggestionEngine {
+    /**
+     * Generate fix suggestions for common component errors
+     */
+    static generateComponentFixSuggestions(component: string, error: string, _args: unknown[]): FixSuggestion[];
+    /**
+     * Generate fix for missing parameters
+     */
+    private static generateParameterFix;
+    /**
+     * Generate fix for type mismatches
+     */
+    private static generateTypeFix;
+    /**
+     * Generate fix for null/undefined values
+     */
+    private static generateNullCheckFix;
+}
+export declare const errorReporter: EnhancedErrorReporter;
+export declare const ErrorReportingUtils: {
+    createError: (message: string, context: Partial<EnhancedErrorContext>) => EnhancedValidationError;
+    formatError: (error: EnhancedValidationError) => string;
+    getStats: () => {
+        totalErrors: number;
+        categories: {
+            [k: string]: number;
+        };
+        severities: {
+            [k: string]: number;
+        };
+        components: {
+            [k: string]: number;
+        };
+        recentErrors: {
+            code: string;
+            component: string;
+            message: string;
+            timestamp: number;
+        }[];
+    };
+    exportReport: () => string;
+    generateSuggestions: typeof ErrorSuggestionEngine.generateComponentFixSuggestions;
+};
+//# sourceMappingURL=error-reporting.d.ts.map

package/dist/validation/error-reporting.d.ts.map

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

package/dist/validation/error-reporting.js

@@ -0,0 +1,370 @@
+import { EnhancedValidationError as g } from "./enhanced-runtime.js";
+var f = Object.defineProperty, h = (n, t, e) => t in n ? f(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e, c = (n, t, e) => h(n, typeof t != "symbol" ? t + "" : t, e);
+const p = {
+  // Component Construction Errors
+  COMPONENT_MISSING_REQUIRED_PARAM: {
+    title: "Missing Required Parameter",
+    description: "The {component} component requires a {parameter} parameter to function correctly.",
+    impact: "Component will not render or may throw runtime errors.",
+    quickFix: "Add the missing {parameter} parameter.",
+    detailedSolution: "Check the component documentation for required parameters and their expected types.",
+    prevention: "Use TypeScript for compile-time validation of required parameters.",
+    emoji: "❌",
+    color: "red"
+  },
+  COMPONENT_INVALID_PARAM_TYPE: {
+    title: "Invalid Parameter Type",
+    description: "The {component} component received {received} but expected {expected}.",
+    impact: "May cause unexpected behavior or runtime errors.",
+    quickFix: "Convert the value to the expected type: {expected}.",
+    detailedSolution: "Ensure all parameters match the expected types. Use type guards or validation.",
+    prevention: "Enable strict TypeScript checking and use proper type annotations.",
+    emoji: "🔄",
+    color: "yellow"
+  },
+  COMPONENT_NULL_UNDEFINED_PARAM: {
+    title: "Null or Undefined Parameter",
+    description: "The {component} component received null or undefined for {parameter}.",
+    impact: "Component may not render correctly or throw errors.",
+    quickFix: "Provide a valid value or use conditional rendering.",
+    detailedSolution: "Check for null/undefined values before passing to components.",
+    prevention: "Use optional chaining (?.) and nullish coalescing (??) operators.",
+    emoji: "⚠️",
+    color: "yellow"
+  },
+  // Modifier Usage Errors
+  MODIFIER_NOT_EXISTS: {
+    title: "Unknown Modifier",
+    description: "The modifier .{modifier}() does not exist in the tachUI framework.",
+    impact: "Build errors or silent failures in modifier chains.",
+    quickFix: "Check the spelling or use a valid modifier name.",
+    detailedSolution: "Refer to the modifier documentation for available options.",
+    prevention: "Use IDE autocompletion and enable TypeScript strict mode.",
+    emoji: "🔍",
+    color: "red"
+  },
+  MODIFIER_INVALID_COMPONENT: {
+    title: "Invalid Modifier Usage",
+    description: "The modifier .{modifier}() is not valid for {component} components.",
+    impact: "Modifier will be ignored or cause styling issues.",
+    quickFix: "Use this modifier only on compatible components: {validComponents}.",
+    detailedSolution: "Each modifier has specific component compatibility. Check documentation.",
+    prevention: "Learn modifier-component compatibility rules.",
+    emoji: "🚫",
+    color: "yellow"
+  },
+  MODIFIER_WRONG_PARAMS: {
+    title: "Incorrect Modifier Parameters",
+    description: "The modifier .{modifier}() received incorrect parameters.",
+    impact: "Modifier may not work as expected or throw errors.",
+    quickFix: "Use the correct parameter format: {correctFormat}.",
+    detailedSolution: "Check modifier documentation for parameter requirements.",
+    prevention: "Use TypeScript for parameter validation.",
+    emoji: "📝",
+    color: "yellow"
+  },
+  // Prop Validation Errors
+  PROP_MISSING_REQUIRED: {
+    title: "Missing Required Property",
+    description: "The {component} component is missing the required {property} property.",
+    impact: "Component may not function correctly without this property.",
+    quickFix: "Add the {property} property to the component props.",
+    detailedSolution: "Required properties are essential for component functionality.",
+    prevention: "Use TypeScript interfaces to enforce required properties.",
+    emoji: "📋",
+    color: "red"
+  },
+  PROP_INVALID_TYPE: {
+    title: "Invalid Property Type",
+    description: "Property {property} expected {expected} but received {received}.",
+    impact: "May cause type errors or unexpected component behavior.",
+    quickFix: "Convert the value to {expected} type.",
+    detailedSolution: "Ensure all props match their expected types.",
+    prevention: "Use proper TypeScript typing for props.",
+    emoji: "🔧",
+    color: "yellow"
+  },
+  // Lifecycle Errors
+  LIFECYCLE_INVALID_STATE: {
+    title: "Invalid Component State",
+    description: "Component {component} is in an invalid state during {phase}.",
+    impact: "May cause rendering issues or memory leaks.",
+    quickFix: "Ensure proper component lifecycle management.",
+    detailedSolution: "Review component mounting, updating, and unmounting logic.",
+    prevention: "Follow React/component lifecycle best practices.",
+    emoji: "🔄",
+    color: "yellow"
+  },
+  // Performance Errors
+  PERFORMANCE_EXPENSIVE_RENDER: {
+    title: "Expensive Render Operation",
+    description: "Component {component} is performing expensive operations during render.",
+    impact: "May cause UI lag and poor user experience.",
+    quickFix: "Move expensive operations to useEffect or useMemo.",
+    detailedSolution: "Optimize component rendering by avoiding heavy computations.",
+    prevention: "Use performance profiling tools and React DevTools.",
+    emoji: "⚡",
+    color: "blue"
+  },
+  // Best Practices
+  BEST_PRACTICE_DEPRECATED: {
+    title: "Deprecated Usage",
+    description: "Using deprecated {feature} which will be removed in future versions.",
+    impact: "Code may break in future framework updates.",
+    quickFix: "Replace with the recommended alternative: {alternative}.",
+    detailedSolution: "Check migration guide for updated patterns.",
+    prevention: "Stay updated with framework changelog and migration guides.",
+    emoji: "⚠️",
+    color: "blue"
+  }
+};
+class l {
+  static generate(t, e, r) {
+    const o = this.categories[t], i = e.substring(0, 3).toUpperCase(), a = r ? r.substring(0, 3).toUpperCase() : "001", u = Date.now().toString(36).substring(-3).toUpperCase();
+    return `TACH-${o}-${i}-${a}-${u}`;
+  }
+}
+c(l, "categories", {
+  "component-construction": "CC",
+  "modifier-usage": "MU",
+  "prop-validation": "PV",
+  lifecycle: "LC",
+  performance: "PF",
+  accessibility: "AC",
+  "best-practices": "BP"
+});
+const d = class m {
+  constructor() {
+    c(this, "errorHistory", []), c(this, "maxHistorySize", 100);
+  }
+  static getInstance() {
+    return this.instance || (this.instance = new m()), this.instance;
+  }
+  /**
+   * Create enhanced validation error with rich context
+   */
+  createError(t, e) {
+    const o = {
+      component: "Unknown",
+      category: "component-construction",
+      severity: "error",
+      errorCode: l.generate(
+        e.category || "component-construction",
+        e.component || "Unknown",
+        e.property
+      ),
+      suggestion: "Please check the component documentation.",
+      documentation: "https://docs.tachui.dev/",
+      fixes: [],
+      examples: { wrong: [], correct: [] },
+      recoveryStrategy: "throw",
+      ...e
+    }, i = new g(t, o);
+    return this.recordError(i), i;
+  }
+  /**
+   * Format error message with rich context
+   */
+  formatError(t) {
+    const e = t.context, r = this.getTemplate(e.errorCode || "UNKNOWN");
+    let o = `${r.emoji} ${r.title}
+`;
+    return o += `📍 Error Code: ${e.errorCode}
+`, o += `🏷️  Category: ${e.category} | Severity: ${e.severity}
+
+`, o += `📋 Description:
+${this.substituteVariables(r.description, e)}
+
+`, o += `⚠️  Impact:
+${r.impact}
+
+`, r.quickFix && (o += `🔧 Quick Fix:
+${this.substituteVariables(r.quickFix, e)}
+
+`), e.examples.wrong.length > 0 && (o += `❌ Wrong:
+${e.examples.wrong.map((i) => `   ${i}`).join(`
+`)}
+
+`), e.examples.correct.length > 0 && (o += `✅ Correct:
+${e.examples.correct.map((i) => `   ${i}`).join(`
+`)}
+
+`), e.fixes.length > 0 && (o += `🔨 Available Fixes:
+`, e.fixes.forEach((i, a) => {
+      o += `   ${a + 1}. ${i.description} (${i.difficulty})
+`, o += `      ${i.code}
+`;
+    }), o += `
+`), o += `📚 Documentation: ${e.documentation}
+`, e.commonMistakes && e.commonMistakes.length > 0 && (o += `💡 Common Mistakes:
+${e.commonMistakes.map((i) => `   • ${i}`).join(`
+`)}
+`), o += `🛡️  Recovery: ${this.getRecoveryDescription(e.recoveryStrategy)}
+`, o;
+  }
+  /**
+   * Get error template by code or fallback to default
+   */
+  getTemplate(t) {
+    const e = t.split("-");
+    if (e.length >= 2) {
+      const r = e[1], i = Object.keys(p).find((a) => r === "CC" ? a.startsWith("COMPONENT_") : r === "MU" ? a.startsWith("MODIFIER_") : r === "PV" ? a.startsWith("PROP_") : r === "LC" ? a.startsWith("LIFECYCLE_") : r === "PF" ? a.startsWith("PERFORMANCE_") : r === "BP" ? a.startsWith("BEST_PRACTICE_") : !1);
+      if (i)
+        return p[i];
+    }
+    return {
+      title: "Validation Error",
+      description: "A validation error occurred.",
+      impact: "May affect component functionality.",
+      emoji: "❌",
+      color: "red"
+    };
+  }
+  /**
+   * Substitute variables in template strings
+   */
+  substituteVariables(t, e) {
+    return t.replace(/\{component\}/g, e.component).replace(/\{package\}/g, e.package || "Core").replace(/\{property\}/g, e.property || "property").replace(/\{parameter\}/g, e.property || "parameter").replace(/\{modifier\}/g, e.property || "modifier");
+  }
+  /**
+   * Get recovery strategy description
+   */
+  getRecoveryDescription(t) {
+    switch (t) {
+      case "ignore":
+        return "Error will be ignored and execution continues";
+      case "fallback":
+        return "Fallback value will be used";
+      case "fix":
+        return "Automatic fix will be applied if available";
+      case "throw":
+        return "Error will be thrown and must be handled";
+      default:
+        return "No recovery strategy specified";
+    }
+  }
+  /**
+   * Record error in history for analytics
+   */
+  recordError(t) {
+    this.errorHistory.push(t), this.errorHistory.length > this.maxHistorySize && this.errorHistory.shift();
+  }
+  /**
+   * Get error statistics
+   */
+  getErrorStats() {
+    const t = /* @__PURE__ */ new Map(), e = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+    return this.errorHistory.forEach((o) => {
+      const i = o.context;
+      t.set(i.category, (t.get(i.category) || 0) + 1), e.set(i.severity, (e.get(i.severity) || 0) + 1), r.set(i.component, (r.get(i.component) || 0) + 1);
+    }), {
+      totalErrors: this.errorHistory.length,
+      categories: Object.fromEntries(t),
+      severities: Object.fromEntries(e),
+      components: Object.fromEntries(r),
+      recentErrors: this.errorHistory.slice(-10).map((o) => ({
+        code: o.context.errorCode,
+        component: o.context.component,
+        message: o.message,
+        timestamp: Date.now()
+      }))
+    };
+  }
+  /**
+   * Clear error history
+   */
+  clearHistory() {
+    this.errorHistory = [];
+  }
+  /**
+   * Export error report for debugging
+   */
+  exportErrorReport() {
+    const t = this.getErrorStats(), e = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      framework: "tachUI",
+      version: "1.0.0",
+      // Would be dynamic in real implementation
+      stats: t,
+      errors: this.errorHistory.map((r) => ({
+        code: r.context.errorCode,
+        message: r.message,
+        context: r.context,
+        stack: r.stack
+      }))
+    };
+    return JSON.stringify(e, null, 2);
+  }
+};
+c(d, "instance");
+let y = d;
+class E {
+  /**
+   * Generate fix suggestions for common component errors
+   */
+  static generateComponentFixSuggestions(t, e, r) {
+    const o = [];
+    return e.includes("requires") && e.includes("parameter") && o.push({
+      description: `Add the missing parameter to ${t}`,
+      code: this.generateParameterFix(t, r),
+      difficulty: "easy",
+      autoFix: () => this.generateParameterFix(t, r)
+    }), e.includes("type") && e.includes("expected") && o.push({
+      description: "Convert value to expected type",
+      code: this.generateTypeFix(t, r),
+      difficulty: "medium"
+    }), (e.includes("null") || e.includes("undefined")) && o.push({
+      description: "Add null check and default value",
+      code: this.generateNullCheckFix(t, r),
+      difficulty: "easy"
+    }), o;
+  }
+  /**
+   * Generate fix for missing parameters
+   */
+  static generateParameterFix(t, e) {
+    return {
+      Text: 'Text("Hello World")',
+      Button: 'Button("Click me", () => {})',
+      Image: 'Image({ source: "image.jpg" })',
+      Toggle: "Toggle({ isOn: false })",
+      VStack: "VStack({ children: [] })",
+      HStack: "HStack({ children: [] })"
+    }[t] || `${t}({ /* add required props */ })`;
+  }
+  /**
+   * Generate fix for type mismatches
+   */
+  static generateTypeFix(t, e) {
+    if (e.length > 0) {
+      const r = e[0];
+      if (typeof r == "number")
+        return `${t}(String(${r})) // Convert number to string`;
+      if (typeof r == "object")
+        return `${t}(JSON.stringify(${JSON.stringify(r)})) // Serialize object`;
+    }
+    return `${t}(/* provide correct type */)`;
+  }
+  /**
+   * Generate fix for null/undefined values
+   */
+  static generateNullCheckFix(t, e) {
+    return `${t}(value || "default") // Provide fallback for null/undefined`;
+  }
+}
+const s = y.getInstance(), C = {
+  createError: (n, t) => s.createError(n, t),
+  formatError: (n) => s.formatError(n),
+  getStats: () => s.getErrorStats(),
+  exportReport: () => s.exportErrorReport(),
+  generateSuggestions: E.generateComponentFixSuggestions
+};
+export {
+  y as EnhancedErrorReporter,
+  l as ErrorCodeGenerator,
+  C as ErrorReportingUtils,
+  E as ErrorSuggestionEngine,
+  p as ErrorTemplates,
+  s as errorReporter
+};
+//# sourceMappingURL=error-reporting.js.map

package/dist/validation/error-reporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting.js","sources":["../../src/validation/error-reporting.ts"],"sourcesContent":["/**\n * Enhanced Error Reporting System - Phase 1C\n * \n * Rich error message templates, contextual suggestions, fix examples,\n * and comprehensive developer guidance for validation errors.\n */\n\nimport type { RecoveryStrategy } from './enhanced-runtime'\nimport { EnhancedValidationError } from './enhanced-runtime'\n\n/**\n * Error severity levels\n */\nexport type ValidationErrorSeverity = 'critical' | 'error' | 'warning' | 'info'\n\n/**\n * Error category for classification\n */\nexport type ValidationErrorCategory = \n  | 'component-construction'\n  | 'modifier-usage'\n  | 'prop-validation'\n  | 'lifecycle'\n  | 'performance'\n  | 'accessibility'\n  | 'best-practices'\n\n/**\n * Fix suggestion with automated repair capability\n */\nexport interface FixSuggestion {\n  description: string\n  code: string\n  autoFix?: () => string\n  difficulty: 'easy' | 'medium' | 'hard'\n}\n\n/**\n * Enhanced error context with rich metadata\n */\nexport interface EnhancedErrorContext {\n  component: string\n  package?: string\n  property?: string\n  \n  // Error classification\n  category: ValidationErrorCategory\n  severity: ValidationErrorSeverity\n  errorCode: string\n  \n  // Developer guidance\n  suggestion: string\n  documentation: string\n  fixes: FixSuggestion[]\n  \n  // Examples\n  examples: {\n    wrong: string[]\n    correct: string[]\n  }\n  \n  // Recovery options\n  recoveryStrategy: RecoveryStrategy\n  fallbackValue?: any\n  autoFix?: () => any\n  \n  // Context information\n  location?: {\n    file?: string\n    line?: number\n    column?: number\n  }\n  \n  // Related errors\n  relatedErrors?: string[]\n  commonMistakes?: string[]\n}\n\n/**\n * Error message template for consistent formatting\n */\nexport interface ErrorMessageTemplate {\n  title: string\n  description: string\n  impact: string\n  \n  // Developer guidance sections\n  quickFix?: string\n  detailedSolution?: string\n  prevention?: string\n  \n  // Visual formatting\n  emoji: string\n  color: 'red' | 'yellow' | 'blue' | 'gray'\n}\n\n/**\n * Comprehensive error templates database\n */\nexport const ErrorTemplates: Record<string, ErrorMessageTemplate> = {\n  // Component Construction Errors\n  'COMPONENT_MISSING_REQUIRED_PARAM': {\n    title: 'Missing Required Parameter',\n    description: 'The {component} component requires a {parameter} parameter to function correctly.',\n    impact: 'Component will not render or may throw runtime errors.',\n    quickFix: 'Add the missing {parameter} parameter.',\n    detailedSolution: 'Check the component documentation for required parameters and their expected types.',\n    prevention: 'Use TypeScript for compile-time validation of required parameters.',\n    emoji: '❌',\n    color: 'red'\n  },\n\n  'COMPONENT_INVALID_PARAM_TYPE': {\n    title: 'Invalid Parameter Type',\n    description: 'The {component} component received {received} but expected {expected}.',\n    impact: 'May cause unexpected behavior or runtime errors.',\n    quickFix: 'Convert the value to the expected type: {expected}.',\n    detailedSolution: 'Ensure all parameters match the expected types. Use type guards or validation.',\n    prevention: 'Enable strict TypeScript checking and use proper type annotations.',\n    emoji: '🔄',\n    color: 'yellow'\n  },\n\n  'COMPONENT_NULL_UNDEFINED_PARAM': {\n    title: 'Null or Undefined Parameter',\n    description: 'The {component} component received null or undefined for {parameter}.',\n    impact: 'Component may not render correctly or throw errors.',\n    quickFix: 'Provide a valid value or use conditional rendering.',\n    detailedSolution: 'Check for null/undefined values before passing to components.',\n    prevention: 'Use optional chaining (?.) and nullish coalescing (??) operators.',\n    emoji: '⚠️',\n    color: 'yellow'\n  },\n\n  // Modifier Usage Errors\n  'MODIFIER_NOT_EXISTS': {\n    title: 'Unknown Modifier',\n    description: 'The modifier .{modifier}() does not exist in the tachUI framework.',\n    impact: 'Build errors or silent failures in modifier chains.',\n    quickFix: 'Check the spelling or use a valid modifier name.',\n    detailedSolution: 'Refer to the modifier documentation for available options.',\n    prevention: 'Use IDE autocompletion and enable TypeScript strict mode.',\n    emoji: '🔍',\n    color: 'red'\n  },\n\n  'MODIFIER_INVALID_COMPONENT': {\n    title: 'Invalid Modifier Usage',\n    description: 'The modifier .{modifier}() is not valid for {component} components.',\n    impact: 'Modifier will be ignored or cause styling issues.',\n    quickFix: 'Use this modifier only on compatible components: {validComponents}.',\n    detailedSolution: 'Each modifier has specific component compatibility. Check documentation.',\n    prevention: 'Learn modifier-component compatibility rules.',\n    emoji: '🚫',\n    color: 'yellow'\n  },\n\n  'MODIFIER_WRONG_PARAMS': {\n    title: 'Incorrect Modifier Parameters',\n    description: 'The modifier .{modifier}() received incorrect parameters.',\n    impact: 'Modifier may not work as expected or throw errors.',\n    quickFix: 'Use the correct parameter format: {correctFormat}.',\n    detailedSolution: 'Check modifier documentation for parameter requirements.',\n    prevention: 'Use TypeScript for parameter validation.',\n    emoji: '📝',\n    color: 'yellow'\n  },\n\n  // Prop Validation Errors\n  'PROP_MISSING_REQUIRED': {\n    title: 'Missing Required Property',\n    description: 'The {component} component is missing the required {property} property.',\n    impact: 'Component may not function correctly without this property.',\n    quickFix: 'Add the {property} property to the component props.',\n    detailedSolution: 'Required properties are essential for component functionality.',\n    prevention: 'Use TypeScript interfaces to enforce required properties.',\n    emoji: '📋',\n    color: 'red'\n  },\n\n  'PROP_INVALID_TYPE': {\n    title: 'Invalid Property Type',\n    description: 'Property {property} expected {expected} but received {received}.',\n    impact: 'May cause type errors or unexpected component behavior.',\n    quickFix: 'Convert the value to {expected} type.',\n    detailedSolution: 'Ensure all props match their expected types.',\n    prevention: 'Use proper TypeScript typing for props.',\n    emoji: '🔧',\n    color: 'yellow'\n  },\n\n  // Lifecycle Errors\n  'LIFECYCLE_INVALID_STATE': {\n    title: 'Invalid Component State',\n    description: 'Component {component} is in an invalid state during {phase}.',\n    impact: 'May cause rendering issues or memory leaks.',\n    quickFix: 'Ensure proper component lifecycle management.',\n    detailedSolution: 'Review component mounting, updating, and unmounting logic.',\n    prevention: 'Follow React/component lifecycle best practices.',\n    emoji: '🔄',\n    color: 'yellow'\n  },\n\n  // Performance Errors\n  'PERFORMANCE_EXPENSIVE_RENDER': {\n    title: 'Expensive Render Operation',\n    description: 'Component {component} is performing expensive operations during render.',\n    impact: 'May cause UI lag and poor user experience.',\n    quickFix: 'Move expensive operations to useEffect or useMemo.',\n    detailedSolution: 'Optimize component rendering by avoiding heavy computations.',\n    prevention: 'Use performance profiling tools and React DevTools.',\n    emoji: '⚡',\n    color: 'blue'\n  },\n\n  // Best Practices\n  'BEST_PRACTICE_DEPRECATED': {\n    title: 'Deprecated Usage',\n    description: 'Using deprecated {feature} which will be removed in future versions.',\n    impact: 'Code may break in future framework updates.',\n    quickFix: 'Replace with the recommended alternative: {alternative}.',\n    detailedSolution: 'Check migration guide for updated patterns.',\n    prevention: 'Stay updated with framework changelog and migration guides.',\n    emoji: '⚠️',\n    color: 'blue'\n  }\n}\n\n/**\n * Error code generator for consistent error identification\n */\nexport class ErrorCodeGenerator {\n  private static categories = {\n    'component-construction': 'CC',\n    'modifier-usage': 'MU',\n    'prop-validation': 'PV',\n    'lifecycle': 'LC',\n    'performance': 'PF',\n    'accessibility': 'AC',\n    'best-practices': 'BP'\n  }\n\n  static generate(category: ValidationErrorCategory, component: string, specific?: string): string {\n    const categoryCode = this.categories[category]\n    const componentCode = component.substring(0, 3).toUpperCase()\n    const specificCode = specific ? specific.substring(0, 3).toUpperCase() : '001'\n    const timestamp = Date.now().toString(36).substring(-3).toUpperCase()\n    \n    return `TACH-${categoryCode}-${componentCode}-${specificCode}-${timestamp}`\n  }\n}\n\n/**\n * Enhanced error reporter with rich formatting\n */\nexport class EnhancedErrorReporter {\n  private static instance: EnhancedErrorReporter\n  private errorHistory: EnhancedValidationError[] = []\n  private maxHistorySize = 100\n\n  static getInstance(): EnhancedErrorReporter {\n    if (!this.instance) {\n      this.instance = new EnhancedErrorReporter()\n    }\n    return this.instance\n  }\n\n  /**\n   * Create enhanced validation error with rich context\n   */\n  createError(\n    message: string,\n    context: Partial<EnhancedErrorContext>\n  ): EnhancedValidationError {\n    const errorCode = ErrorCodeGenerator.generate(\n      context.category || 'component-construction',\n      context.component || 'Unknown',\n      context.property\n    )\n\n    const enhancedContext: EnhancedErrorContext = {\n      component: 'Unknown',\n      category: 'component-construction',\n      severity: 'error',\n      errorCode,\n      suggestion: 'Please check the component documentation.',\n      documentation: 'https://docs.tachui.dev/',\n      fixes: [],\n      examples: { wrong: [], correct: [] },\n      recoveryStrategy: 'throw',\n      ...context\n    }\n\n    const error = new EnhancedValidationError(message, enhancedContext)\n    this.recordError(error)\n    return error\n  }\n\n  /**\n   * Format error message with rich context\n   */\n  formatError(error: EnhancedValidationError): string {\n    const context = error.context as any as EnhancedErrorContext\n    const template = this.getTemplate(context.errorCode || 'UNKNOWN')\n    \n    let formatted = `${template.emoji} ${template.title}\\n`\n    formatted += `📍 Error Code: ${context.errorCode}\\n`\n    formatted += `🏷️  Category: ${context.category} | Severity: ${context.severity}\\n\\n`\n    \n    // Description with context substitution\n    formatted += `📋 Description:\\n${this.substituteVariables(template.description, context)}\\n\\n`\n    \n    // Impact\n    formatted += `⚠️  Impact:\\n${template.impact}\\n\\n`\n    \n    // Quick fix\n    if (template.quickFix) {\n      formatted += `🔧 Quick Fix:\\n${this.substituteVariables(template.quickFix, context)}\\n\\n`\n    }\n    \n    // Examples\n    if (context.examples.wrong.length > 0) {\n      formatted += `❌ Wrong:\\n${context.examples.wrong.map(ex => `   ${ex}`).join('\\n')}\\n\\n`\n    }\n    \n    if (context.examples.correct.length > 0) {\n      formatted += `✅ Correct:\\n${context.examples.correct.map(ex => `   ${ex}`).join('\\n')}\\n\\n`\n    }\n    \n    // Fix suggestions\n    if (context.fixes.length > 0) {\n      formatted += `🔨 Available Fixes:\\n`\n      context.fixes.forEach((fix, index) => {\n        formatted += `   ${index + 1}. ${fix.description} (${fix.difficulty})\\n`\n        formatted += `      ${fix.code}\\n`\n      })\n      formatted += '\\n'\n    }\n    \n    // Documentation\n    formatted += `📚 Documentation: ${context.documentation}\\n`\n    \n    // Related information\n    if (context.commonMistakes && context.commonMistakes.length > 0) {\n      formatted += `💡 Common Mistakes:\\n${context.commonMistakes.map(m => `   • ${m}`).join('\\n')}\\n`\n    }\n    \n    // Recovery information\n    formatted += `🛡️  Recovery: ${this.getRecoveryDescription(context.recoveryStrategy)}\\n`\n    \n    return formatted\n  }\n\n  /**\n   * Get error template by code or fallback to default\n   */\n  private getTemplate(errorCode: string): ErrorMessageTemplate {\n    // Extract template key from error code\n    const parts = errorCode.split('-')\n    if (parts.length >= 2) {\n      const category = parts[1]\n      const templateKeys = Object.keys(ErrorTemplates)\n      const matchingTemplate = templateKeys.find(key => {\n        if (category === 'CC') return key.startsWith('COMPONENT_')\n        if (category === 'MU') return key.startsWith('MODIFIER_')\n        if (category === 'PV') return key.startsWith('PROP_')\n        if (category === 'LC') return key.startsWith('LIFECYCLE_')\n        if (category === 'PF') return key.startsWith('PERFORMANCE_')\n        if (category === 'BP') return key.startsWith('BEST_PRACTICE_')\n        return false\n      })\n      \n      if (matchingTemplate) {\n        return ErrorTemplates[matchingTemplate]\n      }\n    }\n    \n    // Fallback to generic template\n    return {\n      title: 'Validation Error',\n      description: 'A validation error occurred.',\n      impact: 'May affect component functionality.',\n      emoji: '❌',\n      color: 'red'\n    }\n  }\n\n  /**\n   * Substitute variables in template strings\n   */\n  private substituteVariables(template: string, context: EnhancedErrorContext): string {\n    return template\n      .replace(/\\{component\\}/g, context.component)\n      .replace(/\\{package\\}/g, context.package || 'Core')\n      .replace(/\\{property\\}/g, context.property || 'property')\n      .replace(/\\{parameter\\}/g, context.property || 'parameter')\n      .replace(/\\{modifier\\}/g, context.property || 'modifier')\n  }\n\n  /**\n   * Get recovery strategy description\n   */\n  private getRecoveryDescription(strategy: RecoveryStrategy): string {\n    switch (strategy) {\n      case 'ignore': return 'Error will be ignored and execution continues'\n      case 'fallback': return 'Fallback value will be used'\n      case 'fix': return 'Automatic fix will be applied if available'\n      case 'throw': return 'Error will be thrown and must be handled'\n      default: return 'No recovery strategy specified'\n    }\n  }\n\n  /**\n   * Record error in history for analytics\n   */\n  private recordError(error: EnhancedValidationError): void {\n    this.errorHistory.push(error)\n    \n    // Maintain history size limit\n    if (this.errorHistory.length > this.maxHistorySize) {\n      this.errorHistory.shift()\n    }\n  }\n\n  /**\n   * Get error statistics\n   */\n  getErrorStats() {\n    const categoryCounts = new Map<ValidationErrorCategory, number>()\n    const severityCounts = new Map<ValidationErrorSeverity, number>()\n    const componentCounts = new Map<string, number>()\n    \n    this.errorHistory.forEach(error => {\n      const context = error.context as EnhancedErrorContext\n      \n      categoryCounts.set(context.category, (categoryCounts.get(context.category) || 0) + 1)\n      severityCounts.set(context.severity, (severityCounts.get(context.severity) || 0) + 1)\n      componentCounts.set(context.component, (componentCounts.get(context.component) || 0) + 1)\n    })\n    \n    return {\n      totalErrors: this.errorHistory.length,\n      categories: Object.fromEntries(categoryCounts),\n      severities: Object.fromEntries(severityCounts),\n      components: Object.fromEntries(componentCounts),\n      recentErrors: this.errorHistory.slice(-10).map(e => ({\n        code: (e.context as EnhancedErrorContext).errorCode,\n        component: e.context.component,\n        message: e.message,\n        timestamp: Date.now()\n      }))\n    }\n  }\n\n  /**\n   * Clear error history\n   */\n  clearHistory(): void {\n    this.errorHistory = []\n  }\n\n  /**\n   * Export error report for debugging\n   */\n  exportErrorReport(): string {\n    const stats = this.getErrorStats()\n    const report = {\n      timestamp: new Date().toISOString(),\n      framework: 'tachUI',\n      version: '1.0.0', // Would be dynamic in real implementation\n      stats,\n      errors: this.errorHistory.map(error => ({\n        code: (error.context as EnhancedErrorContext).errorCode,\n        message: error.message,\n        context: error.context,\n        stack: error.stack\n      }))\n    }\n    \n    return JSON.stringify(report, null, 2)\n  }\n}\n\n/**\n * Error suggestion engine for intelligent fixes\n */\nexport class ErrorSuggestionEngine {\n  /**\n   * Generate fix suggestions for common component errors\n   */\n  static generateComponentFixSuggestions(\n    component: string,\n    error: string,\n    _args: unknown[]\n  ): FixSuggestion[] {\n    const suggestions: FixSuggestion[] = []\n    \n    // Missing parameter fixes\n    if (error.includes('requires') && error.includes('parameter')) {\n      suggestions.push({\n        description: `Add the missing parameter to ${component}`,\n        code: this.generateParameterFix(component, _args),\n        difficulty: 'easy',\n        autoFix: () => this.generateParameterFix(component, _args)\n      })\n    }\n    \n    // Type mismatch fixes\n    if (error.includes('type') && error.includes('expected')) {\n      suggestions.push({\n        description: 'Convert value to expected type',\n        code: this.generateTypeFix(component, _args),\n        difficulty: 'medium'\n      })\n    }\n    \n    // Null/undefined fixes\n    if (error.includes('null') || error.includes('undefined')) {\n      suggestions.push({\n        description: 'Add null check and default value',\n        code: this.generateNullCheckFix(component, _args),\n        difficulty: 'easy'\n      })\n    }\n    \n    return suggestions\n  }\n\n  /**\n   * Generate fix for missing parameters\n   */\n  private static generateParameterFix(component: string, _args: unknown[]): string {\n    const componentDefaults: Record<string, string> = {\n      'Text': 'Text(\"Hello World\")',\n      'Button': 'Button(\"Click me\", () => {})',\n      'Image': 'Image({ source: \"image.jpg\" })',\n      'Toggle': 'Toggle({ isOn: false })',\n      'VStack': 'VStack({ children: [] })',\n      'HStack': 'HStack({ children: [] })'\n    }\n    \n    return componentDefaults[component] || `${component}({ /* add required props */ })`\n  }\n\n  /**\n   * Generate fix for type mismatches\n   */\n  private static generateTypeFix(component: string, args: unknown[]): string {\n    if (args.length > 0) {\n      const firstArg = args[0]\n      if (typeof firstArg === 'number') {\n        return `${component}(String(${firstArg})) // Convert number to string`\n      }\n      if (typeof firstArg === 'object') {\n        return `${component}(JSON.stringify(${JSON.stringify(firstArg)})) // Serialize object`\n      }\n    }\n    return `${component}(/* provide correct type */)`\n  }\n\n  /**\n   * Generate fix for null/undefined values\n   */\n  private static generateNullCheckFix(component: string, _args: unknown[]): string {\n    return `${component}(value || \"default\") // Provide fallback for null/undefined`\n  }\n}\n\n// Export singleton instance\nexport const errorReporter = EnhancedErrorReporter.getInstance()\n\n// Export utilities\nexport const ErrorReportingUtils = {\n  createError: (message: string, context: Partial<EnhancedErrorContext>) => \n    errorReporter.createError(message, context),\n  \n  formatError: (error: EnhancedValidationError) => \n    errorReporter.formatError(error),\n  \n  getStats: () => \n    errorReporter.getErrorStats(),\n  \n  exportReport: () => \n    errorReporter.exportErrorReport(),\n  \n  generateSuggestions: ErrorSuggestionEngine.generateComponentFixSuggestions\n}"],"names":["ErrorTemplates","ErrorCodeGenerator","category","component","specific","categoryCode","componentCode","specificCode","timestamp","__publicField","_EnhancedErrorReporter","message","context","enhancedContext","error","EnhancedValidationError","template","formatted","ex","fix","index","m","errorCode","parts","matchingTemplate","key","strategy","categoryCounts","severityCounts","componentCounts","e","stats","report","EnhancedErrorReporter","ErrorSuggestionEngine","_args","suggestions","args","firstArg","errorReporter","ErrorReportingUtils"],"mappings":"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"}