commons-assessment 12.0.39-dev.2 → 12.0.39-dev.4

package/README.md

@@ -219,6 +219,7 @@ To render the assessment taker interface, use the `<lib-assessment-taker>` compo
 | `[enableSkillsToQuestionMapping]` | `@Input` | `boolean` | (Optional) Enables ability to map skills to questions. Default is false. |
 | `[proctorLinkLoader]` | `@Input` | `() => Promise<any>` | (Optional) Loader for the optional `@proctorlink/sdk`, e.g. `() => import('@proctorlink/sdk')`. Required only when proctoring is enabled; keeps the SDK out of the library bundle so non-proctoring apps don't need the package installed. |
 | `[resumeTimerAcrossVisits]` | `@Input` | `boolean` | (Optional) For timed assessments, anchors the countdown to the assessee's first-visit time (`assesseeResponse.createdAt`) so it keeps elapsing across reloads/absences instead of restarting each visit. On begin, the assessee is created up front (already created when proctoring is enabled) so `createdAt` exists. On return, remaining time = `duration - elapsedSinceCreatedAt`; if it has already elapsed, the timer shows `00:00` and the assessment auto-submits. Default is false. |
+| `[warnOnLeaveDuringProctoring]` | `@Input` | `boolean` | (Optional) While a proctoring session is running, warn the candidate before they refresh/close/navigate away (the browser's native "Leave site?" prompt) or press the in-app Back button (a custom confirmation dialog). Set `false` to disable both warnings. Default is true. |
 | `(stepChanged)` | `@Output` | `EventEmitter<{ currentStepIndex: number, totalSteps: number, isLastStep: boolean }>` | Emits initially and on every step change. Provides the current step index, total steps, and indicating boolean. |
 | `(consentToProceed)` | `@Output` | `EventEmitter<boolean>` | A full-screen intro gate is shown before the assessment starts when proctoring is enabled, or when `[resumeTimerAcrossVisits]` is set on a timed assessment. It presents the assessment details/warnings (and, for proctoring, the consent notice + reference-photo capture). On proceed, the assessee is created (and the proctoring session started, when proctored) with a loader; emits `true` once the candidate agrees and the assessment begins. |
 | `(submitAssessment)` | `@Output` | `EventEmitter<{ assesseeId: number, completed: boolean }>` | Emits when the assessment is submitted, containing the `assesseeId` and a `completed` flag indicating if the taker finished the entire assessment. |