@crup/react-timer-hook 0.0.1-alpha.4 → 0.0.1-alpha.5

package/dist/index.js

@@ -1,812 +1 @@
-// src/durationParts.ts
-var SECOND = 1e3;
-var MINUTE = 60 * SECOND;
-var HOUR = 60 * MINUTE;
-var DAY = 24 * HOUR;
-function durationParts(milliseconds) {
-  const totalMilliseconds = Math.max(0, Math.trunc(Number.isFinite(milliseconds) ? milliseconds : 0));
-  const days = Math.floor(totalMilliseconds / DAY);
-  const afterDays = totalMilliseconds % DAY;
-  const hours = Math.floor(afterDays / HOUR);
-  const afterHours = afterDays % HOUR;
-  const minutes = Math.floor(afterHours / MINUTE);
-  const afterMinutes = afterHours % MINUTE;
-  const seconds = Math.floor(afterMinutes / SECOND);
-  return {
-    totalMilliseconds,
-    totalSeconds: Math.floor(totalMilliseconds / SECOND),
-    milliseconds: afterMinutes % SECOND,
-    seconds,
-    minutes,
-    hours,
-    days
-  };
-}
-
-// src/useTimer.ts
-import { useCallback, useEffect, useMemo, useReducer, useRef } from "react";
-
-// src/debug.ts
-function resolveDebug(debug) {
-  if (!debug) return { enabled: false, includeTicks: false };
-  if (debug === true) return { enabled: true, includeTicks: false, logger: console.debug };
-  if (typeof debug === "function") return { enabled: true, includeTicks: false, logger: debug };
-  return {
-    enabled: debug.enabled !== false,
-    includeTicks: debug.includeTicks ?? false,
-    label: debug.label,
-    logger: debug.logger ?? console.debug
-  };
-}
-function emitDebug(debug, event) {
-  const config = resolveDebug(debug);
-  if (!config.enabled || !config.logger) return;
-  if (event.type === "timer:tick" && !config.includeTicks) return;
-  config.logger({
-    ...event,
-    label: event.label ?? config.label
-  });
-}
-function baseDebugEvent(snapshot, generation) {
-  return {
-    generation,
-    tick: snapshot.tick,
-    now: snapshot.now,
-    elapsedMilliseconds: snapshot.elapsedMilliseconds,
-    status: snapshot.status
-  };
-}
-
-// src/clocks.ts
-function readClock() {
-  const wallNow = Date.now();
-  const monotonicNow = typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : wallNow;
-  return { wallNow, monotonicNow };
-}
-function validatePositiveFinite(value, name) {
-  if (!Number.isFinite(value) || value <= 0) {
-    throw new RangeError(`${name} must be a finite number greater than 0`);
-  }
-}
-
-// src/state.ts
-function createTimerState(clock) {
-  return {
-    status: "idle",
-    generation: 0,
-    tick: 0,
-    startedAt: null,
-    pausedAt: null,
-    endedAt: null,
-    cancelledAt: null,
-    cancelReason: null,
-    baseElapsedMilliseconds: 0,
-    activeStartedAtMonotonic: null,
-    now: clock.wallNow
-  };
-}
-function getElapsedMilliseconds(state, clock) {
-  if (state.status !== "running" || state.activeStartedAtMonotonic === null) {
-    return state.baseElapsedMilliseconds;
-  }
-  return Math.max(0, state.baseElapsedMilliseconds + clock.monotonicNow - state.activeStartedAtMonotonic);
-}
-function toSnapshot(state, clock) {
-  const elapsedMilliseconds = getElapsedMilliseconds(state, clock);
-  return {
-    status: state.status,
-    now: clock.wallNow,
-    tick: state.tick,
-    startedAt: state.startedAt,
-    pausedAt: state.pausedAt,
-    endedAt: state.endedAt,
-    cancelledAt: state.cancelledAt,
-    cancelReason: state.cancelReason,
-    elapsedMilliseconds,
-    isIdle: state.status === "idle",
-    isRunning: state.status === "running",
-    isPaused: state.status === "paused",
-    isEnded: state.status === "ended",
-    isCancelled: state.status === "cancelled"
-  };
-}
-function startTimerState(state, clock) {
-  if (state.status !== "idle") return false;
-  state.status = "running";
-  state.startedAt = clock.wallNow;
-  state.pausedAt = null;
-  state.endedAt = null;
-  state.cancelledAt = null;
-  state.cancelReason = null;
-  state.activeStartedAtMonotonic = clock.monotonicNow;
-  state.now = clock.wallNow;
-  return true;
-}
-function pauseTimerState(state, clock) {
-  if (state.status !== "running") return false;
-  state.baseElapsedMilliseconds = getElapsedMilliseconds(state, clock);
-  state.activeStartedAtMonotonic = null;
-  state.status = "paused";
-  state.pausedAt = clock.wallNow;
-  state.now = clock.wallNow;
-  return true;
-}
-function resumeTimerState(state, clock) {
-  if (state.status !== "paused") return false;
-  state.status = "running";
-  state.pausedAt = null;
-  state.activeStartedAtMonotonic = clock.monotonicNow;
-  state.now = clock.wallNow;
-  return true;
-}
-function resetTimerState(state, clock, options = {}) {
-  state.generation += 1;
-  state.tick = 0;
-  state.status = options.autoStart ? "running" : "idle";
-  state.startedAt = options.autoStart ? clock.wallNow : null;
-  state.pausedAt = null;
-  state.endedAt = null;
-  state.cancelledAt = null;
-  state.cancelReason = null;
-  state.baseElapsedMilliseconds = 0;
-  state.activeStartedAtMonotonic = options.autoStart ? clock.monotonicNow : null;
-  state.now = clock.wallNow;
-  return true;
-}
-function restartTimerState(state, clock) {
-  return resetTimerState(state, clock, { autoStart: true });
-}
-function cancelTimerState(state, clock, reason) {
-  if (state.status === "ended" || state.status === "cancelled") return false;
-  state.baseElapsedMilliseconds = getElapsedMilliseconds(state, clock);
-  state.activeStartedAtMonotonic = null;
-  state.status = "cancelled";
-  state.cancelledAt = clock.wallNow;
-  state.cancelReason = reason ?? null;
-  state.now = clock.wallNow;
-  return true;
-}
-function endTimerState(state, clock) {
-  if (state.status !== "running") return false;
-  state.baseElapsedMilliseconds = getElapsedMilliseconds(state, clock);
-  state.activeStartedAtMonotonic = null;
-  state.status = "ended";
-  state.endedAt = clock.wallNow;
-  state.now = clock.wallNow;
-  return true;
-}
-function tickTimerState(state, clock) {
-  if (state.status !== "running") return false;
-  state.tick += 1;
-  state.now = clock.wallNow;
-  return true;
-}
-
-// src/useTimer.ts
-function useTimer(options = {}) {
-  const updateIntervalMs = options.updateIntervalMs ?? 1e3;
-  validatePositiveFinite(updateIntervalMs, "updateIntervalMs");
-  validateSchedules(options.schedules);
-  const optionsRef = useRef(options);
-  optionsRef.current = options;
-  const stateRef = useRef(null);
-  if (stateRef.current === null) {
-    stateRef.current = createTimerState(readClock());
-  }
-  const mountedRef = useRef(false);
-  const timeoutRef = useRef(null);
-  const schedulesRef = useRef(/* @__PURE__ */ new Map());
-  const endCalledGenerationRef = useRef(null);
-  const [, rerender] = useReducer((value) => value + 1, 0);
-  const clearScheduledTick = useCallback(() => {
-    if (timeoutRef.current !== null) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
-    }
-  }, []);
-  const getSnapshot = useCallback((clock = readClock()) => {
-    return toSnapshot(stateRef.current, clock);
-  }, []);
-  const emit = useCallback(
-    (type, snapshot2, extra = {}) => {
-      emitDebug(optionsRef.current.debug, {
-        type,
-        scope: "timer",
-        ...baseDebugEvent(snapshot2, stateRef.current.generation),
-        ...extra
-      });
-    },
-    []
-  );
-  const controlsRef = useRef(null);
-  const callOnEnd = useCallback(
-    (snapshot2) => {
-      const generation2 = stateRef.current.generation;
-      if (endCalledGenerationRef.current === generation2) return;
-      endCalledGenerationRef.current = generation2;
-      try {
-        void optionsRef.current.onEnd?.(snapshot2, controlsRef.current);
-      } catch (error) {
-        emitDebug(optionsRef.current.debug, {
-          type: "callback:error",
-          scope: "timer",
-          ...baseDebugEvent(snapshot2, generation2),
-          error
-        });
-      }
-    },
-    []
-  );
-  const runSchedule = useCallback(
-    (schedule, key, scheduleState, snapshot2, generation2) => {
-      if (scheduleState.pending && (schedule.overlap ?? "skip") === "skip") {
-        emitDebug(optionsRef.current.debug, {
-          type: "schedule:skip",
-          scope: "timer",
-          scheduleId: schedule.id ?? key,
-          reason: "overlap",
-          ...baseDebugEvent(snapshot2, generation2)
-        });
-        return;
-      }
-      scheduleState.lastRunAt = snapshot2.now;
-      scheduleState.pending = true;
-      emitDebug(optionsRef.current.debug, {
-        type: "schedule:start",
-        scope: "timer",
-        scheduleId: schedule.id ?? key,
-        ...baseDebugEvent(snapshot2, generation2)
-      });
-      Promise.resolve().then(() => schedule.callback(snapshot2, controlsRef.current)).then(
-        () => {
-          emitDebug(optionsRef.current.debug, {
-            type: "schedule:end",
-            scope: "timer",
-            scheduleId: schedule.id ?? key,
-            ...baseDebugEvent(snapshot2, generation2)
-          });
-        },
-        (error) => {
-          emitDebug(optionsRef.current.debug, {
-            type: "schedule:error",
-            scope: "timer",
-            scheduleId: schedule.id ?? key,
-            error,
-            ...baseDebugEvent(snapshot2, generation2)
-          });
-        }
-      ).finally(() => {
-        if (stateRef.current?.generation === generation2) {
-          scheduleState.pending = false;
-        }
-      });
-    },
-    []
-  );
-  const evaluateSchedules = useCallback(
-    (snapshot2, generation2, activation = false) => {
-      const schedules = optionsRef.current.schedules ?? [];
-      const liveKeys = /* @__PURE__ */ new Set();
-      schedules.forEach((schedule, index) => {
-        const key = schedule.id ?? String(index);
-        liveKeys.add(key);
-        let scheduleState = schedulesRef.current.get(key);
-        if (!scheduleState) {
-          scheduleState = { lastRunAt: null, pending: false, leadingGeneration: null };
-          schedulesRef.current.set(key, scheduleState);
-        }
-        if (activation && schedule.leading && scheduleState.leadingGeneration !== generation2) {
-          scheduleState.leadingGeneration = generation2;
-          runSchedule(schedule, key, scheduleState, snapshot2, generation2);
-          return;
-        }
-        if (scheduleState.lastRunAt === null) {
-          scheduleState.lastRunAt = snapshot2.now;
-          return;
-        }
-        if (snapshot2.now - scheduleState.lastRunAt >= schedule.everyMs) {
-          runSchedule(schedule, key, scheduleState, snapshot2, generation2);
-        }
-      });
-      for (const key of schedulesRef.current.keys()) {
-        if (!liveKeys.has(key)) schedulesRef.current.delete(key);
-      }
-    },
-    [runSchedule]
-  );
-  const processRunningState = useCallback(
-    (clock = readClock(), activation = false) => {
-      const state = stateRef.current;
-      if (state.status !== "running") return;
-      const snapshot2 = toSnapshot(state, clock);
-      const generation2 = state.generation;
-      if (optionsRef.current.endWhen?.(snapshot2)) {
-        if (endTimerState(state, clock)) {
-          const endedSnapshot = toSnapshot(state, clock);
-          emit("timer:end", endedSnapshot);
-          clearScheduledTick();
-          callOnEnd(endedSnapshot);
-          rerender();
-        }
-        return;
-      }
-      evaluateSchedules(snapshot2, generation2, activation);
-    },
-    [callOnEnd, clearScheduledTick, emit, evaluateSchedules]
-  );
-  const start = useCallback(() => {
-    const clock = readClock();
-    if (!startTimerState(stateRef.current, clock)) return;
-    const snapshot2 = toSnapshot(stateRef.current, clock);
-    emit("timer:start", snapshot2);
-    processRunningState(clock, true);
-    rerender();
-  }, [emit, processRunningState]);
-  const pause = useCallback(() => {
-    const clock = readClock();
-    if (!pauseTimerState(stateRef.current, clock)) return;
-    clearScheduledTick();
-    const snapshot2 = toSnapshot(stateRef.current, clock);
-    emit("timer:pause", snapshot2);
-    rerender();
-  }, [clearScheduledTick, emit]);
-  const resume = useCallback(() => {
-    const clock = readClock();
-    if (!resumeTimerState(stateRef.current, clock)) return;
-    const snapshot2 = toSnapshot(stateRef.current, clock);
-    emit("timer:resume", snapshot2);
-    processRunningState(clock, true);
-    rerender();
-  }, [emit, processRunningState]);
-  const reset = useCallback(
-    (resetOptions = {}) => {
-      const clock = readClock();
-      clearScheduledTick();
-      resetTimerState(stateRef.current, clock, resetOptions);
-      schedulesRef.current.clear();
-      endCalledGenerationRef.current = null;
-      const snapshot2 = toSnapshot(stateRef.current, clock);
-      emit("timer:reset", snapshot2);
-      if (resetOptions.autoStart) processRunningState(clock, true);
-      rerender();
-    },
-    [clearScheduledTick, emit, processRunningState]
-  );
-  const restart = useCallback(() => {
-    const clock = readClock();
-    clearScheduledTick();
-    restartTimerState(stateRef.current, clock);
-    schedulesRef.current.clear();
-    endCalledGenerationRef.current = null;
-    const snapshot2 = toSnapshot(stateRef.current, clock);
-    emit("timer:restart", snapshot2);
-    processRunningState(clock, true);
-    rerender();
-  }, [clearScheduledTick, emit, processRunningState]);
-  const cancel = useCallback(
-    (reason) => {
-      const clock = readClock();
-      if (!cancelTimerState(stateRef.current, clock, reason)) return;
-      clearScheduledTick();
-      const snapshot2 = toSnapshot(stateRef.current, clock);
-      emit("timer:cancel", snapshot2, { reason });
-      rerender();
-    },
-    [clearScheduledTick, emit]
-  );
-  controlsRef.current = useMemo(
-    () => ({ start, pause, resume, reset, restart, cancel }),
-    [cancel, pause, reset, restart, resume, start]
-  );
-  useEffect(() => {
-    mountedRef.current = true;
-    if (optionsRef.current.autoStart && stateRef.current.status === "idle") {
-      controlsRef.current.start();
-    }
-    return () => {
-      mountedRef.current = false;
-      clearScheduledTick();
-    };
-  }, [clearScheduledTick]);
-  const snapshot = getSnapshot();
-  const generation = stateRef.current.generation;
-  const status = snapshot.status;
-  useEffect(() => {
-    if (!mountedRef.current || status !== "running") {
-      clearScheduledTick();
-      return;
-    }
-    clearScheduledTick();
-    emit("scheduler:start", getSnapshot());
-    timeoutRef.current = setTimeout(() => {
-      if (!mountedRef.current) return;
-      if (stateRef.current.generation !== generation) return;
-      if (stateRef.current.status !== "running") return;
-      const clock = readClock();
-      tickTimerState(stateRef.current, clock);
-      const tickSnapshot = toSnapshot(stateRef.current, clock);
-      emit("timer:tick", tickSnapshot);
-      processRunningState(clock);
-      rerender();
-    }, optionsRef.current.updateIntervalMs ?? 1e3);
-    return () => {
-      if (timeoutRef.current !== null) {
-        emit("scheduler:stop", getSnapshot());
-      }
-      clearScheduledTick();
-    };
-  }, [clearScheduledTick, emit, generation, getSnapshot, processRunningState, snapshot.tick, status]);
-  return {
-    ...snapshot,
-    ...controlsRef.current
-  };
-}
-function validateSchedules(schedules) {
-  schedules?.forEach((schedule) => validatePositiveFinite(schedule.everyMs, "schedule.everyMs"));
-}
-
-// src/useTimerGroup.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useReducer as useReducer2, useRef as useRef2 } from "react";
-function useTimerGroup(options = {}) {
-  const updateIntervalMs = options.updateIntervalMs ?? 1e3;
-  validatePositiveFinite(updateIntervalMs, "updateIntervalMs");
-  validateItems(options.items);
-  const optionsRef = useRef2(options);
-  optionsRef.current = options;
-  const itemsRef = useRef2(/* @__PURE__ */ new Map());
-  const mountedRef = useRef2(false);
-  const timeoutRef = useRef2(null);
-  const [, rerender] = useReducer2((value) => value + 1, 0);
-  const clearScheduledTick = useCallback2(() => {
-    if (timeoutRef.current !== null) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
-    }
-  }, []);
-  const getItemSnapshot = useCallback2((item, clock = readClock()) => {
-    return toSnapshot(item.state, clock);
-  }, []);
-  const emit = useCallback2(
-    (type, item, snapshot, extra = {}) => {
-      emitDebug(optionsRef.current.debug, {
-        type,
-        scope: "timer-group",
-        timerId: item?.id,
-        ...baseDebugEvent(snapshot, item?.state.generation ?? 0),
-        ...extra
-      });
-    },
-    []
-  );
-  const controlsFor = useCallback2((id) => {
-    return {
-      start: () => start(id),
-      pause: () => pause(id),
-      resume: () => resume(id),
-      reset: (resetOptions) => reset(id, resetOptions),
-      restart: () => restart(id),
-      cancel: (reason) => cancel(id, reason)
-    };
-  }, []);
-  const callOnEnd = useCallback2(
-    (item, snapshot) => {
-      const generation = item.state.generation;
-      if (item.endCalledGeneration === generation) return;
-      item.endCalledGeneration = generation;
-      try {
-        void item.definition.onEnd?.(snapshot, controlsFor(item.id));
-      } catch (error) {
-        emitDebug(optionsRef.current.debug, {
-          type: "callback:error",
-          scope: "timer-group",
-          timerId: item.id,
-          error,
-          ...baseDebugEvent(snapshot, generation)
-        });
-      }
-    },
-    [controlsFor]
-  );
-  const runSchedule = useCallback2(
-    (item, schedule, key, scheduleState, snapshot, generation) => {
-      if (scheduleState.pending && (schedule.overlap ?? "skip") === "skip") {
-        emitDebug(optionsRef.current.debug, {
-          type: "schedule:skip",
-          scope: "timer-group",
-          timerId: item.id,
-          scheduleId: schedule.id ?? key,
-          reason: "overlap",
-          ...baseDebugEvent(snapshot, generation)
-        });
-        return;
-      }
-      scheduleState.lastRunAt = snapshot.now;
-      scheduleState.pending = true;
-      emitDebug(optionsRef.current.debug, {
-        type: "schedule:start",
-        scope: "timer-group",
-        timerId: item.id,
-        scheduleId: schedule.id ?? key,
-        ...baseDebugEvent(snapshot, generation)
-      });
-      Promise.resolve().then(() => schedule.callback(snapshot, controlsFor(item.id))).then(
-        () => {
-          emitDebug(optionsRef.current.debug, {
-            type: "schedule:end",
-            scope: "timer-group",
-            timerId: item.id,
-            scheduleId: schedule.id ?? key,
-            ...baseDebugEvent(snapshot, generation)
-          });
-        },
-        (error) => {
-          emitDebug(optionsRef.current.debug, {
-            type: "schedule:error",
-            scope: "timer-group",
-            timerId: item.id,
-            scheduleId: schedule.id ?? key,
-            error,
-            ...baseDebugEvent(snapshot, generation)
-          });
-        }
-      ).finally(() => {
-        const liveItem = itemsRef.current.get(item.id);
-        if (liveItem?.state.generation === generation) {
-          scheduleState.pending = false;
-        }
-      });
-    },
-    [controlsFor]
-  );
-  const evaluateItemSchedules = useCallback2(
-    (item, snapshot, activation = false) => {
-      const schedules = item.definition.schedules ?? [];
-      const liveKeys = /* @__PURE__ */ new Set();
-      schedules.forEach((schedule, index) => {
-        const key = schedule.id ?? String(index);
-        liveKeys.add(key);
-        let scheduleState = item.schedules.get(key);
-        if (!scheduleState) {
-          scheduleState = { lastRunAt: null, pending: false, leadingGeneration: null };
-          item.schedules.set(key, scheduleState);
-        }
-        if (activation && schedule.leading && scheduleState.leadingGeneration !== item.state.generation) {
-          scheduleState.leadingGeneration = item.state.generation;
-          runSchedule(item, schedule, key, scheduleState, snapshot, item.state.generation);
-          return;
-        }
-        if (scheduleState.lastRunAt === null) {
-          scheduleState.lastRunAt = item.state.startedAt ?? snapshot.now;
-          if (snapshot.now - scheduleState.lastRunAt >= schedule.everyMs) {
-            runSchedule(item, schedule, key, scheduleState, snapshot, item.state.generation);
-          }
-          return;
-        }
-        if (snapshot.now - scheduleState.lastRunAt >= schedule.everyMs) {
-          runSchedule(item, schedule, key, scheduleState, snapshot, item.state.generation);
-        }
-      });
-      for (const key of item.schedules.keys()) {
-        if (!liveKeys.has(key)) item.schedules.delete(key);
-      }
-    },
-    [runSchedule]
-  );
-  const processItem = useCallback2(
-    (item, clock = readClock(), activation = false) => {
-      if (item.state.status !== "running") return;
-      const snapshot = toSnapshot(item.state, clock);
-      if (item.definition.endWhen?.(snapshot)) {
-        if (endTimerState(item.state, clock)) {
-          const endedSnapshot = toSnapshot(item.state, clock);
-          emit("timer:end", item, endedSnapshot);
-          callOnEnd(item, endedSnapshot);
-        }
-        return;
-      }
-      evaluateItemSchedules(item, snapshot, activation);
-    },
-    [callOnEnd, emit, evaluateItemSchedules]
-  );
-  const ensureItem = useCallback2((definition) => {
-    const existing = itemsRef.current.get(definition.id);
-    if (existing) {
-      existing.definition = definition;
-      return { item: existing, added: false };
-    }
-    const item = {
-      id: definition.id,
-      state: createTimerState(readClock()),
-      definition,
-      schedules: /* @__PURE__ */ new Map(),
-      endCalledGeneration: null
-    };
-    itemsRef.current.set(definition.id, item);
-    if (definition.autoStart) {
-      startTimerState(item.state, readClock());
-    }
-    return { item, added: true };
-  }, []);
-  const syncItems = useCallback2(() => {
-    const definitions = optionsRef.current.items ?? [];
-    const liveIds = /* @__PURE__ */ new Set();
-    let changed = false;
-    definitions.forEach((definition) => {
-      liveIds.add(definition.id);
-      const { item, added } = ensureItem(definition);
-      changed = changed || added;
-      if (definition.autoStart && item.state.status === "idle") {
-        changed = startTimerState(item.state, readClock()) || changed;
-      }
-    });
-    for (const id of itemsRef.current.keys()) {
-      if (!liveIds.has(id)) {
-        itemsRef.current.delete(id);
-        changed = true;
-      }
-    }
-    return changed;
-  }, [ensureItem]);
-  useEffect2(() => {
-    if (syncItems()) rerender();
-  }, [syncItems, options.items]);
-  const add = useCallback2((item) => {
-    validateItems([item]);
-    if (itemsRef.current.has(item.id)) throw new Error(`Timer item "${item.id}" already exists`);
-    ensureItem(item);
-    rerender();
-  }, [ensureItem]);
-  const update = useCallback2((id, item) => {
-    const existing = itemsRef.current.get(id);
-    if (!existing) return;
-    const next = { ...existing.definition, ...item, id };
-    validateItems([next]);
-    existing.definition = next;
-    rerender();
-  }, []);
-  const remove = useCallback2((id) => {
-    itemsRef.current.delete(id);
-    rerender();
-  }, []);
-  const clear = useCallback2(() => {
-    itemsRef.current.clear();
-    clearScheduledTick();
-    rerender();
-  }, [clearScheduledTick]);
-  const start = useCallback2((id) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    if (!startTimerState(item.state, clock)) return;
-    emit("timer:start", item, toSnapshot(item.state, clock));
-    processItem(item, clock, true);
-    rerender();
-  }, [emit, processItem]);
-  const pause = useCallback2((id) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    if (!pauseTimerState(item.state, clock)) return;
-    emit("timer:pause", item, toSnapshot(item.state, clock));
-    rerender();
-  }, [emit]);
-  const resume = useCallback2((id) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    if (!resumeTimerState(item.state, clock)) return;
-    emit("timer:resume", item, toSnapshot(item.state, clock));
-    processItem(item, clock, true);
-    rerender();
-  }, [emit, processItem]);
-  const reset = useCallback2((id, resetOptions = {}) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    resetTimerState(item.state, clock, resetOptions);
-    item.schedules.clear();
-    item.endCalledGeneration = null;
-    emit("timer:reset", item, toSnapshot(item.state, clock));
-    if (resetOptions.autoStart) processItem(item, clock, true);
-    rerender();
-  }, [emit, processItem]);
-  const restart = useCallback2((id) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    restartTimerState(item.state, clock);
-    item.schedules.clear();
-    item.endCalledGeneration = null;
-    emit("timer:restart", item, toSnapshot(item.state, clock));
-    processItem(item, clock, true);
-    rerender();
-  }, [emit, processItem]);
-  const cancel = useCallback2((id, reason) => {
-    const item = itemsRef.current.get(id);
-    if (!item) return;
-    const clock = readClock();
-    if (!cancelTimerState(item.state, clock, reason)) return;
-    emit("timer:cancel", item, toSnapshot(item.state, clock), { reason });
-    rerender();
-  }, [emit]);
-  const ids = Array.from(itemsRef.current.keys());
-  const activeSignature = ids.map((id) => `${id}:${itemsRef.current.get(id).state.status}:${itemsRef.current.get(id).state.generation}:${itemsRef.current.get(id).state.tick}`).join("|");
-  useEffect2(() => {
-    mountedRef.current = true;
-    const runningItems = Array.from(itemsRef.current.values()).filter((item) => item.state.status === "running");
-    if (runningItems.length === 0) {
-      clearScheduledTick();
-      return;
-    }
-    clearScheduledTick();
-    const first = runningItems[0];
-    emit("scheduler:start", first, toSnapshot(first.state, readClock()));
-    timeoutRef.current = setTimeout(() => {
-      if (!mountedRef.current) return;
-      const clock = readClock();
-      for (const item of itemsRef.current.values()) {
-        if (item.state.status !== "running") continue;
-        tickTimerState(item.state, clock);
-        const snapshot = toSnapshot(item.state, clock);
-        emit("timer:tick", item, snapshot);
-        processItem(item, clock);
-      }
-      rerender();
-    }, optionsRef.current.updateIntervalMs ?? 1e3);
-    return () => {
-      if (timeoutRef.current !== null) {
-        emit("scheduler:stop", first, toSnapshot(first.state, readClock()));
-      }
-      clearScheduledTick();
-      mountedRef.current = false;
-    };
-  }, [activeSignature, clearScheduledTick, emit, processItem]);
-  const get = useCallback2(
-    (id) => {
-      const item = itemsRef.current.get(id);
-      if (!item) return void 0;
-      return getItemSnapshot(item);
-    },
-    [getItemSnapshot]
-  );
-  const now = readClock().wallNow;
-  return useMemo2(
-    () => ({
-      now,
-      size: itemsRef.current.size,
-      ids: Array.from(itemsRef.current.keys()),
-      get,
-      add,
-      update,
-      remove,
-      clear,
-      start,
-      pause,
-      resume,
-      reset,
-      restart,
-      cancel,
-      startAll: () => Array.from(itemsRef.current.keys()).forEach(start),
-      pauseAll: () => Array.from(itemsRef.current.keys()).forEach(pause),
-      resumeAll: () => Array.from(itemsRef.current.keys()).forEach(resume),
-      resetAll: (resetOptions) => Array.from(itemsRef.current.keys()).forEach((id) => reset(id, resetOptions)),
-      restartAll: () => Array.from(itemsRef.current.keys()).forEach(restart),
-      cancelAll: (reason) => Array.from(itemsRef.current.keys()).forEach((id) => cancel(id, reason))
-    }),
-    [add, cancel, clear, get, now, pause, remove, reset, restart, resume, start, update]
-  );
-}
-function validateItems(items) {
-  const ids = /* @__PURE__ */ new Set();
-  items?.forEach((item) => {
-    if (ids.has(item.id)) throw new Error(`Duplicate timer item id "${item.id}"`);
-    ids.add(item.id);
-    item.schedules?.forEach((schedule) => validatePositiveFinite(schedule.everyMs, "schedule.everyMs"));
-  });
-}
-export {
-  durationParts,
-  useTimer,
-  useTimerGroup
-};
-//# sourceMappingURL=index.js.map
+function ie(e){let u=Math.max(0,Math.trunc(Number.isFinite(e)?e:0)),i=Math.floor(u/864e5),o=u%864e5,C=Math.floor(o/36e5),h=o%36e5,p=Math.floor(h/6e4),I=h%6e4,v=Math.floor(I/1e3);return{totalMilliseconds:u,totalSeconds:Math.floor(u/1e3),milliseconds:I%1e3,seconds:v,minutes:p,hours:C,days:i}}import{useCallback as E,useEffect as se,useMemo as ce,useReducer as de,useRef as H}from"react";function le(e){return e?e===!0?{enabled:!0,includeTicks:!1,logger:console.debug}:typeof e=="function"?{enabled:!0,includeTicks:!1,logger:e}:{enabled:e.enabled!==!1,includeTicks:e.includeTicks??!1,label:e.label,logger:e.logger??console.debug}:{enabled:!1,includeTicks:!1}}function A(e,u){let i=le(e);!i.enabled||!i.logger||u.type==="timer:tick"&&!i.includeTicks||i.logger({...u,label:u.label??i.label})}function k(e,u){return{generation:u,tick:e.tick,now:e.now,elapsedMilliseconds:e.elapsedMilliseconds,status:e.status}}function d(){let e=Date.now(),u=typeof performance<"u"&&typeof performance.now=="function"?performance.now():e;return{wallNow:e,monotonicNow:u}}function Y(e,u){if(!Number.isFinite(e)||e<=0)throw new RangeError(`${u} must be a finite number greater than 0`)}function V(e){return{status:"idle",generation:0,tick:0,startedAt:null,pausedAt:null,endedAt:null,cancelledAt:null,cancelReason:null,baseElapsedMilliseconds:0,activeStartedAtMonotonic:null,now:e.wallNow}}function X(e,u){return e.status!=="running"||e.activeStartedAtMonotonic===null?e.baseElapsedMilliseconds:Math.max(0,e.baseElapsedMilliseconds+u.monotonicNow-e.activeStartedAtMonotonic)}function m(e,u){let i=X(e,u);return{status:e.status,now:u.wallNow,tick:e.tick,startedAt:e.startedAt,pausedAt:e.pausedAt,endedAt:e.endedAt,cancelledAt:e.cancelledAt,cancelReason:e.cancelReason,elapsedMilliseconds:i,isIdle:e.status==="idle",isRunning:e.status==="running",isPaused:e.status==="paused",isEnded:e.status==="ended",isCancelled:e.status==="cancelled"}}function z(e,u){return e.status!=="idle"?!1:(e.status="running",e.startedAt=u.wallNow,e.pausedAt=null,e.endedAt=null,e.cancelledAt=null,e.cancelReason=null,e.activeStartedAtMonotonic=u.monotonicNow,e.now=u.wallNow,!0)}function Z(e,u){return e.status!=="running"?!1:(e.baseElapsedMilliseconds=X(e,u),e.activeStartedAtMonotonic=null,e.status="paused",e.pausedAt=u.wallNow,e.now=u.wallNow,!0)}function _(e,u){return e.status!=="paused"?!1:(e.status="running",e.pausedAt=null,e.activeStartedAtMonotonic=u.monotonicNow,e.now=u.wallNow,!0)}function J(e,u,i={}){return e.generation+=1,e.tick=0,e.status=i.autoStart?"running":"idle",e.startedAt=i.autoStart?u.wallNow:null,e.pausedAt=null,e.endedAt=null,e.cancelledAt=null,e.cancelReason=null,e.baseElapsedMilliseconds=0,e.activeStartedAtMonotonic=i.autoStart?u.monotonicNow:null,e.now=u.wallNow,!0}function ee(e,u){return J(e,u,{autoStart:!0})}function te(e,u,i){return e.status==="ended"||e.status==="cancelled"?!1:(e.baseElapsedMilliseconds=X(e,u),e.activeStartedAtMonotonic=null,e.status="cancelled",e.cancelledAt=u.wallNow,e.cancelReason=i??null,e.now=u.wallNow,!0)}function re(e,u){return e.status!=="running"?!1:(e.baseElapsedMilliseconds=X(e,u),e.activeStartedAtMonotonic=null,e.status="ended",e.endedAt=u.wallNow,e.now=u.wallNow,!0)}function ne(e,u){return e.status!=="running"?!1:(e.tick+=1,e.now=u.wallNow,!0)}function me(e={}){let u=e.updateIntervalMs??1e3;Y(u,"updateIntervalMs"),fe(e.schedules);let i=H(e);i.current=e;let o=H(null);o.current===null&&(o.current=V(d()));let C=H(!1),h=H(null),p=H(new Map),I=H(null),[,v]=de(s=>s+1,0),l=E(()=>{h.current!==null&&(clearTimeout(h.current),h.current=null)},[]),N=E((s=d())=>m(o.current,s),[]),g=E((s,c,f={})=>{A(i.current.debug,{type:s,scope:"timer",...k(c,o.current.generation),...f})},[]),D=H(null),K=E(s=>{let c=o.current.generation;if(I.current!==c){I.current=c;try{i.current.onEnd?.(s,D.current)}catch(f){A(i.current.debug,{type:"callback:error",scope:"timer",...k(s,c),error:f})}}},[]),y=E((s,c,f,w,M)=>{if(f.pending&&(s.overlap??"skip")==="skip"){A(i.current.debug,{type:"schedule:skip",scope:"timer",scheduleId:s.id??c,reason:"overlap",...k(w,M)});return}f.lastRunAt=w.now,f.pending=!0,A(i.current.debug,{type:"schedule:start",scope:"timer",scheduleId:s.id??c,...k(w,M)}),Promise.resolve().then(()=>s.callback(w,D.current)).then(()=>{A(i.current.debug,{type:"schedule:end",scope:"timer",scheduleId:s.id??c,...k(w,M)})},t=>{A(i.current.debug,{type:"schedule:error",scope:"timer",scheduleId:s.id??c,error:t,...k(w,M)})}).finally(()=>{o.current?.generation===M&&(f.pending=!1)})},[]),P=E((s,c,f=!1)=>{let w=i.current.schedules??[],M=new Set;w.forEach((t,r)=>{let n=t.id??String(r);M.add(n);let a=p.current.get(n);if(a||(a={lastRunAt:null,pending:!1,leadingGeneration:null},p.current.set(n,a)),f&&t.leading&&a.leadingGeneration!==c){a.leadingGeneration=c,y(t,n,a,s,c);return}if(a.lastRunAt===null){a.lastRunAt=s.now;return}s.now-a.lastRunAt>=t.everyMs&&y(t,n,a,s,c)});for(let t of p.current.keys())M.has(t)||p.current.delete(t)},[y]),R=E((s=d(),c=!1)=>{let f=o.current;if(f.status!=="running")return;let w=m(f,s),M=f.generation;if(i.current.endWhen?.(w)){if(re(f,s)){let t=m(f,s);g("timer:end",t),l(),K(t),v()}return}P(w,M,c)},[K,l,g,P]),W=E(()=>{let s=d();if(!z(o.current,s))return;let c=m(o.current,s);g("timer:start",c),R(s,!0),v()},[g,R]),j=E(()=>{let s=d();if(!Z(o.current,s))return;l();let c=m(o.current,s);g("timer:pause",c),v()},[l,g]),q=E(()=>{let s=d();if(!_(o.current,s))return;let c=m(o.current,s);g("timer:resume",c),R(s,!0),v()},[g,R]),B=E((s={})=>{let c=d();l(),J(o.current,c,s),p.current.clear(),I.current=null;let f=m(o.current,c);g("timer:reset",f),s.autoStart&&R(c,!0),v()},[l,g,R]),O=E(()=>{let s=d();l(),ee(o.current,s),p.current.clear(),I.current=null;let c=m(o.current,s);g("timer:restart",c),R(s,!0),v()},[l,g,R]),U=E(s=>{let c=d();if(!te(o.current,c,s))return;l();let f=m(o.current,c);g("timer:cancel",f,{reason:s}),v()},[l,g]);D.current=ce(()=>({start:W,pause:j,resume:q,reset:B,restart:O,cancel:U}),[U,j,B,O,q,W]),se(()=>(C.current=!0,i.current.autoStart&&o.current.status==="idle"&&D.current.start(),()=>{C.current=!1,l()}),[l]);let x=N(),$=o.current.generation,F=x.status;return se(()=>{if(!C.current||F!=="running"){l();return}return l(),g("scheduler:start",N()),h.current=setTimeout(()=>{if(!C.current||o.current.generation!==$||o.current.status!=="running")return;let s=d();ne(o.current,s);let c=m(o.current,s);g("timer:tick",c),R(s),v()},i.current.updateIntervalMs??1e3),()=>{h.current!==null&&g("scheduler:stop",N()),l()}},[l,g,$,N,R,x.tick,F]),{...x,...D.current}}function fe(e){e?.forEach(u=>Y(u.everyMs,"schedule.everyMs"))}import{useCallback as T,useEffect as ae,useMemo as pe,useReducer as ge,useRef as oe}from"react";function Te(e={}){let u=e.updateIntervalMs??1e3;Y(u,"updateIntervalMs"),ue(e.items);let i=oe(e);i.current=e;let o=oe(new Map),C=oe(!1),h=oe(null),[,p]=ge(t=>t+1,0),I=T(()=>{h.current!==null&&(clearTimeout(h.current),h.current=null)},[]),v=T((t,r=d())=>m(t.state,r),[]),l=T((t,r,n,a={})=>{A(i.current.debug,{type:t,scope:"timer-group",timerId:r?.id,...k(n,r?.state.generation??0),...a})},[]),N=T(t=>({start:()=>O(t),pause:()=>U(t),resume:()=>x(t),reset:r=>$(t,r),restart:()=>F(t),cancel:r=>s(t,r)}),[]),g=T((t,r)=>{let n=t.state.generation;if(t.endCalledGeneration!==n){t.endCalledGeneration=n;try{t.definition.onEnd?.(r,N(t.id))}catch(a){A(i.current.debug,{type:"callback:error",scope:"timer-group",timerId:t.id,error:a,...k(r,n)})}}},[N]),D=T((t,r,n,a,b,S)=>{if(a.pending&&(r.overlap??"skip")==="skip"){A(i.current.debug,{type:"schedule:skip",scope:"timer-group",timerId:t.id,scheduleId:r.id??n,reason:"overlap",...k(b,S)});return}a.lastRunAt=b.now,a.pending=!0,A(i.current.debug,{type:"schedule:start",scope:"timer-group",timerId:t.id,scheduleId:r.id??n,...k(b,S)}),Promise.resolve().then(()=>r.callback(b,N(t.id))).then(()=>{A(i.current.debug,{type:"schedule:end",scope:"timer-group",timerId:t.id,scheduleId:r.id??n,...k(b,S)})},Q=>{A(i.current.debug,{type:"schedule:error",scope:"timer-group",timerId:t.id,scheduleId:r.id??n,error:Q,...k(b,S)})}).finally(()=>{o.current.get(t.id)?.state.generation===S&&(a.pending=!1)})},[N]),K=T((t,r,n=!1)=>{let a=t.definition.schedules??[],b=new Set;a.forEach((S,Q)=>{let L=S.id??String(Q);b.add(L);let G=t.schedules.get(L);if(G||(G={lastRunAt:null,pending:!1,leadingGeneration:null},t.schedules.set(L,G)),n&&S.leading&&G.leadingGeneration!==t.state.generation){G.leadingGeneration=t.state.generation,D(t,S,L,G,r,t.state.generation);return}if(G.lastRunAt===null){G.lastRunAt=t.state.startedAt??r.now,r.now-G.lastRunAt>=S.everyMs&&D(t,S,L,G,r,t.state.generation);return}r.now-G.lastRunAt>=S.everyMs&&D(t,S,L,G,r,t.state.generation)});for(let S of t.schedules.keys())b.has(S)||t.schedules.delete(S)},[D]),y=T((t,r=d(),n=!1)=>{if(t.state.status!=="running")return;let a=m(t.state,r);if(t.definition.endWhen?.(a)){if(re(t.state,r)){let b=m(t.state,r);l("timer:end",t,b),g(t,b)}return}K(t,a,n)},[g,l,K]),P=T(t=>{let r=o.current.get(t.id);if(r)return r.definition=t,{item:r,added:!1};let n={id:t.id,state:V(d()),definition:t,schedules:new Map,endCalledGeneration:null};return o.current.set(t.id,n),t.autoStart&&z(n.state,d()),{item:n,added:!0}},[]),R=T(()=>{let t=i.current.items??[],r=new Set,n=!1;t.forEach(a=>{r.add(a.id);let{item:b,added:S}=P(a);n=n||S,a.autoStart&&b.state.status==="idle"&&(n=z(b.state,d())||n)});for(let a of o.current.keys())r.has(a)||(o.current.delete(a),n=!0);return n},[P]);ae(()=>{R()&&p()},[R,e.items]);let W=T(t=>{if(ue([t]),o.current.has(t.id))throw new Error(`Timer item "${t.id}" already exists`);P(t),p()},[P]),j=T((t,r)=>{let n=o.current.get(t);if(!n)return;let a={...n.definition,...r,id:t};ue([a]),n.definition=a,p()},[]),q=T(t=>{o.current.delete(t),p()},[]),B=T(()=>{o.current.clear(),I(),p()},[I]),O=T(t=>{let r=o.current.get(t);if(!r)return;let n=d();z(r.state,n)&&(l("timer:start",r,m(r.state,n)),y(r,n,!0),p())},[l,y]),U=T(t=>{let r=o.current.get(t);if(!r)return;let n=d();Z(r.state,n)&&(l("timer:pause",r,m(r.state,n)),p())},[l]),x=T(t=>{let r=o.current.get(t);if(!r)return;let n=d();_(r.state,n)&&(l("timer:resume",r,m(r.state,n)),y(r,n,!0),p())},[l,y]),$=T((t,r={})=>{let n=o.current.get(t);if(!n)return;let a=d();J(n.state,a,r),n.schedules.clear(),n.endCalledGeneration=null,l("timer:reset",n,m(n.state,a)),r.autoStart&&y(n,a,!0),p()},[l,y]),F=T(t=>{let r=o.current.get(t);if(!r)return;let n=d();ee(r.state,n),r.schedules.clear(),r.endCalledGeneration=null,l("timer:restart",r,m(r.state,n)),y(r,n,!0),p()},[l,y]),s=T((t,r)=>{let n=o.current.get(t);if(!n)return;let a=d();te(n.state,a,r)&&(l("timer:cancel",n,m(n.state,a),{reason:r}),p())},[l]),f=Array.from(o.current.keys()).map(t=>`${t}:${o.current.get(t).state.status}:${o.current.get(t).state.generation}:${o.current.get(t).state.tick}`).join("|");ae(()=>{C.current=!0;let t=Array.from(o.current.values()).filter(n=>n.state.status==="running");if(t.length===0){I();return}I();let r=t[0];return l("scheduler:start",r,m(r.state,d())),h.current=setTimeout(()=>{if(!C.current)return;let n=d();for(let a of o.current.values()){if(a.state.status!=="running")continue;ne(a.state,n);let b=m(a.state,n);l("timer:tick",a,b),y(a,n)}p()},i.current.updateIntervalMs??1e3),()=>{h.current!==null&&l("scheduler:stop",r,m(r.state,d())),I(),C.current=!1}},[f,I,l,y]);let w=T(t=>{let r=o.current.get(t);if(r)return v(r)},[v]),M=d().wallNow;return pe(()=>({now:M,size:o.current.size,ids:Array.from(o.current.keys()),get:w,add:W,update:j,remove:q,clear:B,start:O,pause:U,resume:x,reset:$,restart:F,cancel:s,startAll:()=>Array.from(o.current.keys()).forEach(O),pauseAll:()=>Array.from(o.current.keys()).forEach(U),resumeAll:()=>Array.from(o.current.keys()).forEach(x),resetAll:t=>Array.from(o.current.keys()).forEach(r=>$(r,t)),restartAll:()=>Array.from(o.current.keys()).forEach(F),cancelAll:t=>Array.from(o.current.keys()).forEach(r=>s(r,t))}),[W,s,B,w,M,U,q,$,F,x,O,j])}function ue(e){let u=new Set;e?.forEach(i=>{if(u.has(i.id))throw new Error(`Duplicate timer item id "${i.id}"`);u.add(i.id),i.schedules?.forEach(o=>Y(o.everyMs,"schedule.everyMs"))})}export{ie as durationParts,me as useTimer,Te as useTimerGroup};