Skip to content

Write HTML. Render video. Built for agents.

1.7 KB
Raw Blame
export type AuthoredTimingValue = string | number | null | undefined;

export const AUTHORED_DURATION_ATTR = "data-hf-authored-duration";
export const AUTHORED_END_ATTR = "data-hf-authored-end";

export interface RawAuthoredTiming {
  start?: AuthoredTimingValue;
  duration?: AuthoredTimingValue;
  authoredDuration?: AuthoredTimingValue;
  end?: AuthoredTimingValue;
  authoredEnd?: AuthoredTimingValue;
}

export interface AuthoredTimingWindow {
  start: number;
  duration: number | null;
  end: number | null;
}

function finiteNumber(value: AuthoredTimingValue): number | null {
  if (value == null) return null;
  if (typeof value === "string" && value.trim() === "") return null;
  const parsed = typeof value === "number" ? value : Number(value);
  return Number.isFinite(parsed) ? parsed : null;
}

export function resolveAuthoredTimingWindow(
  values: RawAuthoredTiming,
): AuthoredTimingWindow | null {
  const parsedStart = finiteNumber(values.start);
  if (parsedStart == null) return null;
  const start = Math.max(0, parsedStart);

  const publicDuration = finiteNumber(values.duration);
  const preservedDuration = finiteNumber(values.authoredDuration);
  const duration =
    publicDuration != null && publicDuration > 0
      ? publicDuration
      : preservedDuration != null && preservedDuration > 0
        ? preservedDuration
        : null;
  if (duration != null) return { start, duration, end: start + duration };

  const publicEnd = finiteNumber(values.end);
  const preservedEnd = finiteNumber(values.authoredEnd);
  const end =
    publicEnd != null && publicEnd > start
      ? publicEnd
      : preservedEnd != null && preservedEnd > start
        ? preservedEnd
        : null;
  return { start, duration: end == null ? null : end - start, end };
}