Results & Sessions

type Grade = 'again' | 'hard' | 'good' | 'easy';

const GRADES: readonly Grade[] = ['again', 'hard', 'good', 'easy'] as const;

interface GradeResult {
    card: CardBase;                        // Updated card with new SRS state
    reviewLog: ReviewLog;                  // Immutable record of this review
    nextIntervals: Record<Grade, string>;  // Preview intervals for next review
}

interface SessionQueue {
    cards: CardBase[];  // Ordered: learning → review → new
    counts: {
        new: number;       // New cards in queue
        learning: number;  // Learning/relearning cards
        review: number;    // Due review cards
    };
}

interface SessionSummary {
    totalReviewed: number;
    correctCount: number;                     // grade !== 'again'
    incorrectCount: number;                   // grade === 'again'
    averageTimeMsPerCard: number;
    gradeDistribution: Record<Grade, number>; // Count per grade
    newCardsStudied: number;                  // Cards that were in 'new' state
    reviewsCompleted: number;                 // Cards that were in 'review' state
}

interface ImportResult {
    notesCreated: number;
    cardsCreated: number;
    errors: string[];  // Per-row error messages (import continues on error)
}

interface LoopKitExportData {
    version: string;           // Schema version (e.g., "1.0.0")
    exportedAt: string;        // ISO 8601 timestamp
    decks: DeckBase[];
    noteTypes: NoteType[];
    notes: NoteBase[];
    cards: CardBase[];
    presets: DeckPreset[];
    reviewLogs?: ReviewLog[];  // Optional, included when requested
}

type FieldMapping = { [csvColumn: string]: string };

// Example: { "question": "Front", "answer": "Back" }