student-review-screen 0.0.1

package/dist/components/Organisms/TeacherEvaluation/TeacherToast.d.ts

@@ -0,0 +1,8 @@
+export function teacherSuccessToast(message: any, theme?: string): {
+    position: string;
+    duration: number;
+    render: ({ onClose }: {
+        onClose: any;
+    }) => import("react").JSX.Element;
+};
+export default teacherSuccessToast;

package/dist/components/Organisms/TeacherEvaluation/TeacherToast.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.teacherSuccessToast = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const icons_1 = require("@chakra-ui/icons");
+const TeacherEvaluation_styles_1 = require("./TeacherEvaluation.styles");
+/**
+ * Confirmation toast for a saved score or summary.
+ *
+ * Returns `useToast` options rather than a component, so the consumer keeps
+ * owning when it fires (it is the one making the save call):
+ *
+ *   toast(teacherSuccessToast("Marks updated successfully"));
+ *
+ * Colours come from the same `accent` / `accentContrast` pair as the score
+ * panel's Update button, and follow `theme` with it.
+ */
+const teacherSuccessToast = (message, theme = TeacherEvaluation_styles_1.THEMES.DARK) => {
+    const styles = (0, TeacherEvaluation_styles_1.getStyles)(theme);
+    const colors = (0, TeacherEvaluation_styles_1.getTeacherColors)(theme);
+    return {
+        position: "top",
+        duration: 3000,
+        render: ({ onClose }) => ((0, jsx_runtime_1.jsxs)(react_1.Flex, { sx: styles.toast, "data-testid": "teacher-success-toast", children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { sx: styles.toastContent, children: [(0, jsx_runtime_1.jsx)(react_1.Flex, { sx: styles.toastIcon, children: (0, jsx_runtime_1.jsx)(icons_1.CheckIcon, { color: colors.accent, boxSize: "12px" }) }), (0, jsx_runtime_1.jsx)(react_1.Text, { sx: styles.toastMessage, children: message })] }), (0, jsx_runtime_1.jsx)(react_1.IconButton, { "aria-label": "Close", icon: (0, jsx_runtime_1.jsx)(icons_1.CloseIcon, { boxSize: "10px" }), size: "sm", sx: styles.toastClose, onClick: onClose, "data-testid": "teacher-success-toast-close" })] })),
+    };
+};
+exports.teacherSuccessToast = teacherSuccessToast;
+exports.default = exports.teacherSuccessToast;
+//# sourceMappingURL=TeacherToast.js.map

package/dist/components/Organisms/TeacherEvaluation/TeacherToast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeacherToast.js","sourceRoot":"","sources":["../../../../src/components/Organisms/TeacherEvaluation/TeacherToast.jsx"],"names":[],"mappings":";;;;AAAA,4CAA0D;AAC1D,4CAAwD;AACxD,yEAIoC;AAEpC;;;;;;;;;;GAUG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,KAAK,GAAG,iCAAM,CAAC,IAAI,EAAE,EAAE;IAClE,MAAM,MAAM,GAAG,IAAA,oCAAS,EAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAA,2CAAgB,EAAC,KAAK,CAAC,CAAC;IAEvC,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CACvB,wBAAC,YAAI,IAAC,EAAE,EAAE,MAAM,CAAC,KAAK,iBAAc,uBAAuB,aACzD,wBAAC,YAAI,IAAC,EAAE,EAAE,MAAM,CAAC,YAAY,aAC3B,uBAAC,YAAI,IAAC,EAAE,EAAE,MAAM,CAAC,SAAS,YACxB,uBAAC,iBAAS,IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAC,MAAM,GAAG,GAC7C,EACP,uBAAC,YAAI,IAAC,EAAE,EAAE,MAAM,CAAC,YAAY,YAAG,OAAO,GAAQ,IAC1C,EAEP,uBAAC,kBAAU,kBACE,OAAO,EAClB,IAAI,EAAE,uBAAC,iBAAS,IAAC,OAAO,EAAC,MAAM,GAAG,EAClC,IAAI,EAAC,IAAI,EACT,EAAE,EAAE,MAAM,CAAC,UAAU,EACrB,OAAO,EAAE,OAAO,iBACJ,6BAA6B,GACzC,IACG,CACR;KACF,CAAC;AACJ,CAAC,CAAC;AA3BW,QAAA,mBAAmB,uBA2B9B;AAEF,kBAAe,2BAAmB,CAAC"}

