@edpire/sdk 0.8.1 → 0.8.3

package/dist/react.d.mts

@@ -147,12 +147,22 @@ interface ShellReview {
     /** The attempt's marking. Drives the score banner and every per-node mark. */
     result: SubmitResult;
 }
+/**
+ * Where the host's saving of answers in progress stands, shown quietly in the
+ * top bar. "failed" means saving keeps failing: the shell then says so plainly.
+ */
+type ShellSaveState = "saving" | "saved" | "failed";
 interface SubmitResult {
     submissionId: string;
     totalScore: number;
     maxScore: number;
     percentage: number;
     passed: boolean;
+    /**
+     * False when the assessment has no pass mark: the banner shows the score in
+     * ink, with no "passed" / "not passed". Default true (unchanged).
+     */
+    showVerdict?: boolean;
     /** If null/undefined, the shell hides the "View Full Report" button. */
     returnUrl?: string | null;
     exerciseFeedback: ExerciseFeedbackData[];
@@ -399,6 +409,25 @@ interface AssessmentShellProps {
     timeLimitMinutes?: number | null;
     /** ISO timestamp of attempt start — anchors the countdown server-side. */
     startedAt?: string;
+    /**
+     * Answers saved earlier in this attempt. They are filled in and stay
+     * editable, and are part of what `onSubmit` receives even if the learner
+     * changes nothing. Read on mount only.
+     */
+    initialAnswers?: AssessmentAnswers;
+    /**
+     * Called with the whole set of answers on every change, for hosts that save
+     * progress. Restored answers are included.
+     */
+    onAnswersChange?: (answers: AssessmentAnswers) => void;
+    /** The host's saving state, shown quietly in the top bar. Omit when the host doesn't save. */
+    saveState?: ShellSaveState | null;
+    /**
+     * The learner is coming back to an attempt they opened before: a short note
+     * says so, whether their answers are back, and with a time limit how much
+     * time is left (the clock keeps running while they are away).
+     */
+    resumed?: boolean;
     /** Called when the learner submits. Should throw on error. */
     onSubmit: (answers: AssessmentAnswers) => Promise<SubmitResult>;
     /**
@@ -449,6 +478,6 @@ interface AssessmentShellProps {
      */
     fallbackLogoUrl?: string;
 }
-declare function AssessmentShell({ assessment, meta, locale, branding, timeLimitMinutes, startedAt, onSubmit, review, onViewReport, reportLabel, onBack, backLabel, allowReset, onReset, overlayConfig, contained, layout, onClose, mediaHandler, onAddAnnex, fallbackLogoUrl, }: AssessmentShellProps): react_jsx_runtime.JSX.Element;
+declare function AssessmentShell({ assessment, meta, locale, branding, timeLimitMinutes, startedAt, initialAnswers, onAnswersChange, saveState, resumed, onSubmit, review, onViewReport, reportLabel, onBack, backLabel, allowReset, onReset, overlayConfig, contained, layout, onClose, mediaHandler, onAddAnnex, fallbackLogoUrl, }: AssessmentShellProps): react_jsx_runtime.JSX.Element;
 
-export { AssessmentShell, type AssessmentShellProps, EdpireAssessmentPlayer, type EdpireAssessmentPlayerProps, EdpireQuestion, type EdpireQuestionProps, type ExerciseFeedbackData, type NodeDetail, type NodeFeedback, type OverlayConfig, type QuestionFeedback, type ShellLayout, type ShellLocale, type ShellReview, type SpinnerTheme, type SubmitResult, type TakeBranding };
+export { AssessmentShell, type AssessmentShellProps, EdpireAssessmentPlayer, type EdpireAssessmentPlayerProps, EdpireQuestion, type EdpireQuestionProps, type ExerciseFeedbackData, type NodeDetail, type NodeFeedback, type OverlayConfig, type QuestionFeedback, type ShellLayout, type ShellLocale, type ShellReview, type ShellSaveState, type SpinnerTheme, type SubmitResult, type TakeBranding };