/** * Regenerates most of the README screenshots from the mock server. * * Drives headless Chrome over CDP, so the viewport is exactly the size the * images already use rather than whatever a window happens to be. * * npm run dev:mock # in another terminal * node scripts/screenshots.mjs screenshots * node scripts/screenshots-light.mjs screenshots * * Restart the mock before a run. The filters shot creates rules, so a second * run against the same mock shows them twice. * * The files shot was taken by hand until 2026-08-27, and had gone stale twice * over by the time anyone noticed. Anything the docs show should be generated * from the mock, or it describes whatever the app looked like on the day * somebody had a screenshot tool open. * * Two shots are deliberately not taken here: * * - **mobile**, because at the tail of this sequence the app would not render * the message list at 500px within the wait. A short run of its own is * reliable, and it is a screenshot, not a mystery worth solving. * * - **inbox-light**, because of setDeviceMetricsOverride. Swapping the theme * under the emulation layer captures a *mixed* frame: the panes that * re-rendered come out light while the rest of the chrome stays dark, with * the DOM and computed styles insisting the whole page is light. The app is * not at fault -- update() calls applyTheme() synchronously and the CSS does * flip --bg to #f6f8fa. The compositor simply does not repaint everything a * CSS-variable change touches while metrics are overridden. Launching Chrome * at --window-size and never calling setDeviceMetricsOverride renders it * correctly, which is what scripts/screenshots-light.mjs does. * * assertTheme() stays either way: without it this script wrote a dark * screenshot under a light caption and reported success, and that is how the * README came to show the same theme twice for months. */ import { spawn } from "node:child_process"; import { writeFile, mkdir } from "node:fs/promises"; import { setTimeout as sleep } from "node:timers/promises"; const OUT = process.argv[2]; if (!OUT) { console.error("usage: node shots.mjs "); process.exit(2); } await mkdir(OUT, { recursive: true }); const PORT = 9333; const chrome = spawn("google-chrome-stable", [ "--headless=new", `--remote-debugging-port=${PORT}`, "--hide-scrollbars", "--no-first-run", "--no-default-browser-check", "--disable-gpu", `--user-data-dir=/tmp/ihasmail-shots-profile`, "about:blank", ], { stdio: "ignore" }); const json = async (path) => { for (let i = 0; i < 60; i++) { try { return await (await fetch(`http://127.0.0.1:${PORT}${path}`)).json(); } catch { await sleep(250); } } throw new Error("Chrome did not come up"); }; const version = await json("/json/version"); let nextId = 1; const pending = new Map(); const ws = new WebSocket(version.webSocketDebuggerUrl); await new Promise((res, rej) => { ws.onopen = res; ws.onerror = rej; }); ws.onmessage = (m) => { const msg = JSON.parse(m.data); if (msg.id && pending.has(msg.id)) { const { resolve, reject } = pending.get(msg.id); pending.delete(msg.id); msg.error ? reject(new Error(JSON.stringify(msg.error))) : resolve(msg.result); } }; const send = (method, params = {}, sessionId) => new Promise((resolve, reject) => { const id = nextId++; pending.set(id, { resolve, reject }); ws.send(JSON.stringify({ id, method, params, ...(sessionId ? { sessionId } : {}) })); }); const { targetId } = await send("Target.createTarget", { url: "about:blank" }); const { sessionId } = await send("Target.attachToTarget", { targetId, flatten: true }); const cmd = (m, p) => send(m, p, sessionId); await cmd("Page.enable"); await cmd("Runtime.enable"); let current = { width: 1420, height: 703, mobile: false }; const metrics = (width, height, mobile = false) => { current = { width, height, mobile }; return cmd("Emulation.setDeviceMetricsOverride", { width, height, deviceScaleFactor: 1, mobile }); }; /** * Forces the whole page to repaint. * * Headless only repaints the layers that changed, and a theme swap changes CSS * variables rather than any single element — so the capture came back with the * message pane in the new theme and the rest of the app in the old one. Nudging * the viewport by a pixel and back invalidates everything. */ const repaint = async () => { // Detaching and reattaching the body invalidates every layer; nudging the // viewport did not, and the capture kept coming back with mixed themes. await evaluate(`(() => { const b = document.body; b.style.display = 'none'; void b.offsetHeight; b.style.display = ''; })()`); await sleep(500); }; const go = async (url) => { await cmd("Page.navigate", { url }); await sleep(1200); }; const evaluate = async (expression) => { const r = await cmd("Runtime.evaluate", { expression, awaitPromise: true, returnByValue: true }); if (r.exceptionDetails) throw new Error(r.exceptionDetails.exception?.description ?? "eval failed"); return r.result.value; }; /** Polls a predicate inside the page until it is true, or gives up loudly. */ const waitFor = async (jsExpr, what, ms = 15000) => { const deadline = Date.now() + ms; while (Date.now() < deadline) { if (await evaluate(`!!(${jsExpr})`)) return; await sleep(200); } throw new Error(`timed out waiting for ${what}`); }; /** * Pins the theme, because setting it once is not enough. * * The app re-runs applyTheme() from its own setting whenever the settings store * stirs, and that overwrote a plain attribute set during the settle before the * capture — twice, silently, producing a "light" screenshot of the dark theme. * A MutationObserver puts it back faster than anything can take it away. * * The check is the rendered background color: the attribute is what lied. */ const themeTest = (want) => want === "light" ? "parseInt(getComputedStyle(document.body).backgroundColor.match(/\\d+/)[0], 10) > 200" : "parseInt(getComputedStyle(document.body).backgroundColor.match(/\\d+/)[0], 10) < 60"; const setTheme = async (want) => { await evaluate(`(() => { const html = document.documentElement; const want = ${JSON.stringify(want)}; if (window.__themePin) window.__themePin.disconnect(); window.__themePin = new MutationObserver(() => { if (html.dataset.theme !== want) html.dataset.theme = want; }); window.__themePin.observe(html, { attributes: true, attributeFilter: ['data-theme'] }); html.dataset.theme = want; })()`); await waitFor(themeTest(want), `the ${want} theme to actually render`); await repaint(); }; /** Refuses to write the file unless the page still looks the way it should. */ const assertTheme = async (want) => { if (!(await evaluate(themeTest(want)))) throw new Error(`page is not rendering the ${want} theme at capture time`); }; const shot = async (name) => { const { data } = await cmd("Page.captureScreenshot", { format: "jpeg", quality: 82 }); await writeFile(`${OUT}/${name}`, Buffer.from(data, "base64")); console.log(" wrote", name); }; // Helpers injected into the page: React-controlled inputs need the native setter. const HELPERS = ` window.__set = (el, v) => { Object.getOwnPropertyDescriptor(HTMLInputElement.prototype,'value').set.call(el, v); el.dispatchEvent(new Event('input',{bubbles:true})); }; window.__btn = (txt, root=document) => [...root.querySelectorAll('button')].find(b => b.textContent.trim() === txt); window.__click = (sel) => { const el = document.querySelector(sel); if (el) el.click(); return !!el; }; window.__sel = (el, v) => { el.value = v; el.dispatchEvent(new Event('change', { bubbles: true })); }; `; try { console.log("chrome:", version.Browser); // --- login (taller, as the existing shot is) --- await metrics(1420, 759); await go("http://localhost:5173/"); await evaluate(HELPERS); await sleep(600); await shot("login.jpg"); // --- sign in (a fresh profile prefills nothing, so both fields) --- await evaluate(`(() => { const inputs = [...document.querySelectorAll('input')]; const user = inputs.find(i => i.type === 'text' || i.type === 'email'); const pw = document.querySelector('input[type=password]'); window.__set(user, 'demo@example.com'); window.__set(pw, 'demo'); window.__btn('Sign in').click(); })()`); await waitFor("document.querySelector('.msg-row') || document.querySelector('.nav-item')", "the app after sign-in"); await sleep(1500); // --- inbox, dark, with a conversation open --- await metrics(1420, 703); await go("http://localhost:5173/mail"); await evaluate(HELPERS); await waitFor("document.querySelectorAll('.msg-row').length > 2", "the message list"); await evaluate(`(() => { const r = document.querySelectorAll('.msg-row'); if (r[1]) r[1].click(); })()`); await sleep(1800); await shot("inbox-dark.jpg"); // --- the reply composer, still on the dark theme --- await evaluate(`(() => { const b = [...document.querySelectorAll('button')].find(x => /^reply$/i.test(x.getAttribute('aria-label')||'') || /^reply$/i.test(x.textContent.trim())); if (b) b.click(); })()`); await sleep(1800); await shot("compose.jpg"); // The recipient picker, taken here because the composer is already open. The // site claims you can pick recipients by reading the address books rather // than remembering a name, and this is that claim photographed. Doing it from // a later step meant navigating back to the mail list, which turned out not // to be reliable once the run had been through Files. await evaluate(`(() => { const b = [...document.querySelectorAll('button')].find(x => x.getAttribute('aria-label') === 'Choose from address books'); if (b) b.click(); })()`); await waitFor("/Choose recipients/.test(document.body.innerText)", "the recipient picker"); await evaluate(`(() => { // Two ticked, so the shot shows a selection rather than an empty list. for (const b of [...document.querySelectorAll('.menu-item input[type=checkbox]')].slice(0, 2)) b.click(); })()`); await sleep(1500); await shot("recipients.jpg"); await evaluate(`(() => { const c = [...document.querySelectorAll('button')].find(b => b.textContent.trim() === 'Cancel'); if (c) c.click(); })()`); await sleep(600); await evaluate(`(() => { const c = [...document.querySelectorAll('button')].find(b => /close|discard/i.test(b.getAttribute('aria-label')||'')); if (c) c.click(); })()`); await sleep(800); // (inbox-light is captured by scripts/screenshots-light.mjs -- see the header) // --- calendar --- await go("http://localhost:5173/calendar"); await waitFor("document.querySelector('.cal-grid, .calendar, [class*=cal]')", "the calendar"); await evaluate(HELPERS); // The README caption promises the month view. await evaluate(`(() => { const b = window.__btn('Month'); if (b) b.click(); })()`); await sleep(1800); await shot("calendar.jpg"); // --- contacts --- await go("http://localhost:5173/contacts"); await waitFor("document.querySelector('[class*=contact]')", "the contact list"); // Open someone, so the detail pane is not an empty "Select a contact". await evaluate(`(() => { const hit = [...document.querySelectorAll('div, li, button, a')] .filter(e => (e.textContent || '').trim().startsWith('Ada Lovelace')) .sort((a, b) => a.textContent.length - b.textContent.length)[0]; if (hit) (hit.closest('li, button, a, [class*=row], [class*=item]') || hit).click(); })()`); await waitFor("!/Select a contact/.test(document.body.innerText)", "the contact detail pane", 8000); await sleep(1800); await shot("contacts.jpg"); // --- files --- // Was the one shot taken by hand, which is why it outlived two rewrites of // the view it was meant to show. The tree makes it worth automating: opening // a folder is now the difference between a screenshot of a file manager and a // screenshot of a list. await go("http://localhost:5173/files"); await waitFor("document.querySelector('.files-table, .files-layout')", "the files view"); await evaluate(`(() => { // Expand the tree and open a folder, so the shot shows the pane doing its job. const twisty = document.querySelector('.sidebar .nav-twisty'); if (twisty) twisty.click(); const folder = [...document.querySelectorAll('.sidebar .nav-item')].find(e => /Documents/.test(e.textContent || "")); if (folder) folder.click(); })()`); await sleep(1800); await shot("files.jpg"); // --- filters, with rules that actually say something --- await go("http://localhost:5173/settings/filters"); await evaluate(HELPERS); await waitFor("[...document.querySelectorAll('button')].some(b => b.textContent.trim() === 'New rule')", "the filters editor"); await evaluate(`(async () => { const wait = (ms=350) => new Promise(r => setTimeout(r, ms)); const rules = [ { name: 'Newsletters', field: 'list-id', op: 'exists', value: '', folder: 'Newsletters' }, { name: 'From the boss', field: 'from', op: 'contains', value: 'ada@example.org', folder: 'Work' }, { name: 'Receipts', field: 'subject', op: 'contains', value: 'invoice', folder: 'Archive' }, { name: 'Build failures',field: 'subject', op: 'matches', value: '*FAILED*', folder: 'Work' }, ]; for (const r of rules) { window.__btn('New rule').click(); await wait(); const d = document.querySelector('.dialog'); window.__set(d.querySelector('input.input'), r.name); await wait(120); const row = d.querySelector('.rule-row'); const sels = row.querySelectorAll('select'); window.__sel(sels[0], r.field); await wait(120); const sels2 = d.querySelector('.rule-row').querySelectorAll('select'); if (sels2[1]) { window.__sel(sels2[1], r.op); await wait(120); } const val = [...d.querySelector('.rule-row').querySelectorAll('input.input')].pop(); if (val && r.value) { window.__set(val, r.value); await wait(120); } const arow = d.querySelector('.rule-row.actions'); const asels = arow.querySelectorAll('select'); if (asels[1]) { window.__sel(asels[1], r.folder); await wait(120); } window.__btn('Done', d).click(); await wait(); } const save = window.__btn('Save filters'); if (save && !save.disabled) save.click(); await wait(1500); // Clear the "Filters saved" toast so it does not sit over a rule. document.querySelectorAll('.toast, [class*=toast]').forEach(t => t.remove()); })()`); await sleep(1200); await shot("filters.jpg"); // (mobile is captured separately by shots-mobile.mjs) console.log("done"); } finally { ws.close(); chrome.kill(); }