@tinyweb_dev/oe-exam-sdk 0.2.12 → 0.2.14

package/dist/components/questions/types/answer-the-question-group/transform.js

@@ -1,3 +1,4 @@
+import { fromAnswerTheQuestionGroupImageUrls, toAnswerTheQuestionGroupImageUrls, } from '../../_shared/types/answer-the-question-group.type';
 const CHILD_QUESTION_TYPE = 'ANSWER_THE_QUESTION';
 const GRADING_TYPE = 'AI';
 const DEFAULT_INSTRUCTION = 'Read the text again and answer the questions.';
@@ -26,10 +27,12 @@ export const transformAnswerTheQuestionGroup = (question) => {
     const answerData = question.answer;
     const items = Array.isArray(answerData?.items) ? answerData.items : [];
     if (items.length === 0) {
+        const emptyAudioUrl = typeof answerData?.audioUrl === 'string' ? answerData.audioUrl.trim() : '';
         return {
             apiContent: {
                 meta: {
-                    instruction: DEFAULT_INSTRUCTION,
+                    instruction: answerData?.instruction || DEFAULT_INSTRUCTION,
+                    ...(emptyAudioUrl ? { audioUrl: emptyAudioUrl } : {}),
                     gradingType: GRADING_TYPE,
                     isAiGraded: true,
                 },
@@ -40,11 +43,13 @@ export const transformAnswerTheQuestionGroup = (question) => {
     }
     const apiItems = items.map((item, index) => {
         const expectedAnswers = normalizeExpectedAnswers(item.expectedAnswers);
+        const imageUrl = fromAnswerTheQuestionGroupImageUrls(item.imageUrl);
         return {
             questionType: CHILD_QUESTION_TYPE,
             ...(item.isExample ? { isExample: true } : {}),
             content: {
                 question: item.question || '',
+                ...(imageUrl !== undefined ? { imageUrl } : {}),
             },
             correctAnswer: { expectedAnswers },
             points: item.isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
@@ -52,11 +57,15 @@ export const transformAnswerTheQuestionGroup = (question) => {
         };
     });
     const passage = answerData?.passage?.trim();
+    const audioUrl = typeof answerData?.audioUrl === 'string' ? answerData.audioUrl.trim() : '';
+    const imageUrl = toAnswerTheQuestionGroupImageUrls(answerData?.imageUrl);
     return {
         apiContent: {
             meta: {
                 instruction: answerData?.instruction || DEFAULT_INSTRUCTION,
                 ...(!isContentEmpty(passage) ? { passage } : {}),
+                ...(audioUrl ? { audioUrl } : {}),
+                ...(imageUrl.length ? { imageUrl } : {}),
                 gradingType: GRADING_TYPE,
                 isAiGraded: true,
             },

package/dist/components/questions/types/choose-then-answer-group/ChooseThenAnswerGroupClient.d.ts

@@ -0,0 +1,2 @@
+import type { ChooseThenAnswerGroupClientProps } from '../../_shared/types/choose-then-answer-group.type';
+export declare function ChooseThenAnswerGroupClient({ questionData, isReviewMode, userAnswers, onAnswerChange, }: ChooseThenAnswerGroupClientProps): import("react").JSX.Element;

package/dist/components/questions/types/choose-then-answer-group/ChooseThenAnswerGroupClient.js

@@ -0,0 +1,34 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Lightbulb, Star } from 'lucide-react';
+import { cn } from '../../../../shared/lib/utils';
+function emptyAnswer() {
+    return { optionId: '', text: '' };
+}
+export function ChooseThenAnswerGroupClient({ questionData, isReviewMode = false, userAnswers = [], onAnswerChange, }) {
+    const canEdit = Boolean(onAnswerChange) && !isReviewMode;
+    const items = questionData.items || [];
+    return (_jsxs("div", { className: "space-y-4", children: [(questionData.title || questionData.instruction) && (_jsxs("div", { className: "rounded-xl border border-slate-200 bg-slate-50 px-4 py-3", children: [questionData.title && (_jsx("p", { className: "text-xs font-semibold uppercase tracking-wide text-slate-500", children: questionData.title })), questionData.instruction && (_jsx("p", { className: "text-sm font-medium text-slate-800", children: questionData.instruction }))] })), items.map((item, itemIndex) => {
+                const stored = userAnswers[itemIndex] || emptyAnswer();
+                const current = item.isExample
+                    ? { optionId: item.optionId, text: stored.text }
+                    : stored;
+                const expectedId = item.optionId;
+                const parts = (item.question || '').split('{0}');
+                const setAnswer = (next) => {
+                    if (!canEdit || item.isExample)
+                        return;
+                    onAnswerChange?.(itemIndex, {
+                        optionId: next.optionId ?? current.optionId,
+                        text: next.text ?? current.text,
+                    });
+                };
+                return (_jsxs("div", { className: "space-y-2 rounded-xl border border-gray-200 bg-white p-4", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "flex h-6 w-6 items-center justify-center rounded-full bg-slate-800 text-xs font-bold text-white", children: item.questionNumber || itemIndex + 1 }), item.isExample && (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-[10px] font-semibold uppercase text-amber-800", children: [_jsx(Star, { className: "h-3 w-3" }), "Example"] }))] }), _jsxs("p", { className: "flex flex-wrap items-center gap-1.5 text-[15px] leading-relaxed text-slate-800", children: [_jsx("span", { children: parts[0] || '' }), _jsx("span", { className: "inline-flex items-center gap-1", children: item.options.map((option, optionIndex) => {
+                                        const selected = current.optionId === option.id;
+                                        const showReview = isReviewMode && !item.isExample && Boolean(expectedId);
+                                        const isCorrect = showReview && option.id === expectedId;
+                                        const isWrong = showReview && selected && option.id !== expectedId;
+                                        return (_jsxs("span", { className: "inline-flex items-center gap-1", children: [optionIndex > 0 && _jsx("span", { className: "text-slate-400", children: "|" }), _jsx("button", { type: "button", disabled: !canEdit || item.isExample, onClick: () => setAnswer({ optionId: option.id }), className: cn('rounded-md border px-2.5 py-1 text-sm transition-colors', selected && !isCorrect && !isWrong && 'border-black bg-black text-white', !selected && !isCorrect && !isWrong && 'border-gray-300 bg-white text-gray-900', isCorrect && 'border-emerald-500 bg-emerald-50 text-emerald-900', isWrong && 'border-red-500 bg-red-50 text-red-900', (!canEdit || item.isExample) && 'cursor-default'), children: option.text || option.id })] }, option.id));
+                                    }) }), _jsx("span", { children: parts.slice(1).join('{0}') })] }), _jsx("textarea", { value: current.text, disabled: !canEdit || item.isExample, onChange: (event) => setAnswer({ text: event.target.value }), placeholder: "Answer for you", rows: 3, className: "w-full rounded-lg border border-slate-200 bg-white px-3 py-2 text-sm text-slate-800 outline-none focus:border-slate-400 disabled:bg-slate-50" })] }, `${item.questionNumber}-${itemIndex}`));
+            }), isReviewMode && questionData.explanation && (_jsxs("div", { className: "flex items-start gap-2 rounded-xl border border-amber-100 bg-amber-50 px-4 py-3 text-sm text-amber-800", children: [_jsx(Lightbulb, { className: "mt-0.5 h-4 w-4 flex-shrink-0" }), questionData.explanation] }))] }));
+}

