import './template-browser.css'; import { createSelect } from '../select/custom-select'; import { apiAuthRefusalMessage, curatedPreviewUrl, createCuratedPicker, type ListSavedModels } from './curated-picker'; import { cachedCatalogRequest, catalogOwnerKey, clearCatalogMemory, peekCatalog, refreshCatalog, updatePresetDisplay, type CatalogRequest, type CatalogResult } from './catalog-cache'; import { createCatalogAppendSkeleton, createCatalogLoading, createCatalogPreview, createCatalogSkeleton } from './catalog-loading'; import { createCatalogCarousel } from './catalog-carousel'; import { createTemplateGrid, type TemplateGridPosition } from './template-grid'; import { parseTemplateDetail, parseTemplateSelection, templateIdentity, templateModelAllowed, type TemplateDetail, type TemplateModel, type TemplateSelection } from './template-policy'; export { parseTemplateDetail, parseTemplateSelection, templateModelAllowed } from './template-policy'; export type { TemplateOutput, TemplateModel, TemplateEnvironment, TemplateSelection } from './template-policy'; export interface TemplatePresentation extends Pick { ownerKey: string; sourceGuidance: string; model?: { selection: TemplateModel; name: string; previewSrc?: string }; } interface Options { mount: HTMLElement; actionsMount?: HTMLElement; layout?: 'grid' | 'carousel'; allowModelSelection?: boolean; request: CatalogRequest; onSelect: (selection: TemplateSelection, title: string, presentation?: TemplatePresentation) => void; onRequestUpload?: () => Promise; listLibrary?: ListSavedModels; isConnected?: () => boolean; publicTemplates?: unknown; showFeatured?: boolean; onConnect?: () => void; onError?: (message: string) => void; onAvailability?: (available: boolean) => void; translate: (text: string) => string; } interface Choice { id: string; title: string } interface Section extends Choice { categoryId: string; productTypeId: string; rank: number } interface Card extends Choice { description: string; preview: Record; categoryId?: string; sectionId?: string; placements: { productTypeId: string; sectionId: string }[] } interface Group { node: HTMLElement; grid: HTMLElement; cards: Card[]; virtual?: ReturnType>; append?: ReturnType; syncNavigation?: () => void; destroy: () => void } const object = (value: unknown): Record => value !== null && typeof value === 'object' && !Array.isArray(value) ? value as Record : {}; const opaque = (value: unknown): value is string => typeof value === 'string' && value.trim().length > 0 && value.length <= 8192 && !/[\u0000-\u001f\u007f]/.test(value); const choices = (value: unknown): Choice[] | null => { if (!Array.isArray(value)) return null; const rows: Choice[] = []; for (const raw of value) { const row = object(raw); if (!templateIdentity(row.id) || typeof row.title !== 'string' || !row.title.trim() || rows.some(item => item.id === row.id)) return null; rows.push({ id: row.id, title: row.title }); } return rows; }; const parseCards = (value: unknown): Card[] | null => { if (!Array.isArray(value) || value.length > 24) return null; const rows: Card[] = []; for (const raw of value) { const row = object(raw), placements: Card['placements'] = []; if (!templateIdentity(row.id) || typeof row.title !== 'string' || !row.title.trim() || (row.sectionId !== undefined && !templateIdentity(row.sectionId))) return null; if (row.sectionPlacements !== undefined) { if (!Array.isArray(row.sectionPlacements)) return null; for (const rawPlacement of row.sectionPlacements) { const placement = object(rawPlacement); if (!templateIdentity(placement.productTypeId) || !templateIdentity(placement.sectionId)) return null; placements.push({ productTypeId: placement.productTypeId, sectionId: placement.sectionId }); } } rows.push({ id: row.id, title: row.title, description: typeof row.shortDescription === 'string' ? row.shortDescription : '', preview: object(row.preview), categoryId: templateIdentity(row.categoryId) ? row.categoryId : undefined, sectionId: row.sectionId as string | undefined, placements }); } return rows; }; // The wide Dashboard carousel shows ten cards per page. const FEATURED_CARD_LIMIT = 20; const isFeaturedCard = (card: Card): boolean => !/\bfront[\s-]+views?\b/i.test(card.title); const featuredCards = (cards: Card[]): Card[] => { const eligible = cards.filter(isFeaturedCard); const withPreviews = eligible.filter(card => curatedPreviewUrl(card.preview.src)); const candidates = withPreviews.length ? withPreviews : eligible; const titleKey = (card: Card): string => card.title.trim().toLowerCase(); const titleCounts = new Map(); for (const card of candidates) { const title = titleKey(card); titleCounts.set(title, (titleCounts.get(title) ?? 0) + 1); } const occurrences = (card: Card): number => titleCounts.get(titleKey(card)) ?? 0; const ranked = [...candidates].sort((left, right) => occurrences(left) - occurrences(right)); const firstPerCategory = new Map(); for (const card of ranked) { if (card.categoryId && !firstPerCategory.has(card.categoryId)) firstPerCategory.set(card.categoryId, card); } const featured = new Set(firstPerCategory.values()); return [...featured, ...ranked.filter(card => !featured.has(card))].slice(0, FEATURED_CARD_LIMIT); }; /** Prepare only the first visible page. The browser still checks catalog access before rendering it. */ export const prefetchTemplates = async (rawRequest: CatalogRequest, signal: AbortSignal): Promise => { const request = cachedCatalogRequest(rawRequest); const navigation = request('catalog', {}, signal); const firstPage = request('presets', { limit: '24' }, signal); const result = await navigation; if (!result.ok) { if (!result.aborted && !signal.aborted) clearCatalogMemory(); await firstPage; return result; } return firstPage; }; /** Featured artwork can be bundled. Applying a template always requires current authenticated detail. */ export const createTemplateBrowser = ({ mount, actionsMount, layout = 'grid', allowModelSelection = true, request: rawRequest, onSelect, onRequestUpload, listLibrary, publicTemplates, showFeatured = false, isConnected = () => document.querySelector('[data-fa-catalog-cache]')?.dataset.connected === '1', onConnect, onError, onAvailability, translate: t }: Options): { destroy: () => void } => { const request = cachedCatalogRequest(rawRequest); const publicCards = parseCards(publicTemplates) ?? []; const bundledFeatured = showFeatured ? publicCards.filter(isFeaturedCard).slice(0, FEATURED_CARD_LIMIT) : []; const unavailableFeatured = new Set(); let destroyed = false, listEpoch = 0, categoryEpoch = 0, detailEpoch = 0, busy = false, halted = false, cursorRestarted = false; let catalogBusy = false, typeBusy = false, detailBusy = false; let category = '', productType = '', cursor: string | undefined, sections: Section[] = []; let featured = showFeatured; let listController = new AbortController(), typeController = new AbortController(), detailController = new AbortController(); let picker: ReturnType | undefined; const ids = new Set(), cursors = new Set(), groups = new Map(), selectors: ReturnType[] = []; let detailPosition: { group: Group; position: TemplateGridPosition } | undefined; const node = (tag: K, text = '', className = ''): HTMLElementTagNameMap[K] => { const element = document.createElement(tag); element.className = className; element.textContent = text; return element; }; const button = (text: string, action: () => void, className = ''): HTMLButtonElement => { const element = node('button', text, className); element.type = 'button'; element.addEventListener('click', action); return element; }; const status = node('p', '', 'fotogenic-ai-template-status'); status.setAttribute('role', 'status'); const filters = node('div', '', 'fotogenic-ai-template-filters'); const list = node('div', '', 'fotogenic-ai-template-content'); const detailMount = node('div', '', 'fotogenic-ai-template-content'); detailMount.hidden = true; const loading = createCatalogLoading(t, 'fotogenic-ai-template-grid', undefined, 'screen-reader'); loading.hidden = true; const sentinel = node('div', '', 'fotogenic-ai-curated-sentinel'); sentinel.hidden = true; mount.classList.add('fotogenic-ai-template-browser'); mount.dataset.layout = layout; mount.replaceChildren(status, filters, list, sentinel, detailMount, loading); const active = (epoch: number): boolean => !destroyed && epoch === listEpoch && !listController.signal.aborted; const clearAppendSkeletons = (): void => { groups.forEach(group => group.append?.clear()); }; const syncAppendSkeletons = (): void => { groups.forEach(group => { const pending = busy && ids.size > 0 && detailMount.hidden && group.node === list.lastElementChild; group.virtual?.setPending(pending); group.append?.sync(pending); }); }; const syncLoading = (): void => { syncAppendSkeletons(); groups.forEach(group => group.syncNavigation?.()); loading.dataset.append = String(ids.size > 0 || !detailMount.hidden); loading.hidden = detailMount.hidden ? !catalogBusy && !typeBusy && !busy : !detailBusy; }; const setBusy = (value: boolean): void => { busy = value; syncLoading(); list.setAttribute('aria-busy', String(value)); }; const report = (message = t('We could not load the templates. Reload the page and try again. If this continues, contact support.')): void => { if (!destroyed) onError?.(message); }; const reportReadFailure = (result: CatalogResult, fallback?: string): void => report(result.wpSessionExpired ? t('Sign in to WordPress again, then reopen Templates.') : apiAuthRefusalMessage(result, t) ?? (result.authExpired || result.status === 401 ? t('Sign in to Fotogenic AI, then open Templates again.') : result.status === 403 ? t('You do not have permission to browse these templates. Contact your site administrator.') : fallback)); const observer = new IntersectionObserver(entries => { if (entries.some(entry => entry.isIntersecting)) void loadPage(false); }, { rootMargin: '200px' }); const syncContinuation = (): void => { observer.unobserve(sentinel); const lastGrid = list.lastElementChild?.querySelector('.fotogenic-ai-template-grid'); const vertical = layout === 'grid' || Boolean(lastGrid && lastGrid.clientWidth > 0 && lastGrid.scrollWidth <= lastGrid.clientWidth + 1); sentinel.hidden = destroyed || busy || halted || !cursor || !detailMount.hidden || !vertical; if (!sentinel.hidden) observer.observe(sentinel); }; const resetGroups = (): void => { clearAppendSkeletons(); groups.forEach(group => group.destroy()); groups.clear(); ids.clear(); cursors.clear(); list.replaceChildren(); cursor = undefined; sentinel.hidden = true; observer.unobserve(sentinel); }; const closeDetail = (restoreFocus = true): void => { const saved = detailPosition; detailPosition = undefined; detailEpoch++; detailController.abort(); picker?.destroy(); picker = undefined; detailBusy = false; detailMount.setAttribute('aria-busy', 'false'); detailMount.replaceChildren(); detailMount.hidden = true; filters.hidden = !filters.childElementCount; list.hidden = false; syncLoading(); if (actionsMount) { actionsMount.replaceChildren(); actionsMount.hidden = true; } if (restoreFocus && saved) saved.group.virtual?.resume(saved.position); groups.forEach(group => { if (!restoreFocus || group !== saved?.group) group.virtual?.resume(); }); if (restoreFocus) opener?.focus({ preventScroll: true }); syncContinuation(); }; let opener: HTMLButtonElement | undefined; const image = (preview: Record, eager = false): HTMLElement => { const src = curatedPreviewUrl(preview.src), alt = typeof preview.alt === 'string' ? preview.alt : ''; const element = createCatalogPreview(src, t('Preview unavailable'), eager); element.classList.add('fotogenic-ai-template-image'); const img = element.querySelector('img'); if (img) { img.alt = alt; if (Number.isSafeInteger(preview.width) && Number(preview.width) > 0) img.width = Number(preview.width); if (Number.isSafeInteger(preview.height) && Number(preview.height) > 0) img.height = Number(preview.height); } return element; }; const renderCard = (card: HTMLButtonElement, row: Card, eager: boolean): void => { const copy = node('span', '', 'fotogenic-ai-template-card-copy'); copy.append(node('strong', row.title)); if (row.description) copy.append(node('small', row.description)); card.replaceChildren(image(row.preview, eager), copy); }; const createCard = (row: Card, eager: boolean): HTMLButtonElement => { const card = button('', () => { opener = card; void loadDetail(row); }, 'fotogenic-ai-template-card'); card.dataset.templateId = row.id; renderCard(card, row, eager); return card; }; const renewCard = (detail: TemplateDetail): void => { updatePresetDisplay(detail); for (const group of groups.values()) { const row = group.cards.find(card => card.id === detail.id); if (!row) continue; row.title = detail.title; row.preview = { ...detail.preview }; for (const card of group.grid.querySelectorAll('[data-template-id]')) if (card.dataset.templateId === detail.id && card !== opener) renderCard(card, row, true); if (opener?.dataset.templateId === detail.id) renderCard(opener, row, true); } }; const createGroup = (id: string, title: string): Group => { const section = node('section', '', 'fotogenic-ai-template-group'); section.dataset.sectionId = id; if (title) section.append(node('h3', title, 'fotogenic-ai-template-group-heading')); const frame = node('div', '', 'fotogenic-ai-template-viewport'), grid = node('div', '', 'fotogenic-ai-template-grid'); frame.append(grid); section.append(frame); let carousel: ReturnType | undefined; if (layout === 'carousel') { carousel = createCatalogCarousel({ frame, grid, previousLabel: t('Previous templates'), nextLabel: t('Next templates'), onScroll: () => { if (grid.scrollLeft + grid.clientWidth * 2 >= grid.scrollWidth) void loadPage(false); }, onResize: () => { syncAppendSkeletons(); syncContinuation(); } }); } const group: Group = { node: section, grid, cards: [], syncNavigation: carousel?.sync, ...(layout === 'grid' ? { virtual: createTemplateGrid({ content: grid, createCard, onLoading() {} }) } : { append: createCatalogAppendSkeleton(grid, { cardSelector: '[data-template-id]' }) }), destroy: () => { group.virtual?.destroy(); group.append?.destroy(); carousel?.destroy(); } }; groups.set(id, group); const order = id === 'popular' ? -1 : sections.findIndex(section => section.id === id); const following = [...groups].filter(([other]) => other !== id && sections.findIndex(section => section.id === other) > order) .sort(([a], [b]) => sections.findIndex(section => section.id === a) - sections.findIndex(section => section.id === b))[0]?.[1]; list.insertBefore(section, following?.node ?? null); return group; }; const groupFor = (row: Card): { id: string; title: string } | null => { if (featured) return { id: '', title: t('Featured templates') }; if (!category) return { id: '', title: '' }; if (!productType && category) return { id: 'popular', title: t('Most popular') }; const placement = row.placements.find(value => value.productTypeId === productType); const section = sections.find(value => value.id === (placement?.sectionId || row.sectionId) && (!category || value.categoryId === category) && (!productType || value.productTypeId === productType)); if (section) return section; return !sections.length ? { id: '', title: '' } : null; }; const retainViewport = (): (() => void) | undefined => { const focused = [...groups.values()].find(group => group.grid.contains(document.activeElement)); const restore = focused?.virtual?.retainViewport(); if (restore) return restore; for (const section of list.children) { const restore = groups.get((section as HTMLElement).dataset.sectionId || '')?.virtual?.retainViewport(); if (restore) return restore; } return undefined; }; list.addEventListener('focusin', event => { const card = (event.target as HTMLElement).closest('[data-template-id]'); if (card && [...ids].slice(-4).includes(card.dataset.templateId || '')) void loadPage(false); }); const appendCards = (cards: Card[]): boolean => { const staged = cards.map(card => ({ card, group: groupFor(card) })); if (staged.some(value => !value.group)) return false; const changed = new Set(); for (const { card, group: placement } of staged) { if (ids.has(card.id)) continue; ids.add(card.id); const group = groups.get(placement!.id) || createGroup(placement!.id, placement!.title); group.cards.push(card); changed.add(group); if (!group.virtual) group.grid.append(createCard(card, group.cards.length <= 5)); } changed.forEach(group => group.virtual?.appendRows(group.cards)); return true; }; const loadPage = async (reset: boolean, initialResult?: CatalogResult): Promise => { if (destroyed || busy || (!reset && (!cursor || halted || !detailMount.hidden))) return; const epoch = listEpoch; observer.unobserve(sentinel); if (reset) resetGroups(); status.textContent = ''; if (featured && bundledFeatured.length) { // Current authenticated detail can refresh rendered cards without changing the public collection. appendCards(bundledFeatured.filter(card => !unavailableFeatured.has(card.id)).map(card => ({ ...card }))); if (!ids.size) status.textContent = t('No templates are available for this selection.'); syncLoading(); syncContinuation(); return; } setBusy(true); let restoreViewport: (() => void) | undefined; try { const popular = Boolean(category && !productType); const query = { ...(category ? { categoryId: category } : {}), ...(productType ? { productTypeId: productType } : {}), ...(popular ? { sort: 'popular' } : { limit: '24', ...(cursor ? { cursor } : {}) }) }; const result = initialResult || await request('presets', query, listController.signal); if (!active(epoch) || result.aborted) return; if (!result.ok && cursor && [400, 409].includes(result.status || 0) && !cursorRestarted) { cursorRestarted = true; clearCatalogMemory(); setBusy(false); await loadPage(true); return; } if (!result.ok) { halted = true; reportReadFailure(result); return; } const data = object(result.data), cards = parseCards(data.items), next = data.nextCursor; if (!cards || (next !== undefined && (!opaque(next) || popular || cursors.has(next) || !cards.length))) { halted = true; report(); return; } let displayCards = featured ? featuredCards(cards) : cards; if (featured && displayCards.length < FEATURED_CARD_LIMIT && typeof next === 'string') { const supplement = await request('presets', { limit: '24', cursor: next }, listController.signal); if (!active(epoch) || supplement.aborted) return; const moreCards = supplement.ok ? parseCards(object(supplement.data).items) : null; if (moreCards) { const unique = new Map(cards.map(card => [card.id, card])); for (const card of moreCards) { if (!unique.has(card.id)) unique.set(card.id, card); } displayCards = featuredCards([...unique.values()]); } else if (!displayCards.length) { reportReadFailure(supplement); return; } } restoreViewport = retainViewport(); clearAppendSkeletons(); if (!appendCards(displayCards)) { halted = true; report(); return; } cursor = !featured && typeof next === 'string' ? next : undefined; if (cursor) cursors.add(cursor); if (!ids.size) status.textContent = t('No templates are available for this selection.'); } catch { if (active(epoch)) { halted = true; report(); } } finally { if (active(epoch)) { setBusy(false); restoreViewport?.(); syncContinuation(); } } }; const select = (label: string, values: Choice[], change: (value: string) => void, selectedId = ''): { native: HTMLSelectElement; custom: ReturnType } => { const wrapper = node('label'), native = node('select'); wrapper.append(node('span', label, 'screen-reader-text')); values.forEach(value => { const option = node('option', value.title); option.value = value.id; native.append(option); }); native.value = selectedId; native.addEventListener('change', () => change(native.value)); const custom = createSelect({ select: native, label }); selectors.push(custom); wrapper.append(native, custom.element); filters.append(wrapper); return { native, custom }; }; let productSelect: ReturnType | undefined; const resetList = (): void => { listEpoch++; listController.abort(); listController = new AbortController(); busy = false; halted = false; cursorRestarted = false; closeDetail(false); resetGroups(); }; const loadTypes = async (): Promise => { const epoch = categoryEpoch; typeController.abort(); typeController = new AbortController(); typeBusy = true; syncLoading(); if (productSelect) { productSelect.native.disabled = true; productSelect.custom.sync(); } try { const result = await request('product-types', { categoryId: category }, typeController.signal); if (destroyed || epoch !== categoryEpoch || typeController.signal.aborted || result.aborted) return; const data = object(result.data), rows = choices(data.items); if (!result.ok || data.categoryId !== category || !rows || rows.length > 32) { reportReadFailure(result, t('Product filters could not be loaded. You can browse popular templates, or reload the page to restore the filters.')); return; } if (productSelect) { productSelect.native.replaceChildren(...[{ id: '', title: t('All product types') }, ...rows].map(row => { const option = node('option', row.title); option.value = row.id; return option; })); productSelect.native.value = ''; productSelect.native.disabled = !rows.length; productSelect.custom.sync(); } } catch { if (!destroyed && epoch === categoryEpoch) report(t('Product filters could not be loaded. You can browse popular templates, or reload the page to restore the filters.')); } finally { if (!destroyed && epoch === categoryEpoch) { typeBusy = false; syncLoading(); } } }; const chooseCategory = (id: string, showFeaturedView: boolean): void => { categoryEpoch++; category = id; productType = ''; featured = showFeaturedView; resetList(); if (productSelect) { const option = node('option', t('All product types')); option.value = ''; productSelect.native.replaceChildren(option); productSelect.native.value = ''; productSelect.native.disabled = true; productSelect.custom.sync(); } if (category) void loadTypes(); else { typeController.abort(); typeBusy = false; } void loadPage(true); }; const createDetailPanel = (detail: Pick) => { const panel = node('section', '', 'fotogenic-ai-template-detail-panel'); panel.setAttribute('aria-label', detail.title); const toolbar = node('div', '', 'fotogenic-ai-template-detail-toolbar'); toolbar.append(button(t('Back to templates'), () => closeDetail(), 'fotogenic-ai-template-back')); const header = node('div', '', 'fotogenic-ai-template-detail'), copy = node('div'), heading = node('h3', detail.title), description = node('p', detail.description), preview = image(detail.preview); heading.tabIndex = -1; description.hidden = !detail.description; copy.append(heading, description); header.append(preview, copy); panel.append(toolbar, header); return { panel, copy, heading, description, preview }; }; const renderDetail = (detail: TemplateDetail, token: number, presentation: ReturnType): void => { const noModelAllowed = templateModelAllowed(detail.modelPolicy, { sourceType: 'none' }); const selection: TemplateSelection = { creationPresetId: detail.id, output: detail.defaultOutput, ...(noModelAllowed ? { modelSelection: { sourceType: 'none' } } : {}) }; let modelPresentation: TemplatePresentation['model'] = detail.modelPolicy.mode !== 'none' && noModelAllowed ? { selection: { sourceType: 'none' }, name: t('No model') } : undefined; const { panel, copy, heading, description, preview } = presentation; panel.setAttribute('aria-label', detail.title); heading.textContent = detail.title; description.textContent = detail.description; description.hidden = !detail.description; const currentImage = preview.querySelector('img'); if (!currentImage || currentImage.src !== detail.preview.src) preview.replaceWith(image(detail.preview)); else { currentImage.alt = detail.preview.alt; if (detail.preview.width) currentImage.width = detail.preview.width; if (detail.preview.height) currentImage.height = detail.preview.height; } copy.append(node('p', `${detail.defaultOutput.quality} · ${detail.defaultOutput.aspectRatio.replace('_', ':')} · ${detail.defaultOutput.count} ${t(detail.defaultOutput.count === 1 ? 'image' : 'images')}`, 'fotogenic-ai-template-output')); if (detail.productImages.guidance) { const guidance = node('details', '', 'fotogenic-ai-template-guidance'); guidance.append(node('summary', t('Source image guidance')), node('p', detail.productImages.guidance)); panel.append(guidance); } const actions = node('div', '', 'fotogenic-ai-template-actions'), selectedText = node('p', '', 'fotogenic-ai-template-selection-status'); selectedText.setAttribute('role', 'status'); const valid = (): boolean => templateModelAllowed(detail.modelPolicy, selection.modelSelection); const apply = button(t('Use this template'), () => { if (destroyed || token !== detailEpoch || apply.disabled) return; if (!isConnected()) { onConnect?.(); return; } onSelect(selection, detail.title, { id: detail.id, title: detail.title, description: detail.description, preview: { ...detail.preview }, sourceGuidance: detail.productImages.guidance, ownerKey: catalogOwnerKey(), ...(modelPresentation ? { model: modelPresentation } : {}) }); }, 'fotogenic-ai-template-primary fotogenic-ai-recipe-primary'); apply.disabled = allowModelSelection && !valid(); if (allowModelSelection && detail.modelPolicy.mode !== 'none') { const modelArea = node('div', '', 'fotogenic-ai-template-models'); const chooseModel = (model: TemplateModel, label: string, previewSrc?: string): void => { if (destroyed || token !== detailEpoch || !templateModelAllowed(detail.modelPolicy, model)) return; selection.modelSelection = model; selectedText.textContent = `${t('Selected model')}: ${label}`; apply.disabled = false; modelPresentation = { selection: { ...model }, name: label, ...(previewSrc ? { previewSrc: curatedPreviewUrl(previewSrc) } : {}) }; none?.setAttribute('aria-pressed', String(model.sourceType === 'none')); picker?.setSelection(model.sourceType === 'curated' ? model : model.sourceType === 'user' ? { id: model.id } : undefined, model.sourceType === 'upload' ? model.attachmentId : undefined); }; const none = noModelAllowed ? button(t('No model'), () => chooseModel({ sourceType: 'none' }, t('No model selected')), 'fotogenic-ai-template-secondary fotogenic-ai-recipe-secondary') : undefined; if (none) { none.setAttribute('aria-pressed', 'true'); modelArea.append(none); } if (onRequestUpload && detail.modelPolicy.allowUpload) { const upload = button(t('Use my own model image'), () => { upload.disabled = true; void onRequestUpload().then(id => { if (Number.isSafeInteger(id) && Number(id) > 0) chooseModel({ sourceType: 'upload', attachmentId: Number(id) }, t('Your model image')); }).catch(() => { if (!destroyed && token === detailEpoch) report(t('The model image could not be selected. Choose another image and try again.')); }).finally(() => { if (!destroyed && token === detailEpoch) upload.disabled = false; }); }, 'fotogenic-ai-template-secondary fotogenic-ai-recipe-secondary'); modelArea.append(upload); } const modelMount = node('div', '', 'fotogenic-ai-template-model-picker'); modelArea.append(modelMount); picker = createCuratedPicker({ mount: modelMount, kind: 'models', translate: t, allowCurated: detail.modelPolicy.allowCurated, allowAccountModels: isConnected() && detail.modelPolicy.allowUserModels, allowSavedModels: isConnected() && detail.modelPolicy.allowUpload, transport: { listLibrary, curatedPage: (kind, query, options) => rawRequest(kind, { ...query, ...(options.refresh ? { refresh: '1' } : {}) }, options.signal) }, onSelect: (model, item) => chooseModel(model.revision === undefined ? { sourceType: 'user', id: model.id } : { sourceType: 'curated', id: model.id, revision: model.revision }, item.name, item.preview.src), onSelectSaved: item => chooseModel({ sourceType: 'upload', attachmentId: item.attachmentId }, item.name), onError: message => { if (!destroyed && token === detailEpoch) report(message); } }); if (!valid()) selectedText.textContent = t('Choose a model to use this template.'); panel.append(modelArea); } const actionsParent = actionsMount ?? panel; actions.append(selectedText, apply); actionsParent.querySelector('.fotogenic-ai-template-actions')?.remove(); actionsParent.append(actions); }; const loadDetail = async (row: Card): Promise => { const previewOnly = !isConnected(); const id = row.id; if (detailMount.hidden) { const group = [...groups.values()].find(value => value.cards.some(card => card.id === id)); if (group?.virtual) detailPosition = { group, position: { ...group.virtual.position(), index: group.cards.findIndex(card => card.id === id) } }; groups.forEach(value => value.virtual?.suspend()); } listEpoch++; listController.abort(); listController = new AbortController(); busy = false; const token = ++detailEpoch; detailController.abort(); detailController = new AbortController(); picker?.destroy(); picker = undefined; observer.unobserve(sentinel); filters.hidden = true; list.hidden = true; detailMount.hidden = false; detailMount.setAttribute('aria-busy', String(!previewOnly)); detailBusy = !previewOnly; syncLoading(); const presentation = createDetailPanel(row), { panel, heading } = presentation, actions = node('div', '', 'fotogenic-ai-template-actions'); const apply = node('button', t('Use this template'), 'fotogenic-ai-template-primary fotogenic-ai-recipe-primary'); apply.type = 'button'; apply.disabled = true; actions.append(node('p', '', 'fotogenic-ai-template-selection-status'), apply); detailMount.replaceChildren(panel); if (actionsMount) { actionsMount.replaceChildren(actions); actionsMount.hidden = false; } else panel.append(actions); heading.focus({ preventScroll: true }); if (previewOnly) { apply.textContent = t('Connect to use this template'); apply.disabled = false; apply.addEventListener('click', () => { if (!destroyed && token === detailEpoch) onConnect?.(); }); return; } try { const result = await request('detail', { presetId: id }, detailController.signal); if (destroyed || token !== detailEpoch || result.aborted) return; if (!result.ok) { closeDetail(); if ([404, 410].includes(result.status || 0)) { if (featured && bundledFeatured.some(card => card.id === id)) unavailableFeatured.add(id); report(t('This template is no longer available. Choose another template.')); clearCatalogMemory(); resetList(); void loadPage(true); } else reportReadFailure(result); return; } const detail = parseTemplateDetail(result.data); if (!detail || detail.id !== id) { closeDetail(); report(); return; } renewCard(detail); renderDetail(detail, token, presentation); } catch { if (!destroyed && token === detailEpoch) { closeDetail(); report(); } } finally { if (!destroyed && token === detailEpoch) { detailBusy = false; detailMount.setAttribute('aria-busy', 'false'); syncLoading(); } } }; const start = async (): Promise => { categoryEpoch++; typeController.abort(); typeBusy = false; resetList(); selectors.splice(0).forEach(select => select.destroy()); filters.replaceChildren(); productSelect = undefined; status.textContent = ''; category = ''; productType = ''; featured = showFeatured; filters.hidden = !isConnected(); if (!filters.hidden) filters.append(...Array.from(createCatalogSkeleton('', 2).children)); catalogBusy = !peekCatalog('catalog', {}) || (!bundledFeatured.length && !peekCatalog('presets', { limit: '24' })); syncLoading(); const epoch = listEpoch; if (!isConnected()) { catalogBusy = false; syncLoading(); const cards = featured ? bundledFeatured : publicCards; if (!cards.length) { status.textContent = t('Connect Fotogenic AI to browse templates.'); return; } appendCards(cards); syncLoading(); syncContinuation(); return; } try { const navigation = request('catalog', {}, listController.signal); const firstPage = bundledFeatured.length ? undefined : request('presets', { limit: '24' }, listController.signal); const result = await navigation; if (!active(epoch) || result.aborted) return; const discard = (): void => { listController.abort(); clearCatalogMemory(); filters.replaceChildren(); filters.hidden = true; catalogBusy = false; syncLoading(); }; if (!result.ok) { discard(); const unavailable = result.status === 403 && ['creation_presets_unavailable', 'fotogenic_ai_creation_presets_unavailable'].includes(String(result.code || object(result.data).code).toLowerCase()); if (unavailable) { onAvailability?.(false); status.textContent = t('Templates are not available for this account. You can still create images in Studio.'); } else reportReadFailure(result); return; } const data = object(result.data), categories = choices(data.categories); if (data.schemaVersion !== 1 || !categories || !Array.isArray(data.sections)) { discard(); report(); return; } const parsed: Section[] = []; for (const raw of data.sections) { const row = object(raw); if (!templateIdentity(row.id) || typeof row.title !== 'string' || !templateIdentity(row.categoryId) || !templateIdentity(row.productTypeId) || !Number.isSafeInteger(row.rank) || Number(row.rank) < 0 || parsed.some(item => item.id === row.id)) { discard(); report(); return; } parsed.push({ id: row.id, title: row.title, categoryId: row.categoryId, productTypeId: row.productTypeId, rank: Number(row.rank) }); } sections = parsed; onAvailability?.(true); const initialResult = await firstPage; if (!active(epoch) || initialResult?.aborted) return; featured = showFeatured && categories.length > 0; filters.replaceChildren(); filters.hidden = !categories.length; if (categories.length) { const choices: Choice[] = [{ id: '', title: t('All categories') }, ...categories]; let featuredId = 'featured'; if (showFeatured) { const categoryIds = new Set(categories.map(item => item.id)); while (categoryIds.has(featuredId)) featuredId = `_${featuredId}`; choices.unshift({ id: featuredId, title: t('Featured') }); } select(t('Category'), choices, id => { const showFeaturedView = showFeatured && id === featuredId; chooseCategory(showFeaturedView ? '' : id, showFeaturedView); }, showFeatured ? featuredId : ''); productSelect = select(t('Product type'), [{ id: '', title: t('All product types') }], value => { productType = value; resetList(); void loadPage(true); }); productSelect.native.disabled = true; productSelect.custom.sync(); } catalogBusy = false; await loadPage(true, initialResult); } catch { if (active(epoch)) report(); } finally { if (active(epoch)) { catalogBusy = false; if (!selectors.length) { filters.replaceChildren(); filters.hidden = true; } syncLoading(); } } }; let browserConnected = isConnected(), browserOwner = browserConnected ? catalogOwnerKey() : ''; const authChanged = (event: Event): void => { const detail = (event as CustomEvent<{ auth?: { cacheOwner?: unknown; connected?: unknown }; cacheOwner?: unknown; connected?: unknown }>).detail; const auth = detail?.auth || detail; const owner = typeof auth?.cacheOwner === 'string' ? auth.cacheOwner : ''; const nextConnected = typeof auth?.connected === 'boolean' ? auth.connected : Boolean(owner); const nextOwner = nextConnected ? owner : ''; if (browserOwner === nextOwner && browserConnected === nextConnected) return; browserOwner = nextOwner; browserConnected = nextConnected; unavailableFeatured.clear(); categoryEpoch++; typeController.abort(); closeDetail(false); resetList(); if (!destroyed) void start(); }; window.addEventListener('fotogenic-ai:auth-changed', authChanged); void start(); return { destroy() { destroyed = true; listEpoch++; categoryEpoch++; detailEpoch++; listController.abort(); typeController.abort(); detailController.abort(); picker?.destroy(); observer.disconnect(); clearAppendSkeletons(); groups.forEach(group => group.destroy()); selectors.forEach(select => select.destroy()); window.removeEventListener('fotogenic-ai:auth-changed', authChanged); if (actionsMount) { actionsMount.replaceChildren(); actionsMount.hidden = true; } } }; }; interface TemplateWindow extends Window { FotogenicAI?: { Shared?: { ui?: { templates?: { create: typeof createTemplateBrowser; previewUrl: typeof curatedPreviewUrl; cachedRequest: typeof cachedCatalogRequest; prefetch: typeof prefetchTemplates; refresh: typeof refreshCatalog; parseDetail: typeof parseTemplateDetail; parseSelection: typeof parseTemplateSelection; modelAllowed: typeof templateModelAllowed; ownerKey: typeof catalogOwnerKey } } } } } const runtime = window as TemplateWindow; runtime.FotogenicAI ??= {}; runtime.FotogenicAI.Shared ??= {}; runtime.FotogenicAI.Shared.ui ??= {}; runtime.FotogenicAI.Shared.ui.templates = { create: createTemplateBrowser, previewUrl: curatedPreviewUrl, cachedRequest: cachedCatalogRequest, prefetch: prefetchTemplates, refresh: refreshCatalog, parseDetail: parseTemplateDetail, parseSelection: parseTemplateSelection, modelAllowed: templateModelAllowed, ownerKey: catalogOwnerKey };