@iblai/iblai-js 2.3.6 → 2.3.9

package/dist/data-layer/playwright/grader-tab-helpers.d.ts

@@ -25,10 +25,11 @@ export declare const GRADER_LABELS: {
     readonly tabName: "Grader";
     readonly capabilityToggle: "Grading";
     readonly subTabs: {
-        readonly setup: "Grading setup";
+        readonly setup: "Grading Setup";
         readonly rubric: "Rubric";
+        readonly results: "Results";
     };
-    readonly addButton: "Add criterion";
+    readonly addButton: "Add Criterion";
     readonly menu: {
         /** aria-label template for a row's three-dots trigger. */
         readonly actionsAria: (name: string) => string;
@@ -43,18 +44,29 @@ export declare const GRADER_LABELS: {
         };
         readonly cancel: "Cancel";
     };
+    readonly results: {
+        readonly searchUserButton: "Search for User";
+        readonly searchUsersPlaceholder: "Search users...";
+        readonly overrideButton: "Override";
+        /** aria-label template for a result row's Override button. */
+        readonly overrideButtonAria: (email: string) => string;
+        readonly modal: {
+            readonly pointsLabel: "Override Points";
+            readonly feedbackLabel: "Override Feedback";
+        };
+    };
     readonly toasts: {
         readonly toggleOn: "Grading turned on";
         readonly toggleOff: "Grading turned off — your rubric is kept for next time";
     };
     readonly gradingModeOptions: {
-        readonly submission: "A submission";
-        readonly conversation: "The conversation";
+        readonly submission: "A Submission";
+        readonly conversation: "The Conversation";
     };
     readonly feedbackModeOptions: {
-        readonly overall: "Overall feedback only";
-        readonly per_criteria: "Feedback per criterion";
-        readonly both: "Overall + per criterion";
+        readonly overall: "Overall Feedback Only";
+        readonly per_criteria: "Feedback per Criterion";
+        readonly both: "Overall + per Criterion";
     };
 };
 export type GraderSubTab = keyof typeof GRADER_LABELS.subTabs;