package/dist/components/questions/types/choose-then-answer-group/ChooseThenAnswerGroupCreator.d.ts

@@ -0,0 +1,2 @@
+import type { ChooseThenAnswerGroupCreatorProps } from '../../_shared/types/choose-then-answer-group.type';
+export declare function ChooseThenAnswerGroupCreator({ initialData, onChange, externalErrors, onUnsavedChangesChange, validationRef, }: ChooseThenAnswerGroupCreatorProps): import("react").JSX.Element;

package/dist/components/questions/types/choose-then-answer-group/ChooseThenAnswerGroupCreator.js

@@ -0,0 +1,174 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Button } from '../../../../components/ui/button';
+import { Label } from '../../../../components/ui/label';
+import { Input } from '../../../../components/ui/input';
+import { PointsInput } from '../../../../components/ui/points-input';
+import { Textarea } from '../../../../components/ui/textarea';
+import { Card, CardContent, CardHeader, CardTitle } from '../../../../components/ui/card';
+import { Switch } from '../../../../components/ui/switch';
+import { useDebouncedCallback } from '../../../../shared/lib/hooks';
+import { Eye, Pencil, Plus, Star, Trash2 } from 'lucide-react';
+import { ChooseThenAnswerGroupClient } from './ChooseThenAnswerGroupClient';
+import { createEmptyItem, createEmptyOption, sumGradablePoints, } from './map-choose-then-answer-group-data';
+import { CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION } from '../../_shared/types/choose-then-answer-group.type';
+function normalizeItems(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return [createEmptyItem(1)];
+    }
+    return raw.map((item, index) => {
+        const fallback = createEmptyItem(index + 1);
+        const options = Array.isArray(item.options) && item.options.length >= 2
+            ? item.options.map((option, optionIndex) => ({
+                id: option.id || `opt-${optionIndex + 1}`,
+                text: option.text || '',
+            }))
+            : fallback.options;
+        return {
+            question: item.question || '',
+            options,
+            optionId: item.optionId || options[0]?.id || '',
+            isExample: item.isExample === true,
+            points: item.isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
+            questionNumber: item.questionNumber || index + 1,
+        };
+    });
+}
+export function ChooseThenAnswerGroupCreator({ initialData, onChange, externalErrors, onUnsavedChangesChange, validationRef, }) {
+    const [title, setTitle] = useState(initialData?.title || '');
+    const [instruction, setInstruction] = useState(initialData?.instruction || CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION);
+    const [items, setItems] = useState(() => normalizeItems(initialData?.items));
+    const [explanation, setExplanation] = useState(initialData?.explanation || '');
+    const [isClientMode, setIsClientMode] = useState(false);
+    const [errors, setErrors] = useState([]);
+    const onChangeRef = useRef(onChange);
+    const previousPayloadRef = useRef('');
+    useEffect(() => {
+        onChangeRef.current = onChange;
+    }, [onChange]);
+    const buildPayload = (nextTitle = title, nextInstruction = instruction, nextItems = items, nextExplanation = explanation) => ({
+        title: nextTitle,
+        instruction: nextInstruction,
+        items: nextItems,
+        explanation: nextExplanation,
+        points: sumGradablePoints(nextItems),
+    });
+    const debouncedOnChange = useDebouncedCallback((payload) => {
+        onChangeRef.current?.(payload);
+    }, 300);
+    useEffect(() => {
+        const payload = buildPayload();
+        const serialized = JSON.stringify(payload);
+        if (serialized !== previousPayloadRef.current) {
+            previousPayloadRef.current = serialized;
+            debouncedOnChange(payload);
+            onUnsavedChangesChange?.(true);
+        }
+    }, [title, instruction, items, explanation, debouncedOnChange, onUnsavedChangesChange]);
+    const validate = () => {
+        const nextErrors = [];
+        if (!instruction.trim()) {
+            nextErrors.push('Hướng dẫn (Instruction) không được để trống.');
+        }
+        if (items.length < 1) {
+            nextErrors.push('Cần ít nhất 1 câu.');
+        }
+        items.forEach((item, index) => {
+            if (!item.question.trim()) {
+                nextErrors.push(`Câu ${index + 1}: nội dung không được để trống.`);
+            }
+            else if (!item.question.includes('{0}')) {
+                nextErrors.push(`Câu ${index + 1}: phải có chỗ chọn {0}.`);
+            }
+            if (item.options.length < 2) {
+                nextErrors.push(`Câu ${index + 1}: cần ít nhất 2 lựa chọn.`);
+            }
+            const ids = new Set();
+            item.options.forEach((option, optionIndex) => {
+                if (!option.id.trim())
+                    nextErrors.push(`Câu ${index + 1} option ${optionIndex + 1}: thiếu id.`);
+                if (!option.text.trim())
+                    nextErrors.push(`Câu ${index + 1} option ${optionIndex + 1}: thiếu nội dung.`);
+                if (option.id.trim() && ids.has(option.id.trim())) {
+                    nextErrors.push(`Câu ${index + 1}: id "${option.id}" bị trùng.`);
+                }
+                ids.add(option.id.trim());
+            });
+            if (!item.optionId.trim() || !ids.has(item.optionId)) {
+                nextErrors.push(`Câu ${index + 1}: chưa chọn đáp án đúng.`);
+            }
+        });
+        setErrors(nextErrors);
+        return nextErrors.length === 0;
+    };
+    useEffect(() => {
+        if (!validationRef)
+            return;
+        validationRef.current = {
+            triggerValidation: async () => validate(),
+            getFormData: () => buildPayload(),
+        };
+        return () => {
+            validationRef.current = null;
+        };
+    });
+    const updateItem = (index, patch) => {
+        setItems((prev) => prev.map((item, i) => {
+            if (i !== index)
+                return item;
+            const next = { ...item, ...patch };
+            if (next.isExample)
+                next.points = 0;
+            return next;
+        }));
+    };
+    const updateOption = (itemIndex, optionIndex, text) => {
+        setItems((prev) => prev.map((item, i) => {
+            if (i !== itemIndex)
+                return item;
+            return {
+                ...item,
+                options: item.options.map((option, j) => (j === optionIndex ? { ...option, text } : option)),
+            };
+        }));
+    };
+    const addOption = (itemIndex) => {
+        setItems((prev) => prev.map((item, i) => {
+            if (i !== itemIndex)
+                return item;
+            return {
+                ...item,
+                options: [...item.options, createEmptyOption(item.options.map((option) => option.id))],
+            };
+        }));
+    };
+    const removeOption = (itemIndex, optionIndex) => {
+        setItems((prev) => prev.map((item, i) => {
+            if (i !== itemIndex || item.options.length <= 2)
+                return item;
+            const options = item.options.filter((_, j) => j !== optionIndex);
+            const removedId = item.options[optionIndex]?.id;
+            return {
+                ...item,
+                options,
+                optionId: item.optionId === removedId ? (options[0]?.id || '') : item.optionId,
+            };
+        }));
+    };
+    const addItem = () => {
+        setItems((prev) => [...prev, createEmptyItem(prev.length + 1)]);
+    };
+    const removeItem = (index) => {
+        if (items.length <= 1)
+            return;
+        setItems((prev) => prev.filter((_, i) => i !== index).map((item, i) => ({
+            ...item,
+            questionNumber: i + 1,
+        })));
+    };
+    const displayErrors = [...errors, ...(externalErrors || [])];
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx("div", { className: "flex justify-end", children: _jsxs(Button, { type: "button", variant: "outline", size: "sm", onClick: () => setIsClientMode((v) => !v), children: [isClientMode ? _jsx(Pencil, { className: "mr-2 h-4 w-4" }) : _jsx(Eye, { className: "mr-2 h-4 w-4" }), isClientMode ? 'Sửa' : 'Xem trước'] }) }), isClientMode ? (_jsx(ChooseThenAnswerGroupClient, { questionData: buildPayload(), isReviewMode: true })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-4 md:grid-cols-2", children: [_jsxs("div", { children: [_jsx(Label, { htmlFor: "cta-title", children: "Ti\u00EAu \u0111\u1EC1 (optional)" }), _jsx(Input, { id: "cta-title", value: title, onChange: (event) => setTitle(event.target.value), placeholder: "GRAMMAR" })] }), _jsxs("div", { children: [_jsx(Label, { htmlFor: "cta-instruction", children: "H\u01B0\u1EDBng d\u1EABn" }), _jsx(Input, { id: "cta-instruction", value: instruction, onChange: (event) => setInstruction(event.target.value), placeholder: CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION })] })] }), items.map((item, index) => (_jsxs(Card, { children: [_jsxs(CardHeader, { className: "flex flex-row items-center justify-between space-y-0", children: [_jsxs(CardTitle, { className: "text-base", children: ["C\u00E2u ", index + 1] }), items.length > 1 && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => removeItem(index), children: _jsx(Trash2, { className: "h-4 w-4 text-red-500" }) }))] }), _jsxs(CardContent, { className: "space-y-3", children: [_jsx(Input, { value: item.question, onChange: (event) => updateItem(index, { question: event.target.value }), placeholder: "Did you eat {0} for lunch today?" }), _jsxs("p", { className: "text-xs text-slate-500", children: ["D\u00F9ng ", '{0}', " cho ch\u1ED7 hi\u1EC7n chip ch\u1ECDn."] }), item.options.map((option, optionIndex) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Input, { value: option.text, onChange: (event) => updateOption(index, optionIndex, event.target.value), placeholder: `Lựa chọn ${optionIndex + 1}` }), item.options.length > 2 && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => removeOption(index, optionIndex), children: _jsx(Trash2, { className: "h-4 w-4 text-red-500" }) }))] }, option.id))), _jsxs(Button, { type: "button", size: "sm", variant: "outline", onClick: () => addOption(index), children: [_jsx(Plus, { className: "mr-1 h-4 w-4" }), " Th\u00EAm l\u1EF1a ch\u1ECDn"] }), _jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx("select", { className: "h-10 rounded-md border border-input bg-background px-3 text-sm", value: item.optionId, onChange: (event) => updateItem(index, { optionId: event.target.value }), children: item.options.map((option) => (_jsx("option", { value: option.id, children: option.text || option.id }, option.id))) }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx(Switch, { id: `cta-example-${index}`, checked: item.isExample === true, onCheckedChange: (checked) => updateItem(index, { isExample: checked }) }), _jsxs(Label, { htmlFor: `cta-example-${index}`, className: "flex cursor-pointer items-center gap-1 text-xs", children: [_jsx(Star, { className: "h-3 w-3 text-amber-500" }), "Example"] })] }), !item.isExample && (_jsx(PointsInput, { value: item.points, allowZero: true, onChange: (event) => updateItem(index, {
+                                                    points: Number.parseInt(event.target.value, 10) || 1,
+                                                }) }))] })] })] }, `${item.questionNumber}-${index}`))), _jsxs(Button, { type: "button", variant: "outline", onClick: addItem, children: [_jsx(Plus, { className: "mr-1 h-4 w-4" }), " Th\u00EAm c\u00E2u"] }), _jsxs("div", { children: [_jsx(Label, { htmlFor: "cta-explanation", children: "Gi\u1EA3i th\u00EDch" }), _jsx(Textarea, { id: "cta-explanation", value: explanation, onChange: (event) => setExplanation(event.target.value) })] })] })), displayErrors.length > 0 && (_jsx("ul", { className: "list-disc space-y-1 rounded-md border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700", children: displayErrors.map((error) => (_jsx("li", { children: error }, error))) }))] }));
+}

