import json import re import subprocess with open("scratch/unified_docs_data.json") as f: unified_data = json.load(f) # Read current HTML with open("web/docs/index.html") as f: orig_html = f.read() # Extract head/styles head_part = orig_html.split('')[0] # Extra styles extra_styles = """ /* ─── API Key & Endpoints Tabs Styling ─── */ .m-MULTI { background: #EAE6FE; color: #5B21B6; border-color: #DDD6FE; font-weight: 700; } [data-theme=dark] .m-MULTI { background: #3B1B68; color: #DDD6FE; border-color: #6D28D9; } .ep-key-badge { display: inline-flex; align-items: center; gap: 6px; font-size: 11px; font-weight: 700; letter-spacing: 0.05em; text-transform: uppercase; color: var(--ink3); } .ep-count-tag { font-size: 11.5px; font-weight: 600; padding: 2px 8px; border-radius: 99px; background: var(--soft); border: 1px solid var(--line); color: var(--ink2); margin-left: 8px; } .ep-full-url-bar { display: flex; align-items: center; gap: 12px; background: var(--soft); border: 1px solid var(--line); border-radius: 12px; padding: 10px 16px; margin: 14px 0 20px 0; flex-wrap: wrap; } .ep-full-url-bar code { font-family: var(--mono); font-size: 13.5px; color: var(--acc); word-break: break-all; flex: 1; } .ep-tabs-wrapper { margin: 12px 0 22px 0; padding-bottom: 14px; border-bottom: 1px solid var(--line); } .ep-tabs-label { font-size: 11.5px; font-weight: 700; letter-spacing: 0.06em; text-transform: uppercase; color: var(--ink3); margin-bottom: 10px; display: block; } .ep-tabs { display: flex; gap: 8px; flex-wrap: wrap; } .ep-tab { padding: 8px 14px; border-radius: 10px; background: var(--soft); border: 1px solid var(--line); font-family: var(--sans); font-size: 13px; font-weight: 600; color: var(--ink2); cursor: pointer; display: inline-flex; align-items: center; gap: 8px; transition: background 0.15s, border-color 0.15s, color 0.15s, transform 0.15s; } .ep-tab:hover { border-color: var(--acc); color: var(--ink); transform: translateY(-1px); } .ep-tab.active { background: var(--card); border-color: var(--acc); color: var(--acc); box-shadow: 0 2px 10px rgba(0,0,0,0.06); } .ep-tab .m { padding: 3px 7px; font-size: 11px; } /* ─── Preset Chips & Copying ─── */ .chip { font: 400 13px var(--mono); padding: 6px 12px; border-radius: 8px; background: var(--soft); border: 1px solid var(--line); color: var(--ink2); cursor: pointer; transition: background 0.15s, border-color 0.15s, transform 0.15s, color 0.15s, box-shadow 0.15s; user-select: none; position: relative; } .chip:hover { border-color: var(--acc); color: var(--ink); transform: translateY(-1px); box-shadow: 0 2px 6px rgba(0,0,0,0.06); } .chip:active { transform: scale(0.96); } .chip.copied { background: #10b981 !important; border-color: #059669 !important; color: #ffffff !important; box-shadow: 0 0 12px rgba(16, 185, 129, 0.45); transform: scale(1.05); } .chip.sel { background: var(--tint); border-color: var(--acc); color: var(--ink); font-weight: 600; } .chips-hint { margin: 6px 0 10px 0; font-size: 12.5px; color: var(--ink3); display: flex; align-items: center; gap: 6px; } .chips-hint b { color: var(--ink); font-weight: 600; } .pr-tools { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin-bottom: 10px; } .pr-tools input { flex: 1; min-width: 170px; padding: 8px 12px; border: 1px solid var(--line); border-radius: 9px; background: var(--soft); font: inherit; font-size: 13px; color: var(--ink); } .pr-tools .btn { padding: 7px 12px; font-size: 12.5px; display: inline-flex; align-items: center; gap: 6px; } .btn-primary { background: var(--ink); color: var(--paper); border-color: var(--ink); } .btn-primary:hover { background: var(--ink2); border-color: var(--ink2); } [data-theme=dark] .btn-primary { background: #ffffff; color: #0f0e0b; border-color: #ffffff; } .multi-select-toggle { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: var(--ink2); cursor: pointer; padding: 5px 9px; border-radius: 7px; border: 1px solid var(--line); background: var(--soft); user-select: none; } .multi-select-toggle input { cursor: pointer; } """ new_style = style_part + extra_styles # Raw JS code js_code = r""" (()=>{ const $=(s,r=document)=>r.querySelector(s),$$=(s,r=document)=>[...r.querySelectorAll(s)]; const esc=s=>String(s??'').replace(/[&<>"']/g,c=>({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c])); let D=JSON.parse($('#api-data').textContent); const open=new Set();let toastT; // Snippets generator using actual full URL const meaningful=v=>v&&!/^(none|null|-|—)/i.test(v.trim()); const clean=v=>v.replace(/^['"]|['"]$/g,''); function fields(ep){ let used=false; return ep.params.filter(p=>p.rq).map(p=>{ const file=/file|binary/i.test(p.ty);let v; if(file)v=(p.n||'file')+'.jpg'; else if(meaningful(p.df)&&!/auto/i.test(p.df))v=clean(p.df); else if(!used&&ep.chips.length&&/id$/i.test(p.n)){v=ep.chips[0];used=true} else v='<'+p.n+'>'; return{n:p.n,file,v,q:/query/i.test(p.lc)}; }); } function snippets(ep){ const url=ep.full_url || ep.path; const f=fields(ep),isImg=/image|video|audio/.test(ep.resp); const q=f.filter(x=>x.q),b=f.filter(x=>!x.q),qs=q.length?'?'+q.map(x=>x.n+'='+encodeURIComponent(x.v)).join('&'):''; const omitted=ep.params.length-f.length; let curl=`curl -X ${ep.method} "${url}${qs}"`+b.map(x=>` \\\n -F "${x.n}=${x.file?'@':''}${x.v}"`).join('')+(isImg?` \\\n -o result.${/jpeg/.test(ep.resp)?'jpg':'png'}`:''); const files=b.filter(x=>x.file),data=b.filter(x=>!x.file); const py=`import requests\n\nres = requests.${ep.method.toLowerCase()}(\n "${url}${qs}"`+(b.length?`,\n files={${files.map(x=>`"${x.n}": open("${x.v}", "rb")`).join(', ')}},\n data={${data.map(x=>`"${x.n}": "${x.v}"`).join(', ')}}`:'')+`,\n)\nres.raise_for_status()\n`+(isImg?`open("result.${/jpeg/.test(ep.resp)?'jpg':'png'}", "wb").write(res.content)`:`print(res.json())`); const js=(b.length?`const form = new FormData();\n`+files.map(x=>`form.append("${x.n}", fileInput.files[0]); // ${x.v}`).join('\n')+(files.length?'\n':'')+data.map(x=>`form.append("${x.n}", "${x.v}");`).join('\n')+'\n\n':'')+`const res = await fetch("${url}${qs}", {\n method: "${ep.method}",`+(b.length?`\n body: form,`:'')+`\n});\n`+(isImg?`const image = URL.createObjectURL(await res.blob());`:`const result = await res.json();`); return{curl,py,js,omitted}; } const ICON=''; function renderEndpointView(ep, isMulti){ const sn=snippets(ep); return `
`+ (isMulti ? `
${esc(ep.method)}${esc(ep.full_url)}
` : '')+ `

