@tinyweb_dev/oe-exam-sdk 1.0.1 → 1.0.2

package/dist/components/questions/viewer/QuestionViewer.js

@@ -18,7 +18,6 @@ import { WriteAShortLetterClient } from '../types/write-a-short-letter/WriteASho
 import { LookPictureChooseCorrectAnswerClient } from '../types/look-picture-choose-correct-answer/LookPictureChooseCorrectAnswerClient';
 import { LookPictureFillBlankChooseAnswerClient } from '../types/look-picture-fill-blank-choose-answer/LookPictureFillBlankChooseAnswerClient';
 import { FillMissingWordsInGridClient } from '../types/fill-missing-words-in-grid/FillMissingWordsInGridClient';
-import { WordFillStructuredFormClient } from '../types/word-fill-structured-form/WordFillStructuredFormClient';
 import { CrosswordPuzzleClient } from '../types/crossword-puzzle/CrosswordPuzzleClient';
 import { FindWordsInMatrixClient } from '../types/find-words-in-matrix/FindWordsInMatrixClient';
 import { SortWordsIntoCategoriesViewer } from './SortWordsIntoCategoriesViewer';
@@ -517,72 +516,6 @@ export function QuestionViewer({ question, onSubmitAnswer, isReviewMode = false,
                 onSubmitAnswer?.(answers);
             } }));
     };