package/dist/components/questions/types/choose-then-answer-group/index.d.ts

@@ -0,0 +1,5 @@
+export { ChooseThenAnswerGroupCreator } from './ChooseThenAnswerGroupCreator';
+export { ChooseThenAnswerGroupClient } from './ChooseThenAnswerGroupClient';
+export { transformChooseThenAnswerGroup } from './transform';
+export { chooseThenAnswerGroupRegistration } from './register';
+export { mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, } from './map-choose-then-answer-group-data';

package/dist/components/questions/types/choose-then-answer-group/index.js

@@ -0,0 +1,5 @@
+export { ChooseThenAnswerGroupCreator } from './ChooseThenAnswerGroupCreator';
+export { ChooseThenAnswerGroupClient } from './ChooseThenAnswerGroupClient';
+export { transformChooseThenAnswerGroup } from './transform';
+export { chooseThenAnswerGroupRegistration } from './register';
+export { mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, } from './map-choose-then-answer-group-data';

package/dist/components/questions/types/choose-then-answer-group/map-choose-then-answer-group-data.d.ts

@@ -0,0 +1,11 @@
+import type { ChooseThenAnswerGroupData, ChooseThenAnswerGroupItemData, ChooseThenAnswerOption, ChooseThenAnswerStudentItemAnswer } from '../../_shared/types/choose-then-answer-group.type';
+export declare function nextPrefixedId(prefix: string, existing: string[]): string;
+export declare function sumGradablePoints(items: ChooseThenAnswerGroupItemData[]): number;
+export declare function createEmptyOption(existingIds: string[]): ChooseThenAnswerOption;
+export declare function createEmptyItem(questionNumber: number): ChooseThenAnswerGroupItemData;
+export declare function parseItemAnswer(raw: unknown): {
+    optionId: string;
+};
+export declare function parseStudentAnswer(raw: unknown): ChooseThenAnswerStudentItemAnswer;
+export declare function mapApiItem(item: unknown, index: number, fallbackAnswer?: unknown): ChooseThenAnswerGroupItemData;
+export declare function mapQuestionToChooseThenAnswerGroupData(question: Record<string, unknown> | null | undefined): ChooseThenAnswerGroupData;

