Function framesToTimecode

packages/core/src/timecode.ts:3–20

(frame: number, fps: number)

import { HeliosError, HeliosErrorCode } from './errors.js';

export function framesToTimecode(frame: number, fps: number): string {
  if (fps <= 0) {
    throw new HeliosError(HeliosErrorCode.INVALID_FPS, "FPS must be greater than 0");
  }

  // Ensure frame is non-negative and integer
  const safeFrame = Math.max(0, Math.floor(frame));

  const totalSeconds = Math.floor(safeFrame / fps);
  const f = safeFrame % fps;
  const s = totalSeconds % 60;
  const m = Math.floor(totalSeconds / 60) % 60;
  const h = Math.floor(totalSeconds / 3600);

  const pad = (n: number) => n.toString().padStart(2, '0');

  return `${pad(h)}:${pad(m)}:${pad(s)}:${pad(f)}`;
}

export function timecodeToFrames(timecode: string, fps: number): number {
  if (fps <= 0) {