import type { Exception, GraderMap } from '../ExamGrader';
import { GradingResult, QuestionGrader } from '../graders/QuestionGrader';
import { ResponseKind } from '../response/common';
import { ValidSubmission } from '../response/responses';
import { AppliedCurve, ExamCurve } from './ExamCurve';
import { Exam, Question, Section } from './exam_components';
import { StudentInfo } from './exam_specification';
import { Randomizer } from './randomization';
import { ExamComponentSkin } from './skins';
import { TransparentExamManifest, TransparentQuestionManifest, TransparentQuestionSubmission, TransparentSectionManifest, TransparentSectionSubmission, TrustedExamSubmission } from './submissions';
export type UUID_Strategy = "plain" | "uuidv4" | "uuidv5";
export type UUID_Options = {
    strategy: "uuidv5";
    v5_namespace: string;
} | {
    strategy: Exclude<UUID_Strategy, "uuidv5">;
};
/**
 * Takes an ID for an exam, section, or question and creates a uuid
 * for a particular student's instance of that entity. The uuid is
 * created based on the policy specified in the `ExamGenerator`'s
 * options when it is created, which may depend on the provided
 * student uniqname.
 * @param uniqname
 * @param id
 * @returns
 */
export declare function createStudentUuid(options: UUID_Options, uniqname: string, id: string): string;
export declare function createStudentExamUuid(options: UUID_Options, uniqname: string, exam_id: string): string;
export declare function createStudentSectionUuid(options: UUID_Options, uniqname: string, exam_id: string, section_id: string): string;
export declare function createStudentQuestionUuid(options: UUID_Options, uniqname: string, exam_id: string, question_id: string): string;
export declare class AssignedQuestion<QT extends ResponseKind = ResponseKind> {
    readonly uuid: string;
    readonly student: StudentInfo;
    readonly question: Question<QT>;
    readonly skin: ExamComponentSkin;
    readonly displayIndex: string;
    readonly rawSubmission: string | undefined;
    readonly gradedBy?: QuestionGrader<QT>;
    readonly gradingResult?: GradingResult;
    readonly exception?: Exception;
    readonly submission: ValidSubmission<QT>;
    readonly html_description: string;
    readonly html_postscript: string;
    constructor(uuid: string, student: StudentInfo, question: Question<QT>, skin: ExamComponentSkin, displayIndex: string, rawSubmission: string | undefined);
    static createFromSubmission(question: Question, student: StudentInfo, question_submission: TransparentQuestionManifest | TransparentQuestionSubmission, section_skin?: ExamComponentSkin): AssignedQuestion<ResponseKind>;
    static createFromSubmissionWithSkinOverride(question: Question, student: StudentInfo, question_submission: TransparentQuestionManifest | TransparentQuestionSubmission, skin: ExamComponentSkin): AssignedQuestion<ResponseKind>;
    setRawSubmission(raw_submission: string): void;
    getFullAnswers(): TransparentQuestionSubmission;
    grade(grader: QuestionGrader<QT>): void;
    addException(exception: Exception): void;
    get pointsEarned(): number | undefined;
    get pointsEarnedWithoutExceptions(): number | undefined;
    isGraded(): this is GradedQuestion<QT>;
    wasGradedBy<GR extends GradingResult>(grader: QuestionGrader<QT, GR>): this is GradedQuestion<QT, GR>;
    isKind<RK extends QT>(kind: RK): this is AssignedQuestion<RK>;
}
export declare function wereGradedBy<QT extends ResponseKind, GR extends GradingResult>(questions: readonly AssignedQuestion<QT>[], grader: QuestionGrader<QT, GR>): questions is readonly GradedQuestion<QT, GR>[];
export interface GradedQuestion<QT extends ResponseKind, GR extends GradingResult = GradingResult> extends AssignedQuestion<QT> {
    readonly pointsEarned: number;
    readonly pointsEarnedWithoutExceptions: number;
    readonly gradedBy: QuestionGrader<QT>;
    readonly gradingResult: GR;
}
export declare function areAllGradedQuestions<QT extends ResponseKind>(exams: AssignedQuestion[]): exams is GradedQuestion<QT>[];
export declare function areAllGradedQuestions<QT extends ResponseKind>(exams: readonly AssignedQuestion[]): exams is readonly GradedQuestion<QT>[];
export declare function isGradedQuestion<QT extends ResponseKind>(aq: AssignedQuestion<QT>): aq is GradedQuestion<QT>;
export declare class AssignedSection {
    readonly uuid: string;
    readonly student: StudentInfo;
    readonly section: Section;
    readonly sectionIndex: number;
    readonly skin: ExamComponentSkin;
    readonly assignedQuestions: readonly AssignedQuestion[];
    readonly displayIndex: string;
    readonly pointsPossible: number;
    readonly pointsEarned?: number;
    private _isFullyGraded;
    readonly html_description: string;
    readonly html_reference?: string;
    constructor(uuid: string, student: StudentInfo, section: Section, sectionIndex: number, skin: ExamComponentSkin, assignedQuestions: readonly AssignedQuestion[]);
    static createFromSubmission(section: Section, section_index: number, student: StudentInfo, section_submission: TransparentSectionManifest | TransparentSectionSubmission): AssignedSection;
    gradeAllQuestions(ex: AssignedExam, graders: GraderMap): void;
    isGraded(): this is GradedSection;
}
export interface GradedSection extends AssignedSection {
    readonly pointsEarned: number;
}
export declare function areAllGradedSections(sections: AssignedSection[]): sections is GradedSection[];
export declare function areAllGradedSections(sections: readonly AssignedSection[]): sections is readonly GradedSection[];
export declare class AssignedExam {
    readonly uuid: string;
    readonly exam: Exam;
    readonly student: StudentInfo;
    readonly pointsPossible: number;
    readonly pointsEarned?: number;
    private _isFullyGraded;
    readonly curve?: AppliedCurve;
    private assignedQuestionById;
    readonly assignedSections: readonly AssignedSection[];
    readonly assignedQuestions: readonly AssignedQuestion[];
    constructor(uuid: string, exam: Exam, student: StudentInfo, assignedSections: readonly AssignedSection[], allowDuplicates: boolean);
    static createFromManifest(exam: Exam, manifest: TransparentExamManifest): AssignedExam;
    static createFromSubmission(exam: Exam, submission: TrustedExamSubmission): AssignedExam;
    private static createFromSubmission_impl;
    static createRandomized(exam: Exam, student: StudentInfo, uuid_options: UUID_Options, seed: string, allow_duplicates?: boolean, rand?: Randomizer): AssignedExam;
    private static createRandomizedSection;
    private static createRandomizedQuestion;
    getAssignedQuestionById(question_id: string): AssignedQuestion<ResponseKind> | undefined;
    gradeAll(graders: GraderMap): void;
    isGraded(): this is GradedExam;
    applyCurve(this: GradedExam, curve: ExamCurve): void;
    renderGrade(): string;
    createManifest(): TransparentExamManifest;
}
export declare function areAllGradedExams(exams: AssignedExam[]): exams is GradedExam[];
export declare function areAllGradedExams(exams: readonly AssignedExam[]): exams is readonly GradedExam[];
export interface GradedExam extends AssignedExam {
    readonly pointsEarned: number;
}