package/dist/components/questions/types/choose-then-answer-group/map-choose-then-answer-group-data.js

@@ -0,0 +1,127 @@
+import { CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION } from '../../_shared/types/choose-then-answer-group.type';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function asRecord(value) {
+    return isRecord(value) ? value : {};
+}
+function asString(value, fallback = '') {
+    return typeof value === 'string' ? value : fallback;
+}
+export function nextPrefixedId(prefix, existing) {
+    let n = existing.length + 1;
+    const used = new Set(existing);
+    while (used.has(`${prefix}${n}`))
+        n += 1;
+    return `${prefix}${n}`;
+}
+export function sumGradablePoints(items) {
+    return items.reduce((total, item) => {
+        if (item.isExample)
+            return total;
+        return total + (typeof item.points === 'number' ? item.points : 1);
+    }, 0);
+}
+export function createEmptyOption(existingIds) {
+    return {
+        id: nextPrefixedId('opt-', existingIds),
+        text: '',
+    };
+}
+export function createEmptyItem(questionNumber) {
+    const first = createEmptyOption([]);
+    const second = createEmptyOption([first.id]);
+    return {
+        question: '',
+        options: [first, second],
+        optionId: first.id,
+        isExample: false,
+        points: 1,
+        questionNumber,
+    };
+}
+export function parseItemAnswer(raw) {
+    if (!isRecord(raw))
+        return { optionId: '' };
+    return { optionId: asString(raw.optionId) };
+}
+export function parseStudentAnswer(raw) {
+    if (!isRecord(raw))
+        return { optionId: '', text: '' };
+    return {
+        optionId: asString(raw.optionId),
+        text: asString(raw.text),
+    };
+}
+function mapOptions(raw) {
+    if (!Array.isArray(raw) || raw.length < 2) {
+        const first = createEmptyOption([]);
+        const second = createEmptyOption([first.id]);
+        return [first, second];
+    }
+    return raw.map((item, index) => {
+        const record = asRecord(item);
+        return {
+            id: asString(record.id, `opt-${index + 1}`),
+            text: asString(record.text),
+        };
+    });
+}
+export function mapApiItem(item, index, fallbackAnswer) {
+    const record = asRecord(item);
+    const content = asRecord(record.content);
+    const correctAnswer = asRecord(record.correctAnswer);
+    const isExample = record.isExample === true;
+    const options = mapOptions(content.options);
+    const parsed = parseItemAnswer(correctAnswer.answer ?? fallbackAnswer);
+    return {
+        question: asString(content.question) || asString(record.question),
+        options,
+        optionId: parsed.optionId || options[0]?.id || '',
+        isExample,
+        points: isExample ? 0 : (typeof record.points === 'number' ? record.points : 1),
+        questionNumber: typeof record.questionNumber === 'number' ? record.questionNumber : index + 1,
+    };
+}
+export function mapQuestionToChooseThenAnswerGroupData(question) {
+    const source = asRecord(question);
+    const content = asRecord(source.content);
+    const answer = asRecord(source.answer);
+    const correctAnswer = asRecord(source.correctAnswer ?? source.correct_answer ?? answer.correctAnswer);
+    const explanation = asString(source.explanation) || asString(answer.explanation);
+    const meta = asRecord(content.meta ?? answer.meta);
+    const fallbackAnswers = Array.isArray(correctAnswer.answer) ? correctAnswer.answer : [];
+    if (Array.isArray(content.items)) {
+        const items = content.items.map((item, index) => mapApiItem(item, index, fallbackAnswers[index]));
+        return {
+            title: asString(meta.title) || asString(answer.title),
+            instruction: asString(meta.instruction) ||
+                asString(answer.instruction) ||
+                CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION,
+            items,
+            explanation,
+            points: sumGradablePoints(items),
+        };
+    }
+    if (Array.isArray(answer.items)) {
+        const items = answer.items.map((item, index) => ({
+            ...createEmptyItem(index + 1),
+            ...item,
+            questionNumber: item.questionNumber || index + 1,
+        }));
+        return {
+            title: asString(answer.title),
+            instruction: asString(answer.instruction) || CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION,
+            items,
+            explanation,
+            points: typeof answer.points === 'number' ? answer.points : sumGradablePoints(items),
+        };
+    }
+    return {
+        title: '',
+        instruction: CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION,
+        items: [createEmptyItem(1)],
+        explanation,
+        points: 1,
+    };
+}

