/**
 * Decide whether the player should inject the HyperFrames runtime on the
 * current probe tick.
 *
 * The player polls the loaded iframe every 200ms to discover either:
 *   - a runtime bridge already installed (`window.__hf` / `window.__player`), or
 *   - GSAP timelines registered at `window.__timelines`.
 *
 * Two classes of composition require different injection timing:
 *
 *   Nested — the composition uses `data-composition-src` on child elements to
 *   lazy-load sub-scenes. The runtime is what loads those children, so the
 *   composition cannot possibly render on its own. We inject immediately; if
 *   we waited, an inline pre-runtime `gsap.timeline` (common for authoring a
 *   preview before the runtime rebuilds the master timeline) would register
 *   at `__timelines["main"]` with a partial duration, and the adapter path
 *   would then lock the player into `ready` against that incomplete timeline.
 *
 *   Self-contained — the composition has no nested scenes and ships all of
 *   its animation inline (timelines registered under `__timelines`). These
 *   don't strictly need the runtime; the adapter can drive them directly.
 *   We give the adapter path first shot (a 5-tick grace period) and only
 *   inject the runtime as a fallback if no adapter emerges.
 */
export interface ProbeState {
  hasRuntime: boolean;
  hasTimelines: boolean;
  hasNestedCompositions: boolean;
  runtimeInjected: boolean;
  attempts: number;
}

export function shouldInjectRuntime(state: ProbeState): boolean {
  if (state.hasRuntime || state.runtimeInjected) return false;
  if (state.hasNestedCompositions) return true;
  if (state.hasTimelines && state.attempts >= 5) return true;
  return false;
}