pmat 3.11.0

#![cfg(feature = "dap")]

// TRACE-008: Execution Timeline Visualization Tests
// Sprint 73 - RED Phase
//
// Integration tests for terminal-based timeline UI that visualizes execution history.
// Tests drive implementation of interactive timeline navigation and snapshot details display.

use pmat::services::dap::types::{ExecutionSnapshot, SourceLocation, StackFrame};
use std::collections::HashMap;

// Helper function to create a test recording with specified number of snapshots
fn create_test_recording(count: usize) -> Vec<ExecutionSnapshot> {
    let mut snapshots = Vec::new();

    for i in 0..count {
        let mut vars = HashMap::new();
        vars.insert("i".to_string(), serde_json::json!(i));

        snapshots.push(ExecutionSnapshot {
            timestamp: 1000000 + (i as u64 * 1000),
            sequence: i,
            variables: vars,
            call_stack: vec![StackFrame {
                id: 1,
                name: "main".to_string(),
                source: None,
                line: 10,
                column: 0,
            }],
            location: SourceLocation {
                file: "test.rs".to_string(),
                line: 10,
                column: Some(0),
            },
            delta: None,
        });
    }

    snapshots
}

// Helper function to create recording with variables
fn create_test_recording_with_vars() -> Vec<ExecutionSnapshot> {
    let mut snapshots = Vec::new();

    for i in 0..5 {
        let mut vars = HashMap::new();
        vars.insert("counter".to_string(), serde_json::json!(i * 10));
        vars.insert("name".to_string(), serde_json::json!(format!("step_{}", i)));

        snapshots.push(ExecutionSnapshot {
            timestamp: 1000000 + (i as u64 * 1000),
            sequence: i,
            variables: vars,
            call_stack: vec![
                StackFrame {
                    id: 1,
                    name: "main".to_string(),
                    source: None,
                    line: (10 + i) as i64,
                    column: 0,
                },
                StackFrame {
                    id: 2,
                    name: "process".to_string(),
                    source: None,
                    line: (20 + i) as i64,
                    column: 0,
                },
            ],
            location: SourceLocation {
                file: "test.rs".to_string(),
                line: 10 + i,
                column: Some(0),
            },
            delta: None,
        });
    }

    snapshots
}

// RED Test 1: Render timeline from recording
#[test]
fn test_render_timeline() {
    let recording = create_test_recording(10);
    let ui = pmat::services::dap::TimelineUI::new(recording);

    let output = ui.render();

    // Timeline should show positions 0-9
    assert!(
        output.contains("0") && output.contains("9"),
        "Timeline should show start and end positions"
    );
    // Should have position indicator
    assert!(
        output.contains("^") || output.contains("▼"),
        "Timeline should have current position indicator"
    );
}

// RED Test 2: Navigate timeline with keyboard
#[test]
fn test_navigate_timeline() {
    let recording = create_test_recording(10);
    let mut ui = pmat::services::dap::TimelineUI::new(recording);

    // Initial position should be 0
    assert_eq!(ui.current_position(), 0, "Should start at position 0");

    // Step forward
    ui.handle_key('→').unwrap();
    assert_eq!(ui.current_position(), 1, "Should move to position 1");

    ui.handle_key('→').unwrap();
    assert_eq!(ui.current_position(), 2, "Should move to position 2");

    // Step backward
    ui.handle_key('←').unwrap();
    assert_eq!(ui.current_position(), 1, "Should move back to position 1");
}

// RED Test 3: Jump to specific snapshot
#[test]
fn test_jump_to_snapshot() {
    let recording = create_test_recording(10);
    let mut ui = pmat::services::dap::TimelineUI::new(recording);

    ui.jump_to(5).unwrap();
    assert_eq!(ui.current_position(), 5, "Should jump to position 5");

    let output = ui.render();
    // Position indicator should be at position 5
    assert!(
        output.contains("5") && (output.contains("^") || output.contains("▼")),
        "Timeline should show indicator at position 5"
    );

    // Jump to last position
    ui.jump_to(9).unwrap();
    assert_eq!(ui.current_position(), 9, "Should jump to position 9");
}