-    const renderWordFillStructuredForm = () => {
-        const content = (question.content && typeof question.content === 'object'
-            ? question.content
-            : {});
-        // Pearson preview maps correctAnswer → answer; bank may use either shape.
-        const answer = (question.answer ??
-            question.correctAnswer ??
-            {});
-        const answers = answer?.answers && typeof answer.answers === 'object' && !Array.isArray(answer.answers)
-            ? answer.answers
-            : {};
-        const html = String(content.content || '');
-        const blankRaw = String(content.blankStyle || '').toLowerCase();
-        const blankStyle = blankRaw === 'letter' || blankRaw === 'box'
-            ? 'letter'
-            : blankRaw === 'phrase' || blankRaw === 'sentence'
-                ? 'phrase'
-                : 'word';
-        const userMap = userAnswer && typeof userAnswer === 'object' && !Array.isArray(userAnswer)
-            ? userAnswer
-            : selectedAnswer && typeof selectedAnswer === 'object' && !Array.isArray(selectedAnswer)
-                ? selectedAnswer
-                : isReviewMode
-                    ? answers
-                    : {};
-        const qNum = typeof question.questionNumber === 'number' && question.questionNumber > 0
-            ? question.questionNumber
-            : undefined;
-        const rawWordBank = Array.isArray(content.wordBank) ? content.wordBank : undefined;
-        const wordBank = rawWordBank?.map((entry) => {
-            if (entry == null || typeof entry !== 'object')
-                return null;
-            const rec = entry;
-            if (Array.isArray(rec.options)) {
-                const options = rec.options.map((o) => String(o ?? '').trim()).filter(Boolean);
-                return options.length >= 2 ? { options } : null;
-            }
-            const word = String(rec.word ?? '').trim();
-            if (word)
-                return rec.isExample ? { word, isExample: true } : { word };
-            return null;
-        });
-        const hasWordOptions = Boolean(wordBank?.some((e) => e != null &&
-            'options' in e &&
-            Array.isArray(e.options) &&
-            (e.options?.length ?? 0) >= 2));
-        const hasSharedWords = Boolean(wordBank?.some((e) => e != null && 'word' in e && e.word));
-        const viewMode = String(content.viewMode || '').trim() ||
-            (hasWordOptions ? 'WITH_OPTIONS' : hasSharedWords ? 'WITH_WORD_BANK' : undefined);
-        return (_jsx(WordFillStructuredFormClient, { questionData: {
-                title: String(content.title || ''),
-                imageUrl: content.imageUrl ? String(content.imageUrl) : undefined,
-                content: html,
-                blankStyle,
-                answers,
-                caseSensitive: Boolean(answer?.caseSensitive),
-                explanation: question.explanation,
-                ...(viewMode ? { viewMode } : {}),
-                ...((hasWordOptions || hasSharedWords) && wordBank ? { wordBank } : {}),
-            }, userAnswer: userMap, isReviewMode: isReviewMode, autoFillCorrectAnswers: isReviewMode && Object.keys(userMap).length === 0, explanation: question.explanation, questionNumber: qNum, onAnswerChange: (key, value) => {
-                const prev = selectedAnswer && typeof selectedAnswer === 'object' && !Array.isArray(selectedAnswer)
-                    ? selectedAnswer
-                    : {};
-                setSelectedAnswer({ ...prev, [key]: value });
-            } }));
-    };
     const renderWordFillParagraph = () => {
         const content = (question.content && typeof question.content === 'object'
             ? question.content

package/dist/components/themes/cambridge-yle/CambridgeYleInstructionBanner.js

@@ -1,6 +1,15 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Info, Megaphone } from 'lucide-react';
+/** CMS instruction may be plain text or HTML (e.g. `<p>…</p>`). */
+function isHtmlContent(value) {
+    return /<[a-z][\s\S]*>/i.test(value);
+}
+function InstructionHtml({ html, className }) {
+    return (_jsx("div", { className: className, 
+        // Exam CMS content — not end-user input.
+        dangerouslySetInnerHTML: { __html: html } }));
+}
 export default function CambridgeYleInstructionBanner({ instruction, instructions, hasExample = false, children, isReviewMode = false, compact = false, }) {
     if (isReviewMode)
         return null;
@@ -11,9 +20,9 @@ export default function CambridgeYleInstructionBanner({ instruction, instruction
                     ? 'flex w-full items-center gap-2 rounded-[14px] border-2 border-dashed border-blue-300 bg-[#F8FBFF] px-3 py-2 transition-all hover:bg-blue-50/50 lg:gap-3 lg:px-4 lg:py-2.5 xl:gap-5 xl:rounded-[24px] xl:px-5 xl:py-4'
                     : 'flex w-full items-center gap-4 rounded-[24px] border-2 border-dashed border-blue-300 bg-[#F8FBFF] px-5 py-4 transition-all hover:bg-blue-50/50 sm:gap-5', children: [_jsx("div", { className: compact
                             ? 'flex h-8 w-8 shrink-0 -rotate-6 items-center justify-center rounded-[10px] bg-[#0070FF] shadow-[3px_3px_0px_rgba(191,219,254,1)] transition-transform hover:rotate-0 lg:h-9 lg:w-9 xl:h-14 xl:w-14 xl:rounded-[16px] xl:shadow-[4px_4px_0px_rgba(191,219,254,1)]'
-                            : 'flex h-12 w-12 shrink-0 -rotate-6 items-center justify-center rounded-[16px] bg-[#0070FF] shadow-[4px_4px_0px_rgba(191,219,254,1)] transition-transform hover:rotate-0 sm:h-14 sm:w-14', children: _jsx(Megaphone, { className: compact ? 'h-4 w-4 text-white lg:h-5 lg:w-5 xl:h-7 xl:w-7' : 'h-6 w-6 text-white sm:h-7 sm:w-7', strokeWidth: 2.5 }) }), _jsx("div", { className: "flex flex-1 flex-col justify-center", children: _jsxs("p", { className: compact
+                            : 'flex h-12 w-12 shrink-0 -rotate-6 items-center justify-center rounded-[16px] bg-[#0070FF] shadow-[4px_4px_0px_rgba(191,219,254,1)] transition-transform hover:rotate-0 sm:h-14 sm:w-14', children: _jsx(Megaphone, { className: compact ? 'h-4 w-4 text-white lg:h-5 lg:w-5 xl:h-7 xl:w-7' : 'h-6 w-6 text-white sm:h-7 sm:w-7', strokeWidth: 2.5 }) }), _jsx("div", { className: "flex flex-1 flex-col justify-center", children: _jsxs("div", { className: compact
                                 ? 'text-[12px] font-black uppercase leading-tight tracking-wide text-[#002868] lg:text-[13px] xl:text-[18px] xl:leading-snug'
-                                : 'text-[15px] font-black uppercase leading-snug tracking-wide text-[#002868] sm:text-[18px]', style: { fontFamily: '"SVN-Volte Rounded", "Quicksand", sans-serif' }, children: [instruction, hasExample && (_jsx("span", { className: compact
+                                : 'text-[15px] font-black uppercase leading-snug tracking-wide text-[#002868] sm:text-[18px]', style: { fontFamily: '"SVN-Volte Rounded", "Quicksand", sans-serif' }, children: [isHtmlContent(instruction) ? (_jsx(InstructionHtml, { html: instruction, className: "contents [&_p]:m-0 [&_p]:inline" })) : (instruction), hasExample && (_jsx("span", { className: compact
                                         ? 'ml-1 inline-block rounded-full bg-blue-100 px-1.5 py-0.5 align-middle text-[10px] font-bold tracking-normal text-[#0070FF] xl:-mt-1 xl:ml-2 xl:px-3 xl:text-[16px]'
-                                        : 'ml-2 -mt-1 inline-block rounded-full bg-blue-100 px-3 py-0.5 align-middle text-[14px] font-bold tracking-normal text-[#0070FF] sm:text-[16px]', children: "THERE IS ONE EXAMPLE" }))] }) })] })), children, hasInstructionsList && (_jsx("div", { className: "rounded-lg border border-blue-200 bg-white p-4 shadow-sm", children: _jsxs("div", { className: "space-y-3", children: [_jsxs("h4", { className: "flex items-center gap-2 font-semibold text-blue-900", children: [_jsx(Info, { className: "h-4 w-4" }), "Instructions"] }), _jsx("ol", { className: "list-inside list-decimal space-y-1.5 text-sm text-gray-700", children: instructions.map((item, index) => (_jsx("li", { className: "leading-relaxed", children: item }, index))) })] }) }))] }));
+                                        : 'ml-2 -mt-1 inline-block rounded-full bg-blue-100 px-3 py-0.5 align-middle text-[14px] font-bold tracking-normal text-[#0070FF] sm:text-[16px]', children: "THERE IS ONE EXAMPLE" }))] }) })] })), children, hasInstructionsList && (_jsx("div", { className: "rounded-lg border border-blue-200 bg-white p-4 shadow-sm", children: _jsxs("div", { className: "space-y-3", children: [_jsxs("h4", { className: "flex items-center gap-2 font-semibold text-blue-900", children: [_jsx(Info, { className: "h-4 w-4" }), "Instructions"] }), _jsx("ol", { className: "list-inside list-decimal space-y-1.5 text-sm text-gray-700", children: instructions.map((item, index) => (_jsx("li", { className: "leading-relaxed", children: isHtmlContent(item) ? (_jsx(InstructionHtml, { html: item, className: "[&_p]:m-0" })) : (item) }, index))) })] }) }))] }));
 }

