Skip to content

Write HTML. Render video. Built for agents.

1.8 KB
Raw Blame
export interface TimelineEditCapabilities {
  canMove: boolean;
  canTrimStart: boolean;
  canTrimEnd: boolean;
  readOnly?: boolean;
}

function isDeterministicTimelineWindow(input: {
  tag: string;
  kind?: "video" | "audio" | "image" | "element" | "composition";
  compositionSrc?: string;
  playbackStartAttr?: "media-start" | "playback-start";
  sourceDuration?: number;
}): boolean {
  if (input.kind === "composition" || input.compositionSrc || input.playbackStartAttr != null)
    return true;
  if (
    input.sourceDuration != null &&
    Number.isFinite(input.sourceDuration) &&
    input.sourceDuration > 0
  ) {
    return true;
  }
  return ["video", "audio", "img"].includes(input.tag.toLowerCase());
}

export function hasPatchableTimelineTarget(input: {
  domId?: string;
  hfId?: string;
  selector?: string;
}): boolean {
  return Boolean(input.domId || input.hfId || input.selector);
}

export function getTimelineEditCapabilities(input: {
  tag: string;
  kind?: "video" | "audio" | "image" | "element" | "composition";
  duration: number;
  domId?: string;
  hfId?: string;
  selector?: string;
  compositionSrc?: string;
  playbackStart?: number;
  playbackStartAttr?: "media-start" | "playback-start";
  sourceDuration?: number;
  timelineLocked?: boolean;
}): TimelineEditCapabilities {
  if (input.timelineLocked) {
    return { canMove: false, canTrimStart: false, canTrimEnd: false };
  }

  const canPatch = hasPatchableTimelineTarget(input);
  const hasFiniteDuration = Number.isFinite(input.duration) && input.duration > 0;
  const hasDeterministicWindow = isDeterministicTimelineWindow(input);
  return {
    canMove: canPatch && (hasDeterministicWindow || hasFiniteDuration),
    canTrimEnd: canPatch && hasFiniteDuration,
    canTrimStart: canPatch && hasFiniteDuration,
  };
}