package/dist/components/Organisms/TeacherEvaluation/teacherEvaluationUtils.d.ts

@@ -0,0 +1,63 @@
+export const QUESTION_TYPE_LABELS: {
+    [x: string]: string;
+};
+export function getQuestionTypeLabel(questionType: any): string;
+export function getQuestionType(questionObject?: {}, question?: {}): any;
+/**
+ * The only question families this screen renders:
+ *
+ *  - descriptive (4, 5, 15) — summary/score body with an editable score/summary
+ *  - single choice family (2, 6, 7, 8, 11, 12, 13) — the options `Scqtemp` draws
+ *  - comprehension / case study (9, 10) — a passage plus sub-questions
+ *
+ * Multiple choice (1) and fill in the blanks (3, 14) are excluded: they render
+ * through `Mcqtemp` / `Fibtemp`, which this screen neither styles nor supports.
+ * Exported so the consumer's list and the sub-question filter cannot drift.
+ */
+export const SUPPORTED_QUESTION_TYPES: string[];
+export function isSupportedQuestionType(questionObject?: {}, question?: {}): boolean;
+export function isComprehensionQuestion(questionObject?: {}, question?: {}): boolean;
+export function isDescriptiveQuestion(questionObject?: {}, question?: {}): boolean;
+export function normaliseQuestionObject(questionObject?: {}): {
+    options_layout: any;
+    answers_layout: any;
+};
+export function getDescriptiveAnswer(question?: {}): any;
+export function getChatId(question?: {}): any;
+export function getStudentAnswerText(question?: {}): any;
+export function getStudentAnswerImages(question?: {}): any;
+export namespace SUMMARY_STATUS {
+    const CORRECT: string;
+    const PARTIALLY_CORRECT: string;
+    const WRONG: string;
+}
+export function hasVisibleText(html: any): boolean;
+export function getSummary(question?: {}): {
+    status: any;
+    headline: any;
+    wellDone: any;
+    missing: any;
+};
+export function getReferenceAnswerBlocks(question?: {}): any[];
+export function getIndexedValue(prop: any, index: any, defaultValue: any): any;
+export function buildScoreOptions(lower: any, upper: any, step?: number): number[];
+export function getDescriptiveScoreInfo(descriptive?: {}, questionObject?: {}): {
+    score: any;
+    isEdited: boolean;
+    totalMarks: number;
+};
+export function getComprehensionSubQuestions(question?: {}): any;
+/** A score or a summary may be changed at most this many times. */
+export const MAX_TEACHER_EDITS: 2;
+export function getEditCounts(descriptive?: {}): {
+    score: number;
+    feedback: number;
+};
+export function getEditAvailability(descriptive?: {}): {
+    canEditScore: boolean;
+    canEditSummary: boolean;
+    counts: {
+        score: number;
+        feedback: number;
+    };
+};

package/dist/components/Organisms/TeacherEvaluation/teacherEvaluationUtils.js

