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 { useEffect, useRef, useState } from 'react';
import { Plus, X } from 'lucide-react';
import { musicVideoCastGuideReferences, musicVideoConditioningReferences, musicVideoPanelArtReferences, musicVideoReferenceChoices, MUSIC_VIDEO_MAX_CONDITIONING_REFERENCES } from '../../../../server/lib/musicVideoConditioning.js';
import { MUSIC_VIDEO_OTHER_REFERENCES_NOTE } from '../../../../server/lib/musicVideoShotPrompt.js';
// No iOS image callout or text selection, so a long-press opens the preview instead.
const CHIP = 'inline-flex min-h-[44px] max-w-full select-none items-center gap-1 rounded border border-port-border bg-port-bg p-0.5 text-xs [-webkit-touch-callout:none] sm:min-h-[32px]';
const LONG_PRESS_MS = 450;
const thumb = (ref) => <img src={`/data/images/${encodeURIComponent(ref.imageId)}`} alt="" className="h-8 w-8 shrink-0 rounded bg-black object-cover" />;
const nameOf = (ref) => ref.label || ref.role || 'Reference';
/**
* The character and set references sent with this shot's frame renders (start,
* end and both refines), shown as chips. Until the director changes them it is
* the automatic set (the main character, the section's set and anyone the
* prompt names); a change is kept on the shot (`frameReferenceIds`), and Auto
* puts the automatic set back. A shot naming a Casting cast member
* (`characterVariant`, #12763) leads with that member's guides, from `castMedia`.
*/
export default function SceneFrameReferences({ project, scene, castMedia = null, onEditLocal, onSave, disabled = false }) {
const [adding, setAdding] = useState(false);
// The reference shown large: hovering a chip with a mouse, or long-pressing it on a phone.
const [preview, setPreview] = useState(null);
const pressTimer = useRef(null);
const longPressed = useRef(false);
useEffect(() => () => clearTimeout(pressTimer.current), []);
const choices = [...musicVideoCastGuideReferences(project, scene, castMedia), ...musicVideoPanelArtReferences(scene), ...musicVideoReferenceChoices(project)];
if (!choices.length) return null;
const chosen = musicVideoConditioningReferences(project, scene, castMedia);
const ids = chosen.map((ref) => ref.id);
const others = choices.filter((ref) => !ids.includes(ref.id));
const auto = !Array.isArray(scene.frameReferenceIds);
const full = ids.length >= MUSIC_VIDEO_MAX_CONDITIONING_REFERENCES;
const previewProps = (ref) => ({
title: nameOf(ref),
onPointerEnter: (e) => { if (e.pointerType === 'mouse') setPreview(ref); },
onPointerLeave: (e) => {
clearTimeout(pressTimer.current);
if (e.pointerType === 'mouse') setPreview((shown) => (shown?.id === ref.id ? null : shown));
},
onPointerDown: (e) => {
if (e.pointerType === 'mouse') return;
longPressed.current = false;
clearTimeout(pressTimer.current);
pressTimer.current = setTimeout(() => { longPressed.current = true; setPreview(ref); }, LONG_PRESS_MS);
},
onPointerUp: () => clearTimeout(pressTimer.current),
onPointerCancel: () => clearTimeout(pressTimer.current),
onContextMenu: (e) => e.preventDefault(),
});
// A long-press only previews: the tap it ends with does not add or remove.
const unlessLongPress = (action) => () => {
if (longPressed.current) { longPressed.current = false; return; }
action();
};
// Until the cast member's guides load, an edit would save the row without them.
const variantId = scene.characterVariant?.ingredientId;
const locked = disabled || Boolean(castMedia && variantId && castMedia[variantId] === undefined);
// A saved guide id that does not resolve now (its media failed to load) is kept, so an edit cannot drop it.
const unresolvedGuides = (scene.frameReferenceIds || []).filter((refId) => refId.startsWith('mvr-guide-') && !ids.includes(refId));
const set = (picked) => {
const next = picked && [...picked, ...unresolvedGuides].slice(0, MUSIC_VIDEO_MAX_CONDITIONING_REFERENCES);
onEditLocal(scene.sceneId, { frameReferenceIds: next });
onSave(scene.sceneId, { frameReferenceIds: next });
};
return (
<div role="group" aria-label="References sent with the frames" className="space-y-1">
<div className="flex flex-wrap items-center gap-x-2 text-[11px] text-port-text-muted">
<span className="font-medium text-port-text">References</span>
{auto ? <span>Auto: from the prompt</span> : (
<button type="button" onClick={() => set(null)} disabled={locked} className="min-h-[44px] underline sm:min-h-0">Back to auto</button>
)}
</div>
<ul className="flex flex-wrap gap-1">
{chosen.map((ref) => (
<li key={ref.id} className={CHIP} {...previewProps(ref)}>
{thumb(ref)}
<span className="min-w-0 max-w-[10rem] truncate">{nameOf(ref)}</span>
<button type="button" onClick={unlessLongPress(() => { set(ids.filter((id) => id !== ref.id)); setPreview((shown) => (shown?.id === ref.id ? null : shown)); })} disabled={locked} aria-label={`Don't send ${nameOf(ref)}`}
className="inline-flex min-h-[40px] min-w-[32px] items-center justify-center rounded hover:bg-port-border disabled:opacity-50 sm:min-h-[28px] sm:min-w-[24px]">
<X size={12} aria-hidden="true" />
</button>
</li>
))}
{others.length > 0 && (
<li>
<button type="button" onClick={() => setAdding((open) => !open)} disabled={locked || full} aria-expanded={adding}
title={full ? `Up to ${MUSIC_VIDEO_MAX_CONDITIONING_REFERENCES} references` : 'Send another character or set'}
className={`${CHIP} px-2 disabled:opacity-50`}>
<Plus size={12} aria-hidden="true" /> Add
</button>
</li>
)}
</ul>
{full && <p className="text-[11px] text-port-text-muted">Refines and end frames send the frame plus the first {MUSIC_VIDEO_MAX_CONDITIONING_REFERENCES - 1}.</p>}
{chosen.length === 0 && <p className="text-[11px] text-port-text-muted">No references: frames render from the prompt alone.</p>}
{adding && !full && (
<ul aria-label="References to add" className="grid grid-cols-2 gap-1 sm:grid-cols-3 lg:grid-cols-4">
{others.map((ref) => (
<li key={ref.id} className="min-w-0">
<button type="button" onClick={unlessLongPress(() => { set([...ids, ref.id]); setAdding(false); setPreview(null); })} disabled={locked} {...previewProps(ref)}
className={`${CHIP} w-full text-left hover:bg-port-border/40`}>
{thumb(ref)}<span className="min-w-0 truncate">{nameOf(ref)}</span>
</button>
</li>
))}
</ul>
)}
{preview && (
<figure aria-label={`Preview of ${nameOf(preview)}`} className="relative space-y-1 rounded border border-port-border bg-port-bg p-1">
<img src={`/data/images/${encodeURIComponent(preview.imageId)}`} alt="" className="max-h-[60vh] w-full rounded bg-black object-contain" />
<figcaption className="pr-10 text-xs text-port-text">
{nameOf(preview)}
{preview.note && <span className="block text-port-text-muted">{preview.note}</span>}
</figcaption>
<button type="button" onClick={() => setPreview(null)} aria-label="Close preview"
className="absolute bottom-1 right-1 inline-flex min-h-[44px] min-w-[44px] items-center justify-center rounded hover:bg-port-border sm:min-h-[32px] sm:min-w-[32px]">
<X size={14} aria-hidden="true" />
</button>
</figure>
)}
{chosen.length > 0 && (
<details className="text-[11px] text-port-text-muted">
<summary className="cursor-pointer">Note sent with refines and end frames</summary>
<p className="mt-1">{MUSIC_VIDEO_OTHER_REFERENCES_NOTE}</p>
</details>
)}
</div>
);
}