${esc(ep.desc||ep.summary)}

`+ (ep.subs && ep.subs.length?`

Also served at ${ep.subs.length} more routes

`:'')+ `

Parameters ${ep.params.length} total, ${ep.params.filter(p=>p.rq).length} required

`+ (ep.params.length?`${ep.params.map(p=>``).join('')}
NameTypeRequiredDefaultWhat it does
${esc(p.n)}${p.al?`also accepts ${esc(p.al)}`:''}${esc(p.ty)}${esc(p.lc)}${p.rq?'Required':'Optional'}${esc(p.df||'—')}${esc(p.ds)}
`:'

This endpoint takes no parameters.

')+ (ep.chips && ep.chips.length?`

Verified Presets ${ep.chips.length} accepted values

💡 Click any preset below to copy it instantly.
${ep.chips.map(c=>``).join('')}
`:'')+ `

Response

${esc(ep.resp||'—')}${/json/.test(ep.resp)?'Parsed JSON body':'Binary image body, write it straight to a file'}
`+ `

Try it

${esc(sn.curl)}
`+ (sn.omitted?`

${sn.omitted} optional parameter${sn.omitted>1?'s are':' is'} left out of these examples.

`:'')+ `
`; } function detail(api, s){ const isMulti = api.endpoints.length > 1; let html = ''; if(isMulti){ html += `
Endpoints categorized under this API (${api.endpoints.length}):
${api.endpoints.map((ep, idx) => ` `).join('')}
`; html += `
${api.endpoints.map((ep, idx) => `
${renderEndpointView(ep, true)}
`).join('')}
`; } else { html += `
${esc(api.endpoints[0].method)}${esc(api.endpoints[0].full_url)}
`; html += renderEndpointView(api.endpoints[0], false); } return html; } function apiCardHTML(api, s){ const isMulti = api.endpoints.length > 1; const totalParams = api.endpoints.reduce((acc, ep) => acc + (ep.params ? ep.params.length : 0), 0); const totalChips = api.endpoints.reduce((acc, ep) => acc + (ep.chips ? ep.chips.length : 0), 0); const methodBadge = isMulti ? `MULTI` : `${esc(api.endpoints[0].method)}`; return `
`; } const findAPI = id => { for(const s of D.sections){ const a = s.apis.find(x => x.id === id); if(a) return { a, s }; } }; function render(){ const allApis = D.sections.flatMap(s => s.apis); const totalEndpoints = allApis.reduce((acc, a) => acc + a.endpoints.length, 0); const totalPresets = allApis.reduce((acc, a) => acc + a.endpoints.reduce((pacc, ep) => pacc + ep.chips.length, 0), 0); const y = scrollY; document.title = D.meta.title; const m = D.meta; $('#app').innerHTML = `
Lock

