Files
hyperframes/packages/core/src/clipFacts.ts
T
Miguel Ángel d1123299f8 fix(lint): back-to-back audio clips no longer count as overlapping after float rounding (#5837)
duplicate_audio_track compared raw float ends, so 21.03 + 0.1 (21.130000000000003)
overlapped a clip starting at 21.13. The one-instant span helpers move from core's
clipFacts to parsers, which lint and core both depend on; core re-exports them and
the rule uses spansOverlap.
2026-10-18 22:15:23 +00:00

65 lines
1.9 KiB
TypeScript

/** Plain-field clip facts shared by the Ask-agent prompt, `studio_look` and `hyperframes timeline`. */
export interface ClipLane {
/** `volume`, or `fx.<nodeId>.<param>`. */
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(" ")}`;
}