Raxol Core

Copy Markdown View Source

Core behaviours, utilities, events, config, accessibility, and plugin infrastructure for Raxol. One runtime dependency (telemetry).

Install

{:raxol_core, "~> 2.3"}

What's Included

  • Behaviours -- BaseManager, BaseRegistry, BaseServer, Lifecycle, Metrics, StateManager
  • Runtime.Log -- Centralized structured logging with context, timing, and module detection
  • Utils -- Debounce, ErrorPatterns, GenServerHelpers, TimerManager, TimerUtils, Validation
  • Events -- EventManager, subscriptions, telemetry adapter
  • Config -- Config, ConfigServer, ConfigStore
  • Accessibility -- Screen reader support, announcements, focus management, metadata registry
  • Focus/Keyboard -- FocusManager, KeyboardShortcuts, KeyboardNavigator
  • Standards -- CodeGenerator, CodeStyle, ConsistencyChecker
  • Preferences -- UserPreferences with debounced persistence
  • Plugin Infrastructure -- Plugin lifecycle, registry, supervisor, security (BEAM analyzer, capability detector), command system, dependency resolution, event filtering
  • Error Handling -- ErrorHandler (macros), ErrorHandling (safe_call), ErrorRecovery (circuit breaker, retry, cleanup)
  • I18n -- Internationalization server
  • Telemetry -- TraceContext

Usage

GenServers defined here are started by the parent application's supervision tree. This package does not auto-start any processes.

# In your Application supervisor
children = [
  Raxol.Core.Events.EventManager,
  {Raxol.Core.UserPreferences, [name: Raxol.Core.UserPreferences]},
  Raxol.Core.Runtime.Plugins.PluginSupervisor
]

See main docs for the full Raxol framework.