// RED Test 4: Display snapshot details
#[test]
fn test_display_snapshot_details() {
    let recording = create_test_recording_with_vars();
    let mut ui = pmat::services::dap::TimelineUI::new(recording);

    ui.jump_to(3).unwrap();
    let details = ui.render_details();

    // Should show snapshot number
    assert!(
        details.contains("Snapshot #3") || details.contains("Position: 3"),
        "Details should show snapshot number"
    );

    // Should show variables
    assert!(
        details.contains("Variables:"),
        "Details should show variables section"
    );
    assert!(
        details.contains("counter") && details.contains("30"),
        "Details should show variable values"
    );

    // Should show call stack
    assert!(
        details.contains("Call Stack:") || details.contains("Stack:"),
        "Details should show call stack section"
    );
    assert!(
        details.contains("main") && details.contains("process"),
        "Details should show function names"
    );

    // Should show location
    assert!(
        details.contains("Location:") || details.contains("File:"),
        "Details should show location section"
    );
    assert!(details.contains("test.rs"), "Details should show file name");
}

// RED Test 5: Show performance metrics
#[test]
fn test_show_performance_metrics() {
    let recording = create_test_recording(100);
    let ui = pmat::services::dap::TimelineUI::new(recording);

    let metrics = ui.render_metrics();

    // Should show total snapshots
    assert!(
        metrics.contains("Total snapshots: 100") || metrics.contains("100 snapshots"),
        "Metrics should show total snapshot count"
    );

    // Should show recording size estimate
    assert!(
        metrics.contains("size") || metrics.contains("Size"),
        "Metrics should show recording size"
    );

    // Should show compression ratio if available
    // (This depends on whether snapshots have delta field populated)
    assert!(
        metrics.contains("ratio") || metrics.contains("Ratio") || !metrics.is_empty(),
        "Metrics should show compression info or other stats"
    );
}

// RED Test 6: Handle empty recording
#[test]
fn test_handle_empty_recording() {
    let empty_recording = Vec::new();
    let result = std::panic::catch_unwind(|| pmat::services::dap::TimelineUI::new(empty_recording));

    // Should either panic with helpful message or return error
    // For now, we'll test that it doesn't crash silently
    assert!(
        result.is_ok() || result.is_err(),
        "Should handle empty recording gracefully"
    );
}

// RED Test 7: Timeline width adjustment
#[test]
fn test_timeline_width_adjustment() {
    let recording = create_test_recording(50);
    let ui = pmat::services::dap::TimelineUI::new(recording);

    // Render timeline with different widths
    let output_narrow = ui.render_with_width(40);
    let output_wide = ui.render_with_width(120);

    // Both should render successfully
    assert!(!output_narrow.is_empty(), "Narrow timeline should render");
    assert!(!output_wide.is_empty(), "Wide timeline should render");

    // Wide timeline might show more detail
    assert!(
        output_wide.len() >= output_narrow.len(),
        "Wide timeline should have equal or more content"
    );
}

// RED Test 8: Boundary condition - navigate beyond limits
#[test]
fn test_navigate_beyond_limits() {
    let recording = create_test_recording(5); // Only 5 snapshots (0-4)
    let mut ui = pmat::services::dap::TimelineUI::new(recording);

    // Try to step backward from position 0
    let result = ui.handle_key('←');
    assert!(
        result.is_err(),
        "Should not be able to step backward from position 0"
    );
    assert_eq!(ui.current_position(), 0, "Position should remain at 0");

    // Jump to last position
    ui.jump_to(4).unwrap();

    // Try to step forward from last position
    let result = ui.handle_key('→');
    assert!(
        result.is_err(),
        "Should not be able to step forward from last position"
    );
    assert_eq!(ui.current_position(), 4, "Position should remain at 4");

    // Try to jump beyond bounds
    let result = ui.jump_to(10);
    assert!(
        result.is_err(),
        "Should not be able to jump beyond recording length"
    );
}

// RED Test 9: Color-coded timeline
#[test]
fn test_color_coded_timeline() {
    let recording = create_test_recording(10);
    let ui = pmat::services::dap::TimelineUI::new(recording);

    let colored_output = ui.render_colored();

    // Should contain ANSI color codes
    assert!(
        colored_output.contains("\x1b[") || !colored_output.is_empty(),
        "Colored output should contain ANSI escape codes or content"
    );

    // Current position might be highlighted
    // (Exact color scheme TBD during implementation)
}

// RED Test 10: Timeline rendering performance
#[test]
fn test_timeline_rendering_performance() {
    let large_recording = create_test_recording(1000);
    let ui = pmat::services::dap::TimelineUI::new(large_recording);

    let start = std::time::Instant::now();
    let _output = ui.render();
    let elapsed = start.elapsed();

    // Should render in less than 100ms even for 1000 snapshots
    assert!(
        elapsed.as_millis() < 100,
        "Timeline rendering should be <100ms, got {}ms",
        elapsed.as_millis()
    );
}