@provex/react 1.11.0 → 2.0.0

package/dist/clock-BDtn-Itb.d.cts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Clock seam for time-dependent logic.
+ *
+ * Code that reads the current time or schedules timers takes a `Clock`
+ * instead of calling the globals. Production code uses `systemClock`.
+ * Tests pass the deterministic clock from `@provex/react/testing`.
+ */
+/** Opaque handle returned by `Clock.setTimeout` and `Clock.setInterval`. */
+type TimerHandle = ReturnType<typeof setTimeout>;
+/** The time and timer functions that time-dependent code needs. */
+interface Clock {
+    /** Current time in milliseconds since the Unix epoch. */
+    now(): number;
+    /** Run `callback` once after `delayMs` milliseconds. */
+    setTimeout(callback: () => void, delayMs: number): TimerHandle;
+    /** Cancel a timer created by `setTimeout`. */
+    clearTimeout(handle: TimerHandle): void;
+    /** Run `callback` every `intervalMs` milliseconds. */
+    setInterval(callback: () => void, intervalMs: number): TimerHandle;
+    /** Cancel a timer created by `setInterval`. */
+    clearInterval(handle: TimerHandle): void;
+}
+/**
+ * The real clock. Each call reads the global at call time, so code that
+ * replaces the globals (for example `vi.useFakeTimers`) still takes effect.
+ */
+declare const systemClock: Clock;
+
+export { type Clock as C, type TimerHandle as T, systemClock as s };

package/dist/clock-BDtn-Itb.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Clock seam for time-dependent logic.
+ *
+ * Code that reads the current time or schedules timers takes a `Clock`
+ * instead of calling the globals. Production code uses `systemClock`.
+ * Tests pass the deterministic clock from `@provex/react/testing`.
+ */
+/** Opaque handle returned by `Clock.setTimeout` and `Clock.setInterval`. */
+type TimerHandle = ReturnType<typeof setTimeout>;
+/** The time and timer functions that time-dependent code needs. */
+interface Clock {
+    /** Current time in milliseconds since the Unix epoch. */
+    now(): number;
+    /** Run `callback` once after `delayMs` milliseconds. */
+    setTimeout(callback: () => void, delayMs: number): TimerHandle;
+    /** Cancel a timer created by `setTimeout`. */
+    clearTimeout(handle: TimerHandle): void;
+    /** Run `callback` every `intervalMs` milliseconds. */
+    setInterval(callback: () => void, intervalMs: number): TimerHandle;
+    /** Cancel a timer created by `setInterval`. */
+    clearInterval(handle: TimerHandle): void;
+}
+/**
+ * The real clock. Each call reads the global at call time, so code that
+ * replaces the globals (for example `vi.useFakeTimers`) still takes effect.
+ */
+declare const systemClock: Clock;
+
+export { type Clock as C, type TimerHandle as T, systemClock as s };