${esc(m.heading || m.title)}

${esc(m.intro)}

${allApis.length}APIs (from Credentials)
${totalEndpoints}Endpoint routes
${D.sections.length}Families
${totalPresets.toLocaleString()}Verified presets
${m.authNote ? `

${esc(m.authNote)}

` : ''}
${D.sections.map(s => `

${esc(s.title)}

${s.tag ? `${esc(s.tag)}` : ''} ${s.apis.length} API${s.apis.length===1?'':'s'}
${s.lead ? `

${esc(s.lead)}

` : ''}
${s.apis.map(api => apiCardHTML(api, s)).join('')}
`).join('')}
`; open.forEach(id => { const f = findAPI(id); const a = document.getElementById(id); if(f && a) setOpen(a, true); }); scrollTo(0, y); spy(); reel(); } function setOpen(a, on){ const f = findAPI(a.id); if(!f) return; a.classList.toggle('open', on); $('.eh', a).setAttribute('aria-expanded', on); a.style.setProperty('--h', f.s.hue); a.style.setProperty('--a', `hsl(${+f.s.hue||250} 55% 40%)`); const w = $('.ew', a); if(on && !w.innerHTML) w.innerHTML = detail(f.a, f.s); on ? open.add(a.id) : open.delete(a.id); } function toast(t){ const n = $('#toast'); n.textContent = t; n.hidden = false; clearTimeout(toastT); toastT = setTimeout(() => n.hidden = true, 1800); } async function copy(t, msg){ try { await navigator.clipboard.writeText(t); } catch { const x = document.createElement('textarea'); x.value = t; document.body.append(x); x.select(); document.execCommand('copy'); x.remove(); } toast(msg || 'Copied to clipboard'); } function goto(id){ const a = document.getElementById(id); if(!a) return; setOpen(a, true); history.replaceState(null, '', '#' + id); setTimeout(() => a.scrollIntoView({ behavior: 'smooth', block: 'start' }), 60); } let ro; function spy(){ ro && ro.disconnect(); ro = new IntersectionObserver(es => es.forEach(en => { if(en.isIntersecting) $$('.fam').forEach(f => f.classList.toggle('on', f.dataset.s === en.target.id)); }), { rootMargin: '-20% 0px -70% 0px' }); $$('.fsec').forEach(s => ro.observe(s)); } let reelTok = 0, reelCur = null; async function reel(){ const tok = ++reelTok, rp = $('#rp'), rm = $('#rm'), rs = $('#rs'), box = $('.reel'); if(!rp) return; const allApis = D.sections.flatMap(s => s.apis.map(a => ({ a, s }))).filter(x => x.a.api_ip_link); if(!allApis.length) return; const still = matchMedia('(prefers-reduced-motion:reduce)').matches, z = ms => new Promise(r => setTimeout(r, ms)); let i = Math.floor(Math.random() * allApis.length); while(tok === reelTok && document.contains(rp)){ const { a, s } = allApis[i % allApis.length]; reelCur = a.id; box.style.setProperty('--h', s.hue); rm.textContent = a.api_key; rs.textContent = ''; if(still){ rp.textContent = a.api_ip_link; rs.textContent = `${a.summary} (${a.endpoints.length} routes)`; return; } for(let k = 1; k <= a.api_ip_link.length && tok === reelTok; k++){ rp.textContent = a.api_ip_link.slice(0, k); await z(18); } rs.textContent = `${a.summary} (${a.endpoints.length} routes)`; await z(2400); for(let k = a.api_ip_link.length; k >= 0 && tok === reelTok; k -= 3){ rp.textContent = a.api_ip_link.slice(0, Math.max(k, 0)); await z(8); } i += 7; } } function palList(q){ const t = q.toLowerCase().split(/\s+/).filter(Boolean), out = []; for(const s of D.sections){ for(const a of s.apis){ const epDetails = a.endpoints.map(ep => [ep.title, ep.full_url, ep.subpath, ep.summary, ...ep.params.map(p => p.n), ...ep.chips].join(' ')).join(' '); const hay = [a.api_key, a.api_ip_link, a.summary, s.title, epDetails].join(' ').toLowerCase(); if(t.every(w => hay.includes(w))){ const h = (a.api_key + ' ' + a.api_ip_link).toLowerCase(); out.push({ a, sc: t.reduce((n, w) => n + (h.includes(w) ? 3 : 0) + (h.startsWith(w) ? 4 : 0), 0) }); } } } return out.sort((x, y) => y.sc - x.sc).slice(0, 40); } let pi = 0, pr = []; function palDraw(){ const l = $('#pl'); pr = palList($('#pq').value); pi = Math.min(pi, Math.max(pr.length - 1, 0)); l.innerHTML = pr.length ? pr.map((x, i) => ` `).join('') : '

No matching APIs found. Try searching by API key (e.g. Teeth_Whitener) or parameter name.

'; $('.pi.on')?.scrollIntoView({ block: 'nearest' }); } function palOpen(on){ const p = $('.pal'); p.hidden = !on; if(on){ $('#pq').value = ''; pi = 0; palDraw(); $('#pq').focus(); } } // Global click delegation document.addEventListener('click', ev => { const t = ev.target.closest('[data-act]'); if(!t) return; const a = t.dataset.act; const card = t.closest('.ep'); if(a === 'palbg'){ if(ev.target === t) palOpen(false); return; } if(a === 'toggle') setOpen(card, !card.classList.contains('open')); else if(a === 'pal') palOpen(true); else if(a === 'pick'){ palOpen(false); goto(t.dataset.id); } else if(a === 'reel' && reelCur) goto(reelCur); else if(a === 'theme'){ const n = document.documentElement.dataset.theme === 'dark' ? 'light' : 'dark'; document.documentElement.dataset.theme = n; try { localStorage.setItem('apidocs-theme', n); } catch {} } else if(a === 'all'){ const on = t.textContent === 'Expand all'; $$('.ep').forEach(x => setOpen(x, on)); t.textContent = on ? 'Collapse all' : 'Expand all'; } // Endpoint switching within multi-endpoint API else if(a === 'eptab'){ const epid = t.dataset.epid; const cardBody = t.closest('.ew'); $$('.ep-tab', cardBody).forEach(tab => tab.classList.toggle('active', tab === t)); $$('.ep-pane-wrap', cardBody).forEach(pane => { pane.style.display = (pane.id === `pane-wrap-${epid}`) ? 'block' : 'none'; }); } // Copy full URL button else if(a === 'copyurl'){ const url = t.dataset.url; if(url) copy(url, 'Copied full API URL'); } // Single-Click Preset Chip Copy (USER REQUIREMENT!) else if(a === 'chip'){ const chipVal = t.dataset.val || t.textContent.trim(); const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const selectMode = epPane.querySelector('[data-act="toggleselectmode"]')?.checked; if(selectMode){ // In select mode: toggle selection for custom bulk copying t.classList.toggle('sel'); const selCount = epPane.querySelectorAll('.chip.sel').length; const countSpan = epPane.querySelector('[data-n]'); if(countSpan) countSpan.textContent = selCount; const copySelBtn = epPane.querySelector('[data-act="copysel"]'); if(copySelBtn) copySelBtn.style.display = selCount > 0 ? 'inline-flex' : 'none'; const clearBtn = epPane.querySelector('[data-act="clearsel"]'); if(clearBtn) clearBtn.style.display = selCount > 0 ? 'inline-flex' : 'none'; } else { // DEFAULT: SINGLE CLICK COPIES THAT PRESET INSTANTLY! copy(chipVal, `Copied "${chipVal}"`); t.classList.add('copied'); setTimeout(() => t.classList.remove('copied'), 650); } } // Bulk Copy: Copy All (newline-separated) else if(a === 'copyall'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const chips = [...epPane.querySelectorAll('.chip')].map(c => c.dataset.val || c.textContent.trim()); if(chips.length) copy(chips.join('\n'), `Copied all ${chips.length} presets (newline-separated)`); } // Bulk Copy: Copy Comma-Separated else if(a === 'copycomma'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const chips = [...epPane.querySelectorAll('.chip')].map(c => c.dataset.val || c.textContent.trim()); if(chips.length) copy(chips.join(', '), `Copied all ${chips.length} presets (comma-separated)`); } // Bulk Copy: Copy JSON Array else if(a === 'copyjson'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const chips = [...epPane.querySelectorAll('.chip')].map(c => c.dataset.val || c.textContent.trim()); if(chips.length) copy(JSON.stringify(chips, null, 2), `Copied ${chips.length} presets as JSON array`); } // Bulk Copy: Copy Filtered Search Results else if(a === 'copyfilter'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const visibleChips = [...epPane.querySelectorAll('.chip:not([hidden])')].map(c => c.dataset.val || c.textContent.trim()); if(visibleChips.length) copy(visibleChips.join('\n'), `Copied ${visibleChips.length} matching presets`); } // Bulk Copy: Copy Selected Custom Set else if(a === 'copysel'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const selChips = [...epPane.querySelectorAll('.chip.sel')].map(c => c.dataset.val || c.textContent.trim()); if(selChips.length) copy(selChips.join('\n'), `Copied ${selChips.length} selected presets`); } // Clear custom selection else if(a === 'clearsel'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); epPane.querySelectorAll('.chip.sel').forEach(c => c.classList.remove('sel')); const countSpan = epPane.querySelector('[data-n]'); if(countSpan) countSpan.textContent = 0; t.style.display = 'none'; const copySelBtn = epPane.querySelector('[data-act="copysel"]'); if(copySelBtn) copySelBtn.style.display = 'none'; } // Code tabs (cURL, Python, JS) else if(a === 'tab'){ const box = t.closest('[data-code]'); $$('.ctab button[data-t]', box).forEach(b => b.classList.toggle('on', b === t)); $$('pre', box).forEach(p => p.hidden = p.dataset.t !== t.dataset.t); } // Copy code snippet else if(a === 'copycode'){ copy($$('pre', t.closest('[data-code]')).find(p => !p.hidden).textContent, 'Copied request snippet'); } }); // Input delegation for preset filter & search document.addEventListener('input', ev => { const t = ev.target; if(t.id === 'pq'){ pi = 0; palDraw(); } else if(t.dataset.act === 'chipfilter'){ const q = t.value.toLowerCase().trim(); const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const chips = epPane.querySelectorAll('.chip'); let matchCount = 0; chips.forEach(c => { const val = (c.dataset.val || c.textContent).toLowerCase(); const matches = !q || val.includes(q); c.hidden = !matches; if(matches) matchCount++; }); const filterBtn = epPane.querySelector('[data-act="copyfilter"]'); if(filterBtn){ if(q && matchCount > 0){ filterBtn.style.display = 'inline-flex'; filterBtn.querySelector('[data-filtered-count]').textContent = matchCount; } else { filterBtn.style.display = 'none'; } } } }); // Toggle select mode change event document.addEventListener('change', ev => { const t = ev.target; if(t.dataset.act === 'toggleselectmode'){ const epPane = t.closest('.ep-detail-pane') || t.closest('.ew'); const hint = epPane.querySelector('.chips-hint span'); if(t.checked){ if(hint) hint.innerHTML = '👉 Select Mode Active: Click presets to select them, then click Copy Selected.'; } else { if(hint) hint.innerHTML = '💡 Click any preset below to copy it instantly.'; } } }); // Keyboard shortcuts document.addEventListener('keydown', ev => { const p = $('.pal'), typing = /INPUT|TEXTAREA/.test(document.activeElement.tagName); if(((ev.ctrlKey || ev.metaKey) && ev.key === 'k') || (ev.key === '/' && !typing)){ ev.preventDefault(); palOpen(true); } else if(p && !p.hidden){ if(ev.key === 'Escape') palOpen(false); else if(ev.key === 'ArrowDown'){ ev.preventDefault(); pi = Math.min(pi + 1, pr.length - 1); palDraw(); } else if(ev.key === 'ArrowUp'){ ev.preventDefault(); pi = Math.max(pi - 1, 0); palDraw(); } else if(ev.key === 'Enter' && pr[pi]){ palOpen(false); goto(pr[pi].a.id); } } }); render(); })(); """ # Assemble new HTML new_html = head_part + "\n\n\n
\n" new_html += '\n' new_html += '\n\n' # Write to test file and check syntax with open("/tmp/test_docs.js", "w") as f: f.write(js_code) res = subprocess.run(["node", "--check", "/tmp/test_docs.js"], capture_output=True, text=True) print("Node check exit code:", res.returncode) if res.stderr: print("Errors:", res.stderr) exit(1) # Write to web/docs/index.html and web/docs/FASTAPI_BACKEND_API_DOCS.html with open("web/docs/index.html", "w") as f: f.write(new_html) with open("web/docs/FASTAPI_BACKEND_API_DOCS.html", "w") as f: f.write(new_html) print("SUCCESS: Updated web/docs/index.html and web/docs/FASTAPI_BACKEND_API_DOCS.html!") print(f"Total HTML file size: {len(new_html)} bytes")