(() => {
'use strict';
const STORAGE_KEY = 'study-pal:v1';
const SETTINGS_KEY = 'study-pal:settings:v1';
const DEFAULT_SETTINGS = {
apiKey: '',
model: 'gpt-5-mini',
apiUrl: 'https://api.openai.com/v1/responses',
systemPrompt: 'You are a patient technical tutor. Use clear Markdown and LaTeX where useful. Build on the conversation context and explain assumptions.'
};
const $ = (selector, root = document) => root.querySelector(selector);
const els = {
welcome: $('#welcome'), conversation: $('#conversation'), composer: $('#composer'),
prompt: $('#prompt'), send: $('#send'), tree: $('#tree'), mapEmpty: $('#map-empty'),
nodeCount: $('#node-count'), branchCount: $('#branch-count'), branchContext: $('#branch-context'),
branchLabel: $('#branch-label'), selectionMenu: $('#selection-menu'), selectionPreview: $('#selection-preview'),
selectionAction: $('#selection-action'), selectionCustom: $('#selection-custom'), settings: $('#settings-dialog'),
apiKey: $('#api-key'), model: $('#model'), apiUrl: $('#api-url'), systemPrompt: $('#system-prompt'),
keyStatus: $('#key-status'), toast: $('#toast')
};
let settings = loadJSON(SETTINGS_KEY, DEFAULT_SETTINGS);
let state = normalizeState(loadJSON(STORAGE_KEY, { nodes: [], activeId: null }));
let activeRequest = null;
let selectedText = null;
let saveTimer = 0;
let toastTimer = 0;
function loadJSON(key, fallback) {
try { return { ...fallback, ...JSON.parse(localStorage.getItem(key) || '{}') }; }
catch { return { ...fallback }; }
}
function normalizeState(value) {
const nodes = Array.isArray(value.nodes) ? value.nodes.filter(n => n && n.id && n.question).map(node => {
if (node.status !== 'loading') return node;
return { ...node, status: 'error', error: 'The page was closed before this response finished.' };
}) : [];
const activeId = nodes.some(n => n.id === value.activeId) ? value.activeId : (nodes.at(-1)?.id || null);
return { nodes, activeId };
}
function persistSoon() {
clearTimeout(saveTimer);
saveTimer = setTimeout(() => {
try { localStorage.setItem(STORAGE_KEY, JSON.stringify(state)); }
catch { showToast('Browser storage is full — this map could not be saved'); }
}, 180);
}
function nodeById(id) { return state.nodes.find(node => node.id === id); }
function pathTo(id) {
const path = [];
const seen = new Set();
let node = nodeById(id);
while (node && !seen.has(node.id)) {
seen.add(node.id);
path.push(node);
node = nodeById(node.parentId);
}
return path.reverse();
}
function childrenOf(id) { return state.nodes.filter(node => node.parentId === id); }
function uid() {
return globalThis.crypto?.randomUUID?.() || `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
}
function escapeHTML(value = '') {
return value.replace(/[&<>'"]/g, char => ({ '&':'&', '<':'<', '>':'>', "'":''', '"':'"' })[char]);
}
function inlineMarkdown(text) {
let output = escapeHTML(text);
output = output.replace(/`([^`]+)`/g, '$1');
output = output.replace(/\*\*([^*]+)\*\*/g, '$1');
output = output.replace(/(?$1');
output = output.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, '$1');
return output;
}
function renderMath(source, displayMode) {
if (!globalThis.katex) return `${escapeHTML(source)}`;
try { return katex.renderToString(source, { displayMode, throwOnError: false, strict: false, trust: false }); }
catch { return `${escapeHTML(source)}`; }
}
function markdown(source = '') {
const stash = [];
const token = html => `\u0000${stash.push(html) - 1}\u0000`;
let text = source.replace(/\r\n?/g, '\n');
text = text.replace(/```([\w+-]*)\n([\s\S]*?)```/g, (_, lang, code) => token(`
${escapeHTML(code.trimEnd())}
`));
text = text.replace(/\$\$([\s\S]*?)\$\$/g, (_, formula) => token(renderMath(formula.trim(), true)));
text = text.replace(/\\\[([\s\S]*?)\\\]/g, (_, formula) => token(renderMath(formula.trim(), true)));
text = text.replace(/\\\((.*?)\\\)/g, (_, formula) => token(renderMath(formula.trim(), false)));
text = text.replace(/(? token(renderMath(formula.trim(), false)));
const lines = text.split('\n');
const html = [];
let paragraph = [];
let list = null;
const flushParagraph = () => {
if (paragraph.length) html.push(`${inlineMarkdown(paragraph.join('\n')).replace(/\n/g, '
')}
`);
paragraph = [];
};
const closeList = () => { if (list) html.push(`${list}>`); list = null; };
for (const line of lines) {
const heading = line.match(/^(#{1,3})\s+(.+)/);
const bullet = line.match(/^\s*[-*+]\s+(.+)/);
const numbered = line.match(/^\s*\d+[.)]\s+(.+)/);
const quote = line.match(/^>\s?(.*)/);
const blockToken = line.match(/^\u0000(\d+)\u0000$/);
if (blockToken) { flushParagraph(); closeList(); html.push(stash[Number(blockToken[1])]); }
else if (heading) { flushParagraph(); closeList(); const level = heading[1].length; html.push(`${inlineMarkdown(heading[2])}`); }
else if (bullet || numbered) {
flushParagraph();
const wanted = bullet ? 'ul' : 'ol';
if (list !== wanted) { closeList(); html.push(`<${wanted}>`); list = wanted; }
html.push(`${inlineMarkdown((bullet || numbered)[1])}`);
} else if (quote) { flushParagraph(); closeList(); html.push(`${inlineMarkdown(quote[1])}
`); }
else if (!line.trim()) { flushParagraph(); closeList(); }
else paragraph.push(line);
}
flushParagraph(); closeList();
return html.join('').replace(/\u0000(\d+)\u0000/g, (_, index) => stash[Number(index)]);
}
function answerHTML(node) {
if (node.status === 'loading' && !node.answer) return '';
if (node.status === 'error') return `${escapeHTML(node.error || 'The request failed.')}
`;
return markdown(node.answer || '');
}
function renderConversation({ scroll = false } = {}) {
const path = pathTo(state.activeId);
els.welcome.hidden = path.length > 0;
els.conversation.hidden = path.length === 0;
const fragment = document.createDocumentFragment();
for (const node of path) {
const article = document.createElement('article');
article.className = 'message';
article.dataset.nodeId = node.id;
article.innerHTML = `
${escapeHTML(node.question)}
${node.status === 'error' ? '' : ''}
`;
fragment.append(article);
}
els.conversation.replaceChildren(fragment);
renderBranchContext();
if (scroll) requestAnimationFrame(() => window.scrollTo({ top: document.documentElement.scrollHeight, behavior: 'smooth' }));
}
function renderTree() {
const ids = new Set(state.nodes.map(node => node.id));
const grouped = new Map();
for (const node of state.nodes) {
const parentId = node.parentId && ids.has(node.parentId) ? node.parentId : null;
if (!grouped.has(parentId)) grouped.set(parentId, []);
grouped.get(parentId).push(node);
}
const roots = grouped.get(null) || [];
const activePath = new Set(pathTo(state.activeId).map(node => node.id));
const build = nodes => {
const ul = document.createElement('ul');
for (const node of nodes) {
const li = document.createElement('li');
const button = document.createElement('button');
button.type = 'button';
button.className = `tree-node${node.id === state.activeId ? ' active' : ''}`;
button.dataset.nodeId = node.id;
button.setAttribute('aria-current', node.id === state.activeId ? 'true' : 'false');
const children = grouped.get(node.id) || [];
button.innerHTML = `${node.status === 'loading' ? '…' : (activePath.has(node.id) ? '●' : '○')}${escapeHTML(node.question)}${children.length} ${children.length === 1 ? 'reply' : 'branches'}`;
li.append(button);
if (children.length) li.append(build(children));
ul.append(li);
}
return ul;
};
els.tree.replaceChildren(build(roots));
els.mapEmpty.hidden = state.nodes.length > 0;
els.tree.hidden = state.nodes.length === 0;
els.nodeCount.textContent = String(state.nodes.length);
let branchCount = 0;
for (const children of grouped.values()) branchCount += Math.max(0, children.length - 1);
els.branchCount.textContent = String(branchCount);
}
function renderBranchContext() {
const active = nodeById(state.activeId);
const latest = state.nodes.at(-1);
const branching = active && latest && active.id !== latest.id;
els.branchContext.hidden = !branching;
if (branching) els.branchLabel.textContent = active.question;
}
function renderAll(options) { renderConversation(options); renderTree(); }
function updateStreamedNode(node) {
if (state.activeId !== node.id) return;
const body = $(`.message[data-node-id="${CSS.escape(node.id)}"] .answer-body`, els.conversation);
if (body) body.innerHTML = answerHTML(node);
}
function inputFor(parentId, question) {
const messages = [];
for (const node of pathTo(parentId)) {
messages.push({ role: 'user', content: node.question });
if (node.answer) messages.push({ role: 'assistant', content: node.answer });
}
messages.push({ role: 'user', content: question });
return messages;
}
async function ask(question, parentId = state.activeId) {
question = question.trim();
if (!question) return;
if (activeRequest) { showToast('Stop or finish the current response first'); return; }
if (!settings.apiKey) { openSettings(); showToast('Add an OpenAI API key to begin'); return; }
const node = { id: uid(), parentId: parentId || null, question, answer: '', status: 'loading', createdAt: Date.now() };
state.nodes.push(node);
state.activeId = node.id;
persistSoon();
renderAll({ scroll: true });
setBusy(true);
const controller = new AbortController();
activeRequest = controller;
try {
const response = await fetch(settings.apiUrl, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${settings.apiKey}` },
body: JSON.stringify({ model: settings.model, instructions: settings.systemPrompt, input: inputFor(parentId, question), stream: true }),
signal: controller.signal
});
if (!response.ok) {
let message = `API request failed (${response.status})`;
try { const data = await response.json(); message = data.error?.message || message; } catch {}
throw new Error(message);
}
if (!response.body) throw new Error('This browser did not provide a streaming response body.');
await consumeSSE(response.body, event => {
if (event.type === 'response.output_text.delta') node.answer += event.delta || '';
if (event.type === 'response.failed') throw new Error(event.response?.error?.message || 'The model response failed.');
}, () => updateStreamedNode(node));
node.status = 'complete';
} catch (error) {
node.status = 'error';
node.error = error.name === 'AbortError' ? 'Response stopped.' : error.message;
} finally {
activeRequest = null;
persistSoon();
setBusy(false);
renderAll();
}
}
async function consumeSSE(stream, onEvent, onPaint) {
const reader = stream.getReader();
const decoder = new TextDecoder();
let buffer = '';
let paintQueued = false;
const queuePaint = () => {
if (paintQueued) return;
paintQueued = true;
setTimeout(() => { paintQueued = false; onPaint(); }, 70);
};
while (true) {
const { done, value } = await reader.read();
buffer += decoder.decode(value || new Uint8Array(), { stream: !done });
const blocks = buffer.split(/\r?\n\r?\n/);
buffer = blocks.pop() || '';
for (const block of blocks) {
for (const line of block.split(/\r?\n/)) {
if (!line.startsWith('data:')) continue;
const data = line.slice(5).trim();
if (!data || data === '[DONE]') continue;
onEvent(JSON.parse(data));
queuePaint();
}
}
if (done) break;
}
onPaint();
}
function setBusy(busy) {
els.prompt.disabled = busy;
els.send.textContent = busy ? '■' : '↑';
els.send.setAttribute('aria-label', busy ? 'Stop response' : 'Send message');
}
function openSettings() {
els.apiKey.value = settings.apiKey || '';
els.model.value = settings.model;
els.apiUrl.value = settings.apiUrl;
els.systemPrompt.value = settings.systemPrompt;
els.settings.showModal();
setTimeout(() => els.apiKey.focus(), 50);
}
function showToast(message) {
els.toast.textContent = message;
els.toast.classList.add('show');
clearTimeout(toastTimer);
toastTimer = setTimeout(() => els.toast.classList.remove('show'), 2200);
}
function updateKeyStatus() { els.keyStatus.classList.toggle('ready', Boolean(settings.apiKey)); }
function updateThemeButton() {
const dark = document.documentElement.dataset.theme === 'dark';
const button = $('#theme-toggle');
button.querySelector('span').textContent = dark ? '☀' : '☾';
button.setAttribute('aria-label', `Switch to ${dark ? 'light' : 'dark'} theme`);
button.title = `Switch to ${dark ? 'light' : 'dark'} theme`;
}
function toggleTheme() {
const next = document.documentElement.dataset.theme === 'dark' ? 'light' : 'dark';
document.documentElement.dataset.theme = next;
try { localStorage.setItem('study-pal:theme', next); } catch {}
updateThemeButton();
}
function showSelectionMenu(text, nodeId, rect) {
selectedText = { text: text.slice(0, 5000), nodeId };
els.selectionPreview.textContent = text.length > 240 ? `${text.slice(0, 240)}…` : text;
els.selectionMenu.hidden = false;
const width = 330;
const left = Math.max(12, Math.min(innerWidth - width - 12, rect.left + rect.width / 2 - width / 2));
const estimatedHeight = 235;
const top = rect.bottom + estimatedHeight < innerHeight ? rect.bottom + 10 : Math.max(10, rect.top - estimatedHeight - 8);
Object.assign(els.selectionMenu.style, { left: `${left}px`, top: `${top}px` });
}
function hideSelectionMenu() { els.selectionMenu.hidden = true; selectedText = null; }
els.composer.addEventListener('submit', event => {
event.preventDefault();
if (activeRequest) { activeRequest.abort(); return; }
const question = els.prompt.value;
els.prompt.value = '';
els.prompt.style.height = '';
ask(question);
});
els.prompt.addEventListener('keydown', event => {
if (event.key === 'Enter' && !event.shiftKey && !event.isComposing) { event.preventDefault(); els.composer.requestSubmit(); }
});
els.prompt.addEventListener('input', () => {
els.prompt.style.height = 'auto';
els.prompt.style.height = `${Math.min(els.prompt.scrollHeight, 180)}px`;
});
document.addEventListener('click', event => {
const starter = event.target.closest('.starter');
if (starter) { els.prompt.value = starter.dataset.prompt; els.prompt.focus(); }
const treeNode = event.target.closest('.tree-node');
if (treeNode) { state.activeId = treeNode.dataset.nodeId; persistSoon(); renderAll(); document.body.classList.remove('map-open'); scrollTo({ top: 0, behavior: 'smooth' }); }
const branch = event.target.closest('.branch-here');
if (branch) { state.activeId = branch.closest('.message').dataset.nodeId; persistSoon(); renderAll(); els.prompt.focus(); }
const retry = event.target.closest('.retry-node');
if (retry) { const old = nodeById(retry.closest('.message').dataset.nodeId); state.activeId = old.parentId; ask(old.question, old.parentId); }
const copy = event.target.closest('.copy-answer');
if (copy) { const node = nodeById(copy.closest('.message').dataset.nodeId); navigator.clipboard.writeText(node.answer).then(() => showToast('Answer copied')); }
});
document.addEventListener('mouseup', event => {
if (event.target.closest('.selection-menu')) return;
requestAnimationFrame(() => {
const selection = getSelection();
const text = selection?.toString().trim();
if (!text || text.length < 2 || !selection.rangeCount) return;
const answer = selection.anchorNode?.parentElement?.closest('.answer-body');
if (!answer || !answer.contains(selection.focusNode)) return;
const message = answer.closest('.message');
showSelectionMenu(text, message.dataset.nodeId, selection.getRangeAt(0).getBoundingClientRect());
});
});
$('#ask-selection').addEventListener('click', () => {
if (!selectedText) return;
const action = els.selectionAction.value === 'custom' ? els.selectionCustom.value.trim() : els.selectionAction.value;
if (!action) { els.selectionCustom.focus(); return; }
const question = `${action}\n\nSelected passage:\n> ${selectedText.text.replace(/\n/g, '\n> ')}`;
const parentId = selectedText.nodeId;
hideSelectionMenu();
getSelection()?.removeAllRanges();
ask(question, parentId);
});
els.selectionAction.addEventListener('change', () => {
els.selectionCustom.hidden = els.selectionAction.value !== 'custom';
if (!els.selectionCustom.hidden) els.selectionCustom.focus();
});
$('#close-selection').addEventListener('click', hideSelectionMenu);
window.addEventListener('scroll', hideSelectionMenu, { passive: true });
$('#open-settings').addEventListener('click', openSettings);
$('#theme-toggle').addEventListener('click', toggleTheme);
$('#close-settings').addEventListener('click', () => els.settings.close());
$('#toggle-key').addEventListener('click', event => { const show = els.apiKey.type === 'password'; els.apiKey.type = show ? 'text' : 'password'; event.target.textContent = show ? 'Hide' : 'Show'; });
$('#settings-form').addEventListener('submit', event => {
event.preventDefault();
settings = { apiKey: els.apiKey.value.trim(), model: els.model.value.trim() || DEFAULT_SETTINGS.model, apiUrl: els.apiUrl.value.trim() || DEFAULT_SETTINGS.apiUrl, systemPrompt: els.systemPrompt.value.trim() };
localStorage.setItem(SETTINGS_KEY, JSON.stringify(settings));
updateKeyStatus(); els.settings.close(); showToast('Settings saved');
});
$('#forget-key').addEventListener('click', () => { settings.apiKey = ''; els.apiKey.value = ''; localStorage.setItem(SETTINGS_KEY, JSON.stringify(settings)); updateKeyStatus(); showToast('API key removed'); });
$('#new-session').addEventListener('click', () => {
if (!state.nodes.length || confirm('Start a new map? This will delete the current conversation tree from this browser.')) {
if (activeRequest) activeRequest.abort();
state = { nodes: [], activeId: null }; localStorage.setItem(STORAGE_KEY, JSON.stringify(state)); renderAll();
}
});
$('#clear-branch').addEventListener('click', () => { state.activeId = state.nodes.at(-1)?.id || null; persistSoon(); renderAll({ scroll: true }); });
$('#collapse-map').addEventListener('click', () => { document.body.classList.remove('map-open'); document.body.classList.add('map-collapsed'); $('#expand-map').hidden = false; });
$('#expand-map').addEventListener('click', () => { document.body.classList.remove('map-collapsed'); document.body.classList.add('map-open'); $('#expand-map').hidden = true; });
updateKeyStatus();
updateThemeButton();
renderAll();
})();