Expand description
Script debugger — breakpoints, stepping, locals inspection, coverage tracking.
§Architecture
DebugSession ←→ ScriptDebugger ←→ Vm
↕ ↕
DebugCommand BreakpointKind
↕
CoverageTrackerStructs§
- Breakpoint
- A single breakpoint with metadata.
- Call
Stack Trace - Human-readable call stack trace.
- Coverage
Tracker - Tracks which instruction indices were executed per chunk name.
- Debug
Session - A REPL-style debug session. Executes
DebugCommands against a VM and aScriptDebugger. - Debugger
State - Mutable debugger state — can be inspected between instructions.
- Frame
Info - A frame entry in a call stack trace.
- Local
Inspector - Inspects local variables in a VM frame.
- Script
Debugger - Wraps VM execution with pre-instruction hooks.
- Watch
Expression - Evaluates a one-liner expression in a fresh VM loaded with provided globals.
Enums§
- Breakpoint
Kind - Specifies when a breakpoint fires.
- Debug
Command - Commands accepted by the debug session REPL.
- Step
Mode - Controls single-step behaviour.