Analysing your progress and preparing the right questions.
Choose your style
DR CLAY'S
A-Level Chemistry
Sign in to keep your progress, classes and personalised practice connected to one account.
OR
Reset your password
Enter your account email. If an email/password account exists, we'll send a secure reset link.
Link to your existing account
We found an existing A-Level Chemistry account with the same email address. Enter that account's password once to link this sign-in method without creating a duplicate account.
Google authenticates you directly. Dr Clay's A-Level Chemistry never receives or stores your Google password. Existing accounts are linked only after secure confirmation, preserving the same progress and user ID.
TEACHER PLATFORM · PRIVATE BETA
My classes
Use the evidence pupils are already generating to decide what they should work on next.
Classes
0active classes
CLASSES0active
PUPILS0across classes
PLAN—account
AI ACCESS—pupil licences
TEACHING
My classes
Open a class to see pupil progress, messages, assessments and next steps.
ACCOUNT & PLANLoading…Licence full — new pupils cannot join.
—student seats
AI ACCESS0 / 0 assignedTeacher Pro required for sponsored pupil AI.
ADMIN TOOLSSite administrationManage memberships, feedback and account access.
Administrator · Platform overview
Site Analytics
Registrations, engagement, memberships, trials and class activity in one place.
Select Site Analytics to load current platform activity.
Administrator · User voice
Feedback & support inbox
Account-linked support tickets. Identify the user, reply inside the app and mark each item resolved when complete.
Select Feedback to load messages.
Administrator · Cost control
AI Usage & Cost Analytics
Monitor AI demand, token usage and estimated OpenAI API cost. Cost figures are stored estimates in USD.
Select the dashboard to load current usage.
Administrator
Membership administration
Look up an account and grant or remove a manual membership while payments are still being built.
TEACHER PRO
Choose your AI licence pool
Your classes can keep using authored content for free. Teacher Pro determines how many pupils you can give AI-powered access to.
AI licences are assigned to individual pupils by the teacher. Pupils without an assigned AI licence still retain the Free authored learning experience.
Plan changes: upgrades take effect immediately with Stripe proration; downgrades take effect at the next renewal. Cancelling a subscription does not hide these plan options.
Create a class
CLASS VIEW
Join code
PUPILS & AI ACCESS
Manage this class
Remove pupils, change AI access or set an individual next step.
Teacher controls
CLASS PRIORITY
Building class evidence…
PUPIL HELP
Messages from pupils
See questions and support conversations for this class.
0
CLASS PROGRESSClass masteryAggregated from each pupil's current mastery evidence.View full mastery ▾
EXAM ANALYTICS
Class assessment evidence
Saved Exam Practice results across this class, including AO and recurring topic priorities.
Class priorities
ASSESSMENTS
Class assessments
Create new Exam Practice work or independently open and manage assessments already set for this class.
ASSESSMENT MANAGEMENT
Set assessments
Review pupil completion without opening the assessment builder.
NEW ASSESSMENT
Set an Exam Practice paper
Choose personalised revision or lock one common paper for the whole class.
1
2
3Select the chemistry content for this assessment.
4
Locked paper: generate the paper first, inspect every question, then regenerate or assign when you are happy.
Revision assignment: each pupil receives a paper assembled from the same specification, but question selection can vary.
ADAPTIVE ASSIGNMENTS
Set a curriculum focus
Everyone works on the same chemistry areas, while adaptive mode chooses suitable questions for each pupil.
TEACHING INTELLIGENCE
What the class evidence suggests
NEW ASSIGNMENT
Set practice for this class
Choose the curriculum focus; adaptive mode personalises the questions within it.
SET NEXT STEP
Select the recommended areas or adjust them.
DR CLAY'S A-LEVEL CHEMISTRY
Welcome back
Your personal A-Level Chemistry learning space — practise, get guided help and improve from your evidence.
Year 12 mastery
—Not assessed
Your membership
Free Individual
Core A-Level Chemistry practice, saved progress and mastery tracking.
Core learning included
⭐ PREMIUM INDIVIDUAL
Meet your personal A-Level Chemistry tutor
Get unstuck, know what to revise and improve your exam answers with personalised support built around your progress.
£4.99/month3-day free trial available
Try Premium free for 3 daysUnlock Adaptive MCQ, the Premium AI question bank, personalised practice, AI marking and Chemistry Support.
Premium Individual
Your personal A-Level Chemistry tutor
Get unstuck, know what to revise and improve your exam answers. Premium combines Dr Clay's authored Chemistry practice with personalised tutoring, feedback and adaptive support for £4.99/month.
✨ Personalised AI practiceFresh questions targeted to your progress and weaker areas.
🧠 Advanced AI markingDetailed feedback for written and extended responses.
🎯 Adaptive MCQ + AI question bankFast mobile practice selected from your mastery, misconceptions and recent evidence, with reusable AI questions created where the bank has gaps.
💬 Dr Clay TutorGuided Chemistry support that uses your learning profile and helps you work towards the answer.
Secure subscription checkout is handled by Stripe. Promotion codes can be applied at checkout. You can cancel or manage your subscription at any time from the billing portal.
WORKING ON NEXT
Your action list
Teacher-set and recommended areas all count as evidence whenever you practise them.
ASSIGNED ASSESSMENTS
Exams set by your teacher
Complete these in Exam Practice conditions. Results are saved to My Exam Results and shared in your class analytics.
RECOMMENDED FOR YOU
Current Chemistry topic
Choose a ready topic to begin building your mastery profile.
CONTINUE LEARNING
Chemistry
Your selected topic is ready to use.
Not assessed
YOUR CLASSES
You are enrolled in
Your teacher can now see your learning evidence and set work for you.
YOUR CLASS
Join a chemistry class
Enter the code your teacher gives you.
DR CLAY TUTOR · BETA ⭐ PREMIUM AI
Stuck or not sure what to do next?
Premium Tutor gives guided Chemistry help using your progress profile. Asking your class teacher remains available separately when you are connected to a class.
YOUR COURSEBrowse all Chemistry topicsView all topics ▾
Your course
Choose a topic or let adaptive practice decide what you need next.
PERSONALISED PRACTICE
What would you like to practise?
Choose the learning goal. The app decides the best mix of benchmark, retrieval and fresh questions underneath.
Current topic
—Building profile
Building your practice…
Analysing your progress and creating a balanced question mix.
Practice access: Free uses the trusted authored Chemistry bank with normal deterministic marking. ⭐ Premium adds adaptive selection, the reusable Premium question bank, selective AI marking where judgement is genuinely needed, and AI review feedback. How AI uses your data.
Saved Full Topic AI Reviews
Your generated review feedback is stored with the completed review. It stays readable later without another AI call, including if you return to Free.
EXAM PRACTICE
Choose your paper style
Build an original assessment in a recognisable A-Level Chemistry format. These are practice papers, not reproduced past papers.
Choose topics
All paper-style sessions use original authored questions. Hints, worked solutions and immediate marking stay hidden until the paper is submitted.
CHOOSE TOPICS
Build your practice
Select the areas you want to include.
Choose one topic
ACCOUNT & MEMBERSHIP
Membership
Your current plan, usage and options — with simple, transparent subscription controls.
Current plan—account
♛
Active
Membership
Loading your account…
—
STATUSActive
NEXT DATE—
ACCESS—
You can cancel anytime. Your paid access will continue until the end of your current billing period.
Paid membership is handled through Stripe. By subscribing you agree to the Subscription Terms; your statutory rights are unaffected.
QUESTIONS THIS MONTH—practice activity
AI USE THIS MONTH—requests
ACTIVE DAYS—this month
What's included
Your current membership includes:
Privacy & Data
Control the information attached to your account and see how AI, cookies and saved learning data are used.
`:""}`;
}
function renderChemVisualInto(el,spec){
if(!el)return false;
const html=renderChemVisualHtml(spec);
el.innerHTML=html;
el.hidden=!html;
return !!html;
}
function appendChemVisualToFeedback(spec){
if(!spec||!chemVisualValidate(spec))return;
const feedbackEl=$("feedback");if(!feedbackEl)return;
const wrap=document.createElement("div");wrap.className="chem-feedback-visual";
wrap.innerHTML=renderChemVisualHtml(spec);
feedbackEl.appendChild(wrap);
}
function renderExactVisual(spec){
if(!spec||!spec.type)return "";
const W=640,H=300,pad=48;
const title=esc(spec.title||"Question data");
const axes=``;
if(spec.type==="mass_spectrum"&&Array.isArray(spec.peaks)){
const peaks=spec.peaks.filter(p=>Number.isFinite(+p.mz)&&Number.isFinite(+p.intensity));
if(!peaks.length)return "";
const min=Math.min(...peaks.map(p=>+p.mz)),max=Math.max(...peaks.map(p=>+p.mz)),mx=Math.max(1,...peaks.map(p=>+p.intensity));
const lines=peaks.map(p=>{const x=pad+((+p.mz-min)/(max-min||1))*(W-2*pad),y=H-pad-(+p.intensity/mx)*(H-2*pad);return `${esc(p.mz)}`}).join("");
return ``
}
if((spec.type==="successive_ie"||spec.type==="first_ie_trend")&&Array.isArray(spec.values)){
const vals=spec.values.map(Number).filter(Number.isFinite);if(!vals.length)return "";
const mx=Math.max(...vals,1),step=(W-2*pad)/Math.max(1,vals.length-1);
const pts=vals.map((v,i)=>`${pad+i*step},${H-pad-(v/mx)*(H-2*pad)}`).join(" ");
const dots=vals.map((v,i)=>`${i+1}`).join("");
return ``
}
if(spec.type==="electron_shells"&&Array.isArray(spec.shells)){
const shells=spec.shells.map(Number).filter(Number.isFinite).slice(0,5);if(!shells.length)return "";
const cx=W/2,cy=H/2+10;
let shapes=``;
shells.forEach((n,i)=>{const r=42+i*30;shapes+=``;for(let j=0;j`}});
return ``
}
return ""
}
function render(){let q=SS.qs[SS.i];const skillMeta=SS.exam?{id:q.s,name:q._skillName||q.s}:(S.find(s=>s.id===q.s)||{id:q.s,name:q.s});SS.tries=0;SS.hints=0;$("qcount").textContent=SS.exam&&q._examLabel?`Question ${q._examLabel} · item ${SS.i+1} of ${SS.qs.length}`:`Question ${SS.i+1} of ${SS.qs.length}`;$("points").textContent=SS.exam?`${SS.max} mark exam`:`${SS.marks}/${SS.max} marks`;$("pbar").style.width=((SS.i+1)/SS.qs.length*100)+"%";$("sb").textContent=q.s+" · "+skillMeta.name;$("db").textContent="Level "+q.d;$("ab").textContent=q.ao;$("mb").textContent=q.m+" mark"+(q.m==1?"":"s");$("aib").hidden=!(q.ai&&hasAiLearningAccess());$("generatedBadge").hidden=!q.isGenerated;$("generatedBadge").textContent=q.isPremiumBank?"PREMIUM BANK":"FRESH VARIATION";setChemistryText($("question"),q.q);
$("questionTopicTitle").textContent=SS.exam?`Topic ${q._topicNumber} · ${q._topicTitle||skillMeta.name}`:skillMeta.name;
$("questionTypeBadge").textContent=questionTypeLabel(q);
$("difficultyDots").innerHTML=renderDifficultyDots(q.d);
$("questionMarksText").textContent=`[${q.m} mark${q.m===1?"":"s"}]`;
setChemistryText($("questionSupport"),q.support||"");
$("questionSupport").hidden=!q.support;
const learnTopicNumber=SS.exam?Number(q._topicNumber||inferTopicFromSkills([q.s])):inferTopicFromSkills([q.s]);
const learnTopicMeta=TOPICS.find(t=>Number(t.number)===Number(learnTopicNumber));
const learnLink=$("questionLearnLink");
if(learnLink){
learnLink.href=(learnTopicMeta&&learnTopicMeta.learn_url)?learnTopicMeta.learn_url:(learnTopicMeta&&learnTopicMeta.slug?`/learn/${learnTopicMeta.slug}/`:"/learn/");
learnLink.textContent=learnTopicMeta?`📖 Learn ${learnTopicMeta.title}`:"📖 Learn this topic";
}
const familyBox=$("examFamilyContext");
if(SS.exam&&q._familyId){
familyBox.hidden=false;
$("examFamilyLabel").textContent=`LINKED QUESTION ${q._examMajor||""} · PART ${q._familyPartIndex}/${q._familyPartCount}`;
$("examFamilyTitle").textContent=q._familyTitle||"Linked question";
setChemistryText($("examFamilyText"),q._familyContext||"");
const fv=$("examFamilyVisual"),fvi=$("examFamilyVisualInner");
if(q._familySharedVisual){fv.hidden=false;renderChemVisualInto(fv,q._familySharedVisual)}else{fv.hidden=true;fvi.innerHTML=""}
}else{familyBox.hidden=true;$("examFamilyVisual").hidden=true;$("examFamilyVisualInner").innerHTML=""}
const imageWrap=$("questionImageWrap");
const image=$("questionImage");
const caption=$("questionImageCaption");
if(q.image_url){
image.src=q.image_url;
image.alt=q.image_alt||"Chemistry question diagram";
imageWrap.hidden=false;
caption.textContent=q.image_caption||"";
caption.hidden=!q.image_caption;
}else{
image.src="";
image.alt="";
imageWrap.hidden=true;
caption.hidden=true;
}
const chemWrap=$("chemVisualWrap");
renderChemVisualInto(chemWrap,q.chem_visual);
const exactVisual=$("questionVisualSpec");
const exactSvg=renderExactVisual(q.visual_spec);
exactVisual.innerHTML=exactSvg;
exactVisual.hidden=!exactSvg;
$("feedback").hidden=true;$("sessionSavedStatus").textContent="";$("check").hidden=false;$("check").disabled=false;$("check").textContent=SS.exam?(SS.i===SS.qs.length-1?"Submit exam":"Save answer & next"):"Mark my work";$("next").hidden=true;$("hint").hidden=SS.exam||SS.mode==="test";$("solution").hidden=SS.exam||SS.mode==="test";$("hint").disabled=false;$("solution").disabled=false;const reportBtn=$("reportPremiumQuestionBtn");if(reportBtn){reportBtn.hidden=!!SS.exam||!q.isPremiumBank;reportBtn.disabled=false;reportBtn.textContent="Report question";}$("examPrevBtn").hidden=!SS.exam||SS.i===0;$("saveLeaveBtn").hidden=!!SS.exam;let ma=masteryFor(q.s);$("cskill").textContent=skillMeta.name;$("cbar").style.width=(ma.attempts?(ma.score??0):0)+"%";$("cval").textContent=ma.uniqueQuestions?`${ma.score}% · ${label(ma.score,ma.uniqueQuestions)} · ${ma.uniqueQuestions} unique questions`:"Not assessed yet";let hist=HISTORY[q.id]||null;
let why=[];
if(ma.uniqueQuestions===0)why.push("this skill has not been assessed yet");
else if(ma.dueForReview)why.push("this skill is due for spaced review");
else if((ma.score??0)<70)why.push("this is a developing or weaker skill");
if(!hist)why.push("you have not seen this question before");
else{
let age=hoursSince(hist.lastAttempt);
if(age>=72)why.push("enough time has passed for useful retrieval practice");
if(hist.lastScore<60)why.push("your previous result on this question was weak");
}
let target=Math.round(targetDifficulty(q.s));
if(Math.abs(q.d-target)<=1)why.push("the difficulty matches your current level");
$("whyText").textContent=why.length
?why.slice(0,2).join(" and ")+"."
:"it provides useful mixed practice at your current level.";
let c=$("control");c.innerHTML="";if(q.t==="mc"){let w=document.createElement("div");w.className="choices";q.o.forEach((o,i)=>{let l=document.createElement("label");l.className="choice";let r=document.createElement("input");r.type="radio";r.name="choice";r.value=i;let sp=document.createElement("span");setChemistryText(sp,o);l.append(r,sp);w.append(l)});c.append(w)}else{let x=document.createElement((q.t==="words"||q.t==="lor6")?"textarea":"input");x.id="ans";x.className="answer";if(q.t==="num"){x.type="number";x.step="any"}if(x.tagName==="TEXTAREA"){x.rows=q.t==="lor6"?10:5;x.placeholder=q.t==="lor6"?"Write your full 6-mark response here…":""}c.append(x)}if(SS.exam){restoreExamAnswer();renderExamNavigator()}else{$("examReview").hidden=true;$("saveLeaveBtn").hidden=false}}
function grade(q){
if(q.t==="mc"){
let c=document.querySelector('input[name="choice"]:checked');
if(!c)return null;
let chosen=+c.value;
if(Number.isInteger(q.a))return chosen===q.a?q.m:0;
if(Array.isArray(q.a)){
let correct=q.a.map(String).map(norm);
return correct.includes(norm(q.o[chosen]))?q.m:0
}
return 0
}
let x=$("ans").value.trim();
if(!x)return null;
if(q.t==="num"){
let target=Array.isArray(q.a)?+q.a[0]:+q.a;
return Math.abs(+x-target)<=q.tol?q.m:0
}
if(q.t==="exact"){
let clean=s=>norm(String(s))
.replace(/\^/g,"")
.replace(/[,\s;]+/g,"")
.replace(/²/g,"2")
.replace(/³/g,"3")
.replace(/⁺/g,"+")
.replace(/[−–—]/g,"-");
let n=clean(x);
let answers=Array.isArray(q.a)?q.a:[q.a];
return answers.some(a=>clean(a)===n)?q.m:0
}
let n=norm(x),keys=Array.isArray(q.k)?q.k:[];
let hits=keys.filter(k=>n.includes(norm(k))).length;
return Math.min(q.m,hits>=(q.need||1)?q.m:hits)
}
function feedback(x){$("feedback").hidden=false;$("feedback").className=visualFeedbackClass(x);$("feedback").innerHTML=x;applyChemistryFormatting($("feedback"))}
function esc(s){return String(s).replace(/[&<>"']/g,c=>({"&":"&","<":"<",">":">","\"":""","'":"'"}[c]))}
async function aiGrade(q){let answer=$("ans").value.trim();if(!answer)return null;$("check").disabled=true;$("check").textContent="AI marking…";feedback("Marking your chemistry…");try{let d=await api("api/mark-answer.php",{method:"POST",body:JSON.stringify({questionId:q.id,answer})});let details="";if(d.strengths?.length)details+="
What you did well: "+d.strengths.map(esc).join("; ")+"
";if(d.missing?.length)details+="
To improve: "+d.missing.map(esc).join("; ")+"
";if(d.next_hint)details+="
Next hint: "+esc(d.next_hint)+"
";return {marks:+d.marks,html:`${d.marks}/${d.max_marks} marks · AI marked.
${esc(d.feedback)}
${details}`}}finally{$("check").disabled=false;$("check").textContent="Mark my work"}}
async function levelResponseGrade(q){
let answer=$("ans").value.trim();
if(!answer)return null;
$("check").disabled=true;
$("check").textContent="Assessing response…";
feedback("Assessing your 6-mark response…
The marker is judging chemistry coverage, completeness and coherence.
");
try{
let d=await api("api/mark-level-response.php",{
method:"POST",
body:JSON.stringify({questionId:q.id,answer})
});
let stageHtml="";
if(Array.isArray(d.stages)){
stageHtml='
'+d.stages.map(s=>{
let status=(s.status||"partial").toLowerCase();
return `
";
}
let strengths=(d.strengths&&d.strengths.length)
?'
What is working well
'+d.strengths.map(x=>`
${esc(x)}
`).join("")+'
'
:"";
let improve='
How to improve
'+esc(d.improvement||"")+'
'+(d.next_step?`
Next step: ${esc(d.next_step)}
`:"")+'
';
let html=`
Level ${d.level}
${esc(d.level_reason||"")}
${d.marks}/6
Coherence: ${esc(d.coherence||"")}
${stageHtml}
${strengths}
${improve}
`;
return {marks:+d.marks,html};
}finally{
$("check").disabled=false;
$("check").textContent="Mark my work";
}
}
async function generatedGrade(q){
let payload={generatedId:q.generatedId};
if(q.t==="mc"){
let c=document.querySelector('input[name="choice"]:checked');
if(!c)return null;
payload.selectedIndex=+c.value;
}else{
let input=$("ans");
let answer=input?input.value.trim():"";
if(!answer)return null;
payload.answer=answer;
}
$("check").disabled=true;
$("check").textContent=q.t==="words"?"AI marking…":"Checking…";
try{
let d=await api("api/mark-generated.php",{method:"POST",body:JSON.stringify(payload)});
let detail=`${d.marks}/${d.max_marks} marks.
${esc(d.feedback||"")}
`;
if(d.strengths&&d.strengths.length)detail+=`
What you did well: ${d.strengths.map(esc).join("; ")}
`;
if(d.missing&&d.missing.length)detail+=`
To improve: ${d.missing.map(esc).join("; ")}
`;
if(d.misconception)detail+=`
Misconception to address: ${esc(d.misconception)}
`;
if(d.next_hint)detail+=`
Next hint: ${esc(d.next_hint)}
`;
return {marks:+d.marks,html:detail};
}finally{
$("check").disabled=false;
$("check").textContent="Mark my work";
}
}
async function generatedSolution(q){
let d=await api("api/generated-solution.php?id="+encodeURIComponent(q.generatedId));
return d.solution||"";
}
/* v3.6.7c1 Exam Session Foundation */
const EXAM_PAPER_PROFILES={
custom:{label:"Custom assessment",topics:null,defaultMarks:20,difficulty:"balanced",strategy:"custom",timePerMark:1.2,description:"Choose exactly which course topics to assess."},
paper1:{label:"Paper 1 style",topics:[1,2,3,4,5,6,10,11,12,13,14,15],defaultMarks:60,difficulty:"balanced",strategy:"paper1",timePerMark:1.15,description:"Physical and inorganic chemistry in a mixed short/long-answer assessment."},
paper2:{label:"Paper 2 style",topics:[2,3,4,5,7,8,9,10,11,12,13,16,17,18,19,20],defaultMarks:60,difficulty:"balanced",strategy:"paper2",timePerMark:1.15,description:"Physical and organic chemistry with synthesis, analysis and calculations."},
paper3:{label:"Paper 3 style",topics:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20],defaultMarks:40,difficulty:"balanced",strategy:"paper3",timePerMark:1.33,description:"Whole-course synoptic practice weighted towards practical/data analysis and multiple choice."},
practical:{label:"Practical & data",topics:[2,4,5,6,8,9,11,12,13,15,20],defaultMarks:20,difficulty:"standard",strategy:"practical",timePerMark:1.25,description:"A focused assessment of methods, observations, graphs, measurements and data interpretation."},
synoptic:{label:"Synoptic challenge",topics:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20],defaultMarks:40,difficulty:"challenge",strategy:"synoptic",timePerMark:1.25,description:"A broad mixed-topic challenge that rewards applying ideas across different areas of chemistry."}
};
function currentExamPaperProfile(){const key=checkedValue("examPaperMode","custom");return {key,...(EXAM_PAPER_PROFILES[key]||EXAM_PAPER_PROFILES.custom)}}
function setExamRadio(name,value){const x=document.querySelector(`input[name="${name}"][value="${value}"]`);if(x)x.checked=true}
function applyExamPaperMode(){
const p=currentExamPaperProfile(),topicSection=$("examTopicSection"),summary=$("examPaperSummary");
if(p.key==="custom"){topicSection.hidden=false}else{topicSection.hidden=true;document.querySelectorAll("#examTopicSelector input").forEach(x=>x.checked=p.topics.includes(Number(x.value)));setExamRadio("examMarks",String(p.defaultMarks));setExamRadio("examDifficulty",p.difficulty)}
const suggested=Math.max(10,Math.round((Number(checkedValue("examMarks",String(p.defaultMarks)))||p.defaultMarks)*p.timePerMark/5)*5);
summary.innerHTML=`${esc(p.label)}${esc(p.description)} Suggested working time for the current mark choice: about ${suggested} minutes.`;
}
function renderExamTopicSelector(){
const box=$("examTopicSelector");if(!box||!TOPICS.length)return;
box.innerHTML=TOPICS.filter(topicIsReady).map(t=>``).join("");
}
async function openExamConfigurator(){
if(!(await requireExamPracticeAccess()))return false;
$("practiceConfigurator").hidden=true;$("practicePlanSummary").hidden=true;
renderExamTopicSelector();
$("examConfigurator").hidden=false;
$("examConfigMessage").hidden=true;
applyExamPaperMode();
$("examConfigurator").scrollIntoView({behavior:"smooth",block:"start"});
return true;
}
async function loadExamTopicBank(n){
n=Number(n);
if(EXAM_BANK_CACHE[n]&&EXAM_SKILL_CACHE[n])return {q:EXAM_BANK_CACHE[n],s:EXAM_SKILL_CACHE[n]};
const [qr,sr]=await Promise.all([
fetch(`data/topic${n}.json`,{cache:"no-store"}),
fetch(`data/topic${n}-skills.json`,{cache:"no-store"})
]);
if(!qr.ok||!sr.ok)throw new Error(`Topic ${n} content could not be loaded.`);
const [q,s]=await Promise.all([qr.json(),sr.json()]);
EXAM_BANK_CACHE[n]=Array.isArray(q)?q:[];EXAM_SKILL_CACHE[n]=Array.isArray(s)?s:[];
return {q:EXAM_BANK_CACHE[n],s:EXAM_SKILL_CACHE[n]};
}
async function loadExamFamilies(){
if(EXAM_FAMILIES_CACHE)return EXAM_FAMILIES_CACHE;
const r=await fetch("data/exam-question-families.json",{cache:"no-store"});
if(!r.ok){EXAM_FAMILIES_CACHE=[];return EXAM_FAMILIES_CACHE}
const d=await r.json();EXAM_FAMILIES_CACHE=Array.isArray(d)?d:[];return EXAM_FAMILIES_CACHE;
}
function materialiseExamFamily(family,banksByTopic){
const b=banksByTopic[Number(family.topic)];if(!b)return null;
const qmap=Object.fromEntries(b.q.map(q=>[q.id,q]));const sm=Object.fromEntries(b.s.map(x=>[x.id,x.name]));
const meta=getTopicMeta(Number(family.topic));const parts=[];
for(let i=0;i<(family.parts||[]).length;i++){
const part=family.parts[i],src=qmap[part.source];if(!src)return null;
parts.push({...src,...part,id:`${family.id}-P${i+1}`,s:src.s,h:[],ai:false,isGenerated:false,_sourceQuestionId:src.id,_familyId:family.id,_familyTitle:family.title,_familyContext:family.context,_familySharedVisual:family.shared_chem_visual||null,_familyPartIndex:i+1,_familyPartCount:family.parts.length,_topicNumber:Number(family.topic),_topicTitle:meta.title,_skillName:sm[src.s]||src.s});
}
return {id:family.id,topic:Number(family.topic),title:family.title,parts,marks:parts.reduce((a,q)=>a+(Number(q.m)||1),0),difficulty:parts.reduce((a,q)=>a+(Number(q.d)||3),0)/Math.max(1,parts.length)};
}
function chooseExamFamilies(groups,target,difficulty){
const desired=target>=60?3:target>=40?2:target>=18?1:0;if(!desired)return [];
const targetD=difficulty==="foundation"?2:difficulty==="challenge"?4:3;
const shuffled=[...groups].sort((a,b)=>(Math.abs(a.difficulty-targetD)+Math.random()*.5)-(Math.abs(b.difficulty-targetD)+Math.random()*.5));
const out=[];let marks=0;for(const g of shuffled){if(out.length>=desired)break;if(marks+g.marks<=Math.max(8,target*.58)){out.push(g);marks+=g.marks}}
return out;
}
function numberExamQueue(queue){
let major=0,lastFamily=null,part=0;
for(const q of queue){
if(q._familyId){if(q._familyId!==lastFamily){major++;lastFamily=q._familyId;part=1}else part++;q._examMajor=major;q._examLabel=`${major}.${part}`}
else{major++;lastFamily=null;part=0;q._examMajor=major;q._examLabel=String(major)}
}
return queue;
}
function examDifficultyWeight(q,mode){
const d=Number(q.d)||3;
if(mode==="foundation")return d<=2?6:d===3?2:-3;
if(mode==="challenge")return d>=4?6:d===3?2:-3;
if(mode==="standard")return d===3?6:(d===2||d===4?3:0);
// balanced: gently centre around 3 but keep the full range
return 5-Math.abs(d-3);
}
function examVisualType(q){const v=q.chem_visual||q._familySharedVisual||null;return v&&typeof v==="object"?String(v.type||"").toLowerCase():""}
function examQuestionSignals(q){
const text=`${q.q||""} ${q.sol||""} ${(q.k||[]).join? (q.k||[]).join(" "):""}`.toLowerCase();
const visual=examVisualType(q);
const practical=/(practical|experiment|method|apparatus|burette|pipette|titration|calorim|rate experiment|uncertaint|error|measurement|colorim|chromatograph|spectrum|spectra|graph|plot|gradient|tangent|observation)/.test(text)||["apparatus","graph","spectrum","titration_curve","calibration_graph","mass_spectrum","ir_spectrum"].some(x=>visual.includes(x));
const data=practical||/(table|data|calculate|deduce|determine|suggest|interpret|analyse|analy[sz]e)/.test(text)||String(q.ao||"").toUpperCase()==="AO3";
return {practical,data,mc:q.t==="mc",extended:(Number(q.m)||1)>=4,ao:String(q.ao||"").toUpperCase()};
}
function examPaperModeWeight(q,mode,stats,target){
const s=examQuestionSignals(q);let w=0;
if(mode==="paper3"){if(s.mc&&stats.mcMarks=4)w+=8;if(s.ao==="AO2"||s.ao==="AO3")w+=7}
else if(mode==="paper1"||mode==="paper2"){if(s.extended)w+=5;if(s.data)w+=5}
return w;
}
function buildExamQueue(pool,target,difficulty,topicNumbers,paperMode="custom"){
const remaining=[...pool];
const chosen=[];let marks=0;
const typeCounts={mc:0,num:0,words:0,exact:0};
const paperStats={mcMarks:0,practicalMarks:0,dataMarks:0};
const topicCounts={};topicNumbers.forEach(n=>topicCounts[n]=0);
while(remaining.length&&markstarget+2)continue;
const topic=Number(q._topicNumber)||0;
const type=q.t||"words";
let score=examDifficultyWeight(q,difficulty)*8;
score+=examPaperModeWeight(q,paperMode,paperStats,target);
score+=Math.random()*8;
// spread across chosen topics
score-= (topicCounts[topic]||0)*7;
// favour a healthy mix of formats
score-= (typeCounts[type]||0)*4;
if(type==="mc"&&typeCounts.mcbestScore){bestScore=score;bestIndex=i}
}
if(bestIndex<0)break;
const q=remaining.splice(bestIndex,1)[0];chosen.push(q);marks+=Number(q.m)||1;
topicCounts[q._topicNumber]=(topicCounts[q._topicNumber]||0)+1;typeCounts[q.t]=(typeCounts[q.t]||0)+1;
const sig=examQuestionSignals(q),qm=Number(q.m)||1;if(sig.mc)paperStats.mcMarks+=qm;if(sig.practical)paperStats.practicalMarks+=qm;if(sig.data)paperStats.dataMarks+=qm;
}
// Try to improve closeness to target with one unused question if we undershot.
if(marksmarks+(Number(q.m)||1)<=target+2).sort((a,b)=>Math.abs(target-(marks+(Number(a.m)||1)))-Math.abs(target-(marks+(Number(b.m)||1))))[0];
if(fit){chosen.push(fit);marks+=Number(fit.m)||1}
}
return chosen;
}
function captureExamAnswer(){
if(!SS||!SS.exam)return true;
const q=SS.qs[SS.i];let value=null;
if(q.t==="mc"){
const c=document.querySelector('input[name="choice"]:checked');
value=c?{kind:"mc",value:Number(c.value)}:null;
}else{
const x=$("ans");const text=x?x.value.trim():"";
value=text?{kind:"text",value:text}:null;
}
if(value)SS.examAnswers[SS.i]=value;else delete SS.examAnswers[SS.i];
renderExamNavigator();return true;
}
function restoreExamAnswer(){
if(!SS||!SS.exam)return;
// Always reset the freshly rendered response control before restoring a saved
// answer for this exact exam item. This prevents browser/form state from
// carrying the previous question's response into the next question.
document.querySelectorAll('input[name="choice"]').forEach(r=>{r.checked=false});
const answerControl=$("ans");
if(answerControl)answerControl.value="";
const a=SS.examAnswers[SS.i];if(!a)return;
if(a.kind==="mc"){
const r=document.querySelector(`input[name="choice"][value="${a.value}"]`);if(r)r.checked=true;
}else if(answerControl)answerControl.value=a.value||"";
}
function renderExamNavigator(){
const wrap=$("examReview"),grid=$("examReviewGrid");if(!wrap||!grid)return;
if(!SS||!SS.exam){wrap.hidden=true;return}
wrap.hidden=false;
grid.innerHTML=SS.qs.map((q,i)=>``).join("");
grid.querySelectorAll("[data-exam-index]").forEach(b=>b.onclick=()=>{captureExamAnswer();SS.i=Number(b.dataset.examIndex);render()});
}
function gradeExamStoredAnswer(q,a){
if(!a)return 0;
if(q.t==="mc"){
const chosen=Number(a.value);
if(Number.isInteger(q.a))return chosen===q.a?q.m:0;
if(Array.isArray(q.a)){const correct=q.a.map(String).map(norm);return correct.includes(norm(q.o[chosen]))?q.m:0}
return 0;
}
const x=String(a.value||"").trim();if(!x)return 0;
if(q.t==="num"){
const target=Array.isArray(q.a)?+q.a[0]:+q.a;
return Math.abs(+x-target)<=q.tol?q.m:0;
}
if(q.t==="exact"){
const clean=s=>norm(String(s)).replace(/\^/g,"").replace(/[,\s;]+/g,"").replace(/²/g,"2").replace(/³/g,"3").replace(/⁺/g,"+").replace(/[−–—]/g,"-");
const answers=Array.isArray(q.a)?q.a:[q.a];return answers.some(v=>clean(v)===clean(x))?q.m:0;
}
const n=norm(x),keys=Array.isArray(q.k)?q.k:[];
const hits=keys.filter(k=>n.includes(norm(k))).length;
return Math.min(q.m,hits>=(q.need||1)?q.m:hits);
}
function examPerformanceBand(pct){
if(pct>=75)return {label:"Strong",cls:"strong"};
if(pct>=60)return {label:"Secure",cls:"strong"};
if(pct>=40)return {label:"Developing",cls:"developing"};
return {label:"Priority review",cls:"review"};
}
function examPct(marks,max){return max?Math.round((Number(marks)||0)/(Number(max)||1)*100):0}
function examAnswerText(q,a){
if(!a)return "No response";
if(a.kind==="mc"){const i=Number(a.value);return Array.isArray(q.o)&&q.o[i]!==undefined?String(q.o[i]):"No response"}
return String(a.value||"No response");
}
function examExpectedText(q){
if(q.t==="mc"){
if(Number.isInteger(q.a)&&Array.isArray(q.o))return String(q.o[q.a]??"");
if(Array.isArray(q.a))return q.a.join(" / ");
}
if(q.t==="num"||q.t==="exact")return (Array.isArray(q.a)?q.a:[q.a]).filter(v=>v!==undefined&&v!==null).join(" / ");
return q.sol||"See the worked solution.";
}
function examElapsedMinutes(){
if(!SS||!SS.examStartedAt)return null;
const end=SS.examFinishedAt||Date.now();
return Math.max(1,Math.round((end-SS.examStartedAt)/60000));
}
function buildExamAnalytics(){
if(!SS||!SS.exam)return null;
const skillMap={},topicRows=[],aoRows=[];
for(let i=0;itopicRows.push({...v,pct:examPct(v.marks,v.max)}));
Object.entries(SS.examAo||{}).forEach(([key,v])=>aoRows.push({key,...v,pct:examPct(v.marks,v.max)}));
const skills=Object.values(skillMap).map(v=>({...v,pct:examPct(v.marks,v.max)})).sort((a,b)=>a.pct-b.pct||b.max-a.max);
topicRows.sort((a,b)=>a.pct-b.pct||b.max-a.max);aoRows.sort((a,b)=>a.key.localeCompare(b.key));
const pct=examPct(SS.marks,SS.max),weakSkill=skills.find(x=>x.max>=1)||null;
const weakestTopic=topicRows[0]||null,strongestTopic=[...topicRows].sort((a,b)=>b.pct-a.pct||b.max-a.max)[0]||null;
const weakestAo=[...aoRows].sort((a,b)=>a.pct-b.pct)[0]||null;
const elapsed=examElapsedMinutes(),suggested=Number(SS.examSuggestedMinutes)||null;
const answered=Object.keys(SS.examAnswers||{}).length;
return {pct,skills,topics:topicRows,aos:aoRows,weakSkill,weakestTopic,strongestTopic,weakestAo,elapsed,suggested,answered};
}
function renderExamPerformanceRows(rows,labelFn){
if(!rows.length)return '
${esc(labelFn(row))}${row.marks}/${row.max} marks · ${band.label}
${pct}%
`}).join("");
}
function renderExamAnalytics(){
const panel=$("examAnalyticsPanel");if(!panel)return;
if(!SS||!SS.exam){panel.hidden=true;return}
const a=buildExamAnalytics();SS.examAnalytics=a;panel.hidden=false;
let timing="";
if(a.elapsed&&a.suggested){const delta=a.elapsed-a.suggested;timing=delta>2?` You used ${a.elapsed} minutes against a suggested ${a.suggested}.`:delta<-2?` You used ${a.elapsed} minutes against a suggested ${a.suggested}, so there may be scope to slow down and check answers.`:` You used ${a.elapsed} minutes, close to the suggested ${a.suggested}.`}
else if(a.elapsed)timing=` Session time: ${a.elapsed} minutes.`;
const strongest=a.strongestTopic?`${a.strongestTopic.title} (${a.strongestTopic.pct}%)`:"the strongest areas sampled";
const weakest=a.weakestTopic?`${a.weakestTopic.title} (${a.weakestTopic.pct}%)`:"the areas needing review";
$("examDiagnosticText").textContent=`You scored ${a.pct}%. Your strongest sampled area was ${strongest}; the clearest topic priority is ${weakest}.${timing}`;
$("examAoAnalytics").innerHTML=renderExamPerformanceRows(a.aos,r=>r.key);
$("examTopicAnalytics").innerHTML=renderExamPerformanceRows(a.topics.slice(0,8),r=>r.title);
const priorities=[];
if(a.weakSkill)priorities.push(`
Assessment objective: ${esc(a.weakestAo.key)} was your weakest AO at ${a.weakestAo.pct}%.
`);
if(a.weakestTopic)priorities.push(`
Topic review: ${esc(a.weakestTopic.title)} should be revisited before another paper.
`);
if(a.answeredCompletion: ${SS.qs.length-a.answered} question${SS.qs.length-a.answered===1?" was":"s were"} left blank.`);
if(a.elapsed&&a.suggested&&a.elapsedExam technique: you finished well inside the suggested time. Use spare time to check calculations, units and command words.`);
if(!priorities.length)priorities.push('
Repeat a mixed paper to build a stronger evidence base.
${renderChemistryText(next.reason||"Use the existing diagnostic priorities to choose your next practice.")}
`;
}
function renderExamAiFeedbackGate(){
const panel=$("examAiFeedbackPanel"),btn=$("examAiFeedbackBtn"),status=$("examAiFeedbackStatus"),body=$("examAiFeedbackBody");
if(!panel)return;
if(!SS||!SS.exam){panel.hidden=true;return}
panel.hidden=false;
if(SS.examAiFeedback){
btn.hidden=true;status.hidden=true;renderExamAiFeedbackResult(SS.examAiFeedback);return;
}
body.hidden=true;body.innerHTML="";btn.hidden=false;btn.disabled=false;btn.textContent="Generate AI feedback";
status.classList.remove("error");
if(hasAiLearningAccess()){
status.hidden=false;status.textContent="Ready to analyse this completed paper. Feedback is generated only when you request it.";
}else{
btn.hidden=true;status.hidden=false;status.textContent="AI exam feedback is available with Premium Individual or teacher-sponsored AI access. Your standard exam analytics above remain available on the Free plan.";
}
}
async function generateExamAiFeedback(){
if(!SS||!SS.exam)return;
const btn=$("examAiFeedbackBtn"),status=$("examAiFeedbackStatus");
if(!hasAiLearningAccess()){renderExamAiFeedbackGate();return}
btn.disabled=true;btn.textContent="Analysing paper…";status.hidden=false;status.classList.remove("error");status.textContent="Reviewing your performance across this paper…";
try{
const payload=examAiFeedbackPayload();
const d=await api("api/exam-feedback.php",{method:"POST",body:JSON.stringify(payload)});
SS.examAiFeedback=d.feedback||d;
renderExamAiFeedbackResult(SS.examAiFeedback);
await persistExamAiFeedback();
btn.hidden=true;status.hidden=true;
}catch(err){
status.hidden=false;status.classList.add("error");status.textContent=err.message||"AI exam feedback is temporarily unavailable.";
btn.disabled=false;btn.textContent="Try AI feedback again";
}
}
function examHistoryPayload(){
if(!SS||!SS.exam)return null;
const a=SS.examAnalytics||buildExamAnalytics();
return {
action:"save_session",
paperMode:SS.examPaperMode||"custom",paperLabel:SS.examPaperLabel||"Exam Practice",difficulty:SS.examDifficulty||"balanced",
targetMarks:Number(SS.examTarget)||0,maxMarks:Number(SS.max)||0,score:Number(SS.marks)||0,percentage:a?a.pct:examPct(SS.marks,SS.max),
elapsedMinutes:a?a.elapsed:examElapsedMinutes(),suggestedMinutes:a?a.suggested:(Number(SS.examSuggestedMinutes)||null),
topics:a?(a.topics||[]).map(x=>({topicNumber:x.topicNumber||null,title:x.title,marks:x.marks,max:x.max,percentage:x.pct})):[],
assessmentObjectives:a?(a.aos||[]).map(x=>({ao:x.key,marks:x.marks,max:x.max,percentage:x.pct})):[],
analytics:a?{strongestTopic:a.strongestTopic,weakestTopic:a.weakestTopic,weakestAo:a.weakestAo,weakSkill:a.weakSkill,answered:a.answered}: {},
responses:SS.qs.map((q,i)=>{const r=(SS.results||[])[i]||{marks:0,max:q.m};return {
questionIndex:i,label:q._examLabel||String(i+1),sourceQuestionId:q._sourceQuestionId||q.id||"",familyId:q._familyId||"",
topicNumber:q._topicNumber||null,topicTitle:q._topicTitle||`Topic ${q._topicNumber||""}`,skillId:q.s||"",skillName:q._skillName||q.s||"",ao:q.ao||"",
marks:Number(r.marks)||0,max:Number(q.m)||1,question:String(q.q||""),studentAnswer:examAnswerText(q,SS.examAnswers[i]),workedAnswer:examExpectedText(q)
}})
};
}
async function persistExamHistory(){
const payload=examHistoryPayload();if(!payload)return null;
try{const d=await api("api/exam-history.php",{method:"POST",body:JSON.stringify(payload)});SS.examHistoryId=Number(d.sessionId)||null;return SS.examHistoryId}
catch(err){console.warn("Exam history save failed",err);SS.examHistorySaveError=err.message||"Exam history could not be saved.";return null}
}
async function persistExamAiFeedback(){
if(!SS||!SS.examHistoryId||!SS.examAiFeedback)return;
try{await api("api/exam-history.php",{method:"POST",body:JSON.stringify({action:"save_ai_feedback",sessionId:SS.examHistoryId,feedback:SS.examAiFeedback})})}
catch(err){console.warn("AI feedback history save failed",err)}
}
function examHistoryFormatDate(value){
if(!value)return "";const d=new Date(String(value).replace(" ","T"));
if(Number.isNaN(d.getTime()))return String(value);
return d.toLocaleDateString(undefined,{day:"numeric",month:"short",year:"numeric"})+" · "+d.toLocaleTimeString(undefined,{hour:"2-digit",minute:"2-digit"});
}
function examHistoryAoMini(rows){
const a=Array.isArray(rows)?rows:[];return a.slice(0,3).map(x=>`${esc(x.ao||"AO")} ${Number(x.percentage)||0}%`).join(" · ");
}
function renderExamHistoryList(){
const box=$("examHistoryList"),msg=$("examHistoryMessage");if(!box)return;
$("examHistoryCount").textContent=EXAM_HISTORY_CACHE.length;
const avg=EXAM_HISTORY_CACHE.length?Math.round(EXAM_HISTORY_CACHE.reduce((n,x)=>n+(Number(x.percentage)||0),0)/EXAM_HISTORY_CACHE.length):null;
$("examHistoryAverage").textContent=avg===null?"No completed papers yet":`Average ${avg}%`;
if(!EXAM_HISTORY_CACHE.length){box.innerHTML='
No saved exam results yet.
Complete an Exam Practice paper and it will appear here automatically.
';return}
box.innerHTML=EXAM_HISTORY_CACHE.map(x=>``).join("");
box.querySelectorAll("[data-history-id]").forEach(b=>b.onclick=()=>openExamHistoryDetail(Number(b.dataset.historyId)));
msg.hidden=true;
}
async function openExamHistoryHub(){
show("examHistoryHub");$("examHistoryDetail").hidden=true;$("examTrendsPanel").hidden=true;$("examHistoryList").hidden=false;
const msg=$("examHistoryMessage");msg.hidden=false;msg.textContent="Loading your saved exam results…";
try{const d=await api("api/exam-history.php?limit=50");EXAM_HISTORY_CACHE=Array.isArray(d.sessions)?d.sessions:[];renderExamHistoryList()}
catch(err){msg.hidden=false;msg.textContent=err.message||"Exam history could not be loaded.";$("examHistoryList").innerHTML=""}
}
function historyPerformanceRows(rows,labelKey){
const arr=Array.isArray(rows)?rows:[];if(!arr.length)return '
`;
}
function renderExamTrends(data){
const box=$("examTrendsContent");if(!box)return;
const s=data.summary||{},delta=examTrendDeltaText(s.deltaRecentVsPrevious),topics=data.topics||[],skills=data.skills||[],aos=data.assessmentObjectives||[],series=data.series||[];
const priorityTopics=topics.filter(x=>Number(x.maxMarks)>=4).sort((a,b)=>Number(a.percentage)-Number(b.percentage)).slice(0,5);
const strongestTopics=topics.filter(x=>Number(x.maxMarks)>=4).sort((a,b)=>Number(b.percentage)-Number(a.percentage)).slice(0,5);
const prioritySkills=skills.filter(x=>Number(x.maxMarks)>=3).sort((a,b)=>Number(a.percentage)-Number(b.percentage)).slice(0,6);
let diagnosis='Complete more exam practice to build a reliable trend.';
if(Number(s.totalExams)>=2){
if(Number(s.deltaRecentVsPrevious)>3)diagnosis=`Your recent exam average is improving. Keep the momentum, but use the priority list to make the improvement broader.`;
else if(Number(s.deltaRecentVsPrevious)<-3)diagnosis=`Your recent average has dipped. Use the repeated weak areas below as the next revision targets rather than reacting to one isolated question.`;
else diagnosis=`Your overall exam performance is relatively steady. The most useful gains are likely to come from the recurring topic, skill and AO priorities below.`;
}
box.innerHTML=`
Your score, previous answers and worked-answer review remain available on Free. Premium adds AO analysis, topic diagnosis, trends and personalised exam priorities.
`}
Question-by-question review
${responseHtml||'
No response detail was saved.
'}
AI exam feedback
${renderSavedAiFeedback(s.aiFeedback)}
`;
}catch(err){msg.hidden=false;msg.textContent=err.message||"This exam result could not be loaded."}
}
async function submitExamSession(){
captureExamAnswer();
const answered=Object.keys(SS.examAnswers||{}).length;
if(answereda+(Number(q.m)||1),0);SS.examFinishedAt=Date.now();
SS.examAnalytics=buildExamAnalytics();
await persistExamHistory();
if(SS.examAssignmentUid&&SS.examHistoryId){try{await api("api/exam-assignments.php",{method:"POST",body:JSON.stringify({action:"complete",assignmentUid:SS.examAssignmentUid,examSessionId:SS.examHistoryId})});await loadStudentExamAssignments();renderStudentExamAssignments()}catch(e){console.warn("Assigned assessment completion could not be recorded",e)}}
btn.disabled=false;end();
}
async function buildExamSession(assigned=null){
if(!assigned && !(await requireExamPracticeAccess()))return;
const selectedProfile=assigned?(EXAM_PAPER_PROFILES[assigned.paperMode]||EXAM_PAPER_PROFILES.custom):currentExamPaperProfile();
const profile={key:assigned?assigned.paperMode:selectedProfile.key,...selectedProfile};
const selected=assigned?(profile.key==="custom"?(Array.isArray(assigned.topics)?assigned.topics.map(Number):[]):[...profile.topics]):(profile.key==="custom"?[...document.querySelectorAll("#examTopicSelector input:checked")].map(x=>Number(x.value)):[...profile.topics]);
const msg=$("examConfigMessage");msg.hidden=true;
if(!selected.length){msg.hidden=false;msg.textContent="Select at least one Chemistry topic.";return}
const target=assigned?(Number(assigned.targetMarks)||profile.defaultMarks):(Number(checkedValue("examMarks",String(profile.defaultMarks)))||profile.defaultMarks);
const difficulty=assigned?(assigned.difficulty||profile.difficulty):checkedValue("examDifficulty",profile.difficulty);
const btn=$("buildExamBtn"),old=btn.textContent;btn.disabled=true;btn.textContent="Building…";
showGlobalLoading("Building your exam session…","Selecting a balanced set of authored Chemistry questions.");
try{
if(assigned&&assigned.assignmentKind==="common"&&assigned.commonPaper){
const queue=await materialiseLockedCommonPaper(assigned.commonPaper);if(!queue.length)throw new Error("The locked common paper is empty.");
const suggestedMinutes=Math.max(10,Math.round((queue.reduce((a,q)=>a+(Number(q.m)||1),0)*profile.timePerMark)/5)*5);
SS={mode:"exam",exam:true,skill:null,qs:queue,i:0,marks:0,max:queue.reduce((a,q)=>a+(Number(q.m)||1),0),ind:0,ass:0,tries:0,hints:0,results:[],examAnswers:{},examTarget:target,examDifficulty:difficulty,examTopicsSelected:selected,examPaperMode:profile.key,examPaperLabel:assigned.title,examSuggestedMinutes:suggestedMinutes,examStartedAt:Date.now(),examAssignmentUid:assigned.uid,examAssignmentClass:assigned.className,personalised:false,examLockedCommonPaper:true};
document.body.classList.add("exam-session");$("modeLabel").textContent="COMMON ASSESSMENT";$("stitle").textContent=assigned.title;$("rules").innerHTML=`
Exam conditions Locked common paper
Teacher-set assessment: ${esc(assigned.title)}${assigned.className?` · ${esc(assigned.className)}`:""}${assigned.dueDate?` · due ${esc(formatAssignmentDate(assigned.dueDate))}`:""}
Every pupil receives this exact locked question set. No hints, worked solutions or immediate marking.
${SS.max} marks · suggested time ${suggestedMinutes} minutes.
`;$("examConfigurator").hidden=true;show("session");render();return;
}
const [banks,familyDefs]=await Promise.all([Promise.all(selected.map(async n=>({n,...await loadExamTopicBank(n)}))),loadExamFamilies()]);
let pool=[];const banksByTopic={};
for(const b of banks){
banksByTopic[b.n]=b;const meta=getTopicMeta(b.n);const sm=Object.fromEntries(b.s.map(x=>[x.id,x.name]));
pool.push(...b.q.filter(q=>!q.isGenerated&&q.t!=="lor6").map(q=>({...q,h:Array.isArray(q.h)?q.h:(q.h?[q.h]:[]),_topicNumber:b.n,_topicTitle:meta.title,_skillName:sm[q.s]||q.s})));
}
if(!pool.length)throw new Error("No suitable authored questions were found for the selected topics.");
let familyGroups=(familyDefs||[]).filter(f=>selected.includes(Number(f.topic))).map(f=>materialiseExamFamily(f,banksByTopic)).filter(Boolean);
if(profile.strategy==="practical"||profile.strategy==="paper3")familyGroups.sort((a,b)=>{const bs=b.parts.reduce((n,q)=>n+(examQuestionSignals(q).practical?2:examQuestionSignals(q).data?1:0),0),as=a.parts.reduce((n,q)=>n+(examQuestionSignals(q).practical?2:examQuestionSignals(q).data?1:0),0);return bs-as});
const chosenFamilies=chooseExamFamilies(familyGroups,target,difficulty);
const usedSources=new Set(chosenFamilies.flatMap(g=>g.parts.map(q=>q._sourceQuestionId)));
pool=pool.filter(q=>!usedSources.has(q.id));
const familyParts=chosenFamilies.flatMap(g=>g.parts),familyMarks=familyParts.reduce((a,q)=>a+(Number(q.m)||1),0);
const singles=buildExamQueue(pool,Math.max(0,target-familyMarks),difficulty,selected,profile.strategy);
const queue=numberExamQueue([...familyParts,...singles]);
if(!queue.length)throw new Error("An exam session could not be assembled from those choices.");
const suggestedMinutes=Math.max(10,Math.round((queue.reduce((a,q)=>a+(Number(q.m)||1),0)*profile.timePerMark)/5)*5);
SS={mode:"exam",exam:true,skill:null,qs:queue,i:0,marks:0,max:queue.reduce((a,q)=>a+(Number(q.m)||1),0),ind:0,ass:0,tries:0,hints:0,results:[],examAnswers:{},examTarget:target,examDifficulty:difficulty,examTopicsSelected:selected,examPaperMode:profile.key,examPaperLabel:assigned?assigned.title:profile.label,examSuggestedMinutes:suggestedMinutes,examStartedAt:Date.now(),examAssignmentUid:assigned?assigned.uid:null,examAssignmentClass:assigned?assigned.className:null,personalised:false};
document.body.classList.add("exam-session");
$("modeLabel").textContent=profile.key==="custom"?"EXAM PRACTICE":profile.label.toUpperCase();
$("stitle").textContent=profile.key==="custom"?(selected.length===1?`Topic ${selected[0]} · ${getTopicMeta(selected[0]).title}`:`${selected.length} topics · Exam Practice`):profile.label;
const paperDetail=profile.key==="paper3"?"The selection is weighted towards practical/data analysis and multiple-choice questions.":profile.key==="practical"?"The selection is weighted towards practical methods, graphs, observations and data interpretation.":profile.key==="synoptic"?"Questions are spread broadly across the course and weighted towards application.":"The paper mixes short, calculation and longer application questions.";
$("rules").innerHTML=`
Exam conditions ${esc(profile.label)}
${assigned?`
Teacher-set assessment: ${esc(assigned.title)}${assigned.className?` · ${esc(assigned.className)}`:""}${assigned.dueDate?` · due ${esc(assigned.dueDate)}`:""}
`:""}
No hints, worked solutions or immediate marking. ${esc(paperDetail)}
${SS.max} marks assembled · suggested time ${suggestedMinutes} minutes · original authored questions only.
`;
$("examConfigurator").hidden=true;show("session");render();
}catch(err){msg.hidden=false;msg.textContent=err.message||"Exam session could not be built."}
finally{hideGlobalLoading();btn.disabled=false;btn.textContent=old}
}
function selectedPracticeSkills(){
return [...document.querySelectorAll("#practiceSkillSelector input[type='checkbox']:checked")].map(x=>x.value)
}
function renderFullReviewTopicSelector(){
const box=$("practiceTopicSelector");if(!box)return;
const ready=(TOPICS||[]).filter(topicIsReady);
box.innerHTML=ready.map(t=>``).join("");
}
async function fullReviewSkillsForTopic(topicNumber){
const groups=await loadAllCourseSkills();
const group=groups.find(g=>Number(g.topic.number)===Number(topicNumber));
return group?group.skills.map(s=>s.id):[];
}
function checkedValue(name,fallback){
let r=document.querySelector(`input[name="${name}"]:checked`);
return r?r.value:fallback
}
function openPracticeHub(){
const o=overall();
$("practiceMastery").textContent=o===null?"—":o+"%";
$("practiceMasteryLabel").textContent=o===null?"Building profile":label(o,5);
const w=weakest(),wm=masteryFor(w.id);
$("recommendedPracticeText").textContent=wm.uniqueQuestions===0
?`Start by gathering evidence in ${w.name}.`
:`Your current priority is ${w.name} (${wm.score}% mastery).`;
$("practiceConfigurator").hidden=true;
$("practiceLoading").hidden=true;
$("practicePlanSummary").hidden=true;
show("practiceHub");
loadSavedPracticeReviews();
}
async function openPracticeConfigurator(route){
PRACTICE_ROUTE=route;
const topicWrap=$("practiceTopicSelectorWrap"),skillBox=$("practiceSkillSelector"),lengthField=$("practiceLengthFieldset"),fullReviewLengthField=$("fullReviewLengthFieldset"),difficultyField=$("difficultyFieldset"),buildBtn=$("buildPracticeBtn");
$("practiceConfigurator").hidden=false;
$("practiceConfigMessage").hidden=true;
$("practicePlanSummary").hidden=true;
topicWrap.hidden=true;skillBox.hidden=false;lengthField.hidden=false;fullReviewLengthField.hidden=true;difficultyField.hidden=false;
buildBtn.textContent="Build my practice";
if(route==="full-review"){
renderFullReviewTopicSelector();
topicWrap.hidden=false;skillBox.hidden=true;lengthField.hidden=true;fullReviewLengthField.hidden=false;difficultyField.hidden=true;
const twenty=document.querySelector('input[name="fullReviewLength"][value="20"]');if(twenty)twenty.checked=true;
$("configEyebrow").textContent="FULL TOPIC REVIEW";
$("configTitle").textContent="Choose a Chemistry topic";
$("configHelp").textContent=hasIntelligentPracticeAccess()
?"Choose any ready topic and 15, 20 or 25 questions. Premium uses your mastery, recency, previous errors and validated Premium-bank questions to personalise the review; new AI questions are created only for genuine coverage gaps."
:"Choose any ready topic and 15, 20 or 25 questions. Free Full Topic Review uses the trusted authored bank with standard marking and broad topic coverage — no AI generation or AI marking calls.";
buildBtn.textContent="Start Full Topic Review";
}else{
await renderPracticeSkillSelector();
$("practiceSkillSelector").querySelectorAll("input").forEach(x=>x.checked=false);
if(route==="mini-review"){
$("configEyebrow").textContent="MINI REVIEW";
$("configTitle").textContent="Choose 2–5 areas";
$("configHelp").textContent=hasIntelligentPracticeAccess()?"Premium will balance the areas using your mastery, recency and previous errors, while reusing validated Premium-bank questions where useful.":"Free Mini Review balances your chosen areas using the trusted authored bank only.";
difficultyField.hidden=true;
}else{
$("configEyebrow").textContent="CHOOSE WHAT TO PRACTISE";
$("configTitle").textContent="Build your practice";
$("configHelp").textContent=hasIntelligentPracticeAccess()?"Choose one or more areas. Premium adapts within your choice using your current evidence and the reusable Premium bank.":"Choose one or more areas. Free practice uses trusted authored questions; upgrade to Premium for adaptive selection and the reusable Premium bank.";
}
}
$("practiceConfigurator").scrollIntoView({behavior:"smooth",block:"start"});
}
async function ensureMultiTopicQuestions(skillIds){
const topics=[...new Set(skillIds.map(id=>{const m=String(id).match(/^T(\d+)\./i);return m?Number(m[1]):CURRENT_TOPIC}))];
if(!topics.length)return [];
const banks=await Promise.all(topics.map(async t=>{
const r=await fetch(`data/topic${t}.json`,{cache:"no-store"});
if(!r.ok)throw new Error(`Topic ${t} question bank could not be loaded.`);
const qs=await r.json();
if(!Array.isArray(qs))throw new Error(`Topic ${t} question bank is invalid.`);
return qs.map(q=>({...q,h:Array.isArray(q.h)?q.h:(q.h?[q.h]:[]),__topic:t,_topicNumber:q._topicNumber||t,_topicTitle:q._topicTitle||getTopicMeta(t).title}));
}));
Q=banks.flat(); return topics;
}
function balancedAuthoredPool(skillIds,count,route){
const source=Q.filter(q=>skillIds.includes(q.s)&&!q.isGenerated);
if(route==="full-review"||route==="mini-review"){
const selected=[];
const groups={};
skillIds.forEach(s=>groups[s]=source.filter(q=>q.s===s).sort((a,b)=>questionPriority(b)-questionPriority(a)));
let cursor=0;
while(selected.length=count)break;
}
}
if(!added)break;
cursor++;
}
return selected.slice(0,count)
}
return source.sort((a,b)=>questionPriority(b)-questionPriority(a)).slice(0,count)
}
function balancedAuthoredStandardPool(skillIds,count){
const source=Q.filter(q=>skillIds.includes(q.s)&&!q.isGenerated&&q.t!=="lor6");
const groups={};
skillIds.forEach(sid=>groups[sid]=source.filter(q=>q.s===sid).sort(()=>Math.random()-.5));
const selected=[];let cursor=0;
while(selected.length=count)break}}if(!added)break;cursor++}
if(selected.lengthq.id));for(const q of source.sort(()=>Math.random()-.5)){if(!used.has(q.id)){selected.push(q);used.add(q.id);if(selected.length>=count)break}}}
return selected.slice(0,count)
}
function interleaveQuestions(authored,generated,total){
const result=[];
let aiIndex=0,authIndex=0;
const aiPositions=new Set();
if(generated.length===1)aiPositions.add(Math.max(1,Math.floor(total/2)));
else{
for(let i=0;iskills.includes(q.s)&&!q.isGenerated&&q.t!=="lor6");
if(difficulty&&difficulty!=="auto"){const wanted=difficulty==="foundation"?[1,2]:difficulty==="challenge"?[4,5]:[3];const filtered=source.filter(q=>wanted.includes(Number(q.d)||3));if(filtered.length>=Math.min(length,3))source=filtered;}
if(!source.length)throw new Error("No suitable authored questions were found for the selected mastery areas.");
const oldQ=Q;Q=source;let queue=(route==="mini-review"||route==="full-review")?balancedAuthoredStandardPool(skills,length):[...source].sort(()=>Math.random()-.5).slice(0,length);Q=oldQ;
if(!queue.length)throw new Error("No suitable questions could be assembled from the selected areas.");
const sessionMode=(route==="mini-review"||route==="full-review")?"test":"practice";
const topicNums=[...new Set(skills.map(id=>{const m=String(id).match(/^T(\d+)\./i);return m?Number(m[1]):CURRENT_TOPIC}))];
SS={mode:sessionMode,skill:null,qs:queue,i:0,marks:0,max:queue.reduce((a,q)=>a+(+q.m||1),0),ind:0,ass:0,tries:0,hints:0,results:[],personalised:true,intelligent:false,route,topicNumber:topicNums.length===1?topicNums[0]:CURRENT_TOPIC,reviewUid:route==="full-review"?`REV-${Date.now()}-${Math.random().toString(36).slice(2,10)}`:null,analysis:"Free practice built from the trusted authored Chemistry bank. No AI question generation or AI marking call was used."};
$("modeLabel").textContent=route==="full-review"?"FULL TOPIC REVIEW":route==="mini-review"?"MINI REVIEW":"CHOSEN PRACTICE";
const labelText=route==="full-review"?"Full Topic Review":route==="mini-review"?"Mini Review":"Chosen Practice";
$("stitle").textContent=topicNums.length===1?`Topic ${topicNums[0]} · ${labelText}`:`${topicNums.length} topics · ${labelText}`;
$("rules").innerHTML=sessionMode==="test"?"
Free authored review
Your first response counts. Questions are spread across the selected areas from the trusted authored bank. AI generation and AI marking are not used.
":"
Free authored practice
Questions are drawn from the trusted authored banks for the areas you selected. Premium adds adaptive selection; Free remains standard authored practice.
";
if(window.drClayAnalytics)window.drClayAnalytics.track("practice_started",{practice_type:route,topic_count:topicNums.length,question_count:queue.length,intelligent:false});
show("session");render();
}
async function buildPersonalisedPractice(route,skills=[],length=10,difficulty="auto",concepts=[],useGlobalLoader=false,topicOverride=null){
$("practiceConfigurator").hidden=true;
$("practicePlanSummary").hidden=true;
$("practiceLoading").hidden=useGlobalLoader;
$("practiceLoadingText").textContent=route==="recommended"
?"Dr Clay Tutor is analysing your strengths, gaps and recent progress to choose what to work on next."
:"Balancing your selected areas with your current mastery profile.";
if(!useGlobalLoader){
$("practiceLoading").hidden=false;
$("practiceStatusArea")?.scrollIntoView({behavior:"smooth",block:"nearest"});
}
try{
if((route==="choose"||route==="mini-review"||route==="full-review")&&Array.isArray(skills)&&skills.length&&!hasIntelligentPracticeAccess()){await buildSelectedCoursePractice(route,skills,length,difficulty);return;}
await loadAdaptiveState();
let plan=await api("api/personalised-practice.php",{
method:"POST",
body:JSON.stringify({route,skills,length,difficulty,concepts,topic:topicOverride||CURRENT_TOPIC})
});
const skillIds=plan.selectedSkills||skills;
await ensureMultiTopicQuestions(skillIds);
const generated=plan.generated||[];
const authoredCount=Math.max(0,plan.length-generated.length);
let authored=balancedAuthoredPool(skillIds,authoredCount,route);if(route==="uncovered"&&concepts.length){authored=Q.filter(q=>q.concepts&&q.concepts.some(c=>concepts.includes(c))).sort((a,b)=>questionPriority(b)-questionPriority(a)).slice(0,authoredCount)}
const queue=interleaveQuestions(authored,generated,plan.length);
if(!queue.length)throw new Error("No suitable questions could be assembled.");
const sessionMode=(route==="mini-review"||route==="full-review")?"test":"practice";
SS={
mode:sessionMode,
skill:null,
qs:queue,
i:0,
marks:0,
max:queue.reduce((a,q)=>a+(+q.m||1),0),
ind:0,ass:0,tries:0,hints:0,results:[],
personalised:true,
intelligent:true,
route,
topicNumber:topicOverride||CURRENT_TOPIC,
reviewUid:route==="full-review"?`REV-${Date.now()}-${Math.random().toString(36).slice(2,10)}`:null,
analysis:(plan.analysis||"Your practice was adapted from your current evidence.")+(plan.freshGenerated?` Premium bank expanded by ${plan.freshGenerated} new validated question${plan.freshGenerated===1?"":"s"}, reusable for future Premium students.`:(plan.reused?` ${plan.reused} validated Premium-bank question${plan.reused===1?" was":"s were"} reused without generating a replacement.`:""))
};
$("modeLabel").textContent=route==="recommended"?"PERSONALISED PRACTICE":route.replace("-"," ").toUpperCase();
$("stitle").textContent=route==="full-review"
?`Topic ${topicOverride||CURRENT_TOPIC} · ${getTopicMeta(topicOverride||CURRENT_TOPIC).title} · Full Review`
:route==="mini-review"
?currentTopicLabel()+" · Mini Review"
:route==="uncovered"
?currentTopicLabel()+" · Uncovered Areas"
:route==="action"
?currentTopicLabel()+" · Working on next"
:currentTopicLabel()+" · Personalised Practice";
$("rules").innerHTML=sessionMode==="test"
?"
⭐ Premium intelligent review
Your first response counts. Authored questions remain the backbone; the engine adapts selection from your learning evidence, reuses validated Premium-bank questions and only generates a new reusable question when a genuine gap exists.
"
:"
⭐ Premium intelligent practice
The session starts with trusted authored content, adapts to your evidence and reuses the shared Premium bank. AI generation is a gap-filler, not the default.
";
if(!useGlobalLoader)$("practiceLoading").hidden=true;
if(window.drClayAnalytics)window.drClayAnalytics.track("practice_started",{practice_type:route,topic_number:CURRENT_TOPIC,question_count:queue.length,personalised:true});
show("session");
render();
}catch(err){
if(!useGlobalLoader)$("practiceLoading").hidden=true;
$("practicePlanSummary").hidden=false;
const premiumGate=/Premium Individual|teacher-sponsored AI access/i.test(String(err&&err.message||""));
$("practicePlanSummary").classList.toggle("premium-gate",premiumGate);
$("practicePlanSummary").innerHTML=premiumGate
?`⭐ PREMIUM FEATUREPersonalised AI practice is included with Premium Individual.
Upgrade to Premium to let Dr Clay Tutor build fresh practice around your strengths and gaps. You can still use the authored practice questions on the Free plan.
`
:`Practice could not be built.${esc(err.message)}`;
$("practiceStatusArea")?.scrollIntoView({behavior:"smooth",block:"nearest"});
}
}
function currentPracticeAnswer(q){
if(!q)return "";
if(q.t==="mc"){const c=document.querySelector('input[name="choice"]:checked');return c&&Array.isArray(q.o)?String(q.o[Number(c.value)]??""):""}
const x=$("ans");return x?x.value.trim():""
}
function recordPracticeResultEvidence(q,marks){
if(!SS||!Array.isArray(SS.results)||!q||q._reviewResultRecorded)return;
q._reviewResultRecorded=true;
SS.results.push({skill:q.s,marks:Number(marks)||0,max:Number(q.m)||1,generated:!!q.isGenerated,premiumBank:!!q.isPremiumBank,questionId:q.generatedId||q.id||"",difficulty:Number(q.d)||3,type:q.t||"",question:q.q||"",studentAnswer:q._reviewStudentAnswer||""})
}
function reviewAiList(items){return Array.isArray(items)&&items.length?`
${esc(r.summary||"Saved AI Full Topic Review feedback.")}
${esc(date)}
`}).join("");list.querySelectorAll(".saved-review-open").forEach(b=>b.onclick=()=>openSavedPracticeReview(b.dataset.reviewUid))}catch(e){panel.hidden=true}}
async function openSavedPracticeReview(uid){const detail=$("savedPracticeReviewDetail");if(!detail)return;detail.hidden=false;detail.innerHTML="
Improve your response and try again, or request a hint.
✓
Marked and saved This attempt has been added to your progress.
")}}catch(err){feedback("AI marking is temporarily unavailable.
"+esc(err.message)+"
")}return}let m=grade(q);if(m===null){feedback("Enter or select an answer first.");return}if(m===q.m||SS.mode==="test")await finish(q,m,ind);else {await saveAttempt(q,m);feedback(`${m}/${q.m} so far.
You have some of the chemistry. Improve the answer or request a hint.
✓
Marked and saved This attempt has been added to your progress.
`)}};
$("examPrevBtn").onclick=()=>{if(!SS||!SS.exam||SS.i<=0)return;captureExamAnswer();SS.i--;render()};
async function reportPremiumQuestion(){let q=SS&&SS.qs?SS.qs[SS.i]:null;if(!q||!q.isPremiumBank||!q.generatedId)return;let reason=prompt("What seems wrong? Enter: answer_wrong, unclear, multiple_correct, marking, formatting, or other","unclear");if(reason===null)return;reason=String(reason).trim().toLowerCase();if(!["answer_wrong","unclear","multiple_correct","marking","formatting","other"].includes(reason))reason="other";let note=prompt("Optional note for Dr Clay (please do not include personal information):","");if(note===null)return;let btn=$("reportPremiumQuestionBtn");if(btn){btn.disabled=true;btn.textContent="Saving report…"}try{let d=await api("api/premium-question-report.php",{method:"POST",body:JSON.stringify({questionUid:q.generatedId,reason,note})});if(btn)btn.textContent=d.alreadyReported?"Already reported":"Reported";alert(d.alreadyReported?"You already have an open report for this question.":"Thanks. This Premium-bank question has been flagged for review.")}catch(e){if(btn){btn.disabled=false;btn.textContent="Report question"}alert(e.message||"The report could not be saved.")}}
$("reportPremiumQuestionBtn").onclick=reportPremiumQuestion;
$("hint").onclick=()=>{let q=SS.qs[SS.i],hints=Array.isArray(q.h)?q.h:(q.h?[q.h]:[]);if(!hints.length){feedback("No additional hint is available for this question.");$("hint").disabled=true;return}let i=Math.min(SS.hints,hints.length-1);SS.hints++;feedback("Hint: "+esc(hints[i]));if(q.hint_chem_visual)appendChemVisualToFeedback(Array.isArray(q.hint_chem_visual)?q.hint_chem_visual[Math.min(i,q.hint_chem_visual.length-1)]:q.hint_chem_visual);if(SS.hints>=hints.length)$("hint").disabled=true};
$("solution").onclick=async()=>{let q=SS.qs[SS.i];SS.ass++;q._reviewStudentAnswer=currentPracticeAnswer(q);let sol=q.sol||"";if(q.isGenerated){try{sol=await generatedSolution(q)}catch(err){feedback("Solution could not be loaded.
"+esc(err.message)+"
");return}}recordPracticeResultEvidence(q,0);await saveAttempt(q,0);feedback("Worked solution: "+esc(sol));appendChemVisualToFeedback(q.solution_chem_visual);$("check").hidden=true;$("next").hidden=false;$("hint").disabled=true;$("solution").disabled=true};
$("next").onclick=async()=>{SS.i++;if(SS.i>=SS.qs.length){await completeSavedSession();end()}else{if(SS.sessionUid)await saveSessionState(false);render()}};function end(){
$("sumtitle").textContent=SS.exam?`${SS.examPaperLabel||"Exam Practice"} complete`:(SS.personalised?(SS.route==="full-review"?"Full Topic Review complete":SS.route==="mini-review"?"Mini Review complete":"Personalised practice complete"):(SS.mode[0].toUpperCase()+SS.mode.slice(1)+" complete"));
$("sumlead").textContent=SS.exam?(SS.examHistorySaveError?`Your ${SS.examPaperLabel||"exam"} has been marked and added to progress, but the exam-history copy could not be saved.`:`Your ${SS.examPaperLabel||"exam"} responses have now been marked, added to your progress and saved in My Exam Results.`):(SS.personalised?(SS.analysis||"Your profile has been updated from this session."):"Your attempts have been saved and mastery updated.");applyChemistryFormatting($("sumlead"));
$("summarks").textContent=`${SS.marks}/${SS.max}`;
if(SS.exam){
$("sumMarksLabel").textContent="Marks";$("sumIndLabel").textContent="Answered";$("sumAssLabel").textContent="Blank";
const answered=Object.keys(SS.examAnswers||{}).length;$("sumind").textContent=answered;$("sumass").textContent=SS.qs.length-answered;
}else{
$("sumMarksLabel").textContent="Marks";$("sumIndLabel").textContent="Independent";$("sumAssLabel").textContent="Assisted";
$("sumind").textContent=SS.ind;$("sumass").textContent=SS.ass;
}
const eb=$("examSummaryBreakdown");
if($("examHistorySummaryBtn"))$("examHistorySummaryBtn").hidden=!SS.exam;
if(SS.exam){
eb.hidden=false;
const pct=SS.max?Math.round(SS.marks/SS.max*100):0;
const aoHtml=Object.entries(SS.examAo||{}).sort().map(([k,v])=>`
`
}).join("");
let weakestSid=skillIds.sort((a,b)=>(masteryFor(a).score??0)-(masteryFor(b).score??0))[0];
follow.dataset.skill=weakestSid||"";
follow.hidden=!weakestSid;
}else{
ps.hidden=true;
ps.innerHTML="";
if(!SS.exam)follow.hidden=true;
}
renderReviewAiFeedbackGate();
renderPremiumDiscovery();
refreshLearningData();
document.body.classList.remove("exam-session");
show("summary")
}
let REGISTER_ACCOUNT_TYPE="student";
function setRegisterAccountType(type){
REGISTER_ACCOUNT_TYPE=type==="teacher"?"teacher":"student";
document.querySelectorAll("[data-account-type]").forEach(b=>b.classList.toggle("active",b.dataset.accountType===REGISTER_ACCOUNT_TYPE));
const createBtn=$("createAccountBtn");
if(createBtn)createBtn.textContent=REGISTER_ACCOUNT_TYPE==="teacher"?"Create teacher account":"Create student account";
if($("registerForm")&&!$("registerForm").hidden&&$("googleSsoBtn")){
$("googleSsoBtn").innerHTML=`GContinue with Google as ${REGISTER_ACCOUNT_TYPE==="teacher"?"Teacher":"Student"}`;
}
}
async function configureSso(){
try{
const d=await api("api/oauth/status.php");
[["googleSsoBtn",d.google]].forEach(([id,on])=>{const b=$(id);if(!b)return;b.disabled=!on;b.classList.toggle("sso-unavailable",!on);b.title=on?"":"Google sign-in still needs its client credentials configured on the server."})
}catch(e){["googleSsoBtn"].forEach(id=>{const b=$(id);if(b){b.disabled=true;b.classList.add("sso-unavailable")}})}
}
function cleanSsoQuery(){try{const u=new URL(location.href);["sso","sso_error"].forEach(k=>u.searchParams.delete(k));history.replaceState({},"",u.pathname+(u.search?u.search:""))}catch(e){}}
async function handleSsoReturn(){
const q=new URLSearchParams(location.search),err=q.get("sso_error"),mode=q.get("sso");
if(err){$("authMsg").hidden=false;$("authMsg").textContent=err;cleanSsoQuery();return}
if(mode==="link"){
try{const d=await api("api/oauth/pending.php");if(d.pending){$("ssoLinkPanel").hidden=false;$("loginForm").hidden=true;$("registerForm").hidden=true;$("ssoLinkText").textContent=`We found an existing A-Level Chemistry account for ${d.email}. Enter that account's password once to connect ${d.provider} without creating a duplicate account.`}else cleanSsoQuery()}catch(e){$("authMsg").hidden=false;$("authMsg").textContent=e.message}
}else if(mode==="success"||mode==="new"){
if(window.drClayAnalytics){
if(mode==="new")window.drClayAnalytics.track("sign_up",{method:"google"});
else window.drClayAnalytics.track("login",{method:"google"});
}
cleanSsoQuery()
}
}
$("googleSsoBtn").onclick=()=>{
try{const dest=requestedAppDestination();if(dest)sessionStorage.setItem("drclayPendingOpen",dest)}catch(e){}
const creating=!$("registerForm").hidden;
if(creating&&!( $("regLegalAccepted")&&$("regLegalAccepted").checked )){$("authMsg").hidden=false;$("authMsg").textContent="Please agree to the Terms of Use and acknowledge the Privacy Notice before creating an account.";return}
const q=new URLSearchParams({provider:"google"});
if(creating){q.set("register","1");q.set("legal","1");q.set("account_type","student")}
const join=pendingClassJoinCode();
if(join)q.set("join",join);
location.href="api/oauth/start.php?"+q.toString();
};
$("ssoLinkForm").onsubmit=async e=>{e.preventDefault();const btn=e.submitter;try{if(btn){btn.disabled=true;btn.textContent="Linking…"};$("ssoLinkMsg").hidden=true;await api("api/oauth/link-existing.php",{method:"POST",body:JSON.stringify({password:$("ssoLinkPassword").value})});cleanSsoQuery();$("ssoLinkPanel").hidden=true;await authCheck()}catch(err){$("ssoLinkMsg").hidden=false;$("ssoLinkMsg").textContent=err.message}finally{if(btn){btn.disabled=false;btn.textContent="Link and sign in"}}};
$("ssoLinkCancel").onclick=async()=>{try{await api("api/oauth/cancel-link.php",{method:"POST",body:"{}"})}catch(e){};$("ssoLinkPanel").hidden=true;$("loginForm").hidden=false;cleanSsoQuery()};
$("loginTab").onclick=()=>{
$("loginTab").classList.add("active");$("registerTab").classList.remove("active");
$("loginForm").hidden=false;$("registerForm").hidden=true;$("resetRequestPanel").hidden=true;$("authMsg").hidden=true;
$("googleSsoBtn").innerHTML='GContinue with Google';
};
$("registerTab").onclick=()=>{
$("registerTab").classList.add("active");$("loginTab").classList.remove("active");
$("registerForm").hidden=false;$("loginForm").hidden=true;$("resetRequestPanel").hidden=true;$("authMsg").hidden=true;
setRegisterAccountType(REGISTER_ACCOUNT_TYPE);
};
$("studentAccountType").onclick=()=>setRegisterAccountType("student");
$("teacherAccountType").onclick=()=>setRegisterAccountType("teacher");
$("forgotPasswordBtn").onclick=()=>{
$("resetRequestPanel").hidden=false;
$("resetEmail").value=$("loginEmail").value||"";
$("resetRequestMsg").hidden=true;
$("resetEmail").focus();
};
$("resetRequestCancel").onclick=()=>{$("resetRequestPanel").hidden=true};
$("resetRequestForm").onsubmit=async e=>{
e.preventDefault();
const btn=e.submitter,old=btn?btn.textContent:"";
try{
if(btn){btn.disabled=true;btn.textContent="Sending…"}
const d=await api("api/password-reset-request.php",{method:"POST",body:JSON.stringify({email:$("resetEmail").value})});
$("resetRequestMsg").hidden=false;$("resetRequestMsg").textContent=d.message||"If an account exists, a reset link has been sent.";
}catch(err){
$("resetRequestMsg").hidden=false;$("resetRequestMsg").textContent="If an account exists, a reset link has been sent. Check your inbox and spam folder.";
}finally{if(btn){btn.disabled=false;btn.textContent=old}}
};
$("loginForm").onsubmit=async e=>{e.preventDefault();const btn=e.submitter;try{if(btn){btn.disabled=true;btn.textContent="Signing in…"};$("authMsg").hidden=true;const email=$("loginEmail").value;const password=$("loginPassword").value;const remember=!!($("rememberMe")&&$("rememberMe").checked);if(remember){localStorage.setItem("drclayRememberEmail",email)}else{localStorage.removeItem("drclayRememberEmail")}const joinCode=pendingClassJoinCode();const result=await api("api/login.php",{method:"POST",body:JSON.stringify({email,password,joinCode})});if(window.drClayAnalytics)window.drClayAnalytics.track("login",{method:"email"});sessionStorage.setItem("lastInviteJoinResult",JSON.stringify(result.joinedClass||null));if(result.joinedClass&&result.joinedClass.ok){clearPendingClassJoin()}await authCheck()}catch(err){$("authMsg").hidden=false;$("authMsg").textContent=err.message}finally{if(btn){btn.disabled=false;btn.textContent="Sign in"}}};
$("registerForm").onsubmit=async e=>{e.preventDefault();const btn=e.submitter;const tokenEl=document.querySelector('#registerForm [name="cf-turnstile-response"]');const turnstileToken=tokenEl?tokenEl.value:"";if(!turnstileToken){$("authMsg").hidden=false;$("authMsg").textContent="Please complete the human verification before creating your account.";return}try{if(btn){btn.disabled=true;btn.textContent="Creating account…"};$("authMsg").hidden=true;const joinCode=pendingClassJoinCode();const result=await api("api/register.php",{method:"POST",body:JSON.stringify({firstName:$("regFirst").value,email:$("regEmail").value,password:$("regPassword").value,joinCode,accountType:"student",legalAccepted:!!($("regLegalAccepted")&&$("regLegalAccepted").checked),website:$("regWebsite")?$("regWebsite").value:"",turnstileToken})});if(window.drClayAnalytics)window.drClayAnalytics.track("sign_up",{method:"email",account_type:REGISTER_ACCOUNT_TYPE});sessionStorage.setItem("lastInviteJoinResult",JSON.stringify(result.joinedClass||null));if(result.trial&&result.trial.active)sessionStorage.setItem("drclayWelcomeTrial","1");if(result.joinedClass&&result.joinedClass.ok){clearPendingClassJoin()}await authCheck()}catch(err){$("authMsg").hidden=false;$("authMsg").textContent=err.message;try{if(window.turnstile)turnstile.reset()}catch(e){}}finally{if(btn){btn.disabled=false;btn.textContent=REGISTER_ACCOUNT_TYPE==="teacher"?"Create teacher account":"Create student account"}}};
$("logoutBtn").onclick=async()=>{await api("api/logout.php",{method:"POST",body:"{}"});CSRF_TOKEN="";USER=null;MEMBERSHIP=null;TRIAL=null;SPONSORED_AI=null;BILLING=null;TEACHER_AI_LICENSES=null;M={};COV=null;SELF_PROFILE={};STUDENT_ACTIONS=[];STUDENT_CLASSES=[];STUDENT_ASSIGNMENTS=[];STUDENT_EXAM_ASSIGNMENTS=[];TEACHER_CLASSES_ALL=[];TEACHER_CLASSES=[];TEACHER_ARCHIVED_CLASSES=[];TEACHER_OVERVIEW=null;TEACHER_ASSIGNMENTS=[];TEACHER_EXAM_ASSIGNMENTS=[];TEACHER_INSIGHTS=null;TEACHER_HELP=[];SUPPORT_THREAD=null;SUPPORT_SKILLS=[];$("userName").textContent="";$("logoutBtn").hidden=true;show("authView")};
$("homeBtn").onclick=$("dashbtn").onclick=async()=>{document.body.classList.remove("exam-session");if(USER&&["teacher","admin"].includes(USER.role)){await Promise.all([loadTeacherClassLists(),loadTeacherLicense(),loadTeacherAiLicenses()]);TEACHER_CLASS_MODE="active";renderTeacherHome();show("teacherHub")}else{await refreshLearningData();show("mainDash")}};$("back").onclick=async()=>{if(SS&&SS.exam){captureExamAnswer();if(!confirm("Leave this exam session? Your responses have not been submitted or added to progress."))return;document.body.classList.remove("exam-session");openPracticeHub();return}await refreshLearningData();if(SS&&SS.personalised)openPracticeHub();else show("mainDash")};$("again").onclick=()=>{if(SS&&SS.exam){openPracticeHub();openExamConfigurator();return}if(SS&&SS.personalised){const ids=[...new Set(SS.qs.map(q=>q.s))];buildPersonalisedPractice(SS.route,SS.route==="recommended"?[]:ids,SS.qs.length,"auto")}else start(SS.mode,SS.skill)};
$("examAiFeedbackBtn").onclick=generateExamAiFeedback;
$("followUpBtn").onclick=async()=>{const sid=$("followUpBtn").dataset.skill;if(!sid)return;await ensureTopicForSkills([sid]);await Promise.all([loadMastery(),loadAdaptiveState(),loadCoverage()]);buildPersonalisedPractice("choose",[sid],5,"auto")};$("recbtn").onclick=()=>start("practice",$("recbtn").dataset.s);document.querySelectorAll("[data-mode]").forEach(b=>b.onclick=()=>start(b.dataset.mode));
function currentTopicSummary(){
return masterySummaryFromObject(M);
}
function renderMainDashboard(){
if(USER)$("welcomeTitle").textContent="Welcome back, "+USER.firstName;
renderResumeCard();
TOPIC_SUMMARIES[CURRENT_TOPIC]=currentTopicSummary();
const y12Scores=TOPICS.filter(t=>Number(t.year)===12&&topicIsReady(t)).map(t=>TOPIC_SUMMARIES[Number(t.number)]).filter(x=>x&&x.score!==null);
const y12Score=y12Scores.length?Math.round(y12Scores.reduce((a,x)=>a+x.score,0)/y12Scores.length):null;
$("year12Mastery").textContent=y12Score===null?"—":y12Score+"%";
$("year12Label").textContent=y12Score===null?"Not assessed":`${y12Scores.length} ready topic${y12Scores.length===1?"":"s"} evidenced`;
const cur=currentTopicSummary();
$("continueTopicTitle").textContent=currentTopicTitle();
$("continueTopicText").textContent=`Topic ${CURRENT_TOPIC} is ready to use.`;
$("continueTopicBar").style.width=(cur.score||0)+"%";
$("continueTopicMeta").textContent=cur.assessed===0?"Not assessed":`${cur.assessed} of ${cur.total||S.length} skills assessed${cur.score!==null?` · ${cur.score}% mastery`:""}`;
const w=weakest();const wm=masteryFor(w.id);
$("mainRecommendedTitle").textContent=`Topic ${CURRENT_TOPIC} · ${w.name}`;
$("mainRecommendedText").textContent=wm.attempts===0
?"This area has not been assessed yet. A short practice session will begin gathering evidence."
:`${wm.score}% mastery from ${wm.attempts} recent attempt${wm.attempts===1?"":"s"}. This is currently your priority area.`;
$("mainOpenTopicBtn").textContent=`Open Topic ${CURRENT_TOPIC}`;
renderCourseTopicCards();
setCourseYear("all");
const courseSummary=$("homeCourseSummaryText");
if(courseSummary)courseSummary.textContent=`View all ${TOPICS.filter(topicIsReady).length} topics ▾`;
}
function openCurrentTopic(){dashboard();show("topicDash")}
$("mainOpenTopicBtn").onclick=openCurrentTopic;
$("mainQuickBtn").onclick=openPracticeHub;
$("recbtn").onclick=()=>start("practice",$("recbtn").dataset.s);
function setCourseYear(year){
const y12=$("year12Topics"),y13=$("year13Topics");
const all=$("allTopicsTab"),b12=$("year12Tab"),b13=$("year13Tab");
const mode=year==="all"?"all":Number(year);
const show12=mode==="all"||mode===12;
const show13=mode==="all"||mode===13;
y12.hidden=!show12;y13.hidden=!show13;
y12.style.display=show12?"grid":"none";
y13.style.display=show13?"grid":"none";
all.className=mode==="all"?"btn primary":"btn secondary";
b12.className=mode===12?"btn primary":"btn secondary";
b13.className=mode===13?"btn primary":"btn secondary";
all.setAttribute("aria-pressed",mode==="all"?"true":"false");
b12.setAttribute("aria-pressed",mode===12?"true":"false");
b13.setAttribute("aria-pressed",mode===13?"true":"false");
}
$("allTopicsTab").onclick=()=>setCourseYear("all");
$("year12Tab").onclick=()=>setCourseYear(12);
$("year13Tab").onclick=()=>setCourseYear(13);
document.querySelectorAll("#studentNav button").forEach(b=>b.onclick=async()=>{
if(b.dataset.view==="home"){await refreshLearningData();show("mainDash")}
if(b.dataset.view==="practice"){await refreshLearningData();openPracticeHub()}
if(b.dataset.view==="progress"){await refreshLearningData();show("progressHub")}
if(b.dataset.view==="support"){await openSupportHub()}
if(b.dataset.view==="exams"){await refreshLearningData();openPracticeHub();openExamConfigurator()}
if(b.dataset.view==="membership"){await openMembershipHub()}
});
$("viewCoverageBtn").onclick=async()=>{await refreshLearningData();show("progressHub")};
$("saveLeaveBtn").onclick=()=>saveSessionState(true);
async function handleResumeSavedSession(){
const btn=$("resumeBtn");if(!btn||btn.disabled)return;
const old=btn.textContent;btn.disabled=true;btn.textContent="Resuming…";
try{
// Refresh the server-side saved session first so Home never resumes stale card data.
await loadSavedSession();
if(!SAVED_SESSION){renderResumeCard();return}
await resumeSavedSession();
}catch(err){
const msg=$("mainNotice");
if(msg){msg.hidden=false;msg.textContent="Your saved session could not be resumed. "+(err.message||"Please try again.")}
}finally{btn.disabled=false;btn.textContent=old}
}
async function handleDiscardSavedSession(){
const btn=$("discardResumeBtn");if(!btn||btn.disabled)return;
const old=btn.textContent;btn.disabled=true;btn.textContent="Discarding…";
try{
if(SAVED_SESSION&&SAVED_SESSION.uid){
await api("api/practice-session.php",{method:"POST",body:JSON.stringify({action:"abandon",uid:SAVED_SESSION.uid})});
}
SAVED_SESSION=null;renderResumeCard();
}catch(err){
const msg=$("mainNotice");
if(msg){msg.hidden=false;msg.textContent="The saved session could not be discarded. "+(err.message||"Please try again.")}
}finally{btn.disabled=false;btn.textContent=old}
}
if($("resumeBtn"))$("resumeBtn").addEventListener("click",handleResumeSavedSession);
if($("discardResumeBtn"))$("discardResumeBtn").addEventListener("click",handleDiscardSavedSession);
$("practiceUncoveredBtn").onclick=()=>{
if(!COV||!COV.uncovered||!COV.uncovered.length)return;
const conceptIds=COV.uncovered.slice(0,12);
const skillIds=[...new Set(conceptIds.map(cid=>{
for(const [sid,sk] of Object.entries(COV.skills||{}))if((sk.concepts||[]).some(c=>c.id===cid))return sid;
return null
}).filter(Boolean))];
buildPersonalisedPractice("uncovered",skillIds,10,"auto",conceptIds)
};
function membershipFmtDate(v){if(!v)return "—";const d=new Date(String(v).replace(" ","T"));return isNaN(d)?"—":d.toLocaleDateString("en-GB",{day:"numeric",month:"short",year:"numeric"})}
function membershipFeatures(role,paid,sponsored){
if(role==="teacher")return paid?["Class management and assignments","Teacher analytics and reporting","Teacher AI tools","Sponsored pupil AI licences","Priority access to new teacher features"]:["Up to 5 active classes","Up to 30 pupils per class","Assignments and core analytics","Saved teacher account data","Upgrade to add sponsored pupil AI"];
return paid?["Unlimited Quick MCQ and Adaptive MCQ","Intelligent Choose, Mini Review and Full Topic Review","Reusable validated Premium question bank","Selective AI marking for responses that need judgement","Optional saved AI feedback after Full Topic Review","Premium Exam Practice and advanced exam trends","Saved progress and exam history across devices","Personalised recommendations and AI tutoring"]:["Trusted authored Chemistry practice","Choose what to practise, Mini Review and Full Topic Review","Deterministic marking with no hidden AI cost in Free reviews","Saved progress and basic mastery tracking","Saved exam results, answers and previous AI feedback remain viewable","Teacher-sponsored AI when assigned"+(sponsored?" — active":""),"10 Quick MCQs per day","Upgrade for adaptive practice, Exam Practice and advanced analysis"];
}
async function loadMembershipPage(){
try{
const [current,billing,usage]=await Promise.all([api("api/membership-current.php"),api("api/billing-status.php"),api("api/membership-usage.php")]);
MEMBERSHIP=current.membership||MEMBERSHIP;TRIAL=current.trial||TRIAL;SPONSORED_AI=current.sponsoredAi||SPONSORED_AI;BILLING=billing;
let teacherLic=null;if(USER&&["teacher","admin"].includes(USER.role)){try{teacherLic=await api("api/teacher-ai-licenses.php");TEACHER_AI_LICENSES=teacherLic}catch(e){}}
renderMembershipPage(usage,teacherLic);
}catch(err){const e=$("membershipPlanSummary");if(e)e.textContent="Membership details could not be loaded. "+(err.message||"")}
}
function renderMembershipPage(usage,teacherLic){
const m=MEMBERSHIP||{};const role=USER&&USER.role==="teacher"?"teacher":(USER&&USER.role==="admin"?"teacher":"student");const code=m.code||"";const source=m.source||"system";const trial=!!(TRIAL&&TRIAL.active);const paid=(role==="student"&&code==="premium_individual")||(role==="teacher"&&code.indexOf("teacher_pro")===0);const subscribed=paid&&source!=="trial"&&BILLING&&BILLING.subscription;const sponsored=!!(SPONSORED_AI&&SPONSORED_AI.allowed);
$("membershipHeroCard").classList.toggle("teacher",role==="teacher");$("membershipPlanIcon").textContent=role==="teacher"?"♟":"♛";$("membershipPageHeroPlan").textContent=m.name||code||"Free";$("membershipPageHeroSub").textContent=trial?"trial active":(paid?"active membership":"free account");$("membershipPlanName").textContent=trial?(m.name+" Trial"):(m.name||"Free account");
$("membershipPlanSummary").textContent=role==="teacher"?(paid?"Teacher tools, analytics and pupil AI licensing are available on this account.":"Core teacher class and assignment tools are included free."):(paid?"Your Premium learning tools and AI support are active.":(sponsored?"You are on Free Individual with AI access provided by your teacher.":"Core A-Level Chemistry learning remains available on the free plan."));
$("membershipStatusChip").textContent=trial?"Trial active":(paid?"Active":"Free");$("membershipStatus").textContent=BILLING&&BILLING.subscription&&BILLING.subscription.cancelAtPeriodEnd?"Cancels at period end":(trial?"Trial active":(paid?"Active":"Free account"));
const sub=BILLING&&BILLING.subscription;$("membershipNextDate").textContent=trial?membershipFmtDate(TRIAL.expiresAt):(sub?membershipFmtDate(sub.currentPeriodEnd):"No renewal date");$("membershipAccess").textContent=role==="teacher"?(paid?"Teacher Pro":"Teacher Free"):(sponsored&&!paid?"Free + class AI":(paid?"Premium":"Free"));
let price="Free",priceNote="";if(role==="student"&&paid){price=trial?"Free trial":"£4.99";priceNote=trial?`${TRIAL.daysRemaining||1} day${(TRIAL.daysRemaining||1)==1?"":"s"} remaining`:"per month"}else if(role==="teacher"&&paid){price=trial?"Free trial":"Teacher Pro";priceNote=trial?`${TRIAL.daysRemaining||1} days remaining`:"current plan"}$("membershipPrice").textContent=price;$("membershipPriceNote").textContent=priceNote;
$("membershipCancelAction").hidden=!sub;$("membershipCancelNote").hidden=!sub;$("membershipBillingAction").hidden=!sub;$("membershipPrimaryAction").textContent=sub?"Manage subscription":(paid?"View plan options":(trial?"View plan options":"Upgrade options"));
$("membershipQuestionsMonth").textContent=String(usage.questionsMonth||0);$("membershipAiMonth").textContent=String(usage.aiRequestsMonth||0);$("membershipAiNote").textContent=usage.aiRequestsMonth?"AI requests":"no AI requests yet";$("membershipThirdKpiLabel").textContent=role==="teacher"?"ACTIVE PUPILS":"ACTIVE DAYS";$("membershipThirdKpi").textContent=String(role==="teacher"?(usage.activePupils||0):(usage.activeDaysMonth||0));$("membershipThirdKpiNote").textContent=role==="teacher"?"across your classes":"this month";
const feats=membershipFeatures(role,paid,sponsored);$("membershipFeatureList").innerHTML=feats.map(x=>`
✓${esc(x)}
`).join("");$("membershipIncludedIntro").textContent=`${m.name||"Your plan"} currently includes:`;$("membershipTeacherCompare").hidden=role!=="teacher";
const licBox=$("membershipTeacherLicences");licBox.hidden=role!=="teacher";if(role==="teacher"){const pool=teacherLic&&teacherLic.pool?teacherLic.pool:{limit:0,assigned:0,remaining:0};$("membershipLicenceAssigned").textContent=pool.assigned||0;$("membershipLicenceAvailable").textContent=pool.remaining||0;$("membershipLicenceTotal").textContent=pool.limit||0;$("membershipTeacherLicenceText").textContent=pool.enabled?`${pool.assigned||0} of ${pool.limit||0} pupil AI licences are currently assigned.`:"Teacher Pro is required before pupil AI licences can be assigned.";$("membershipTeacherLicenceBar").style.width=pool.limit?`${Math.min(100,Math.round((pool.assigned/pool.limit)*100))}%`:"0%"}
}
let FEEDBACK_MESSAGES_READY=true;
function feedbackStatusLabel(v){return v==="new"?"New":(v==="resolved"?"Resolved":"In progress")}
function feedbackWho(m){const name=(m.first_name||"").trim();return name||m.email||(m.sender_role==="admin"?"Dr Clay team":"User")}
function feedbackThreadHtml(ticket,adminView){const replies=Array.isArray(ticket.messages)?ticket.messages:[];const root=`
`).join("")}
async function openMembershipHub(){await loadMembershipPage();show("membershipHub");await Promise.all([loadMyFeedback(),loadPrivacyData()])}
async function membershipOpenPortal(){try{const d=await api("api/billing-portal.php",{method:"POST",body:"{}"});if(d.url)location.href=d.url;else throw new Error("Billing portal unavailable.")}catch(e){alert(e.message||"Billing portal unavailable.")}}
async function loadPrivacyData(){
const status=$("privacyDataStatus");if(!status)return;
try{
const d=await api("api/privacy-data.php?action=summary");
const u=d.user||{};$("privacyAccountName").textContent=(u.first_name||"Account")+(u.role?" · "+u.role:"");$("privacyAccountEmail").textContent=u.email||"—";
const req=d.deletionRequest||null,pending=req&&["pending","reviewing"].includes(String(req.status||""));
$("privacyDeleteRequestBtn").hidden=!!pending;$("privacyDeleteCancelBtn").hidden=!pending;
status.textContent=pending?"Account deletion requested on "+membershipFmtDate(req.requested_at)+". Your account remains active while the request is checked and processed.":"Your privacy controls are ready. The download is a self-service copy of core account and learning data.";
}catch(e){status.textContent=e.message||"Privacy controls could not be loaded."}
}
async function downloadPrivacyData(){
const btn=$("privacyDownloadBtn"),status=$("privacyDataStatus"),old=btn.textContent;btn.disabled=true;btn.textContent="Preparing…";
try{const d=await api("api/privacy-data.php?action=export");const blob=new Blob([JSON.stringify(d,null,2)],{type:"application/json"});const url=URL.createObjectURL(blob);const a=document.createElement("a");a.href=url;a.download="drclay-my-data-"+new Date().toISOString().slice(0,10)+".json";document.body.appendChild(a);a.click();a.remove();URL.revokeObjectURL(url);status.textContent="Your core account and learning data export has been downloaded."}catch(e){status.textContent=e.message||"Your data export could not be prepared."}finally{btn.disabled=false;btn.textContent=old}
}
async function requestAccountDeletion(){
if(!confirm("Request deletion of your Dr Clay account and associated personal data? Your account will stay active while the request is verified and processed."))return;
const btn=$("privacyDeleteRequestBtn"),status=$("privacyDataStatus");btn.disabled=true;
try{const d=await api("api/privacy-data.php",{method:"POST",body:JSON.stringify({action:"request_deletion"})});status.textContent=d.message||"Deletion requested.";await loadPrivacyData();await loadMyFeedback()}catch(e){status.textContent=e.message||"The deletion request could not be sent."}finally{btn.disabled=false}
}
async function cancelAccountDeletion(){
const btn=$("privacyDeleteCancelBtn"),status=$("privacyDataStatus");btn.disabled=true;
try{await api("api/privacy-data.php",{method:"POST",body:JSON.stringify({action:"cancel_deletion"})});status.textContent="Your deletion request has been cancelled.";await loadPrivacyData();await loadMyFeedback()}catch(e){status.textContent=e.message||"The deletion request could not be cancelled."}finally{btn.disabled=false}
}
if($("privacyCookieSettingsBtn"))$("privacyCookieSettingsBtn").onclick=()=>{if(window.drClayAnalytics&&window.drClayAnalytics.openSettings)window.drClayAnalytics.openSettings()};
if($("privacyDownloadBtn"))$("privacyDownloadBtn").onclick=downloadPrivacyData;
if($("privacyDeleteRequestBtn"))$("privacyDeleteRequestBtn").onclick=requestAccountDeletion;
if($("privacyDeleteCancelBtn"))$("privacyDeleteCancelBtn").onclick=cancelAccountDeletion;
async function submitMembershipFeedback(){const btn=$("membershipFeedbackSend"),msg=$("membershipFeedbackMessage").value.trim(),type=$("membershipFeedbackType").value,out=$("membershipFeedbackMsg");if(!msg){out.hidden=false;out.className="msg";out.textContent="Please enter a message first.";return}btn.disabled=true;try{await api("api/feedback.php",{method:"POST",body:JSON.stringify({type,message:msg,page:"membership"})});$("membershipFeedbackMessage").value="";out.hidden=false;out.className="membership-feedback-success";out.textContent="Thanks — your support request has been sent. Any reply will appear below.";await loadMyFeedback()}catch(e){out.hidden=false;out.className="msg";out.textContent=e.message||"Feedback could not be sent."}finally{btn.disabled=false}}
function myFeedbackHtml(rows){if(!rows.length)return '
`:"")+myFeedbackHtml(d.feedback||[]);box.querySelectorAll("[data-user-reply]").forEach(btn=>btn.onclick=async()=>{const id=Number(btn.dataset.userReply),ta=box.querySelector(`[data-user-reply-text="${id}"]`),message=ta?ta.value.trim():"";if(!message)return;btn.disabled=true;try{await api("api/feedback.php",{method:"POST",body:JSON.stringify({action:"reply",ticketId:id,message})});await loadMyFeedback()}catch(e){alert(e.message||"Your reply could not be sent.")}finally{btn.disabled=false}})}catch(e){box.innerHTML=`
${esc(e.message||"Support requests could not be loaded.")}
`}}
function feedbackAdminHtml(rows){if(!rows.length)return '
`:"")+feedbackAdminHtml(d.feedback||[]);box.querySelectorAll("[data-feedback-id]").forEach(b=>b.onclick=async()=>{await api("api/feedback.php",{method:"PATCH",body:JSON.stringify({id:Number(b.dataset.feedbackId),status:b.dataset.feedbackStatus})});await loadFeedbackAdmin()});box.querySelectorAll("[data-admin-reply]").forEach(btn=>btn.onclick=async()=>{const id=Number(btn.dataset.adminReply),ta=box.querySelector(`[data-admin-reply-text="${id}"]`),message=ta?ta.value.trim():"";if(!message)return;btn.disabled=true;try{await api("api/feedback.php",{method:"POST",body:JSON.stringify({action:"reply",ticketId:id,message})});await loadFeedbackAdmin()}catch(e){alert(e.message||"Reply could not be sent.")}finally{btn.disabled=false}})}catch(e){box.innerHTML=`
${esc(e.message||"Feedback could not be loaded.")}
`}}
$("studentMembershipActionBtn").onclick=openMembershipHub;
$("teacherMembershipOpenBtn").onclick=openMembershipHub;
$("membershipPrimaryAction").onclick=()=>{if(BILLING&&BILLING.subscription){membershipOpenPortal();return}if(USER&&["teacher","admin"].includes(USER.role)){show("teacherHub");openTeacherPlanSelector();return}show("mainDash");openPremiumExplore()};
$("membershipBillingAction").onclick=membershipOpenPortal;
$("membershipCancelAction").onclick=membershipOpenPortal;
$("membershipFeedbackSend").onclick=submitMembershipFeedback;
if($("premiumDiscoveryBtn"))$("premiumDiscoveryBtn").onclick=openPremiumExplore;
if($("premiumSummaryBtn"))$("premiumSummaryBtn").onclick=openPremiumExplore;
if($("reviewAiFeedbackBtn"))$("reviewAiFeedbackBtn").onclick=generatePracticeReviewFeedback;
$("closePremiumPanelBtn").onclick=()=>{$("premiumExplorePanel").hidden=true};
$("premiumSubscribeBtn").onclick=()=>{
if($("premiumSubscribeBtn").dataset.billingAction==="manage")openBillingPortal();
else startStripeCheckout("premium_individual");
};
$("homeSupportBtn").onclick=async e=>{
const btn=e.currentTarget,old=btn.textContent;
btn.disabled=true;btn.textContent="Opening…";
try{await openSupportHub()}
finally{btn.disabled=false;btn.textContent=old}
};
document.querySelectorAll("[data-support-prompt]").forEach(b=>b.onclick=()=>{$("supportInput").value=b.dataset.supportPrompt;$("supportInput").focus()});
if($("tutorPremiumBtn"))$("tutorPremiumBtn").onclick=()=>{show("membershipHub");renderMembershipPage();};
$("sendSupportBtn").onclick=sendSupportMessage;
$("supportInput").onkeydown=e=>{if(e.key==="Enter"&&!e.shiftKey){e.preventDefault();sendSupportMessage()}};
$("supportPracticeBtn").onclick=async()=>{if(!SUPPORT_SKILLS.length)return;await ensureTopicForSkills(SUPPORT_SKILLS);await Promise.all([loadMastery(),loadAdaptiveState(),loadCoverage()]);buildPersonalisedPractice("choose",SUPPORT_SKILLS,5,"auto")};
$("askTeacherChoice").onclick=()=>{$("askTeacherPanel").hidden=false;$("teacherHelpMsg").hidden=true;$("askTeacherPanel").scrollIntoView({behavior:"smooth",block:"start"})};
$("closeAskTeacherBtn").onclick=()=>{$("askTeacherPanel").hidden=true};
$("sendTeacherHelpBtn").onclick=async()=>{
const msg=$("teacherHelpMsg");msg.hidden=true;
if(!$("helpClassSelect").value||!$("helpMessage").value.trim()){msg.hidden=false;msg.textContent="Choose your class and describe what you need help with.";return}
const btn=$("sendTeacherHelpBtn"),old=btn.textContent;btn.disabled=true;btn.textContent="Sending…";
try{
const d=await api("api/teacher-help.php",{method:"POST",body:JSON.stringify({action:"send",classUid:$("helpClassSelect").value,subject:$("helpSubject").value,message:$("helpMessage").value,includeContext:$("helpIncludeContext").checked})});
msg.hidden=false;msg.textContent="Your question is now in your teacher's Help Inbox.";
$("helpSubject").value="";$("helpMessage").value="";
renderTeacherReplies(await loadStudentTeacherReplies());
$("askTeacherPanel").hidden=true;
await openStudentTeacherThread(d.uid)
}catch(err){msg.hidden=false;msg.textContent=err.message}
finally{btn.disabled=false;btn.textContent=old}
};
$("teacherTopicSelect").onchange=async e=>{
const n=Number(e.target.value)||CURRENT_TOPIC;
if(n===CURRENT_TOPIC)return;
showGlobalLoading("Loading class topic…","Refreshing class mastery, recommendations and assignment areas for the selected Chemistry topic.");
try{
await loadTopicContent(n);
buildAssignmentSkillOptions();
if(SELECTED_CLASS){
const d=await loadTeacherOverview(SELECTED_CLASS);
await Promise.all([loadTeacherAssignments(SELECTED_CLASS),loadTeacherInsights(SELECTED_CLASS),loadTeacherHelp(SELECTED_CLASS),loadTeacherAiLicenses(SELECTED_CLASS)]);
renderTeacherClassData(d);
renderTeacherV28();
}
}catch(err){
alert(err.message||"This topic could not be loaded.");
renderTeacherTopicSelect();
}finally{hideGlobalLoading()}
};
$("newAssignmentBtn").onclick=()=>{$("assignmentPanel").hidden=false;$("assignmentMsg").hidden=true;buildAssignmentSkillOptions();$("assignmentPanel").scrollIntoView({behavior:"smooth",block:"start"})};
$("closeAssignmentBtn").onclick=()=>{$("assignmentPanel").hidden=true};
$("createAssignmentBtn").onclick=async()=>{
if(!SELECTED_CLASS)return;
const skills=[...document.querySelectorAll("#assignmentSkills input:checked")].map(x=>x.value);
const msg=$("assignmentMsg");msg.hidden=true;
if(!$("assignmentTitle").value.trim()||!skills.length){msg.hidden=false;msg.textContent="Add a title and select at least one curriculum area.";return}
const btn=$("createAssignmentBtn"),old=btn.textContent;btn.disabled=true;btn.textContent="Creating…";
try{
const d=await api("api/assignments.php",{method:"POST",body:JSON.stringify({action:"create",classUid:SELECTED_CLASS,title:$("assignmentTitle").value,instructions:$("assignmentInstructions").value,assignmentType:$("assignmentType").value,skills,target:+$("assignmentTarget").value,dueDate:$("assignmentDue").value})});
msg.hidden=false;msg.textContent=`Assignment created for ${d.pupils} pupil${d.pupils===1?"":"s"}.`;
$("assignmentTitle").value="";$("assignmentInstructions").value="";
await Promise.all([loadTeacherAssignments(SELECTED_CLASS),loadTeacherInsights(SELECTED_CLASS)]);renderTeacherV28()
}catch(err){msg.hidden=false;msg.textContent=err.message}
finally{btn.disabled=false;btn.textContent=old}
};
$("newExamAssignmentBtn").onclick=()=>{renderExamAssignmentTopics();$("teacherExamAssignmentPanel").hidden=false;$("examAssignmentMsg").hidden=true;resetCommonPaperPreview();applyTeacherExamAssignmentMode();applyTeacherExamAssignmentKind();$("teacherExamAssignmentPanel").scrollIntoView({behavior:"smooth",block:"start"})};
$("closeExamAssignmentBtn").onclick=()=>{$("teacherExamAssignmentPanel").hidden=true};
$("viewExamAssignmentsBtn").onclick=async()=>{
const panel=$("teacherExamManagementPanel"),btn=$("viewExamAssignmentsBtn");
panel.hidden=false;btn.disabled=true;const old=btn.textContent;btn.textContent="Loading…";
try{
if(SELECTED_CLASS)await loadTeacherExamAssignments(SELECTED_CLASS);
renderTeacherExamAssignments();
panel.scrollIntoView({behavior:"smooth",block:"nearest"});
}catch(err){
$("teacherExamAssignmentList").innerHTML=`
${esc(err.message||"Assessments could not be loaded.")}
`;
}finally{btn.disabled=false;btn.textContent=old}
};
$("closeExamManagementBtn").onclick=()=>{$("teacherExamManagementPanel").hidden=true};
$("examTopicsSelectAll").onclick=()=>{document.querySelectorAll("#examAssignmentTopics .exam-topic-tile:not([hidden]) input").forEach(x=>{x.checked=true;x.closest(".exam-topic-tile").classList.add("selected")});updateExamBuilderSummary()};
$("examTopicsClear").onclick=()=>{document.querySelectorAll("#examAssignmentTopics input").forEach(x=>{x.checked=false;x.closest(".exam-topic-tile").classList.remove("selected")});updateExamBuilderSummary()};
document.querySelectorAll("[data-exam-topic-filter]").forEach(b=>b.onclick=()=>applyExamTopicFilter(b.dataset.examTopicFilter));
["examAssignmentTitle","examAssignmentMarks","examAssignmentDifficulty","examAssignmentAvailable","examAssignmentDue","examAssignmentInstructions"].forEach(id=>{const el=$(id);if(el)el.addEventListener("input",updateExamBuilderSummary)});
$("examAssignmentMode").onchange=applyTeacherExamAssignmentMode;document.querySelectorAll('input[name="examAssignmentKind"]').forEach(x=>x.onchange=applyTeacherExamAssignmentKind);$("generateCommonPaperBtn").onclick=generateTeacherCommonPaper;$("regenerateCommonPaperBtn").onclick=generateTeacherCommonPaper;
$("createExamAssignmentBtn").onclick=async()=>{
if(!SELECTED_CLASS)return;const msg=$("examAssignmentMsg");msg.hidden=true;const spec=teacherAssessmentSpec(),kind=currentExamAssignmentKind();
if(!$("examAssignmentTitle").value.trim()){msg.hidden=false;msg.textContent="Add an assessment title.";return}if(spec.paperMode==="custom"&&!spec.topics.length){msg.hidden=false;msg.textContent="Choose at least one Chemistry topic.";return}if(kind==="common"&&!COMMON_PAPER_PREVIEW){msg.hidden=false;msg.textContent="Generate and preview the common paper before assigning it.";return}
const btn=$("createExamAssignmentBtn"),old=btn.textContent;btn.disabled=true;btn.textContent="Assigning…";
try{const d=await api("api/exam-assignments.php",{method:"POST",body:JSON.stringify({action:"create",classUid:SELECTED_CLASS,title:$("examAssignmentTitle").value,instructions:$("examAssignmentInstructions").value,paperMode:spec.paperMode,difficulty:spec.difficulty,targetMarks:kind==="common"?COMMON_PAPER_PREVIEW.definition.totalMarks:spec.targetMarks,topics:spec.topics,assignmentKind:kind,commonPaper:kind==="common"?COMMON_PAPER_PREVIEW.definition:null,availableFrom:$("examAssignmentAvailable").value,dueDate:$("examAssignmentDue").value})});msg.hidden=false;msg.textContent=`${kind==="common"?"Locked common paper":"Assessment"} assigned to ${d.pupils} pupil${d.pupils===1?"":"s"}.`;$("examAssignmentTitle").value="";$("examAssignmentInstructions").value="";$("examAssignmentAvailable").value="";$("examAssignmentDue").value="";resetCommonPaperPreview();await loadTeacherExamAssignments(SELECTED_CLASS);renderTeacherExamAssignments()}catch(e){msg.hidden=false;msg.textContent=e.message||"The assessment could not be assigned."}finally{btn.disabled=false;btn.textContent=old}
};
const TEACHER_PRO_TIERS={
teacher_pro_10:{rank:10,name:"Teacher Pro 10",price:"£9.99/month"},
teacher_pro_30:{rank:30,name:"Teacher Pro 30",price:"£14.99/month"},
teacher_pro_60:{rank:60,name:"Teacher Pro 60",price:"£24.99/month"},
teacher_pro_100:{rank:100,name:"Teacher Pro 100",price:"£34.99/month"},
teacher_pro_150:{rank:150,name:"Teacher Pro 150",price:"£44.99/month"}
};
async function loadBillingStatus(){
if(!USER)return null;
try{
const d=await api("api/billing-status.php");
BILLING=d;
return d;
}catch(e){
console.warn("Billing status unavailable",e);
BILLING=null;
return null;
}
}
function teacherPlanButtonState(btn,currentCode,cancelled){
const code=btn.dataset.proPlan;
const info=TEACHER_PRO_TIERS[code];
const current=TEACHER_PRO_TIERS[currentCode];
btn.classList.remove("current-plan","scheduled-plan");
let action=btn.querySelector(".plan-action");
if(!action){
action=document.createElement("em");
action.className="plan-action";
btn.append(action);
}
if(!current){
action.textContent="Choose plan";
return;
}
if(code===currentCode){
btn.classList.add("current-plan");
action.textContent=cancelled?"Continue this plan":"Current plan";
}else if(info.rank>current.rank){
action.textContent="Upgrade now";
}else{
action.textContent="Change at renewal";
}
}
async function openTeacherPlanSelector(){
$("teacherProPlansPanel").hidden=false;
$("teacherProPlansPanel").scrollIntoView({behavior:"smooth",block:"start"});
const b=await loadBillingStatus();
const currentCode=b&&b.teacherPlan?b.teacherPlan.currentCode:
(MEMBERSHIP&&String(MEMBERSHIP.code||"").startsWith("teacher_pro_")?MEMBERSHIP.code:null);
const cancelled=!!(b&&b.teacherPlan&&b.teacherPlan.cancelAtPeriodEnd);
document.querySelectorAll("[data-pro-plan]").forEach(btn=>{
teacherPlanButtonState(btn,currentCode,cancelled);
});
const note=$("teacherPlanSwitchNote");
if(note){
if(currentCode && TEACHER_PRO_TIERS[currentCode]){
const end=b&&b.teacherPlan&&b.teacherPlan.currentPeriodEnd?friendlyDate(b.teacherPlan.currentPeriodEnd):"the end of your billing period";
note.textContent=cancelled
?`${TEACHER_PRO_TIERS[currentCode].name} is currently scheduled to end on ${end}. Choose the same plan to continue it, a higher tier to upgrade immediately, or a lower tier to change at renewal.`
:"Upgrades take effect immediately with Stripe proration. Downgrades take effect at your next renewal.";
}else{
note.textContent="Choose the AI licence pool that suits your classes.";
}
}
}
async function changeTeacherPlan(targetCode){
const b=await loadBillingStatus();
const hasPaid=!!(b&&b.teacherPlan&&b.teacherPlan.currentCode);
if(!hasPaid){
return startStripeCheckout(targetCode);
}
const currentCode=b.teacherPlan.currentCode;
const current=TEACHER_PRO_TIERS[currentCode];
const target=TEACHER_PRO_TIERS[targetCode];
if(!current||!target)return startStripeCheckout(targetCode);
let message="";
if(targetCode===currentCode){
message=b.teacherPlan.cancelAtPeriodEnd
?`Continue ${current.name}? This will remove the scheduled cancellation.`
:`You are already on ${current.name}.`;
if(!b.teacherPlan.cancelAtPeriodEnd){alert(message);return}
}else if(target.rank>current.rank){
message=`Upgrade from ${current.name} to ${target.name} now?\n\nStripe will apply the new AI licence allowance immediately and calculate any prorated charge.`;
}else{
message=`Change from ${current.name} to ${target.name} at your next renewal?\n\nYou will keep your current ${current.rank}-licence allowance until the end of the paid billing period.`;
}
if(!confirm(message))return;
try{
showGlobalLoading("Updating Teacher Pro…","Updating your Stripe subscription and AI licence allowance.");
const d=await api("api/billing-change-plan.php",{
method:"POST",
body:JSON.stringify({membershipCode:targetCode})
});
MEMBERSHIP=d.membership||MEMBERSHIP;
await Promise.all([loadTeacherLicense(),loadTeacherAiLicenses(),loadBillingStatus()]);
renderTeacherHome();
await openTeacherPlanSelector();
alert(d.message||"Teacher Pro plan updated.");
}catch(err){
alert(err.message||"Teacher Pro plan could not be changed.");
}finally{
hideGlobalLoading();
}
}
async function startStripeCheckout(membershipCode){
try{
showGlobalLoading("Opening secure checkout…","Preparing your Stripe subscription checkout.");
const d=await api("api/billing-checkout.php",{
method:"POST",
body:JSON.stringify({membershipCode})
});
location.href=d.url;
}catch(err){
alert(err.message||"Checkout could not be started.");
hideGlobalLoading();
}
}
async function openBillingPortal(){
try{
showGlobalLoading("Opening billing portal…","Loading your subscription management page.");
const d=await api("api/billing-portal.php",{method:"POST",body:"{}"});
location.href=d.url;
}catch(err){
alert(err.message||"Subscription management could not be opened.");
hideGlobalLoading();
}
}
function cleanBillingQuery(){
try{
const u=new URL(location.href);
["billing","session_id"].forEach(k=>u.searchParams.delete(k));
history.replaceState({},"",u.pathname+(u.search?u.search:""));
}catch(e){}
}
async function handleBillingReturn(){
const q=new URLSearchParams(location.search);
const mode=q.get("billing");
if(mode==="cancelled"){
if(USER){
const box=$("billingReturnMsg");
if(box){
box.className="billing-cancelled";
box.textContent="Checkout was cancelled. Your existing membership has not changed.";
box.hidden=false;
}
}
cleanBillingQuery();
return;
}
if(mode!=="success" || !USER)return;
const sessionId=q.get("session_id")||"";
if(!sessionId)return;
try{
showGlobalLoading("Activating your subscription…","Confirming your Stripe payment and updating your membership.");
const d=await api("api/billing-complete.php?session_id="+encodeURIComponent(sessionId));
MEMBERSHIP=d.membership||MEMBERSHIP;
if(window.drClayAnalytics)window.drClayAnalytics.track("subscription_started",{account_type:USER.role,membership_code:(MEMBERSHIP&&MEMBERSHIP.code)||"paid"});
if(USER.role==="student"){
await loadCurrentMembership();
renderStudentMembership();
}else if(["teacher","admin"].includes(USER.role)){
await Promise.all([loadTeacherLicense(),loadTeacherAiLicenses(),loadBillingStatus()]);
}
const box=$("billingReturnMsg");
if(box){
box.className="billing-success";
box.textContent="Subscription activated successfully.";
box.hidden=false;
}
}catch(err){
const box=$("billingReturnMsg");
if(box){
box.className="billing-cancelled";
box.textContent=err.message||"Your payment completed, but the subscription is still updating. Refresh shortly.";
box.hidden=false;
}
}finally{
hideGlobalLoading();
cleanBillingQuery();
}
}
async function startMembershipTrial(kind){
const label=kind==="teacher"?"7-day Teacher Pro trial":"3-day Premium trial";
if(!confirm(`Start your ${label} now? The trial begins immediately and can only be used once on this account.`))return;
try{
showGlobalLoading("Starting your free trial…","Unlocking your AI-powered membership features.");
const d=await api("api/membership-trial.php",{method:"POST",body:JSON.stringify({action:"start"})});
MEMBERSHIP=d.membership||MEMBERSHIP;
TRIAL=d.trial||TRIAL;
if(window.drClayAnalytics)window.drClayAnalytics.track("trial_started",{account_type:kind,trial_type:kind==="teacher"?"teacher_pro_7_day":"premium_3_day"});
if(kind==="teacher"){
await Promise.all([loadTeacherLicense(),loadTeacherClassLists(),loadTeacherAiLicenses()]);
renderTeacherHome();
}else{
await loadCurrentMembership();
renderStudentMembership();
}
alert("Your free trial is now active.");
}catch(err){
alert(err.message||"The free trial could not be started.");
}finally{
hideGlobalLoading();
}
}
$("startStudentTrialBtn").onclick=()=>startMembershipTrial("student");
$("startTeacherTrialBtn").onclick=()=>startMembershipTrial("teacher");
$("upgradeLicenseBtn").onclick=()=>openTeacherPlanSelector();
$("closeTeacherProPlansBtn").onclick=()=>{$("teacherProPlansPanel").hidden=true};
$("teacherManageBillingBtn").onclick=()=>openBillingPortal();
document.querySelectorAll("[data-pro-plan]").forEach(btn=>{
btn.onclick=()=>changeTeacherPlan(btn.dataset.proPlan);
});
$("copyClassInviteBtn").onclick=async()=>{
if(!SELECTED_JOIN_CODE)return;
const url=location.origin+"/app/join/?code="+encodeURIComponent(SELECTED_JOIN_CODE);
try{
await navigator.clipboard.writeText(url);
$("inviteCopyStatus").textContent="Copied";
setTimeout(()=>{$("inviteCopyStatus").textContent=""},1800);
}catch(e){
window.prompt("Copy this class invite link:",url);
}
};
$("copyClassEmailBtn").onclick=async()=>{
if(!SELECTED_JOIN_CODE)return;
const url=location.origin+"/app/join/?code="+encodeURIComponent(SELECTED_JOIN_CODE);
const teacherName=(USER&&USER.firstName)?USER.firstName:"";
const yearText=SELECTED_CLASS_YEAR?SELECTED_CLASS_YEAR:"";
const plainText=
`Hi,
You've been invited to join ${SELECTED_CLASS_NAME} on Dr Clay's A-Level Chemistry.
Join the Chemistry class:
${url}
Class code: ${SELECTED_JOIN_CODE}${yearText?`\nAcademic year: ${yearText}`:""}
Sign in with Google or your existing Dr Clay's A-Level Chemistry account. If you're new, you can create an account when you sign in.
Once you've joined, your teacher can set work and use your progress to help identify what you should practise next.
Best wishes${teacherName?`,\n${teacherName}`:""}`;
const esc=s=>String(s??"").replace(/[&<>"']/g,c=>({"&":"&","<":"<",">":">",'"':""","'":"'"}[c]));
const htmlText=
`
Hi,
You've been invited to join ${esc(SELECTED_CLASS_NAME)} on Dr Clay's A-Level Chemistry.