# FRS — 11 Interactive Drag-and-Drop Exercises Matrix

> [← Tracks & Modes](./tracks-and-modes.md) | [FRS HTML View](./index.html) | Next: [Gamification & Studio →](./gamification-studio-nfr.md)

## Exercise Interaction Flow

```mermaid
flowchart LR
    Load["Render Prompt + Audio"] --> Input["Drag Tile / Tap-to-Place / Keyboard"]
    Input --> AudioTile["Instant Tile Voice + Pop SFX"]
    Input --> Check["Submit Payload"]
    Check --> Grade{"Correct?"}
    Grade -->|"Yes"| Pass["Mint Sparkle + Chime + Band/Nx Breakdown"]
    Grade -->|"No"| Retry["Soft Boop + Hint / Dim Distractors"]
    Retry --> Input
```

## All 11 Drag-and-Drop Exercise Archetypes (`FR-301` – `FR-311`)

| ID | Exercise Type | Interaction Mechanic | Basic / Kid Usage (`A0–A2 / N5`) | Super-Advanced & Exam Usage (`IELTS / TOEIC / TESOL / JLPT N2–N1`) |
| :--- | :--- | :--- | :--- | :--- |
| **FR-301** | `picture_match` | Drag word tiles onto visual cards | Animal, fruit & color icons | **TOEIC Part 1** photo descriptions; **IELTS Task 1** diagram/map labels |
| **FR-302** | `sentence_builder` | Drag scrambled tiles into sequence tray | Simple 3–5 word phrases (`LTR/RTL/CJK`) | **JLPT N2/N1 `★`** grammar ordering; **IELTS Band 8** inversion/cleft clauses |
| **FR-303** | `category_sort` | Drag cards into 2–3 colored buckets | Animals vs Fruits; Vowels vs Consonants | **IELTS True / False / Not Given**; Casual vs **Keigo**; **TESOL PPP vs ESA** |
| **FR-304** | `match_pairs` | Snap Column A ↔ Column B tiles | Word ↔ Meaning or Emoji | Academic collocations; **Basic → C2/Band 9** synonyms; **Kanji ↔ Readings** |
| **FR-305** | `fill_blank_drag` | Drag missing words into inline sentence blanks | Illustrated 1-line story cloze | **TOEIC Parts 5–6** grammar traps; **JLPT N3–N1** connectors; **IELTS** summary cloze |
| **FR-306** | `listen_and_arrange` | Listen (`0.7x`/`1.0x`/`1.15x`) & order tiles | Phonics, Hiragana & Hangul blocks | **IELTS/TOEIC** fast-speech dictation & key-phrase ordering |
| **FR-307** | `tap_hear_explore` | Tap & flip interactive cards | Visual vocab warmup cards | **Kanji radicals**, **IELTS Band 9** phrase frames, **TESOL IPA** chart cards |
| **FR-308** | `reading_passage_drag` | Split-pane text + drag-to-slot + proof highlight | 3-line mini-story comprehension | **IELTS Academic** paragraph headings/TFNG; **TOEIC** memo; **JLPT N2/N1** essay |
| **FR-309** | `essay_architect` | Drag full clauses/stages into blueprint slots | Order 3 story events (`First/Next/Last`) | **IELTS Task 2** essay flow; **TOEIC** email layout; **TESOL** PPP/ESA lesson plan |
| **FR-310** | `error_spotter` | Tap flawed pill + drag fix tile onto it | Fix simple wrong noun/verb | **TOEIC Part 5** trap surgery; **IELTS Band 5 → 8** upgrade; **JLPT N1** particle fix |
| **FR-311** | `listening_lab` | Multi-accent audio (`US/GB/AU`) + form drag-drop | Match speaker to simple picture | **IELTS/TOEIC** form & table completion + post-answer transcript reveal |

## Feedback, Hints & Audio Requirements (`FR-312` – `FR-403`)

| ID | Feature | Behavior |
| :--- | :--- | :--- |
| **FR-312** | **Progressive Hints** | Attempt 1+: targeted hint (`hint_text`) + first-slot/stage clue on attempt 2+ (`attempt_number >= 2`) |
| **FR-313** | **Linguistic Breakdown Drawer** | Post-answer drawer displays Grammar Rule, `why_others_fail`, `band_tip`, & highlighted `evidence_quotes` + audio `transcript` |
| **FR-314** | **Unicode NFC & Multi-Variant Grading** | Supports `accepted_answers[]`, RTL `<bdi>`, CJK & `accent_warning` diacritic coaching (`lenient_diacritics` in `compare_answers()`, incl. Polish `ł->l` & `ą/ę/ó/ś/ź/ż`) |
| **FR-401/402** | **3-Speed Multi-Accent Audio** | `0.7x` Turtle, `1.0x` Normal, `1.15x` Exam; `en-US`, `en-GB`, `en-AU`, `ja-JP`, `de-DE`, `ar-SA`, `vi-VN`, `pl-PL` voices |
| **FR-403** | **Web Audio SFX + Mute** | Zero-asset synthesized pickup/snap/success/warning/tryAgain/celebration SFX with persistent `sound_enabled` switch |

## Changelog

| Version | Date | Summary of Changes |
| :--- | :--- | :--- |
| **v1.2.0** | 2026-11-22 | Verified 1:1 edge TypeScript parity in `worker/src/lib/grader.ts` & `text_normalizer.ts` for all 11 exercise handlers plus Polish diacritic (`pl-PL`) support. |
| **v1.1.0** | 2026-11-15 | Aligned `FR-312`–`FR-403` with actual implemented hints, `ExplanationCard` keys (`why_others_fail`, `band_tip`), `accent_warning`, and `sfx_synth.js` sound events. |
| **v1.0.0** | 2026-11-15 | Initial 11-exercise drag-and-drop matrix & feedback requirements. |