package/dist/components/questions/types/choose-then-answer-group/register.d.ts

@@ -0,0 +1,3 @@
+import type { QuestionTypeRegistration } from '../../creator/question-type-registry';
+export { createEmptyItem, mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, sumGradablePoints, } from './map-choose-then-answer-group-data';
+export declare const chooseThenAnswerGroupRegistration: QuestionTypeRegistration;

package/dist/components/questions/types/choose-then-answer-group/register.js

@@ -0,0 +1,37 @@
+import { ChooseThenAnswerGroupCreator } from './ChooseThenAnswerGroupCreator';
+import { mapQuestionToChooseThenAnswerGroupData } from './map-choose-then-answer-group-data';
+export { createEmptyItem, mapQuestionToChooseThenAnswerGroupData, parseStudentAnswer, sumGradablePoints, } from './map-choose-then-answer-group-data';
+export const chooseThenAnswerGroupRegistration = {
+    component: ChooseThenAnswerGroupCreator,
+    transformInitialData: (initialData) => mapQuestionToChooseThenAnswerGroupData(initialData),
+    getExtraProps: (ctx) => ({
+        onUnsavedChangesChange: ctx.onUnsavedChangesChange,
+        validationRef: ctx.validationRef,
+    }),
+    wrapOnSave: (data, ctx) => {
+        const payload = data;
+        return {
+            type: ctx.questionType,
+            content: ctx.state.content,
+            points: payload.points ?? ctx.state.points ?? 1,
+            level: ctx.state.level,
+            difficulty: ctx.state.difficulty,
+            skill: ctx.state.skill,
+            answer: payload,
+            explanation: payload.explanation || '',
+        };
+    },
+    wrapOnChange: (data, ctx) => {
+        const payload = data;
+        return {
+            type: ctx.questionType,
+            content: ctx.state.content,
+            points: payload.points ?? ctx.state.points ?? 1,
+            level: ctx.state.level,
+            difficulty: ctx.state.difficulty,
+            skill: ctx.state.skill,
+            answer: payload,
+            explanation: payload.explanation || '',
+        };
+    },
+};

