/** Plain-field clip facts shared by the Ask-agent prompt, `studio_look` and `hyperframes timeline`. */ export interface ClipLane { /** `volume`, or `fx..`. */ target: string; /** `t` is seconds from the start of the clip, not the composition. */ points: { t: number; v: number }[]; } export interface ClipFact { id: string; label: string | null; kind: string; start: number; duration: number; end: number; /** The `data-track-index` as written in the source file. */ trackIndex: number; src: string | null; sourceFile: string | null; /** `null` when `data-volume` is not authored (the clip plays at 1). */ volume: number | null; lanes: ClipLane[]; /** `null` at normal speed: not authored, or 1 (the manifest defaults it to 1). */ playbackRate: number | null; audioGroup: string | null; role: string | null; } export const byStart = (a: ClipFact, b: ClipFact) => a.start - b.start || a.trackIndex - b.trackIndex; const roundTo3 = (n: number) => Math.round(n * 1000) / 1000; const num = (n: number) => String(roundTo3(n)); export { instantTolerance, isInsideSpan, sameInstant, spansOverlap, spansShareTime, } from "@hyperframes/parsers/time-spans"; export function formatClipLine(clip: ClipFact): string { const parts = [ `${clip.kind} "${clip.id}"`, clip.src && `src=${clip.src}`, `start=${num(clip.start)}`, `duration=${num(clip.duration)}`, `end=${num(clip.end)}`, `track=${clip.trackIndex}`, clip.volume !== null && `volume=${num(clip.volume)}`, clip.playbackRate !== null && `rate=${num(clip.playbackRate)}`, clip.audioGroup && `group=${clip.audioGroup}`, clip.role && `role=${clip.role}`, clip.sourceFile && `file=${clip.sourceFile}`, ...clip.lanes.map( (lane) => `${lane.target}-lane=[${lane.points.map((p) => `${num(p.t)}:${num(p.v)}`).join(", ")}]`, ), ]; return `- ${parts.filter(Boolean).join(" ")}`; }