package/dist/components/themes/english-certification/EcWordFillStructuredForm.js

@@ -5,6 +5,7 @@ import { ResolvedImage } from '../../../components/common/ResolvedImage';
 import { cn } from '../../../shared/lib/utils';
 import { transformWordFillStructuredForm } from '../../../components/exams/take/exam-taking.utils';
 import { englishCertQuestionDomId } from './english-cert-scroll';
+import { expandWfsfCorrectAlts, formatWfsfCorrectLabel, isWfsfBlankCorrect, } from '../../../shared/lib/utils/wfsf-blank-match';
 /**
  * Replace `{key}` placeholders in raw HTML with inline `<input>` elements so the
  * full HTML structure (tables, forms, …) is preserved and inputs render inside
@@ -25,14 +26,6 @@ function buildHtmlWithInputPlaceholders(html) {
     `;
     });
 }
-function normalizeStructuredAnswer(value, caseSensitive) {
-    const normalized = value
-        .trim()
-        .replace(/[\p{P}]/gu, '')
-        .replace(/\s+/g, ' ')
-        .trim();
-    return caseSensitive ? normalized : normalized.toLowerCase();
-}
 /**
  * Build the card label from the blank keys (which are the IELTS question numbers).
  * Returns "Questions x–y" for a numeric range, a single "Question n", or falls
@@ -82,28 +75,28 @@ const StructuredFormBody = memo(function StructuredFormBody({ question, initialA
             const key = input.getAttribute('data-blank-key') || '';
             const wrapper = container.querySelector(`[data-blank-wrapper="${key}"]`);
             const userAnswer = initialAnswersRef.current[key] || '';
-            const correctAnswer = question.answers[key] || '';
+            const correctAnswer = question.answers[key];
+            const correctLabel = formatWfsfCorrectLabel(correctAnswer);
             const hasUserAnswer = userAnswer.trim().length > 0;
             const isCorrect = hasUserAnswer &&
-                normalizeStructuredAnswer(userAnswer, question.caseSensitive) ===
-                    normalizeStructuredAnswer(correctAnswer, question.caseSensitive);
-            const shouldShowReviewText = isReviewMode && !isCorrect && correctAnswer.trim().length > 0;
+                isWfsfBlankCorrect(userAnswer, correctAnswer, question.caseSensitive);
+            const shouldShowReviewText = isReviewMode && !isCorrect && correctLabel.length > 0;
             input.value = shouldShowReviewText
-                ? `${hasUserAnswer ? userAnswer : '(empty)'} → ${correctAnswer}`
+                ? `${hasUserAnswer ? userAnswer : '(empty)'} → ${correctLabel}`
                 : userAnswer;
             input.disabled = isReviewMode;
             const blankStyle = question.blankStyle || 'word';
             const isLetter = blankStyle === 'letter';
-            const isPhrase = blankStyle === 'phrase';
+            const isPhrase = blankStyle === 'phrase' || blankStyle === 'translate';
             if (isLetter) {
-                input.maxLength = Math.max(1, (correctAnswer || ' ').trim().length || 1);
+                const maxAltLen = expandWfsfCorrectAlts(correctAnswer).reduce((max, alt) => Math.max(max, alt.trim().length), 0);
+                input.maxLength = Math.max(1, maxAltLen || 1);
             }
             input.className = cn('ec-blank-input inline-block bg-blue-50/30 text-base font-semibold leading-tight text-[#0f1730] align-baseline outline-none transition-all hover:bg-blue-50/60 focus:bg-blue-50/80', isLetter
                 ? 'h-8 w-8 rounded border-2 border-[#1167e8] px-0 text-center uppercase'
                 : isPhrase
-                    ? 'min-w-[9rem] max-w-[18rem] w-[14ch] rounded-t border-0 border-b-2 border-dashed border-[#1167e8] px-2 py-0.5 text-center focus:border-solid focus:border-[#0b57d0]'
-                    : // blankStyle=word — compact for one token
-                        'min-w-[4.5rem] max-w-[7.5rem] w-[8ch] rounded-t border-0 border-b-2 border-dashed border-[#1167e8] px-1 py-0.5 text-center focus:border-solid focus:border-[#0b57d0]', isReviewMode
+                    ? 'min-w-[16rem] max-w-[36rem] w-[28ch] rounded-t border-0 border-b-2 border-dashed border-[#1167e8] px-2 py-0.5 text-center focus:border-solid focus:border-[#0b57d0]'
+                    : 'min-w-[4.5rem] max-w-[8rem] w-[10ch] rounded-t border-0 border-b-2 border-dashed border-[#1167e8] px-1 py-0.5 text-center focus:border-solid focus:border-[#0b57d0]', isReviewMode
                 ? isCorrect
                     ? 'border-solid border-[#22c55e] bg-emerald-50 text-[#15803d]'
                     : hasUserAnswer
@@ -111,7 +104,7 @@ const StructuredFormBody = memo(function StructuredFormBody({ question, initialA
                         : 'border-solid border-[#f97316] bg-amber-50 text-[#c2410c]'
                 : '');
             if (!isLetter) {
-                input.size = isPhrase ? 18 : 10;
+                input.size = isPhrase ? 28 : 10;
             }
             // letter inline box — host FE may not scan Tailwind
             if (isLetter) {
@@ -160,7 +153,7 @@ const StructuredFormBody = memo(function StructuredFormBody({ question, initialA
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [processedHtml, isReviewMode]);
-    return (_jsxs("div", { className: "space-y-3", children: [question.title && (_jsx("h3", { className: "text-base font-semibold text-[#0f1730]", children: question.title })), question.imageUrl && (_jsx("div", { className: "flex justify-center", children: _jsx("div", { className: "overflow-hidden rounded-lg border border-[#d9e4f2]", children: _jsx(ResolvedImage, { src: question.imageUrl, alt: question.title || 'Question image', className: "max-h-56 w-auto object-contain" }) }) })), _jsx("div", { ref: containerRef, className: "ec-structured-content w-full overflow-x-auto rounded-xl border border-[#d9e4f2] bg-[#f4f9ff] p-5 text-base leading-relaxed text-[#0f1730] [&_table]:w-full [&_table]:border-collapse [&_td]:border [&_td]:border-[#d9e4f2] [&_td]:px-4 [&_td]:py-3 [&_td]:align-top [&_th]:border [&_th]:border-[#d9e4f2] [&_th]:bg-[#e9f3ff] [&_th]:px-4 [&_th]:py-3 [&_th]:text-left [&_th]:font-semibold" }), isReviewMode && Object.keys(question.answers).length > 0 && (_jsxs("div", { className: "rounded-xl border border-[#d9e4f2] bg-white/70 p-3", children: [_jsx("span", { className: "text-[10px] font-semibold uppercase tracking-wider text-[#64748b]", children: "Correct answers" }), _jsx("div", { className: "mt-1 flex flex-wrap gap-1.5", children: Object.entries(question.answers).map(([key, val]) => (_jsxs("span", { className: "rounded border border-[#b9edc8] bg-[#ddf8e7] px-2 py-0.5 text-xs font-semibold text-[#15803d]", children: [key, ": ", val] }, key))) })] }))] }));
+    return (_jsxs("div", { className: "space-y-3", children: [question.title && (_jsx("h3", { className: "text-base font-semibold text-[#0f1730]", children: question.title })), question.imageUrl && (_jsx("div", { className: "flex justify-center", children: _jsx("div", { className: "overflow-hidden rounded-lg border border-[#d9e4f2]", children: _jsx(ResolvedImage, { src: question.imageUrl, alt: question.title || 'Question image', className: "max-h-56 w-auto object-contain" }) }) })), _jsx("div", { ref: containerRef, className: "ec-structured-content w-full overflow-x-auto rounded-xl border border-[#d9e4f2] bg-[#f4f9ff] p-5 text-base leading-relaxed text-[#0f1730] [&_table]:w-full [&_table]:border-collapse [&_td]:border [&_td]:border-[#d9e4f2] [&_td]:px-4 [&_td]:py-3 [&_td]:align-top [&_th]:border [&_th]:border-[#d9e4f2] [&_th]:bg-[#e9f3ff] [&_th]:px-4 [&_th]:py-3 [&_th]:text-left [&_th]:font-semibold" }), isReviewMode && Object.keys(question.answers).length > 0 && (_jsxs("div", { className: "rounded-xl border border-[#d9e4f2] bg-white/70 p-3", children: [_jsx("span", { className: "text-[10px] font-semibold uppercase tracking-wider text-[#64748b]", children: "Correct answers" }), _jsx("div", { className: "mt-1 flex flex-wrap gap-1.5", children: Object.entries(question.answers).map(([key, val]) => (_jsxs("span", { className: "rounded border border-[#b9edc8] bg-[#ddf8e7] px-2 py-0.5 text-xs font-semibold text-[#15803d]", children: [key, ": ", formatWfsfCorrectLabel(val)] }, key))) })] }))] }));
 });
 /**
  * Branded English Certification renderer for `WORD_FILL_STRUCTURED_FORM`.

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export * as Results from './components/results';
 export * as Themes from './components/themes';
 export * as Shared from './shared';
 export { buildExamTemplatePayload, createContestRoomsApi, createExamCreateApi, createExamEntryApi, createExamQuestionsApi, createExamQuestionsFetchApi, createExamTakingApi, createMockContestRoomsApi, createMockCreateExamApi, createMockExamEntryApi, createMockExamQuestionsApi, createMockExamTakingApi, createMockResultReviewApi, createResultReviewApi } from './api';
-export type { AnswerGradingStatusItem, AnswersGradingStatusResult, ContestRoomListItem, ContestRoomRegistrationStatus, ContestRoomVisibility, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi, CreateExamFetchApiOptions, CreateExamPayload, CreateExamSdkApi, ExamFormData, ExamLevelOption, ExamQuestionsSdkApi, ExamResponse, ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingFetchApiOptions, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingRoom, ExamTakingSdkApi, ExamTakingTemplatePart, ExamTemplatePayload, ExamWithTemplate, ExistingQuestionBank, FetchApiOptions, GradingSummary, QuestionBankFiltersInput, QuestionBankFiltersResult, QuestionSearchItem, SaveExamInput, SaveExamTakingAnswersInput, SaveQuestionInput, SaveQuestionResult, SearchQuestionBankInput, SearchQuestionBankResult, SubmitExamTakingAttemptResult, UpdateExamTemplateInput, UpdatePartAudioInput, UploadAudioAnswerResult } from './api';
+export type { AnswerGradingStatusItem, AnswersGradingStatusResult, ContestRoomListItem, ContestRoomRegistrationStatus, ContestRoomVisibility, ContestRoomsContestDetail, ContestRoomsFetchApiOptions, ContestRoomsSdkApi, CreateExamFetchApiOptions, CreateExamPayload, CreateExamSdkApi, ExamFormData, ExamLevelOption, ExamQuestionsSdkApi, ExamResponse, ExamTakingAnswerValue, ExamTakingAttempt, ExamTakingFetchApiOptions, ExamTakingQuestion, ExamTakingQuestionsResult, ExamTakingRoom, ExamTakingSdkApi, ExamTakingTemplatePart, ExamTemplatePayload, ExamWithTemplate, ExistingQuestionBank, FetchApiOptions, GradingSummary, QuestionSearchItem, SaveExamInput, SaveExamTakingAnswersInput, SaveQuestionInput, SaveQuestionResult, SearchQuestionBankInput, SearchQuestionBankResult, SubmitExamTakingAttemptResult, UpdateExamTemplateInput, UpdatePartAudioInput, UploadAudioAnswerResult } from './api';
 export { CreateExamPageContainer, ExamPreviewDialog, ExamPreviewMode, ExamQuestionsPageContainer, ExamTakingPageContainer, ExamViewDialog, StudentContestRoomsPageContainer, StudentExamEntryPageContainer } from './components/exams';
 export type { CreateExamPageContainerProps, CreateExamTexts, ExamPreviewDialogProps, ExamQuestionsPageContainerProps, ExamTakingPageContainerProps, ExamViewDialogExam, ExamViewDialogProps, StudentContestRoomsPageContainerProps, StudentExamEntryPageContainerProps } from './components/exams';
 export { ResultReviewPageContainer } from './components/results';
@@ -15,8 +15,8 @@ export { QuestionCreator } from './components/questions/creator/QuestionCreator'
 export type { QuestionCreatorProps } from './components/questions/creator/QuestionCreator';
 export { QuestionGroupCreator } from './components/questions/creator/QuestionGroupCreator';
 export type { QuestionGroupCreatorProps } from './components/questions/creator/QuestionGroupCreator';
-export { DifficultyLevel, EditQuestionBankDialog, QuestionBankEditorType, QuestionBankPickerDialog, QuestionEditorRenderer, } from './components/questions/question-bank';
-export type { EditQuestionBankDialogProps, QuestionBankEditItem, QuestionBankLessonSuggestion, QuestionBankPickerDefaultFilters, QuestionBankPickerDialogProps, QuestionEditorChangeData, QuestionEditorRendererProps, SkillType as QuestionBankSkillType, UpdateQuestionBankDto, } from './components/questions/question-bank';
+export { DifficultyLevel, EditQuestionBankDialog, QuestionBankEditorType, QuestionEditorRenderer, } from './components/questions/question-bank';
+export type { EditQuestionBankDialogProps, QuestionBankEditItem, QuestionEditorChangeData, QuestionEditorRendererProps, SkillType as QuestionBankSkillType, UpdateQuestionBankDto, } from './components/questions/question-bank';
 export { renderDedicatedComponent } from './components/questions/creator/dedicated-component-router';
 export type { DedicatedComponentRouterProps, ValidationRef, } from './components/questions/creator/dedicated-component-router';
 export { questionTypeRegistry } from './components/questions/creator/question-type-registry';
@@ -24,7 +24,6 @@ export type { QuestionTypeRegistration, RouterContext, } from './components/ques
 export { QUESTION_TYPE_CONFIG, QUESTION_TYPES_WITH_DEDICATED_COMPONENTS } from './components/questions/_shared/config/question-types.config';
 export { validateQuestion } from './components/questions/_shared/utils/question-validation';
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
-export { transformApiQuestionToFrontend, transformApiQuestionsToFrontend, } from './shared/lib/utils/question-reverse-transform';
 export type { QuestionFormState } from './components/questions/_shared/hooks/useQuestionFormState';
 export * from './components/questions/_shared/types';
 export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, MatchColumnsToMakeSentencesViewer, WordOrderingGroupViewer, SortWordsIntoCategoriesViewer, ChooseThenAnswerGroupViewer, } from './components/questions/viewer';

package/dist/index.js

@@ -14,12 +14,11 @@ export { CreateExamPageContainer, ExamPreviewDialog, ExamPreviewMode, ExamQuesti
 export { ResultReviewPageContainer } from './components/results';
 export { QuestionCreator } from './components/questions/creator/QuestionCreator';
 export { QuestionGroupCreator } from './components/questions/creator/QuestionGroupCreator';
-export { DifficultyLevel, EditQuestionBankDialog, QuestionBankEditorType, QuestionBankPickerDialog, QuestionEditorRenderer, } from './components/questions/question-bank';
+export { DifficultyLevel, EditQuestionBankDialog, QuestionBankEditorType, QuestionEditorRenderer, } from './components/questions/question-bank';
 export { renderDedicatedComponent } from './components/questions/creator/dedicated-component-router';
 export { questionTypeRegistry } from './components/questions/creator/question-type-registry';
 export { QUESTION_TYPE_CONFIG, QUESTION_TYPES_WITH_DEDICATED_COMPONENTS } from './components/questions/_shared/config/question-types.config';
 export { validateQuestion } from './components/questions/_shared/utils/question-validation';
 export { buildAnswerPayload } from './components/questions/_shared/utils/answer-builder';
-export { transformApiQuestionToFrontend, transformApiQuestionsToFrontend, } from './shared/lib/utils/question-reverse-transform';
 export * from './components/questions/_shared/types';
 export { QuestionViewer, QuestionGroupViewer, WordFillStructuredFormViewer, ChooseTheCorrectAnswerGroupViewer, TrueFalseGroupViewer, TrueFalseCorrectGroupViewer, FillInBlankGroupViewer, MatchingWithLinesGroupViewer, CrossOutWordGroupViewer, SpontaneousQaGroupViewer, WordOrderAndMatchGroupViewer, AnswerTheQuestionGroupViewer, MatchWordToPictureViewer, MatchWordToPictureGroupViewer, MatchColumnsToMakeSentencesViewer, WordOrderingGroupViewer, SortWordsIntoCategoriesViewer, ChooseThenAnswerGroupViewer, } from './components/questions/viewer';

package/dist/shared/constants/ApiConstant.d.ts

@@ -86,7 +86,6 @@ export declare const API_ENDPOINTS: {
         readonly QUESTION_BANKS: "/api/v1/manage/question-banks";
         readonly QUESTION_BANK_DETAIL: (id: string) => string;
         readonly QUESTION_BANKS_STATISTICS: "/api/v1/manage/question-banks/statistics";
-        readonly QUESTION_BANKS_FILTERS: "/api/v1/manage/question-banks/filters";
         readonly SCHEDULES_SUMMARY: "/api/v1/manage/schedules/summary";
         readonly SCHEDULES_CALENDAR: "/api/v1/manage/schedules/calendar";
         readonly SCHEDULES: "/api/v1/manage/schedules";

package/dist/shared/constants/ApiConstant.js

@@ -95,7 +95,6 @@ export const API_ENDPOINTS = {
         QUESTION_BANKS: `/api/${API_VERSION}/manage/question-banks`,
         QUESTION_BANK_DETAIL: (id) => `/api/${API_VERSION}/manage/question-banks/${id}`,
         QUESTION_BANKS_STATISTICS: `/api/${API_VERSION}/manage/question-banks/statistics`,
-        QUESTION_BANKS_FILTERS: `/api/${API_VERSION}/manage/question-banks/filters`,
         // Schedules endpoints
         SCHEDULES_SUMMARY: `/api/${API_VERSION}/manage/schedules/summary`,
         SCHEDULES_CALENDAR: `/api/${API_VERSION}/manage/schedules/calendar`,

package/dist/shared/constants/routes.d.ts

@@ -21,8 +21,8 @@ export declare const ROUTES: {
         readonly USERS: "/manage/users";
         readonly USERS_CREATE: "/manage/users/create";
         readonly USERS_EDIT: (id: string) => string;
-        readonly QUESTION_BANK: "/manage/question-bank";
-        readonly QUESTION_CREATE: "/manage/question-bank/create";
+        readonly QUESTION_BANK: "/manage/question-banks";
+        readonly QUESTION_CREATE: "/manage/question-banks/create";
         readonly QUESTION_EDIT: (id: string) => string;
         readonly EXAMS: "/manage/exams";
         readonly EXAMS_CREATE: "/manage/exams/create";

package/dist/shared/constants/routes.js

@@ -26,9 +26,9 @@ export const ROUTES = {
         USERS: '/manage/users',
         USERS_CREATE: '/manage/users/create',
         USERS_EDIT: (id) => `/manage/users/${id}/edit`,
-        QUESTION_BANK: '/manage/question-bank',
-        QUESTION_CREATE: '/manage/question-bank/create',
-        QUESTION_EDIT: (id) => `/manage/question-bank/${id}/edit`,
+        QUESTION_BANK: '/manage/question-banks',
+        QUESTION_CREATE: '/manage/question-banks/create',
+        QUESTION_EDIT: (id) => `/manage/question-banks/${id}/edit`,
         EXAMS: '/manage/exams',
         EXAMS_CREATE: '/manage/exams/create',
         EXAMS_EDIT: (id) => `/manage/exams/${id}/edit`,

package/dist/shared/lib/utils/wfsf-blank-match.d.ts

@@ -0,0 +1,9 @@
+export type WfsfCorrectValue = string | string[];
+export declare function cleanWfsfWord(str: unknown, caseSensitive?: boolean): string;
+export declare function expandWfsfCorrectAlts(correctVal: unknown): string[];
+export declare function formatWfsfCorrectLabel(correctVal: unknown): string;
+export declare function isWfsfBlankCorrect(userWord: string, correctVal: unknown, caseSensitive?: boolean): boolean;
+export declare function normalizeWfsfAnswersMap(raw: unknown): Record<string, string[]>;
+export declare function compactWfsfAnswersMap(answers: Record<string, string | string[]>): Record<string, string[]>;
+export declare function primaryWfsfAnswers(answers: Record<string, string | string[]>): Record<string, string>;
+export declare function hasWfsfBlankAnswer(value: unknown): boolean;

package/dist/shared/lib/utils/wfsf-blank-match.js

@@ -0,0 +1,60 @@
+export function cleanWfsfWord(str, caseSensitive = false) {
+    const text = str == null ? '' : String(str);
+    const cleaned = text
+        .trim()
+        .replace(/[\p{P}]/gu, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return caseSensitive ? cleaned : cleaned.toLowerCase();
+}
+export function expandWfsfCorrectAlts(correctVal) {
+    if (Array.isArray(correctVal)) {
+        return correctVal.map((v) => String(v ?? '').trim()).filter(Boolean);
+    }
+    if (correctVal == null)
+        return [];
+    const valStr = String(correctVal);
+    if (valStr.includes('/')) {
+        return valStr.split('/').map((s) => s.trim()).filter(Boolean);
+    }
+    const trimmed = valStr.trim();
+    return trimmed ? [trimmed] : [];
+}
+export function formatWfsfCorrectLabel(correctVal) {
+    return expandWfsfCorrectAlts(correctVal).join(' / ');
+}
+export function isWfsfBlankCorrect(userWord, correctVal, caseSensitive = false) {
+    const userClean = cleanWfsfWord(userWord, caseSensitive);
+    if (!userClean)
+        return false;
+    return expandWfsfCorrectAlts(correctVal).some((alt) => cleanWfsfWord(alt, caseSensitive) === userClean);
+}
+export function normalizeWfsfAnswersMap(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(raw)) {
+        const alts = expandWfsfCorrectAlts(value);
+        result[key] = alts.length > 0 ? alts : [''];
+    }
+    return result;
+}
+export function compactWfsfAnswersMap(answers) {
+    const result = {};
+    for (const [key, value] of Object.entries(answers)) {
+        const alts = expandWfsfCorrectAlts(value);
+        if (alts.length > 0)
+            result[key] = alts;
+    }
+    return result;
+}
+export function primaryWfsfAnswers(answers) {
+    const result = {};
+    for (const [key, value] of Object.entries(answers)) {
+        result[key] = expandWfsfCorrectAlts(value)[0] || '';
+    }
+    return result;
+}
+export function hasWfsfBlankAnswer(value) {
+    return expandWfsfCorrectAlts(value).length > 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyweb_dev/oe-exam-sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",

package/dist/components/questions/question-bank/QuestionBankPickerDialog.d.ts

@@ -1,45 +0,0 @@
-import type { QuestionBankFiltersInput, QuestionBankFiltersResult, QuestionSearchItem, SearchQuestionBankInput, SearchQuestionBankResult } from '../../../api/exam-questions.types';
-/**
- * Prefill cascade filters from host context.
- * Values are Pearson meta ids: bookId / unitId / lessonId.
- * `lessonIds` = session textbook lessons (default search scope when lesson select = Tất cả).
- */
-export type QuestionBankPickerDefaultFilters = {
-    bookId?: string;
-    unitId?: string;
-    lessonId?: string;
-    /** Session lesson ids — used when lesson dropdown is "Tất cả". */
-    lessonIds?: string[];
-    questionType?: string;
-    /** Optional labels so prefill renders before cascade options load. */
-    bookLabel?: string;
-    unitLabel?: string;
-};
-/** Session textbook lesson → merge into Lesson select + default search scope. */
-export type QuestionBankLessonSuggestion = {
-    lessonId?: string | null;
-    label?: string | null;
-    /** @deprecated use lessonId */
-    lesson?: string | null;
-    book?: string | null;
-    unit?: string | null;
-};
-export interface QuestionBankPickerDialogProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    searchQuestions: (input: SearchQuestionBankInput) => Promise<SearchQuestionBankResult>;
-    getQuestionFilters?: (input?: QuestionBankFiltersInput) => Promise<QuestionBankFiltersResult>;
-    defaultFilters?: QuestionBankPickerDefaultFilters;
-    /** Session lessons: options + default multi-lesson search scope. */
-    lessonSuggestions?: QuestionBankLessonSuggestion[];
-    onConfirm: (items: QuestionSearchItem[]) => void;
-    title?: string;
-    description?: string;
-    confirmLabel?: string;
-}
-/**
- * Multi-select bank picker. Cascade filters use stable meta ids:
- * bookId → unitId → lessonId (labels from meta.*Name).
- * Default lesson scope = session lessonIds when dropdown is "Tất cả".
- */
-export declare function QuestionBankPickerDialog({ open, onOpenChange, searchQuestions, getQuestionFilters, defaultFilters, lessonSuggestions, onConfirm, title, description, confirmLabel, }: QuestionBankPickerDialogProps): import("react").JSX.Element;