package/dist/components/questions/types/choose-then-answer-group/transform.d.ts

@@ -0,0 +1,2 @@
+import type { TransformHandler } from '../../../../shared/lib/utils/question-transform-types';
+export declare const transformChooseThenAnswerGroup: TransformHandler;

package/dist/components/questions/types/choose-then-answer-group/transform.js

@@ -0,0 +1,37 @@
+import { CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION, CHOOSE_THEN_ANSWER_ITEM_TYPE, } from '../../_shared/types/choose-then-answer-group.type';
+import { sumGradablePoints } from './map-choose-then-answer-group-data';
+export const transformChooseThenAnswerGroup = (question) => {
+    const answerData = question.answer;
+    const items = Array.isArray(answerData?.items) ? answerData.items : [];
+    if (items.length === 0) {
+        return { apiContent: { items: [] }, apiCorrectAnswer: { answer: [] } };
+    }
+    const title = typeof answerData?.title === 'string' ? answerData.title.trim() : '';
+    const apiItems = items.map((item, index) => ({
+        questionType: CHOOSE_THEN_ANSWER_ITEM_TYPE,
+        ...(item.isExample ? { isExample: true } : {}),
+        content: {
+            question: item.question || '',
+            options: (item.options || []).map((option) => ({
+                id: option.id || '',
+                text: option.text || '',
+            })),
+        },
+        correctAnswer: { answer: { optionId: item.optionId || '' } },
+        points: item.isExample ? 0 : (typeof item.points === 'number' ? item.points : 1),
+        questionNumber: item.questionNumber || index + 1,
+    }));
+    return {
+        apiContent: {
+            meta: {
+                instruction: answerData?.instruction || CHOOSE_THEN_ANSWER_GROUP_DEFAULT_INSTRUCTION,
+                ...(title ? { title } : {}),
+            },
+            items: apiItems,
+        },
+        apiCorrectAnswer: {
+            answer: apiItems.map((item) => item.correctAnswer.answer),
+        },
+        totalPoints: sumGradablePoints(items),
+    };
+};

package/dist/components/questions/types/fill-in-blank-group/FillInBlankGroupClient.js

@@ -1,15 +1,44 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Lightbulb, Star, Volume2 } from 'lucide-react';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { BookOpen, Lightbulb, Star, Volume2 } from 'lucide-react';
 import { cn } from '../../../../shared/lib/utils';
 import { usePresignedFileUrl } from '../../../../shared/lib/hooks';
