Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { useId, useMemo, useState } from 'react';
import { Compass, Star } from 'lucide-react';
import CatalogMediaTile from './CatalogMediaTile';
import { formatCount } from '../../utils/formatters';
import { updateCatalogIngredientMediaLibrary, attachCatalogIngredientMediaFromMoodBoard } from '../../services/apiCatalog';
export const MAX_CAST_GUIDES = 4;
const ERAS = ['child', 'teen', 'adult', 'elder'];
const LIBRARY_KINDS = new Set(['portrait', 'reference', 'video']);
const eraFor = (m) => m.library?.variant?.era
|| (Number.isInteger(m.library?.variant?.age) ? (m.library.variant.age < 13 ? 'child' : m.library.variant.age < 20 ? 'teen' : m.library.variant.age < 65 ? 'adult' : 'elder') : '');
export default function CatalogReferenceLibrary({ ingredientId, media = [], forms = [], readOnly = false, onChanged, referenceMedia = media, missingMedia = new Set(), onSetPortrait, onDetach }) {
const id = useId();
const [armedDetach, setArmedDetach] = useState(null);
const [filter, setFilter] = useState({ form: '', age: '', era: '', tag: '', guides: false, allMedia: false });
const [error, setError] = useState('');
const [busyKey, setBusyKey] = useState('');
const [boardId, setBoardId] = useState('');
const [itemIds, setItemIds] = useState('');
const rows = useMemo(() => media.filter((m) => !m.deleted && LIBRARY_KINDS.has(m.kind)), [media]);
// Sheets and looks in other tabs still consume the character-wide guide limit.
const guideCount = media.filter((m) => !m.deleted && LIBRARY_KINDS.has(m.kind) && m.library?.guide === true).length;
const ages = [...new Set(rows.map((m) => m.library?.variant?.age).filter(Number.isInteger))].sort((a, b) => a - b);
const tags = [...new Set(rows.flatMap((m) => m.library?.tags || []))].sort();
const formKey = (m) => m.library?.variant?.formId || 'canonical';
const referenceKeys = new Set(referenceMedia.map((m) => `${m.kind}:${m.mediaKey}`));
const visible = rows.filter((m) => (filter.allMedia || referenceKeys.has(`${m.kind}:${m.mediaKey}`))
&& (!filter.form || formKey(m) === filter.form)
&& (filter.age === '' || m.library?.variant?.age === Number(filter.age))
&& (!filter.era || eraFor(m) === filter.era)
&& (!filter.tag || (m.library?.tags || []).includes(filter.tag))
&& (!filter.guides || m.library?.guide === true));
// One visual can have both portrait and reference attachments with independent metadata.
const groups = new Map();
for (const m of visible) {
const key = `${m.kind === 'video' ? 'video' : 'image'}:${m.mediaKey}`;
if (!groups.has(key)) groups.set(key, []);
groups.get(key).push(m);
}
const save = async (m, patch) => {
setError('');
setBusyKey(`${m.kind}:${m.mediaKey}`);
try {
await updateCatalogIngredientMediaLibrary(ingredientId, { mediaKey: m.mediaKey, kind: m.kind, ...patch }, { silent: true });
onChanged?.();
} catch (err) {
setError(err?.message || 'Could not update reference');
} finally {
setBusyKey('');
}
};
const importBoard = async () => {
const ids = itemIds.split(/[\s,]+/).filter(Boolean);
if (!boardId.trim() || ids.length === 0) return;
setError('');
try {
await attachCatalogIngredientMediaFromMoodBoard(ingredientId, { boardId: boardId.trim(), itemIds: ids, inferAge: true }, { silent: true });
setItemIds('');
onChanged?.();
} catch (err) {
setError(err?.message || 'Could not import from mood board');
}
};
const fieldClass = 'min-h-11 min-w-0 w-full rounded border border-port-border bg-port-bg px-2 text-sm';
return (
<section aria-label="Reference library" className="min-w-0 space-y-3">
<header className="flex flex-wrap items-center justify-between gap-2 text-sm">
<h3 className="font-semibold">Reference library</h3>
<span data-testid="guide-count" className="text-gray-400">{formatCount(guideCount)}/{MAX_CAST_GUIDES} render guides (all media)</span>
</header>
<div className="grid grid-cols-[repeat(auto-fit,minmax(min(100%,9rem),1fr))] items-end gap-2 text-xs">
{referenceMedia !== media && (
<label htmlFor={`${id}-scope`} className="min-w-0 space-y-1"><span>Media scope</span>
<select id={`${id}-scope`} value={filter.allMedia ? 'all' : 'references'} onChange={(e) => setFilter({ ...filter, allMedia: e.target.value === 'all' })} className={fieldClass}>
<option value="references">References</option>
<option value="all">All character media</option>
</select>
</label>
)}
{forms.length > 0 && (
<label htmlFor={`${id}-form`} className="min-w-0 space-y-1"><span>Age or look</span>
<select id={`${id}-form`} aria-label="Filter by age or look" value={filter.form} onChange={(e) => setFilter({ ...filter, form: e.target.value })} className={fieldClass}>
<option value="">All</option>
<option value="canonical">Canonical</option>
{forms.map((f) => <option key={f.id} value={f.id}>{f.label}</option>)}
</select>
</label>
)}
<label htmlFor={`${id}-age`} className="min-w-0 space-y-1"><span>Age</span>
<select id={`${id}-age`} aria-label="Filter by age" value={filter.age} onChange={(e) => setFilter({ ...filter, age: e.target.value })} className={fieldClass}>
<option value="">All</option>
{ages.map((age) => <option key={age} value={age}>{age}</option>)}
</select>
</label>
<label htmlFor={`${id}-era`} className="min-w-0 space-y-1"><span>Era</span>
<select id={`${id}-era`} aria-label="Filter by era" value={filter.era} onChange={(e) => setFilter({ ...filter, era: e.target.value })} className={fieldClass}>
<option value="">All</option>
{ERAS.map((era) => <option key={era} value={era}>{era}</option>)}
</select>
</label>
{tags.length > 0 && (
<label htmlFor={`${id}-tag`} className="min-w-0 space-y-1"><span>Tag</span>
<select id={`${id}-tag`} aria-label="Filter by tag" value={filter.tag} onChange={(e) => setFilter({ ...filter, tag: e.target.value })} className={fieldClass}>
<option value="">All</option>
{tags.map((tag) => <option key={tag} value={tag}>{tag}</option>)}
</select>
</label>
)}
<label htmlFor={`${id}-guides`} className="flex min-h-11 items-center gap-2">
<input id={`${id}-guides`} type="checkbox" checked={filter.guides} onChange={(e) => setFilter({ ...filter, guides: e.target.checked })} /> Guides only
</label>
</div>
{error && <p role="alert" className="text-sm text-port-error">{error}</p>}
{visible.length === 0 ? <p className="text-sm text-gray-400">{rows.length ? 'No references match. Change the filters to see more.' : 'No references yet. Add an image or video to start your library.'}</p> : (
<ul className="grid items-start grid-cols-[repeat(auto-fill,minmax(min(100%,16rem),1fr))] gap-3">
{[...groups].map(([groupKey, attachments]) => {
const tile = attachments.find((m) => m.kind === 'portrait') || attachments[0];
const tileEditable = !readOnly && !tile.readOnly;
return (
<li key={groupKey} data-testid="library-row" className="min-w-0 rounded-lg border border-port-border bg-port-bg">
<CatalogMediaTile m={tile} missing={missingMedia.has(tile.mediaKey)} contain
isPortrait={tile.kind === 'portrait'} onSetPortrait={tileEditable ? onSetPortrait : undefined}
onDetach={tileEditable ? onDetach : undefined} armedDetach={armedDetach} onArmDetach={setArmedDetach} />
{attachments.map((m) => {
const key = `${m.kind}:${m.mediaKey}`;
const lib = m.library || {};
const isGuide = lib.guide === true;
const editable = !readOnly && !m.readOnly;
const title = lib.variant?.label || m.caption || m.mediaKey;
const summary = [forms.find((f) => f.id === lib.variant?.formId)?.label || 'Canonical',
Number.isInteger(lib.variant?.age) ? `Age ${lib.variant.age}` : '', eraFor(m), ...(lib.tags || [])].filter(Boolean).join(' · ');
return (
<div key={key} role="group" aria-label={`${m.kind} details for ${m.mediaKey}`} className="min-w-0 space-y-2 border-t border-port-border p-3">
<div className="flex min-w-0 items-start gap-2">
{m.kind === 'portrait' && <Star size={14} aria-label="Primary" className="mt-0.5 shrink-0 text-port-warning" />}
<h4 className="min-w-0 flex-1 text-sm font-medium [overflow-wrap:anywhere]">{title}</h4>
<span className="shrink-0 text-xs text-gray-500">{m.kind}</span>
</div>
<p className="text-xs text-gray-400 [overflow-wrap:anywhere]">{summary}</p>
{m.kind !== 'video' && (editable ? (
<button type="button" disabled={!!busyKey || (!isGuide && guideCount >= MAX_CAST_GUIDES)} aria-pressed={isGuide}
title={!isGuide && guideCount >= MAX_CAST_GUIDES ? `At most ${MAX_CAST_GUIDES} render guides` : 'Use as a render guide'}
onClick={() => save(m, { guide: !isGuide })}
className={`flex min-h-11 w-full items-center justify-center gap-2 rounded border px-3 text-sm disabled:opacity-40 ${isGuide ? 'border-port-accent bg-port-accent/10 text-port-accent' : 'border-port-border text-gray-300 hover:border-port-accent'}`}>
<Compass size={16} aria-hidden="true" /> {busyKey === key ? 'Saving…' : isGuide ? 'Guide' : 'Make guide'}
</button>
) : isGuide && <p className="text-xs text-port-accent">Render guide</p>)}
{editable && (
<details>
<summary className="flex min-h-11 cursor-pointer items-center text-xs text-port-accent">Edit reference details</summary>
<fieldset disabled={!!busyKey} className="grid min-w-0 grid-cols-[repeat(auto-fit,minmax(min(100%,7rem),1fr))] gap-2 text-xs disabled:opacity-50">
{forms.length > 0 && (
<label htmlFor={`${id}-${key}-form`} className="min-w-0 space-y-1"><span>Age or look</span>
<select id={`${id}-${key}-form`} aria-label={`Age or look for ${m.mediaKey}`} value={lib.variant?.formId || ''} className={fieldClass}
onChange={(e) => save(m, { variant: { ...(lib.variant || {}), formId: e.target.value || undefined } })}>
<option value="">Canonical</option>
{forms.map((f) => <option key={f.id} value={f.id}>{f.label}</option>)}
</select>
</label>
)}
<label htmlFor={`${id}-${key}-age`} className="min-w-0 space-y-1"><span>Age</span>
<input id={`${id}-${key}-age`} aria-label={`Age for ${m.mediaKey}`} type="number" min="0" max="150" defaultValue={lib.variant?.age ?? ''} className={fieldClass}
onBlur={(e) => {
if (!e.target.validity.valid) return;
const age = e.target.value === '' ? undefined : Number(e.target.value);
if (age !== lib.variant?.age) save(m, { variant: { ...(lib.variant || {}), age } });
}} />
</label>
<label htmlFor={`${id}-${key}-era`} className="min-w-0 space-y-1"><span>Era</span>
<select id={`${id}-${key}-era`} aria-label={`Era for ${m.mediaKey}`} value={lib.variant?.era || ''} className={fieldClass}
onChange={(e) => save(m, { variant: { ...(lib.variant || {}), era: e.target.value || undefined } })}>
<option value="">From age</option>
{ERAS.map((era) => <option key={era} value={era}>{era}</option>)}
</select>
</label>
<label htmlFor={`${id}-${key}-tags`} className="col-span-full min-w-0 space-y-1"><span>Tags (comma separated)</span>
<input id={`${id}-${key}-tags`} aria-label={`Tags for ${m.mediaKey}`} defaultValue={(lib.tags || []).join(', ')} placeholder="e.g. studio, winter" className={fieldClass}
onBlur={(e) => {
const next = e.target.value.split(',').map((tag) => tag.trim()).filter(Boolean);
if (next.join(',') !== (lib.tags || []).join(',')) save(m, { tags: next });
}} />
</label>
</fieldset>
</details>
)}
</div>
);
})}
</li>
);
})}
</ul>
)}
{!readOnly && (
<details className="rounded border border-port-border p-3 text-xs">
<summary className="min-h-11 cursor-pointer content-center text-gray-400">Add from mood board</summary>
<div className="grid grid-cols-[repeat(auto-fit,minmax(min(100%,12rem),1fr))] items-end gap-2">
<label htmlFor={`${id}-board`} className="min-w-0 space-y-1"><span>Mood board id</span>
<input id={`${id}-board`} value={boardId} onChange={(e) => setBoardId(e.target.value)} className={fieldClass} />
</label>
<label htmlFor={`${id}-items`} className="min-w-0 space-y-1"><span>Mood board item ids</span>
<input id={`${id}-items`} value={itemIds} onChange={(e) => setItemIds(e.target.value)} placeholder="Comma separated" className={fieldClass} />
</label>
<button type="button" onClick={importBoard} className="min-h-11 rounded border border-port-border px-3 text-port-accent">Add from mood board</button>
</div>
</details>
)}
</section>
);
}