building-live-schedule-engine

name	building-live-schedule-engine
description	Builds the real-time schedule state engine with useCurrentTime hook, URL-based time simulation, and getScheduleState calculator. Handles current/past/upcoming detection, multi-day switching, and progress tracking. Use when implementing live schedule tracking logic.

Building the Live Schedule Engine

Two pieces: a time hook and a state calculator.

useCurrentTime Hook

Client-side hook returning current time, updating every second. Supports URL parameters for testing.

"use client";
import { useState, useEffect, useCallback } from "react";

export function useCurrentTime(intervalMs: number = 1000): Date {
  const [mounted, setMounted] = useState(false);
  const [now, setNow] = useState<Date>(() => new Date());

  const getConfig = useCallback(() => {
    if (typeof window === "undefined") return { : , :  };
     params =  (..);
     timeParam = params.();
     speedParam = params.();

     offset = , speed = ;
     (timeParam) {
       simulated =  (timeParam);
       (!(simulated.())) offset = simulated.() - .();
    }
     (speedParam) {
       s = (speedParam);
       (!(s) && s > ) speed = s;
    }
     { offset, speed };
  }, []);

  ( {
    ();
     { offset, speed } = ();
     startReal = .();
    ( (startReal + offset));

     timer = ( {
       elapsed = .() - startReal;
      ( (startReal + offset + elapsed * speed));
    }, intervalMs);
      (timer);
  }, [intervalMs, getConfig]);

  
   (!mounted)   ();
   now;
}