debug overview

Debug Mode overview

LibEQOLDebugMode-1.0 is an opt-in debugging helper for addon bug reports.

• No auto hooks: The module never attaches to EditMode, Settings, frames, or global events on its own.
• Hard activation gate: Capture starts only after StartSession(addonKey, ...).
• Tiered depth: off / basic / deep.
  • off: no capture.
  • basic: manual breadcrumbs (Trace) + errors (CaptureError).
  • deep: basic plus hierarchical spans (BeginSpan/EndSpan) for timeline nesting.
• Parallel addon sessions: each addonKey is isolated; multiple addon keys can run sessions at the same time.
• Optional persistence: store stopped sessions into SavedVariables by passing persistence.savedRoot + persistence.path.
• Report output: build a structured report table and a copy-ready text report via BuildReport.

Entry point:

local Debug = LibStub("LibEQOLDebugMode-1.0")

If loaded through the umbrella table, it is also available as LibEQOL.DebugMode.