@@ -0,0 +1,373 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEditAvailability = exports.getEditCounts = exports.MAX_TEACHER_EDITS = exports.getComprehensionSubQuestions = exports.getDescriptiveScoreInfo = exports.buildScoreOptions = exports.getIndexedValue = exports.getReferenceAnswerBlocks = exports.getSummary = exports.hasVisibleText = exports.SUMMARY_STATUS = exports.getStudentAnswerImages = exports.getStudentAnswerText = exports.getChatId = exports.getDescriptiveAnswer = exports.normaliseQuestionObject = exports.isDescriptiveQuestion = exports.isComprehensionQuestion = exports.isSupportedQuestionType = exports.SUPPORTED_QUESTION_TYPES = exports.getQuestionType = exports.getQuestionTypeLabel = exports.QUESTION_TYPE_LABELS = void 0;
+const LearningPathUtils_1 = require("../../../utils/LearningPathUtils");
+const common_utils_1 = require("../../../utils/common-utils");
+exports.QUESTION_TYPE_LABELS = {
+    [LearningPathUtils_1.questionTypes.very_short_answer]: "Very short answer",
+    [LearningPathUtils_1.questionTypes.short_answer]: "Short answer",
+    [LearningPathUtils_1.questionTypes.long_answer]: "Long answer",
+    [LearningPathUtils_1.questionTypes.scq]: "Single choice",
+    [LearningPathUtils_1.questionTypes.mcq]: "Multiple choice",
+    [LearningPathUtils_1.questionTypes.fib]: "Fill in the blanks",
+    [LearningPathUtils_1.questionTypes.drag_fib]: "Fill in the blanks",
+    [LearningPathUtils_1.questionTypes.tf]: "True or false",
+    [LearningPathUtils_1.questionTypes.yn]: "Yes or no",
+    [LearningPathUtils_1.questionTypes.match]: "Match the following",
+    [LearningPathUtils_1.questionTypes.sorting]: "Sorting",
+    [LearningPathUtils_1.questionTypes.nav]: "Single choice",
+    [LearningPathUtils_1.questionTypes.reason_assertion]: "Assertion and reason",
+    [LearningPathUtils_1.questionTypes.comprehension]: "Comprehension",
+    [LearningPathUtils_1.questionTypes.caseStudy]: "Case study",
+};
+const getQuestionTypeLabel = (questionType) => exports.QUESTION_TYPE_LABELS[questionType] || "Question";
+exports.getQuestionTypeLabel = getQuestionTypeLabel;
+const DESCRIPTIVE_TYPES = [
+    LearningPathUtils_1.questionTypes.short_answer,
+    LearningPathUtils_1.questionTypes.long_answer,
+    LearningPathUtils_1.questionTypes.very_short_answer,
+];
+/**
+ * Some payloads carry the type only under `question_details`. `Review.jsx` falls
+ * back to it before deciding a question is descriptive — once on the question
+ * (`Review.jsx:288`) and once on the question object (`Review.jsx:809`) — so
+ * both spellings are checked here.
+ */
+const getQuestionType = (questionObject = {}, question = {}) => questionObject?.question_type ||
+    questionObject?.question_details?.question_type ||
+    question?.question_details?.question_type;
+exports.getQuestionType = getQuestionType;
+const COMPREHENSION_TYPES = [
+    LearningPathUtils_1.questionTypes.comprehension,
+    LearningPathUtils_1.questionTypes.caseStudy,
+];
+/**
+ * The only question families this screen renders:
+ *
+ *  - descriptive (4, 5, 15) — summary/score body with an editable score/summary
+ *  - single choice family (2, 6, 7, 8, 11, 12, 13) — the options `Scqtemp` draws
+ *  - comprehension / case study (9, 10) — a passage plus sub-questions
+ *
+ * Multiple choice (1) and fill in the blanks (3, 14) are excluded: they render
+ * through `Mcqtemp` / `Fibtemp`, which this screen neither styles nor supports.
+ * Exported so the consumer's list and the sub-question filter cannot drift.
+ */
+exports.SUPPORTED_QUESTION_TYPES = [
+    LearningPathUtils_1.questionTypes.scq,
+    LearningPathUtils_1.questionTypes.match,
+    LearningPathUtils_1.questionTypes.tf,
+    LearningPathUtils_1.questionTypes.reason_assertion,
+    LearningPathUtils_1.questionTypes.sorting,
+    LearningPathUtils_1.questionTypes.nav,
+    LearningPathUtils_1.questionTypes.yn,
+    LearningPathUtils_1.questionTypes.short_answer,
+    LearningPathUtils_1.questionTypes.long_answer,
+    LearningPathUtils_1.questionTypes.very_short_answer,
+    LearningPathUtils_1.questionTypes.comprehension,
+    LearningPathUtils_1.questionTypes.caseStudy,
+];
+const isSupportedQuestionType = (questionObject = {}, question = {}) => exports.SUPPORTED_QUESTION_TYPES.includes(String((0, exports.getQuestionType)(questionObject, question)));
+exports.isSupportedQuestionType = isSupportedQuestionType;
+/**
+ * Comprehension and case study hold no answer of their own — a passage plus
+ * nested sub-questions, each with its own answer, score and summary.
+ */
+const isComprehensionQuestion = (questionObject = {}, question = {}) => COMPREHENSION_TYPES.includes(String((0, exports.getQuestionType)(questionObject, question)));
+exports.isComprehensionQuestion = isComprehensionQuestion;
+/** Only descriptive answers carry a score band and an AI summary to evaluate. */
+const isDescriptiveQuestion = (questionObject = {}, question = {}) => DESCRIPTIVE_TYPES.includes(String((0, exports.getQuestionType)(questionObject, question)));
+exports.isDescriptiveQuestion = isDescriptiveQuestion;
+/**
+ * The option layouts compare option strings against answer strings, so both
+ * need the same whitespace normalisation QuestionsLayout applies before
+ * handing a question to AnswersLayout.
+ */
+const normaliseQuestionObject = (questionObject = {}) => {
+    const optionsLayout = questionObject?.options_layout
+        ? questionObject.options_layout.map((item) => (0, common_utils_1.handleRemoveExtraSpaceInBubbles)(item))
+        : [];
+    const answersLayout = (0, common_utils_1.isNotEmptyOrNull)(questionObject?.answers_index_hashed_keys)
+        ? questionObject.answers_index_hashed_keys
+        : questionObject?.answers_layout
+            ? questionObject.answers_layout.map((item) => (0, common_utils_1.handleRemoveExtraSpaceInBubbles)(item))
+            : [];
+    return {
+        ...questionObject,
+        options_layout: optionsLayout,
+        answers_layout: answersLayout,
+    };
+};
+exports.normaliseQuestionObject = normaliseQuestionObject;
+/**
+ * The evaluated descriptive answer lives on whichever assistant turn carries it.
+ * Same lookup the review flow uses, kept here so the teacher layout does not
+ * depend on the chat presenter.
+ */
+const getDescriptiveAnswer = (question = {}) => {
+    const history = question?.history || [];
+    return (history?.find?.((chat) => chat?.descriptive_answer)?.descriptive_answer ||
+        history?.[0]?.descriptive_answer ||
+        {});
+};
+exports.getDescriptiveAnswer = getDescriptiveAnswer;
+/**
+ * `chat_uuid` the teacher feedback save is keyed by.
+ *
+ * `userAnswer.chatId` comes first because that is what the score save uses
+ * directly, and the history itself is fetched as
+ * `chatInfoData[userAnswer.chatId].history` — preferring an inner history
+ * `chatID` would write the summary to a different chat record than the score.
+ */
+const getChatId = (question = {}) => {
+    const history = question?.history || [];
+    return (question?.userAnswer?.chatId ||
+        history?.find?.((chat) => chat?.descriptive_answer)?.chatID ||
+        history?.[0]?.chatID ||
+        "");
+};
+exports.getChatId = getChatId;
+/**
+ * Student's typed answer. `ChatPresenter` hands `history[0].content` straight
+ * through as `user_query`, so index 0 is the answer turn. Scanning for a
+ * `role === "user"` turn instead can land on a later follow up chat message —
+ * turns do carry roles (`Review.jsx:227` filters `role == "assistant"`), so the
+ * answer turn is not guaranteed to be tagged `user`.
+ */
+const getStudentAnswerText = (question = {}) => question?.history?.[0]?.content || "";
+exports.getStudentAnswerText = getStudentAnswerText;
+/** Handwritten uploads, in the order the review flow resolves them. */
+const getStudentAnswerImages = (question = {}) => {
+    const first = question?.history?.[0] || {};
+    const descriptive = (0, exports.getDescriptiveAnswer)(question);
+    if ((0, common_utils_1.isNotEmptyOrNull)(first?.descImageList)) {
+        return first.descImageList.map((item) => item?.image).filter(Boolean);
+    }
+    if ((0, common_utils_1.isNotEmptyOrNull)(descriptive?.transcribeImageList)) {
+        return descriptive.transcribeImageList
+            .map((item) => item?.image)
+            .filter(Boolean);
+    }
+    return descriptive?.image_urls || [];
+};
+exports.getStudentAnswerImages = getStudentAnswerImages;
+exports.SUMMARY_STATUS = {
+    CORRECT: "correct",
+    PARTIALLY_CORRECT: "partially_correct",
+    WRONG: "wrong",
+};
+const hasVisibleText = (html) => (0, common_utils_1.isNotEmptyOrNull)(html) &&
+    String(html)
+        .replace(/<[^>]*>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .trim().length > 0;
+exports.hasVisibleText = hasVisibleText;
+/**
+ * The AI (or teacher edited) summary.
+ *
+ * `DescriptiveAnswerV1` picks its branch from `bandInfo.status || status` and
+ * renders a different pair of fields per branch, so both fields are returned
+ * along with the status rather than assuming `student_answer_missing`:
+ *
+ *   correct            → bandInfo.message + student_answer_well_done
+ *   partially_correct  → bandInfo.message + student_answer_well_done
+ *                                         + student_answer_missing
+ *   wrong              → bandInfo.message + student_answer_missing
+ *
+ * The original renders nothing when the status is none of the three; here an
+ * unrecognised status keeps whichever fields are present so the evaluation is
+ * never silently blank.
+ */
+const getSummary = (question = {}) => {
+    const descriptive = (0, exports.getDescriptiveAnswer)(question);
+    const status = descriptive?.bandInfo?.status || descriptive?.status || "";
+    const wellDone = descriptive?.student_answer_well_done || "";
+    const missing = descriptive?.student_answer_missing || "";
+    const isKnownStatus = Object.values(exports.SUMMARY_STATUS).includes(status);
+    const showWellDone = isKnownStatus
+        ? status !== exports.SUMMARY_STATUS.WRONG
+        : (0, exports.hasVisibleText)(wellDone);
+    const showMissing = isKnownStatus
+        ? status !== exports.SUMMARY_STATUS.CORRECT
+        : (0, exports.hasVisibleText)(missing);
+    return {
+        status,
+        headline: descriptive?.bandInfo?.message || "",
+        wellDone: showWellDone && (0, exports.hasVisibleText)(wellDone) ? wellDone : "",
+        /* The only field the teacher feedback API accepts, so the only editable one. */
+        missing: showMissing && (0, exports.hasVisibleText)(missing) ? missing : "",
+    };
+};
+exports.getSummary = getSummary;
+/**
+ * Reference answer as flat text blocks, so the layout does not have to know
+ * whether it came from `solution_layout` or a plain `sample_answer`.
+ */
+const getReferenceAnswerBlocks = (question = {}) => {
+    const descriptive = (0, exports.getDescriptiveAnswer)(question);
+    /* `DescriptiveAnswerV1:165` reads solution_layout off descriptive_answer when
+       that object is present and only falls back to the question when it is empty
+       — so a non-empty descriptive_answer without a layout must fall through to
+       sample_answer rather than borrow the question's layout. */
+    const solutionLayout = (0, common_utils_1.isNotEmptyOrNull)(descriptive)
+        ? descriptive?.solution_layout
+        : question?.questionObject?.solution_layout;
+    if ((0, common_utils_1.isNotEmptyOrNull)(solutionLayout)) {
+        const blocks = [];
+        solutionLayout.forEach((section) => {
+            if (!Array.isArray(section?.data))
+                return;
+            section.data.forEach((item) => {
+                /* Media hangs off a text block in the original, which skips any item
+                   without text_layout — a media-only item renders nothing. */
+                if ((0, common_utils_1.isEmptyOrNull)(item?.text_layout))
+                    return;
+                blocks.push({
+                    text: item.text_layout,
+                    media: item?.media_type === "image" && !(0, common_utils_1.isEmptyOrNull)(item?.media)
+                        ? item.media
+                        : "",
+                });
+            });
+        });
+        if (blocks.length > 0)
+            return blocks;
+    }
+    if ((0, common_utils_1.isNotEmptyOrNull)(descriptive?.sample_answer)) {
+        return [{ text: descriptive.sample_answer, media: "" }];
+    }
+    return [];
+};
+exports.getReferenceAnswerBlocks = getReferenceAnswerBlocks;
+/**
+ * Per question value read out of props that may be a scalar (shared by every
+ * question) or an array/map keyed by question index. Mirrors how `lowerLimit`,
+ * `upperLimit` and `isEdited` are already passed to the review presenter.
+ */
+const getIndexedValue = (prop, index, defaultValue) => {
+    if (prop === undefined || prop === null)
+        return defaultValue;
+    if (Array.isArray(prop) || typeof prop === "object") {
+        return prop[index] !== undefined ? prop[index] : defaultValue;
+    }
+    return prop;
+};
+exports.getIndexedValue = getIndexedValue;
+const buildScoreOptions = (lower, upper, step = 0.5) => {
+    const min = Number(lower);
+    const max = Number(upper);
+    if (Number.isNaN(min) || Number.isNaN(max) || max < min)
+        return [];
+    const options = [];
+    for (let value = min; value <= max; value += step) {
+        options.push(Number(value.toFixed(1)));
+    }
+    return options;
+};
+exports.buildScoreOptions = buildScoreOptions;
+/**
+ * Score, edited flag and mark ceiling for one descriptive answer, derived from
+ * its `descriptive_answer`. A teacher edit wins over the AI marks; otherwise the
+ * AI marks are the sum of the per rubric weights.
+ *
+ * Top level questions get these from the consumer (which keys them by question
+ * index); nested sub-questions have no index of their own, so they are derived
+ * here instead.
+ */
+const getDescriptiveScoreInfo = (descriptive = {}, questionObject = {}) => {
+    const totalMarks = Number(questionObject?.rubric?.totalMarks ?? descriptive?.rubric?.totalMarks ?? 0);
+    const editedMarks = descriptive?.teacher_feedback?.teacher_edited_marks;
+    const isEdited = (Number(descriptive?.teacher_score_edit_count) || 0) > 0 ||
+        (editedMarks !== undefined && editedMarks !== null);
+    if (isEdited) {
+        return { score: Number(editedMarks ?? 0), isEdited: true, totalMarks };
+    }
+    const aiMarks = Array.isArray(descriptive?.result)
+        ? descriptive.result.reduce((sum, mark) => sum + (Number(mark?.student_weight_score) || 0), 0)
+        : 0;
+    return { score: aiMarks, isEdited: false, totalMarks };
+};
+exports.getDescriptiveScoreInfo = getDescriptiveScoreInfo;
+/**
+ * Flattens a comprehension into one evaluable entry per sub-question, each
+ * shaped exactly like a top level question ({ questionObject, userAnswer,
+ * history }) so the same card internals can render it.
+ *
+ * Three sources have to be stitched together, the way the consumer assembles
+ * them and `ComprehensionLayout` reads them back:
+ *  - `sub_question`  — the definitions, identified by `version_uuid`
+ *  - `sub_questions` — the answers, pointing at a definition through `question`
+ *    (or `sub_question_id` inside the `user_answer` json) and carrying `chatId`
+ *  - the parent `history` — which gains one `{ [chatId]: [...] }` entry per
+ *    descriptive sub-answer
+ */
+const getComprehensionSubQuestions = (question = {}) => {
+    const questionObject = question?.questionObject || {};
+    const definitions = questionObject?.sub_question || [];
+    const answers = questionObject?.sub_questions || [];
+    /* The parent history mixes its own turns with single key { chatId: turns }
+       maps appended for the sub-answers; index the latter by chat id. */
+    const historyByChatId = {};
+    (question?.history || []).forEach((entry) => {
+        if (!entry || typeof entry !== "object")
+            return;
+        const keys = Object.keys(entry);
+        if (keys.length === 1 && Array.isArray(entry[keys[0]])) {
+            historyByChatId[keys[0]] = entry[keys[0]];
+        }
+    });
+    const source = (0, common_utils_1.isNotEmptyOrNull)(answers) ? answers : definitions;
+    const resolved = source.map((entry, index) => {
+        let parsedAnswer = {};
+        if ((0, common_utils_1.isNotEmptyOrNull)(entry?.user_answer)) {
+            try {
+                parsedAnswer = JSON.parse(entry.user_answer);
+            }
+            catch (error) {
+                parsedAnswer = {};
+            }
+        }
+        const definition = definitions.find((item) => item?.version_uuid === entry?.question) ||
+            definitions.find((item) => item?.version_uuid === parsedAnswer?.sub_question_id) ||
+            definitions.find((item) => item?.version_uuid === entry?.version_uuid) ||
+            /* `sub_questions` was absent, so `entry` is already a definition. */
+            entry;
+        const chatId = parsedAnswer?.chatId || "";
+        return {
+            questionObject: definition || {},
+            userAnswer: parsedAnswer,
+            history: historyByChatId[chatId] || [],
+            chatId,
+            subIndex: index,
+        };
+    });
+    /* A sub-question of an unsupported type has no layout here, so it is dropped
+       rather than rendered as an empty block. `subIndex` is re-stamped so the
+       numbering shown stays contiguous. */
+    return resolved
+        .filter((entry) => (0, exports.isSupportedQuestionType)(entry.questionObject, entry))
+        .map((entry, index) => ({ ...entry, subIndex: index }));
+};
+exports.getComprehensionSubQuestions = getComprehensionSubQuestions;
+/** A score or a summary may be changed at most this many times. */
+exports.MAX_TEACHER_EDITS = 2;
+/**
+ * How many times this answer's score and summary have already been changed.
+ * Both counters are reported by the save responses (`teacher_score_edit_count`
+ * and `teacher_feedback_edit_count`), so the consumer can store the server's
+ * value and the affordance disappears without waiting for a refetch.
+ */
+const getEditCounts = (descriptive = {}) => ({
+    score: Number(descriptive?.teacher_score_edit_count) || 0,
+    feedback: Number(descriptive?.teacher_feedback_edit_count) || 0,
+});
+exports.getEditCounts = getEditCounts;
+const getEditAvailability = (descriptive = {}) => {
+    const counts = (0, exports.getEditCounts)(descriptive);
+    return {
+        canEditScore: counts.score < exports.MAX_TEACHER_EDITS,
+        canEditSummary: counts.feedback < exports.MAX_TEACHER_EDITS,
+        counts,
+    };
+};
+exports.getEditAvailability = getEditAvailability;
+//# sourceMappingURL=teacherEvaluationUtils.js.map

package/dist/components/Organisms/TeacherEvaluation/teacherEvaluationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacherEvaluationUtils.js","sourceRoot":"","sources":["../../../../src/components/Organisms/TeacherEvaluation/teacherEvaluationUtils.js"],"names":[],"mappings":"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"}

package/dist/components/Organisms/TeacherEvaluation/useKeyboardAwareScroll.d.ts

@@ -0,0 +1 @@
+export function useKeyboardAwareScroll(isActive: any): import("react").MutableRefObject<null>;

package/dist/components/Organisms/TeacherEvaluation/useKeyboardAwareScroll.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useKeyboardAwareScroll = void 0;
+const react_1 = require("react");
+/**
+ * Mobile browsers shrink the visual viewport when the on-screen keyboard opens
+ * rather than reflowing the page layout, so a row sitting below the focused
+ * field (e.g. the editor's Save/Cancel actions) ends up covered by the
+ * keyboard instead of scrolled out of its way. `visualViewport`'s `resize`
+ * event fires once the keyboard finishes animating in, which is the cue to
+ * pull the returned ref's element back into view.
+ */
+const useKeyboardAwareScroll = (isActive) => {
+    const ref = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (!isActive)
+            return undefined;
+        const scrollIntoView = () => ref.current?.scrollIntoView({ behavior: "smooth", block: "end" });
+        const viewport = window.visualViewport;
+        viewport?.addEventListener("resize", scrollIntoView);
+        return () => viewport?.removeEventListener("resize", scrollIntoView);
+    }, [isActive]);
+    return ref;
+};
+exports.useKeyboardAwareScroll = useKeyboardAwareScroll;
+//# sourceMappingURL=useKeyboardAwareScroll.js.map

