Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

2.1 KB
Raw Blame
import { useState, useSyncExternalStore } from "react";
import { usePlayerStore } from "../store/playerStore";

/** How long the timeline must go without a zoom step to count as at rest. */
export const TIMELINE_REST_MS = 150;

let moving = false;
let restTimer: ReturnType<typeof setTimeout> | null = null;
const listeners = new Set<() => void>();

const emit = () => listeners.forEach((listener) => listener());

/** A zoom step: work that only matters at rest (redraws, decodes) waits for the zoom to end. */
export function markTimelineMotion(): void {
  if (!moving) {
    moving = true;
    emit();
  }
  if (restTimer) clearTimeout(restTimer);
  restTimer = setTimeout(() => {
    restTimer = null;
    moving = false;
    emit();
  }, TIMELINE_REST_MS);
}

const onIdle = (callback: () => void) => {
  if (typeof requestIdleCallback === "function") requestIdleCallback(callback, { timeout: 1000 });
  else setTimeout(callback, 0);
};

const busy = () => moving || usePlayerStore.getState().isPlaying;

/** Resolves at an idle moment with the film stopped and no zoom moving the timeline: long work waits there. */
export function whenTimelineIdle(): Promise<void> {
  return new Promise((resolve) => {
    const check = () => {
      if (!busy()) return resolve();
      const wake = () => {
        if (busy()) return;
        stopMotion();
        stopPlayback();
        onIdle(check);
      };
      const stopMotion = subscribeTimelineMotion(wake);
      const stopPlayback = usePlayerStore.subscribe(wake);
    };
    onIdle(check);
  });
}

export function isTimelineMoving(): boolean {
  return moving;
}

export function subscribeTimelineMotion(listener: () => void): () => void {
  listeners.add(listener);
  return () => listeners.delete(listener);
}

/** `value` at rest; while the timeline moves, the value it had when it last rested. */
export function useValueAtRest<T>(value: T): T {
  // Re-renders only when a zoom starts and when it rests.
  const moving = useSyncExternalStore(subscribeTimelineMotion, isTimelineMoving, () => false);
  const [held, setHeld] = useState(value);
  if (!moving && !Object.is(held, value)) setHeld(value);
  return moving ? held : value;
}