@type enhanced_error() :: %{
  original_error: term(),
  category: error_category(),
  severity: Raxol.Core.ErrorHandler.error_severity(),
  context: map(),
  suggestions: [fix_suggestion()],
  performance_impact: :none | :low | :medium | :high | :critical,
  related_optimizations: [String.t()],
  recovery_options: [atom()]
}

@type error_category() ::
  :performance
  | :compilation
  | :runtime
  | :ui_rendering
  | :terminal_io
  | :component_lifecycle
  | :optimization
  | :integration

@type fix_suggestion() :: %{
  type: :automatic | :guided | :manual | :documentation,
  description: String.t(),
  action: String.t() | nil,
  confidence: float(),
  related_tools: [atom()],
  phase3_context: map() | nil
}