package/dist/components/Organisms/TeacherEvaluation/useKeyboardAwareScroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardAwareScroll.js","sourceRoot":"","sources":["../../../../src/components/Organisms/TeacherEvaluation/useKeyboardAwareScroll.js"],"names":[],"mappings":";;;AAAA,iCAA0C;AAE1C;;;;;;;GAOG;AACI,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,EAAE;IACjD,MAAM,GAAG,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAC;IAEzB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,cAAc,GAAG,GAAG,EAAE,CAC1B,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEpE,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC;QACvC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACrD,OAAO,GAAG,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAfW,QAAA,sBAAsB,0BAejC"}

package/dist/components/Organisms/TeacherEvaluation/useReviewNavigation.d.ts

@@ -0,0 +1,15 @@
+export function useReviewNavigation({ questions, handleNextProgress, learnProgressDetails, isRevision, reviewJourneyId, enabled, }: {
+    questions?: any[] | undefined;
+    handleNextProgress: any;
+    learnProgressDetails: any;
+    isRevision: any;
+    reviewJourneyId: any;
+    enabled?: boolean | undefined;
+}): {
+    chatVisibility: never[];
+    handleToggleChat: (index: any) => void;
+    scrollToQuestion: (index: any) => void;
+    updateDisplayRange: (limit: any, endIndex: any) => void;
+    pendingScrollIndex: number;
+};
+export default useReviewNavigation;