-import { blankSlotCount, extractPlaceholderIndices, isBlankMatch, joinSlashAnswers, padStudentAnswers, splitStem, } from './blank-utils';
+import { blankSlotCount, extractPlaceholderIndices, isBlankMatch, joinSlashAnswers, padStudentAnswers, resolveBlankOptions, splitStem, splitStemTextDecorations, toFillInBlankImageUrls, } from './blank-utils';
+const STEM_MARK_STYLE = {
+    fontWeight: 700,
+    fontSize: 20,
+    lineHeight: 1,
+};
+function StemText({ value }) {
+    return (_jsx(_Fragment, { children: splitStemTextDecorations(value).map((fragment, fragmentIndex) => {
+            if (fragment.type === 'br') {
+                return _jsx("br", {}, `br-${fragmentIndex}`);
+            }
+            if (fragment.type === 'tick') {
+                return (_jsx("span", { style: { ...STEM_MARK_STYLE, color: '#16a34a' }, children: fragment.value }, `tick-${fragmentIndex}`));
+            }
+            if (fragment.type === 'cross') {
+                return (_jsx("span", { style: { ...STEM_MARK_STYLE, color: '#dc2626' }, children: fragment.value }, `cross-${fragmentIndex}`));
+            }
+            return _jsx("span", { children: fragment.value }, `text-${fragmentIndex}`);
+        }) }));
+}
+function isDisplayableMediaUrl(value) {
+    return (value.startsWith('http://')
+        || value.startsWith('https://')
+        || value.startsWith('blob:')
+        || value.startsWith('data:')
+        || value.startsWith('/'));
+}
 function MediaPreview({ src, kind, alt }) {
     const { previewUrl, isLoading } = usePresignedFileUrl(src);
     if (isLoading) {
         return _jsx("div", { className: "h-16 w-16 animate-pulse rounded-md bg-slate-100" });
     }
-    const url = previewUrl || src;
+    const url = previewUrl || (isDisplayableMediaUrl(src) ? src : '');
+    if (!url) {
+        return null;
+    }
     if (kind === 'audio') {
         return _jsx("audio", { controls: true, src: url, className: "h-8 max-w-full" });
     }
@@ -35,30 +64,36 @@ export function FillInBlankGroupClient({ questionData, isReviewMode = false, use
         next[itemIndex] = { answers: current };
         onAnswerChange(next);
     };
-    return (_jsxs("div", { className: "space-y-4", children: [questionData.instruction && (_jsx("div", { className: "rounded-xl border border-indigo-100 bg-indigo-50 px-4 py-3 text-sm font-medium text-indigo-800", children: questionData.instruction })), questionData.audioUrl && (_jsxs("div", { className: "flex items-center gap-2 rounded-lg border border-slate-200 bg-white px-3 py-2", children: [_jsx(Volume2, { className: "h-4 w-4 text-slate-500" }), _jsx(MediaPreview, { src: questionData.audioUrl, kind: "audio", alt: "Group audio" })] })), questionData.imageUrl && (_jsx("div", { className: "flex justify-center rounded-lg border border-slate-100 bg-slate-50 p-3", children: _jsx(MediaPreview, { src: questionData.imageUrl, kind: "image", alt: "Group image" }) })), groupHints.length > 0 && (_jsx("div", { className: "flex flex-wrap gap-2", children: groupHints.map((hint) => (_jsx("span", { className: "rounded-full border border-blue-200 bg-blue-50 px-3 py-1 text-xs font-semibold text-blue-700", children: hint }, hint))) })), _jsx("div", { className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3", children: items.map((item, itemIndex) => {
+    return (_jsxs("div", { className: "space-y-4", children: [questionData.instruction && (_jsx("div", { className: "rounded-xl border border-indigo-100 bg-indigo-50 px-4 py-3 text-sm font-medium text-indigo-800", children: questionData.instruction })), questionData.passage && (_jsxs("div", { className: "rounded-xl border border-gray-200 bg-white p-5 shadow-xs", children: [_jsxs("div", { className: "mb-2.5 flex items-center gap-2 text-xs font-bold uppercase tracking-wider text-indigo-700", children: [_jsx(BookOpen, { className: "h-4 w-4" }), _jsx("span", { children: "B\u00E0i \u0111\u1ECDc (Reading Passage)" })] }), _jsx("div", { className: "prose prose-sm max-w-none leading-relaxed text-gray-800", dangerouslySetInnerHTML: { __html: questionData.passage } })] })), questionData.audioUrl && (_jsxs("div", { className: "flex items-center gap-2 rounded-lg border border-slate-200 bg-white px-3 py-2", children: [_jsx(Volume2, { className: "h-4 w-4 text-slate-500" }), _jsx(MediaPreview, { src: questionData.audioUrl, kind: "audio", alt: "Group audio" })] })), toFillInBlankImageUrls(questionData.imageUrl).length > 0 && (_jsx("div", { className: "flex flex-wrap gap-2", children: toFillInBlankImageUrls(questionData.imageUrl).map((url, imageIndex) => (_jsx(MediaPreview, { src: url, kind: "image", alt: `Group image ${imageIndex + 1}` }, `group-image-${imageIndex}`))) })), groupHints.length > 0 && (_jsx("div", { className: "flex flex-wrap gap-2", children: groupHints.map((hint) => (_jsx("span", { className: "rounded-full border border-blue-200 bg-blue-50 px-3 py-1 text-xs font-semibold text-blue-700", children: hint }, hint))) })), _jsx("div", { className: "grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3", children: items.map((item, itemIndex) => {
                     const blankCount = blankSlotCount(item.question || '{0}');
                     const placeholderIndices = extractPlaceholderIndices(item.question || '{0}');
                     const userValue = padStudentAnswers(userAnswers[itemIndex], blankCount);
                     const stem = splitStem(item.question || '{0}');
                     const showItemAudio = Boolean(item.audioUrl) && !questionData.audioUrl;
-                    return (_jsxs("div", { className: "overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-100 bg-gray-50 px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "flex h-6 w-6 items-center justify-center rounded-full bg-blue-600 text-xs font-bold text-white", children: item.questionNumber || itemIndex + 1 }), item.isExample && (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-xs font-semibold text-amber-700", children: [_jsx(Star, { className: "h-3 w-3" }), "Example"] }))] }), _jsxs("span", { className: "text-xs text-gray-500", children: [item.points || 0, " \u0111i\u1EC3m"] })] }), _jsxs("div", { className: "flex items-center gap-3 p-3", children: [item.imageUrl && (_jsx(MediaPreview, { src: item.imageUrl, kind: "image", alt: `Item ${item.questionNumber}` })), _jsxs("div", { className: "min-w-0 flex-1 space-y-2 text-sm leading-relaxed text-slate-800", children: [showItemAudio && item.audioUrl && (_jsx(MediaPreview, { src: item.audioUrl, kind: "audio", alt: `Item ${item.questionNumber} audio` })), stem.map((part, partIndex) => {
+                    return (_jsxs("div", { className: "overflow-hidden rounded-xl border border-gray-200 bg-white shadow-sm", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-gray-100 bg-gray-50 px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "flex h-6 w-6 items-center justify-center rounded-full bg-blue-600 text-xs font-bold text-white", children: item.questionNumber || itemIndex + 1 }), item.isExample && (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-xs font-semibold text-amber-700", children: [_jsx(Star, { className: "h-3 w-3" }), "Example"] }))] }), _jsxs("span", { className: "text-xs text-gray-500", children: [item.points || 0, " \u0111i\u1EC3m"] })] }), _jsxs("div", { className: "space-y-3 p-3", children: [toFillInBlankImageUrls(item.imageUrl).length > 0 && (_jsx("div", { className: "flex flex-wrap items-center gap-2", children: toFillInBlankImageUrls(item.imageUrl).map((url, imageIndex) => (_jsx(MediaPreview, { src: url, kind: "image", alt: `Item ${item.questionNumber} image ${imageIndex + 1}` }, `${item.questionNumber}-${imageIndex}`))) })), _jsxs("div", { className: "min-w-0 space-y-2 text-sm leading-relaxed text-slate-800", children: [showItemAudio && item.audioUrl && (_jsx(MediaPreview, { src: item.audioUrl, kind: "audio", alt: `Item ${item.questionNumber} audio` })), stem.map((part, partIndex) => {
                                                 if (part.type === 'text') {
-                                                    return _jsx("span", { children: part.value }, partIndex);
+                                                    return (_jsx("span", { children: _jsx(StemText, { value: part.value }) }, partIndex));
                                                 }
                                                 const alts = item.answers[part.index] || [];
                                                 const student = userValue[part.index] || '';
                                                 const canEdit = !isReviewMode && !item.isExample && Boolean(onAnswerChange);
                                                 const correct = isReviewMode && isBlankMatch(student, alts);
                                                 const wrong = isReviewMode && student.trim().length > 0 && !correct;
-                                                return (_jsx("input", { type: "text", disabled: !canEdit, value: item.isExample ? (alts[0] || '') : student, onChange: (event) => handleBlankChange(itemIndex, part.index, event.target.value), placeholder: item.isExample ? '' : '...', className: cn('mx-1 inline-block w-16 rounded-md border-2 px-1 py-0.5 text-center text-sm font-semibold outline-none', item.isExample
-                                                        ? 'border-amber-300 bg-amber-50 text-amber-800'
-                                                        : correct
-                                                            ? 'border-emerald-400 bg-emerald-50 text-emerald-800'
-                                                            : wrong
-                                                                ? 'border-rose-400 bg-rose-50 text-rose-800'
-                                                                : canEdit
-                                                                    ? 'border-blue-300 bg-white text-slate-800 focus:border-blue-500'
-                                                                    : 'border-blue-200 bg-blue-50 text-blue-900') }, partIndex));
+                                                const blankOptions = resolveBlankOptions(part.index, item.wordBank, questionData.wordBank);
+                                                const useOptions = Boolean(blankOptions);
+                                                const fieldClass = cn('mx-1 inline-block rounded-md border-2 px-1 py-0.5 text-center text-sm font-semibold outline-none', useOptions ? 'min-w-[5.5rem]' : 'w-16', item.isExample
+                                                    ? 'border-amber-300 bg-amber-50 text-amber-800'
+                                                    : correct
+                                                        ? 'border-emerald-400 bg-emerald-50 text-emerald-800'
+                                                        : wrong
+                                                            ? 'border-rose-400 bg-rose-50 text-rose-800'
+                                                            : canEdit
+                                                                ? 'border-blue-300 bg-white text-slate-800 focus:border-blue-500'
+                                                                : 'border-blue-200 bg-blue-50 text-blue-900');
+                                                if (useOptions && blankOptions) {
+                                                    return (_jsxs("select", { disabled: !canEdit, value: item.isExample ? (alts[0] || '') : student, onChange: (event) => handleBlankChange(itemIndex, part.index, event.target.value), className: fieldClass, children: [!item.isExample && _jsx("option", { value: "", children: "..." }), blankOptions.map((option) => (_jsx("option", { value: option, children: option }, option)))] }, partIndex));
+                                                }
+                                                return (_jsx("input", { type: "text", disabled: !canEdit, value: item.isExample ? (alts[0] || '') : student, onChange: (event) => handleBlankChange(itemIndex, part.index, event.target.value), placeholder: item.isExample ? '' : '...', className: fieldClass }, partIndex));
                                             })] })] }), isReviewMode && !item.isExample && (_jsxs("div", { className: "border-t border-emerald-100 bg-emerald-50 px-3 py-2 text-xs text-emerald-800", children: ["\u0110\u00E1p \u00E1n: ", placeholderIndices.map((index) => joinSlashAnswers(item.answers[index]) || '(trống)').join(' | ')] }))] }, `${item.questionNumber}-${itemIndex}`));
                 }) }), isReviewMode && questionData.explanation && (_jsxs("div", { className: "flex items-start gap-2 rounded-xl border border-amber-100 bg-amber-50 px-4 py-3 text-sm text-amber-800", children: [_jsx(Lightbulb, { className: "mt-0.5 h-4 w-4 flex-shrink-0" }), questionData.explanation] }))] }));
 }