import { catalogAppendCount, createCatalogSkeleton } from './catalog-loading'; interface GridWindow { start: number; end: number; before: number; after: number } export interface TemplateGridPosition { index: number; scrollTop: number } /** Keep complete catalog navigation while mounting only nearby rows. */ export const templateGridWindow = (total: number, columns: number, stride: number, offset: number, height: number): GridWindow => { const rows = Math.ceil(total / columns); const visible = Math.ceil(height / stride); const count = Math.min(rows, Math.max(6, visible + 4)); const first = Math.max(0, Math.min(rows - count, Math.floor(Math.max(0, offset) / stride) - 2)); const last = Math.min(rows, first + count); return { start: first * columns, end: Math.min(total, last * columns), before: first * stride, after: (rows - last) * stride }; }; export const createTemplateGrid = ({ content, createCard, onLoading }: { content: HTMLElement; createCard: (row: T, eager: boolean) => HTMLButtonElement; onLoading: (loading: boolean) => void; }): { setRows: (rows: T[], position?: TemplateGridPosition) => void; appendRows: (rows: T[]) => void; setPending: (pending: boolean) => void; retainViewport: () => (() => void) | undefined; position: () => TemplateGridPosition; suspend: () => void; resume: (position?: TemplateGridPosition) => void; clear: () => void; destroy: () => void } => { let rows: T[] = []; let revealed = 0; let frame = 0; let destroyed = false; let suspended = false; let selected = 0; let root: HTMLElement | null = null; let columns = 4; let stride = 350; let windowStart = -1; let windowEnd = -1; let pending = false; let pendingCards: HTMLElement[] = []; const cards = new Map(); const bounds = (): { top: number; height: number } => root ? { top: root.getBoundingClientRect().top, height: root.clientHeight } : { top: 0, height: window.innerHeight }; const findRoot = (): HTMLElement | null => { for (let parent = content.parentElement; parent; parent = parent.parentElement) { if (/^(auto|scroll)$/.test(window.getComputedStyle(parent).overflowY)) return parent; } return null; }; const measure = (): void => { const style = window.getComputedStyle(content); columns = Math.max(1, style.gridTemplateColumns.split(/\s+/).filter(Boolean).length); const card = content.querySelector('.fotogenic-ai-template-card'); if (card) stride = card.getBoundingClientRect().height + (Number.parseFloat(style.rowGap) || 0); stride = Math.max(1, stride); }; const render = (index?: number): void => { if (destroyed || suspended || !rows.length) return; measure(); const pendingCount = pending ? catalogAppendCount(content, '.fotogenic-ai-template-card') : 0; if (pendingCards.length !== pendingCount) { pendingCards = pendingCount ? Array.from(createCatalogSkeleton('', pendingCount).children) as HTMLElement[] : []; pendingCards.forEach(card => { card.dataset.faCatalogAppendSkeleton = ''; }); windowStart = -1; } const view = bounds(); const offset = index === undefined ? view.top - content.getBoundingClientRect().top : Math.floor(index / columns) * stride; if (index !== undefined) revealed = Math.min(rows.length, Math.max(revealed, Math.ceil((index + 1) / 24) * 24)); const range = templateGridWindow(revealed + pendingCount, columns, stride, offset, view.height); let focusedIndex = -1; if (range.start !== windowStart || range.end !== windowEnd) { const active = document.activeElement; focusedIndex = active && content.contains(active) ? Number(active.closest('[data-template-index]')?.dataset.templateIndex) : -1; const nodes: HTMLElement[] = []; for (let i = range.start; i < range.end; i++) { if (i >= revealed) { nodes.push(pendingCards[i - revealed]!); continue; } const card = cards.get(i) ?? createCard(rows[i]!, i < range.start + columns); card.dataset.templateIndex = String(i); cards.set(i, card); nodes.push(card); } // Retain mounted cards while reconciling the window. Detaching every card // briefly collapses the scroll range and makes WebKit clamp its position. nodes.forEach((card, index) => { const current = content.children[index]; if (current !== card) content.insertBefore(card, current ?? null); }); while (content.children.length > nodes.length) content.lastElementChild?.remove(); for (const key of cards.keys()) if (key < range.start || key >= range.end) cards.delete(key); windowStart = range.start; windowEnd = range.end; } content.style.paddingBlockStart = `${range.before}px`; content.style.paddingBlockEnd = `${range.after}px`; if (index === undefined && focusedIndex >= range.start && focusedIndex < range.end) cards.get(focusedIndex)?.focus({ preventScroll: true }); if (index !== undefined) { const card = cards.get(index); card?.scrollIntoView({ block: 'nearest', behavior: 'instant' }); card?.focus({ preventScroll: true }); } }; const schedule = (): void => { if (destroyed || suspended || !rows.length || frame) return; const view = bounds(); const nearEnd = view.top + view.height + 200 >= content.getBoundingClientRect().top + Math.ceil(revealed / columns) * stride; const append = nearEnd && revealed < rows.length; if (append) onLoading(true); frame = window.requestAnimationFrame(() => { frame = 0; if (append) revealed = Math.min(rows.length, revealed + 24); render(); onLoading(false); }); }; const keydown = (event: KeyboardEvent): void => { const card = (event.target as HTMLElement).closest('[data-template-index]'); if (!card) return; const index = Number(card.dataset.templateIndex); const offsets: Record = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -columns, ArrowDown: columns }; let next = event.key === 'Home' ? 0 : event.key === 'End' ? rows.length - 1 : Object.hasOwn(offsets, event.key) ? index + offsets[event.key]! : undefined; if (event.key === 'Tab' && ((!event.shiftKey && index === windowEnd - 1 && index < rows.length - 1) || (event.shiftKey && index === windowStart && index > 0))) next = index + (event.shiftKey ? -1 : 1); if (next === undefined) return; event.preventDefault(); selected = Math.max(0, Math.min(rows.length - 1, next)); render(selected); }; const remember = (event: Event): void => { const card = (event.target as HTMLElement).closest('[data-template-index]'); if (card) selected = Number(card.dataset.templateIndex); }; const suspend = (): void => { suspended = true; if (frame) window.cancelAnimationFrame(frame); frame = 0; onLoading(false); }; const clear = (): void => { rows = []; revealed = 0; pending = false; pendingCards = []; suspended = false; cards.clear(); windowStart = -1; windowEnd = -1; if (frame) window.cancelAnimationFrame(frame); frame = 0; onLoading(false); content.style.paddingBlockStart = ''; content.style.paddingBlockEnd = ''; root?.removeEventListener('scroll', schedule); root = null; }; const observer = new ResizeObserver(() => { windowStart = -1; schedule(); }); observer.observe(content); window.addEventListener('scroll', schedule, { passive: true }); content.addEventListener('keydown', keydown); content.addEventListener('click', remember, true); content.addEventListener('focusin', remember); return { setRows(nextRows, position) { clear(); rows = nextRows; revealed = Math.min(rows.length, 24); selected = position?.index ?? 0; root = findRoot(); root?.addEventListener('scroll', schedule, { passive: true }); render(position?.index); if (position && root) root.scrollTop = position.scrollTop; schedule(); }, appendRows(nextRows) { rows = nextRows.slice(); revealed = rows.length; pending = false; if (!root) { root = findRoot(); root?.addEventListener('scroll', schedule, { passive: true }); } render(); schedule(); }, setPending(value) { if (destroyed || pending === value) return; pending = value; render(); }, retainViewport() { if (destroyed || suspended) return; const view = bounds(); const visible = [...content.querySelectorAll('[data-template-index]')].filter(card => { const rect = card.getBoundingClientRect(); return rect.bottom > view.top && rect.top < view.top + view.height; }); const anchor = visible.find(card => card === document.activeElement) ?? visible[0]; if (!anchor) return; const top = anchor.getBoundingClientRect().top; // A preceding section can grow during the same page commit. Keep this // window mounted until its scroll owner has absorbed that displacement. suspend(); return () => { if (destroyed || !content.contains(anchor)) return; const delta = anchor.getBoundingClientRect().top - top; if (delta) { if (root) root.scrollTop += delta; else window.scrollTo({ top: window.scrollY + delta, left: window.scrollX, behavior: 'instant' }); } suspended = false; render(); schedule(); }; }, position: () => ({ index: selected, scrollTop: root?.scrollTop ?? window.scrollY }), suspend, resume(position) { if (destroyed) return; suspended = false; if (position) { selected = Math.max(0, Math.min(rows.length - 1, position.index)); render(selected); if (root) root.scrollTop = position.scrollTop; else window.scrollTo({ top: position.scrollTop, left: window.scrollX, behavior: 'instant' }); } schedule(); }, clear, destroy() { destroyed = true; clear(); observer.disconnect(); window.removeEventListener('scroll', schedule); content.removeEventListener('keydown', keydown); content.removeEventListener('click', remember, true); content.removeEventListener('focusin', remember); }, }; };