@@ -136,3 +148,25 @@ export declare function expectLastCriterionDeleteDisabled(page: Page, name: stri
 export declare function expectGraderMisconfiguredWarning(page: Page, visible: boolean): Promise<void>;
 /** Assert the rubric's live "total possible points" readout (Rubric sub-tab). */
 export declare function expectGraderTotalPoints(page: Page, total: number): Promise<void>;
+/**
+ * Filter the grade-results list by learner via the "Search for User" picker
+ * (switches to the Results sub-tab first). Types into the picker's search box,
+ * selects the learner, and gates completion on the matching row rendering.
+ */
+export declare function filterGradeResultsByEmail(page: Page, email: string): Promise<void>;
+/** Assert a grade-result row for the given learner email is visible. */
+export declare function expectGradeResultRow(page: Page, email: string): Promise<void>;
+/**
+ * Override a learner's grade via the row's three-dots menu → Override grade
+ * popup. Points are in rubric points (0 to the rubric's total). Completion is
+ * gated on the popup closing, which only happens after the PATCH resolves.
+ */
+export declare function overrideGradeResult(page: Page, email: string, values: {
+    points: number;
+    feedback?: string;
+}): Promise<void>;
+/**
+ * Clear a learner's grade override via the popup, restoring the AI score.
+ * Completion is gated on the popup closing after the PATCH resolves.
+ */
+export declare function clearGradeResultOverride(page: Page, email: string): Promise<void>;

package/dist/data-layer/playwright/index.d.ts

@@ -29,7 +29,7 @@ export { VOICE_LABELS, isVoiceTabVisible, switchToVoiceTab, switchToVoiceSubTab,
 export type { VoiceProvider, CallMode, TtsProvider, SttProvider, LlmProvider, } from './voice-tab-helpers';
 export { SCREENSHARE_LABELS, isScreenShareTabVisible, switchToScreenShareTab, openScreenSharePromptEditor, setScreenSharePrompt, saveScreenSharePrompts, expectScreenShareDisabledHint, } from './screenshare-tab-helpers';
 export type { ScreenSharePromptField } from './screenshare-tab-helpers';
-export { graderTabBody, isGraderTabVisible, switchToGraderTab, switchToGraderSubTab, isGradingEnabled, setGradingEnabled, saveGraderConfig, addGraderCriterion, editGraderCriterion, deleteGraderCriterion, expectLastCriterionDeleteDisabled, expectGraderMisconfiguredWarning, expectGraderTotalPoints, GRADER_LABELS, } from './grader-tab-helpers';
+export { graderTabBody, isGraderTabVisible, switchToGraderTab, switchToGraderSubTab, isGradingEnabled, setGradingEnabled, saveGraderConfig, addGraderCriterion, editGraderCriterion, deleteGraderCriterion, expectLastCriterionDeleteDisabled, expectGraderMisconfiguredWarning, expectGraderTotalPoints, filterGradeResultsByEmail, expectGradeResultRow, overrideGradeResult, clearGradeResultOverride, GRADER_LABELS, } from './grader-tab-helpers';
 export type { GraderCriterionInput, GraderGradingMode, GraderFeedbackMode, GraderSubTab, } from './grader-tab-helpers';
 export { billingPlanSection, billingCreditsSection, billingAutoRechargeSection, getBillingPlanLabel, getBillingAutoRechargeStatus, waitForBillingTabReady, expectBillingPlanSection, expectBillingCreditsSection, expectBillingAutoRechargeSection, expectBillingTabForFreePlan, expectBillingTabForTrialPlan, expectBillingTabForPremiumPlan, expectBillingTabForCurrentPlan, clickBillingUpgrade, clickBillingAddCredits, clickBillingManageBilling, clickBillingManageUsage, } from './billing-tab-helpers';
 export type { BillingAutoRechargeStatus } from './billing-tab-helpers';

package/dist/playwright/index.cjs

@@ -4066,10 +4066,11 @@ const GRADER_LABELS = {
     tabName: 'Grader',
     capabilityToggle: 'Grading',
     subTabs: {
-        setup: 'Grading setup',
+        setup: 'Grading Setup',
         rubric: 'Rubric',
+        results: 'Results',
     },
-    addButton: 'Add criterion',
+    addButton: 'Add Criterion',
     menu: {
         /** aria-label template for a row's three-dots trigger. */
         actionsAria: (name) => `Actions for ${name}`,
@@ -4084,18 +4085,29 @@ const GRADER_LABELS = {
         },
         cancel: 'Cancel',
     },
+    results: {
+        searchUserButton: 'Search for User',
+        searchUsersPlaceholder: 'Search users...',
+        overrideButton: 'Override',
+        /** aria-label template for a result row's Override button. */
+        overrideButtonAria: (email) => `Override grade for ${email}`,
+        modal: {
+            pointsLabel: 'Override Points',
+            feedbackLabel: 'Override Feedback',
+        },
+    },
     toasts: {
         toggleOn: 'Grading turned on',
         toggleOff: 'Grading turned off — your rubric is kept for next time',
     },
     gradingModeOptions: {
-        submission: 'A submission',
-        conversation: 'The conversation',
+        submission: 'A Submission',
+        conversation: 'The Conversation',
     },
     feedbackModeOptions: {
-        overall: 'Overall feedback only',
-        per_criteria: 'Feedback per criterion',
-        both: 'Overall + per criterion',
+        overall: 'Overall Feedback Only',
+        per_criteria: 'Feedback per Criterion',
+        both: 'Overall + per Criterion',
     },
 };
 const UI_TIMEOUT = 10000;
@@ -4160,9 +4172,12 @@ async function switchToGraderSubTab(page, subTab) {
     const trigger = body.getByTestId(`grader-sub-tab-${subTab}`);
     await test$1.expect(trigger).toBeVisible({ timeout: UI_TIMEOUT });
     await trigger.click();
-    const section = subTab === 'setup'
-        ? body.getByTestId('grader-setup-section')
-        : body.getByTestId('grader-criteria-section');
+    const sectionTestId = {
+        setup: 'grader-setup-section',
+        rubric: 'grader-criteria-section',
+        results: 'grader-results-section',
+    }[subTab];
+    const section = body.getByTestId(sectionTestId);
     await test$1.expect(section).toBeVisible({ timeout: UI_TIMEOUT });
     logger.info(`Switched to Grader ${subTab} sub-tab`);
 }
@@ -4349,7 +4364,88 @@ async function expectGraderMisconfiguredWarning(page, visible) {
 /** Assert the rubric's live "total possible points" readout (Rubric sub-tab). */
 async function expectGraderTotalPoints(page, total) {
     await switchToGraderSubTab(page, 'rubric');
-    await test$1.expect(criteriaSection(page).getByText(`Total possible points: ${total}`, { exact: true })).toBeVisible({ timeout: UI_TIMEOUT });
+    await test$1.expect(criteriaSection(page).getByText(`Total Possible Points: ${total}`, { exact: true })).toBeVisible({ timeout: UI_TIMEOUT });
+}
+/** The Results sub-tab's section within the tab body. */
+function resultsSection(page) {
+    return graderTabBody(page).getByTestId('grader-results-section');
+}
+/** A grade-result table row containing the given learner email (exact match). */
+function gradeResultRow(page, email) {
+    return resultsSection(page)
+        .locator('[data-testid^="grader-result-row-"]')
+        .filter({ has: page.getByText(email, { exact: true }) });
+}
+/**
+ * Filter the grade-results list by learner via the "Search for User" picker
+ * (switches to the Results sub-tab first). Types into the picker's search box,
+ * selects the learner, and gates completion on the matching row rendering.
+ */
+async function filterGradeResultsByEmail(page, email) {
+    await switchToGraderSubTab(page, 'results');
+    const trigger = resultsSection(page).getByTestId('grader-results-user-filter');
+    await test$1.expect(trigger).toBeVisible({ timeout: UI_TIMEOUT });
+    await trigger.click();
+    const searchBox = resultsSection(page).getByPlaceholder(GRADER_LABELS.results.searchUsersPlaceholder);
+    await test$1.expect(searchBox).toBeVisible({ timeout: UI_TIMEOUT });
+    await searchBox.fill(email);
+    const option = resultsSection(page).getByRole('option', { name: email });
+    await test$1.expect(option).toBeVisible({ timeout: UI_TIMEOUT });
+    await option.click();
+    await test$1.expect(gradeResultRow(page, email)).toBeVisible({ timeout: MUTATION_TIMEOUT });
+    logger.info(`Filtered grade results by learner "${email}"`);
+}
+/** Assert a grade-result row for the given learner email is visible. */
+async function expectGradeResultRow(page, email) {
+    await switchToGraderSubTab(page, 'results');
+    await test$1.expect(gradeResultRow(page, email)).toBeVisible({ timeout: UI_TIMEOUT });
+}
+/**
+ * Override a learner's grade via the row's three-dots menu → Override grade
+ * popup. Points are in rubric points (0 to the rubric's total). Completion is
+ * gated on the popup closing, which only happens after the PATCH resolves.
+ */
+async function overrideGradeResult(page, email, values) {
+    await switchToGraderSubTab(page, 'results');
+    const overrideButton = gradeResultRow(page, email).getByRole('button', {
+        name: GRADER_LABELS.results.overrideButtonAria(email),
+    });
+    await test$1.expect(overrideButton).toBeVisible({ timeout: UI_TIMEOUT });
+    await overrideButton.click();
+    const modal = page.getByTestId('grader-override-modal');
+    await test$1.expect(modal).toBeVisible({ timeout: UI_TIMEOUT });
+    await modal
+        .getByLabel(GRADER_LABELS.results.modal.pointsLabel, { exact: true })
+        .fill(String(values.points));
+    if (values.feedback !== undefined) {
+        await modal
+            .getByLabel(GRADER_LABELS.results.modal.feedbackLabel, { exact: true })
+            .fill(values.feedback);
+    }
+    const saveButton = modal.getByTestId('grader-override-save');
+    await test$1.expect(saveButton).toBeEnabled({ timeout: UI_TIMEOUT });
+    await saveButton.click();
+    await test$1.expect(modal).toBeHidden({ timeout: MUTATION_TIMEOUT });
+    logger.info(`Overrode grade for "${email}" with ${values.points} points`);
+}
+/**
+ * Clear a learner's grade override via the popup, restoring the AI score.
+ * Completion is gated on the popup closing after the PATCH resolves.
+ */
+async function clearGradeResultOverride(page, email) {
+    await switchToGraderSubTab(page, 'results');
+    const overrideButton = gradeResultRow(page, email).getByRole('button', {
+        name: GRADER_LABELS.results.overrideButtonAria(email),
+    });
+    await test$1.expect(overrideButton).toBeVisible({ timeout: UI_TIMEOUT });
+    await overrideButton.click();
+    const modal = page.getByTestId('grader-override-modal');
+    await test$1.expect(modal).toBeVisible({ timeout: UI_TIMEOUT });
+    const clearButton = modal.getByTestId('grader-override-clear');
+    await test$1.expect(clearButton).toBeEnabled({ timeout: UI_TIMEOUT });
+    await clearButton.click();
+    await test$1.expect(modal).toBeHidden({ timeout: MUTATION_TIMEOUT });
+    logger.info(`Cleared grade override for "${email}"`);
 }
 
 const DEFAULT_TIMEOUT = 10000;
@@ -6874,6 +6970,7 @@ exports.cancelStartEvaluation = cancelStartEvaluation;
 exports.checkAdminStatus = checkAdminStatus;
 exports.checkRunStatus = checkRunStatus;
 exports.clearDateRangeFilter = clearDateRangeFilter;
+exports.clearGradeResultOverride = clearGradeResultOverride;
 exports.clearInstanceSearch = clearInstanceSearch;
 exports.clearUserFilter = clearUserFilter;
 exports.clickBackHome = clickBackHome;
@@ -6955,6 +7052,7 @@ exports.expectDetailWaitingForTraces = expectDetailWaitingForTraces;
 exports.expectEndpointUrl = expectEndpointUrl;
 exports.expectEntitySelected = expectEntitySelected;
 exports.expectFailedTasks = expectFailedTasks;
+exports.expectGradeResultRow = expectGradeResultRow;
 exports.expectGraderMisconfiguredWarning = expectGraderMisconfiguredWarning;
 exports.expectGraderTotalPoints = expectGraderTotalPoints;
 exports.expectKeyDeleteError = expectKeyDeleteError;
@@ -7019,6 +7117,7 @@ exports.filterByActionAndVerify = filterByActionAndVerify;
 exports.filterByActor = filterByActor;
 exports.filterByActorAndVerify = filterByActorAndVerify;
 exports.filterByDateRange = filterByDateRange;
+exports.filterGradeResultsByEmail = filterGradeResultsByEmail;
 exports.filterTicketsByStatus = filterTicketsByStatus;
 exports.filterTicketsByUser = filterTicketsByUser;
 exports.generateBrowserSetupProjects = generateBrowserSetupProjects;
@@ -7178,6 +7277,7 @@ exports.openScreenSharePromptEditor = openScreenSharePromptEditor;
 exports.openSkillActionsMenu = openSkillActionsMenu;
 exports.openStartEvaluationDialog = openStartEvaluationDialog;
 exports.openTicket = openTicket;
+exports.overrideGradeResult = overrideGradeResult;
 exports.parseReportUrlParams = parseReportUrlParams;
 exports.previewCallConfigVoiceInline = previewCallConfigVoiceInline;
 exports.previewMentorVoiceInline = previewMentorVoiceInline;