import {debounce} from 'throttle-debounce'; import {GET} from './fetch.ts'; import {html, htmlRaw} from '../utils/html.ts'; export type SearchResult = { title: string; description?: string; image?: string; }; function buildResultHTML(result: SearchResult): string { const img = result.image ? html`
` : ''; const desc = result.description ? html`
${result.description}
` : ''; return html`${htmlRaw(img)}
${result.title}
${htmlRaw(desc)}
`; } // Awaits one user selection from an autocomplete attached to `container`. Resolves with // the chosen item; the caller writes it to whatever input/state it owns. Wrap in a loop // to keep the search box live across selections. export function chooseFromApi(container: HTMLElement, url: string, parse: (raw: any, query: string) => SearchResult[], {minCharacters = 2}: {minCharacters?: number} = {}): Promise { return new Promise((resolve) => { const input = container.querySelector('input.prompt') ?? container.querySelector('input')!; let resultsEl = container.querySelector(':scope > .results'); if (!resultsEl) { resultsEl = document.createElement('div'); resultsEl.className = 'results'; container.append(resultsEl); } let fetchController: AbortController | null = null; const lifecycleController = new AbortController(); const itemResults = new Map(); const items = () => resultsEl.querySelectorAll('.result'); const hide = () => { resultsEl.style.display = 'none'; resultsEl.replaceChildren(); itemResults.clear(); }; const render = (results: SearchResult[]) => { if (!results.length) return hide(); resultsEl.replaceChildren(); itemResults.clear(); for (const result of results) { const item = document.createElement('div'); item.className = 'result'; item.innerHTML = buildResultHTML(result); itemResults.set(item, result); resultsEl.append(item); } resultsEl.style.display = 'block'; }; const finish = (item: HTMLElement) => { const picked = itemResults.get(item)!; hide(); lifecycleController.abort(); resolve(picked); }; const performSearch = async (query: string) => { fetchController?.abort(); if (query.length < minCharacters) return hide(); fetchController = new AbortController(); try { const response = await GET(url.replaceAll('{query}', encodeURIComponent(query)), {signal: fetchController.signal}); if (!response.ok) return hide(); const results = parse(await response.json(), query); if (input.value !== query) return; // stale response racing a newer keystroke render(results); } catch (err) { if ((err as Error).name !== 'AbortError') hide(); } }; const debounced = debounce(200, (query: string) => { performSearch(query) }); input.addEventListener('input', () => debounced(input.value), {signal: lifecycleController.signal}); input.addEventListener('focus', () => { if (items().length) resultsEl.style.display = 'block'; }, {signal: lifecycleController.signal}); input.addEventListener('keydown', (event) => { const all = items(); if (!all.length) return; const activeIndex = Array.from(all).findIndex((it) => it.classList.contains('active')); const move = (next: number) => { event.preventDefault(); all[activeIndex]?.classList.remove('active'); all[next].classList.add('active'); }; if (event.key === 'ArrowDown') { move((activeIndex + 1) % all.length); } else if (event.key === 'ArrowUp') { move(activeIndex <= 0 ? all.length - 1 : activeIndex - 1); } else if (event.key === 'Enter' && activeIndex >= 0) { event.preventDefault(); finish(all[activeIndex]); } else if (event.key === 'Escape') { hide(); } }, {signal: lifecycleController.signal}); // mousedown fires before input blur so the selection registers before blur-hide kicks in resultsEl.addEventListener('mousedown', (event) => { const target = (event.target as HTMLElement).closest('.result'); if (!target) return; event.preventDefault(); finish(target); }, {signal: lifecycleController.signal}); document.addEventListener('click', (event) => { if (!container.contains(event.target as Node)) hide(); }, {signal: lifecycleController.signal}); input.addEventListener('blur', () => setTimeout(hide, 150), {signal: lifecycleController.signal}); // deferred so a result mousedown can land first }); }