@tinyweb_dev/oe-exam-sdk 1.0.0 → 1.0.2

package/dist/components/results/renderers/ReviewListenAndWriteRenderer.d.ts

@@ -1,4 +1,5 @@
 import type { FillBlankQuestion } from '../../../components/exams/take/types';
+import { type ImageLabelData } from '../../questions/_shared/types/question-group.type';
 interface ReviewListenAndWriteRendererProps {
     partNumber: number;
     questionCount: number;
@@ -12,6 +13,7 @@ interface ReviewListenAndWriteRendererProps {
     questions: FillBlankQuestion[];
     answers: Record<string, unknown>;
     isCorrectMap: Record<string, boolean | null>;
+    imageLabels?: ImageLabelData[];
 }
-export declare function ReviewListenAndWriteRenderer({ partNumber, questionCount, instruction, partName, audioUrl, title, exampleText, questions, answers, isCorrectMap, }: ReviewListenAndWriteRendererProps): import("react").JSX.Element;
+export declare function ReviewListenAndWriteRenderer({ partNumber, questionCount, instruction, partName, audioUrl, title, exampleText, questions, answers, isCorrectMap, imageLabels, }: ReviewListenAndWriteRendererProps): import("react").JSX.Element;
 export {};

package/dist/components/results/renderers/ReviewListenAndWriteRenderer.js

@@ -6,7 +6,9 @@ import CambridgeYlePartBanner from '../../../components/themes/cambridge-yle/Cam
 import CambridgeYleInstructionBanner from '../../../components/themes/cambridge-yle/CambridgeYleInstructionBanner';
 import CambridgeYleAudioPlayer from '../../../components/themes/cambridge-yle/CambridgeYleAudioPlayer';
 import { countBlanks, formatAcceptedAnswers, hasAnyBlankValue, isBlankCorrect, toBlankValues, } from '../../../shared/lib/utils/fill-in-blank';
-export function ReviewListenAndWriteRenderer({ partNumber, questionCount, instruction, partName, audioUrl, title, exampleText, questions, answers, isCorrectMap, }) {
+import { ImageLabelWordBank } from '../../questions/groups/ImageLabelWordBank';
+import { hasImageLabels } from '../../questions/_shared/types/question-group.type';
+export function ReviewListenAndWriteRenderer({ partNumber, questionCount, instruction, partName, audioUrl, title, exampleText, questions, answers, isCorrectMap, imageLabels, }) {
     /**
      * Get answer status from API's isCorrect field
      * Returns: 'correct' | 'incorrect' | 'unanswered'
@@ -44,7 +46,7 @@ export function ReviewListenAndWriteRenderer({ partNumber, questionCount, instru
             return 'unanswered';
         return isBlankCorrect(userValue, accepted) ? 'correct' : 'incorrect';
     };
-    return (_jsxs("div", { className: "flex flex-col gap-6 h-full", children: [_jsxs("div", { className: "flex flex-col gap-4 pb-0 pt-4", children: [_jsx(CambridgeYlePartBanner, { partNumber: partNumber, questionCount: questionCount, partName: partName, isReviewMode: true }), _jsx(CambridgeYleInstructionBanner, { instruction: instruction, hasExample: !!exampleText, isReviewMode: true }), audioUrl && _jsx(CambridgeYleAudioPlayer, { audioSrc: audioUrl, compact: true })] }), _jsxs("div", { className: "flex flex-col gap-6 pb-6 pl-2 pt-2", children: [_jsx("h2", { className: "text-center text-3xl font-bold uppercase text-coral-500", children: title }), _jsx("div", { className: "flex flex-col gap-4", children: questions.map((question) => {
+    return (_jsxs("div", { className: "flex flex-col gap-6 h-full", children: [_jsxs("div", { className: "flex flex-col gap-4 pb-0 pt-4", children: [_jsx(CambridgeYlePartBanner, { partNumber: partNumber, questionCount: questionCount, partName: partName, isReviewMode: true }), _jsx(CambridgeYleInstructionBanner, { instruction: instruction, hasExample: !!exampleText, isReviewMode: true }), hasImageLabels(imageLabels) && (_jsx(ImageLabelWordBank, { items: imageLabels, className: "rounded-2xl border border-slate-200 bg-slate-50/80 p-4 shadow-sm" })), audioUrl && _jsx(CambridgeYleAudioPlayer, { audioSrc: audioUrl, compact: true })] }), _jsxs("div", { className: "flex flex-col gap-6 pb-6 pl-2 pt-2", children: [_jsx("h2", { className: "text-center text-3xl font-bold uppercase text-coral-500", children: title }), _jsx("div", { className: "flex flex-col gap-4", children: questions.map((question) => {
                             const status = getAnswerStatus(question.id);
                             const userValues = toBlankValues(answers[question.id], countBlanks(question.segments));
                             const renderBlank = (blankIndex) => {

package/dist/components/results/renderers/review-question-body-dedicated.js

@@ -27,8 +27,8 @@ export function renderDedicatedReviewBody(ctx) {
     const apiQuestions = asApiQuestions(questions);
     switch (questionType) {
         case 'FILL_IN_BLANK': {
-            const data = transformFillInBlank(apiQuestions);
-            return (_jsx(ReviewListenAndWriteRenderer, { partNumber: partNo, questionCount: questionCount, partName: part.name, instruction: part.instructions || data.instruction, title: data.title, imageUrl: data.imageUrl, audioUrl: data.audioUrl, exampleText: data.exampleText, exampleHighlight: data.exampleHighlight, questions: data.questions, answers: answers, isCorrectMap: isCorrectMap }));
+            const data = transformFillInBlank(apiQuestions, { suggestedAnswers: part.suggestedAnswers });
+            return (_jsx(ReviewListenAndWriteRenderer, { partNumber: partNo, questionCount: questionCount, partName: part.name, instruction: part.instructions || data.instruction, title: data.title, imageUrl: data.imageUrl, audioUrl: data.audioUrl, exampleText: data.exampleText, exampleHighlight: data.exampleHighlight, questions: data.questions, answers: answers, isCorrectMap: isCorrectMap, imageLabels: data.imageLabels }));
         }
         case 'WRITE_CORRECT_VERB_FORM': {
             const data = transformWriteCorrectVerbForm(apiQuestions);

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/components/themes/english-certification/EnglishCertificationQuestionRenderer.js

@@ -13,6 +13,8 @@ import { EcMatchByWritingAnswer } from './EcMatchByWritingAnswer';
 import { EcAnswerTheQuestion } from './EcAnswerTheQuestion';
 import { EcWordFillParagraph } from './EcWordFillParagraph';
 import { EcWritingTask } from './EcWritingTask';
+import { MoversListenAndWriteRenderer } from '../../../components/exams/take/components/question-renderers/MoversListenAndWriteRenderer';
+import { transformFillInBlank } from '../../../components/exams/take/utils/question-transformers';
 /**
  * Question types that the branded English Certification theme renders natively
  * as multiple-choice cards (TOEIC + IELTS MCQ variants such as TRUE/FALSE/NOT GIVEN).
@@ -67,6 +69,12 @@ export function EnglishCertificationQuestionRenderer({ part, partConfig, answers
                 return (_jsx(EcAnswerTheQuestion, { part: part, answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
             case 'WORD_FILL_PARAGRAPH':
                 return (_jsx(EcWordFillParagraph, { part: part, answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
+            case 'FILL_IN_BLANK': {
+                const data = transformFillInBlank(part.questions, {
+                    suggestedAnswers: part.suggestedAnswers,
+                });
+                return (_jsx(MoversListenAndWriteRenderer, { partNumber: part.partNo ?? 0, partName: part.name, questionCount: part.questions.filter((q) => !q.is_example).length, instruction: part.instructions || data.instruction, title: data.title, imageUrl: data.groupImageUrl || data.imageUrl, audioUrl: data.audioUrl || part.audioUrl, exampleText: data.exampleText, exampleHighlight: data.exampleHighlight, questions: data.questions, answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode, showHints: data.showHints, groupContent: data.groupContent, groupTitle: data.groupTitle, imageLabels: data.imageLabels }));
+            }
             case 'WRITE_A_SHORT_LETTER':
                 return (_jsx(EcWritingTask, { part: part, answers: answers, onAnswerChange: onAnswerChange, isReviewMode: isReviewMode }));
             default:

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/rich-text.d.ts

@@ -1,3 +1,7 @@
 /** Strip HTML tags/entities so empty TipTap documents (`<p></p>`) count as blank. */
 export declare function richTextToPlainText(value: string | null | undefined): string;
 export declare function isRichTextEmpty(value: string | null | undefined): boolean;
+/** True when HTML has marks/blocks beyond a plain paragraph (bold, list, table, …). */
+export declare function hasRichTextFormatting(value: string | null | undefined): boolean;
+/** Show stored TipTap HTML as editable plain text without collapsing line breaks. */
+export declare function htmlToPlainEditorText(value: string | null | undefined): string;

package/dist/shared/lib/rich-text.js

@@ -22,3 +22,28 @@ export function richTextToPlainText(value) {
 export function isRichTextEmpty(value) {
     return richTextToPlainText(value) === '';
 }
+const SIMPLE_WRAPPER_TAG_RE = /<\/?(?:p|br)\s*\/?>/gi;
+/** True when HTML has marks/blocks beyond a plain paragraph (bold, list, table, …). */
+export function hasRichTextFormatting(value) {
+    if (!value)
+        return false;
+    return /<[^>]+>/.test(value.replace(SIMPLE_WRAPPER_TAG_RE, ''));
+}
+/** Show stored TipTap HTML as editable plain text without collapsing line breaks. */
+export function htmlToPlainEditorText(value) {
+    if (!value)
+        return '';
+    if (!/<[a-z][\s\S]*>/i.test(value))
+        return value;
+    return value
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>\s*<p>/gi, '\n')
+        .replace(HTML_TAG_RE, '')
+        .replace(/&nbsp;|&amp;|&lt;|&gt;|&quot;|&#39;/gi, (entity) => {
+        return HTML_ENTITIES[entity.toLowerCase()] ?? entity;
+    })
+        .replace(/\u00a0/g, ' ')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}

package/dist/shared/lib/stores/examQuestionStore.d.ts

@@ -20,6 +20,10 @@ interface SharedPassageData {
         content: string;
         imageUrl: string;
     }>;
+    imageLabels?: Array<{
+        imageUrl: string;
+        label: string;
+    }>;
 }
 interface SharedSceneData {
     backgroundImageUrl?: string;

package/dist/shared/lib/utils/question-transform-types.d.ts

@@ -27,6 +27,10 @@ export type TransformResult = {
         content?: string;
         imageUrl?: string;
         articles?: any[];
+        imageLabels?: Array<{
+            imageUrl: string;
+            label: string;
+        }>;
     };
     questionListGroupData?: {
         questions: Array<{

package/dist/shared/lib/utils/question-transform.js

@@ -175,7 +175,7 @@ function resolveQuestionGroupPayload(sources) {
         return passageData;
     if (imageData)
         return imageData;
-    if (basicGroupData && (basicGroupData.title || basicGroupData.subtitle || basicGroupData.content || basicGroupData.imageUrl || basicGroupData.articles)) {
+    if (basicGroupData && (basicGroupData.title || basicGroupData.subtitle || basicGroupData.content || basicGroupData.imageUrl || basicGroupData.articles || (basicGroupData.imageLabels && basicGroupData.imageLabels.length > 0))) {
         return basicGroupData;
     }
     if (sceneData)

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.0",
+  "version": "1.0.2",
   "description": "Reusable OceanEdu question components.",
   "type": "module",
   "main": "./dist/index.js",