package/dist/components/Organisms/TeacherEvaluation/useReviewNavigation.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReviewNavigation = void 0;
+const react_1 = require("react");
+const react_usestateref_1 = __importDefault(require("react-usestateref"));
+const common_utils_1 = require("../../../utils/common-utils");
+/**
+ * Scroll, paging and per-question chat visibility for a review list.
+ *
+ * This is the same behaviour `ReviewPresenter` implements inline. It lives here
+ * rather than being imported from there because `ReviewPresenter` is the
+ * reference implementation for the existing student flow and is deliberately
+ * left untouched; once the two presenters are known to agree, that file can
+ * adopt this hook and the duplication goes away.
+ *
+ * Sub-questions carry `count: -1` and are excluded from every index here, so a
+ * progress dot and a scroll target both refer to main questions only — the same
+ * indexing `handleNextProgress` is called with.
+ */
+const useReviewNavigation = ({ questions = [], handleNextProgress, learnProgressDetails, isRevision, reviewJourneyId, enabled = true, }) => {
+    const [chatVisibility, setChatVisibility] = (0, react_usestateref_1.default)([]);
+    const [pendingScrollIndex, setPendingScrollIndex, pendingScrollIndexRef] = (0, react_usestateref_1.default)(0);
+    const [, setPaginatedValue, paginatedValueRef] = (0, react_usestateref_1.default)(0);
+    (0, react_1.useEffect)(() => {
+        setChatVisibility(Array(questions?.length || 0).fill(false));
+    }, [questions]);
+    (0, react_1.useEffect)(() => {
+        if (!enabled)
+            return;
+        setPendingScrollIndex(0);
+        setPaginatedValue(0);
+        !(0, common_utils_1.isNotEmptyOrNull)(learnProgressDetails) && !isRevision && scrollToQuestion(0);
+    }, [reviewJourneyId, isRevision, enabled]);
+    const getMainQuestions = () => questions?.filter((item) => item?.count !== -1) || [];
+    const scrollToQuestion = (index) => {
+        const mainQuestions = getMainQuestions();
+        if (index >= mainQuestions.length) {
+            setPendingScrollIndex(index);
+        }
+        /* The sticky header height grows with the viewport, so the scroll target is
+           offset by the band that would otherwise cover the question. */
+        const offsetHeight = [54, 54, 66, 70, 70, 70];
+        const breakpointIndex = Math.min((window.innerWidth / 320) | 0, offsetHeight.length - 1);
+        const adjustedHeight = offsetHeight[breakpointIndex];
+        const questionElement = mainQuestions[index]?.ref?.current;
+        if (questionElement) {
+            questionElement.style.scrollMarginTop = `${adjustedHeight}px`;
+            questionElement.scrollIntoView({
+                behavior: "smooth",
+                block: "start",
+                inline: "nearest",
+            });
+        }
+    };
+    /**
+     * Called by `ProgressView` whenever its visible window moves. When the window
+     * runs past what is loaded, ask the consumer for the next page instead of
+     * scrolling to a question that is not there yet.
+     */
+    const updateDisplayRange = (limit, endIndex) => {
+        const page = (0, common_utils_1.isNotEmptyOrNull)(Math.ceil(endIndex / limit))
+            ? Math.ceil(endIndex / limit)
+            : 1;
+        setPaginatedValue(page);
+        const mainQuestions = getMainQuestions();
+        if (paginatedValueRef?.current * limit >= mainQuestions.length) {
+            handleNextProgress?.(pendingScrollIndexRef?.current, paginatedValueRef?.current * limit);
+            return;
+        }
+        if (endIndex < mainQuestions.length && pendingScrollIndexRef?.current !== 0) {
+            scrollToQuestion(pendingScrollIndexRef?.current);
+        }
+    };
+    const handleToggleChat = (index) => {
+        setChatVisibility(chatVisibility?.map((item, i) => (i === index ? !item : item)));
+    };
+    return {
+        chatVisibility,
+        handleToggleChat,
+        scrollToQuestion,
+        updateDisplayRange,
+        pendingScrollIndex,
+    };
+};
+exports.useReviewNavigation = useReviewNavigation;
+exports.default = exports.useReviewNavigation;
+//# sourceMappingURL=useReviewNavigation.js.map

package/dist/components/Organisms/TeacherEvaluation/useReviewNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReviewNavigation.js","sourceRoot":"","sources":["../../../../src/components/Organisms/TeacherEvaluation/useReviewNavigation.js"],"names":[],"mappings":"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"}