INIT

node_modules/runed/dist/utilities/use-interval/index.d.ts

@@ -0,0 +1 @@
+export * from "./use-interval.svelte.js";

node_modules/runed/dist/utilities/use-interval/index.js

@@ -0,0 +1 @@
+export * from "./use-interval.svelte.js";

node_modules/runed/dist/utilities/use-interval/use-interval.svelte.d.ts

@@ -0,0 +1,51 @@
+import type { MaybeGetter } from "../../internal/types.js";
+export type UseIntervalOptions = {
+    /**
+     * Start the timer immediately
+     *
+     * @default true
+     */
+    immediate?: boolean;
+    /**
+     * Execute the callback immediately after calling `resume`
+     *
+     * @default false
+     */
+    immediateCallback?: boolean;
+    /**
+     * Callback to execute on every interval tick, receives the current counter value
+     */
+    callback?: (count: number) => void;
+};
+export type UseIntervalReturn = {
+    /**
+     * Pause the interval
+     */
+    pause: () => void;
+    /**
+     * Resume the interval
+     */
+    resume: () => void;
+    /**
+     * Reset the counter to 0
+     */
+    reset: () => void;
+    /**
+     * Whether the interval is currently active
+     */
+    readonly isActive: boolean;
+    /**
+     * The current counter value
+     */
+    readonly counter: number;
+};
+/**
+ * Wrapper for `setInterval` with controls for pausing and resuming.
+ *
+ * @see https://runed.dev/docs/utilities/use-interval
+ *
+ * @param delay - The interval in milliseconds between executions
+ * @param options - Configuration options
+ * @returns Object with pause, resume, reset methods, counter and isActive state
+ */
+export declare function useInterval(delay: MaybeGetter<number>, options?: UseIntervalOptions): UseIntervalReturn;

node_modules/runed/dist/utilities/use-interval/use-interval.svelte.js

@@ -0,0 +1,61 @@
+import { extract } from "../extract/index.js";
+import { watch } from "../watch/watch.svelte.js";
+/**
+ * Wrapper for `setInterval` with controls for pausing and resuming.
+ *
+ * @see https://runed.dev/docs/utilities/use-interval
+ *
+ * @param delay - The interval in milliseconds between executions
+ * @param options - Configuration options
+ * @returns Object with pause, resume, reset methods, counter and isActive state
+ */
+export function useInterval(delay, options = {}) {
+    const { immediate = true, immediateCallback = false, callback } = options;
+    let intervalId = $state(null);
+    let counter = $state(0);
+    const delay$ = $derived(extract(delay));
+    const isActive = $derived(intervalId !== null);
+    function runCallback() {
+        counter++;
+        callback?.(counter);
+    }
+    function createInterval() {
+        intervalId = setInterval(runCallback, delay$);
+    }
+    const pause = () => {
+        if (intervalId === null)
+            return;
+        clearInterval(intervalId);
+        intervalId = null;
+    };
+    const resume = () => {
+        if (intervalId !== null)
+            return;
+        if (immediateCallback)
+            runCallback();
+        createInterval();
+    };
+    if (immediate) {
+        resume();
+    }
+    // Sync interval's delay with the prop
+    watch(() => delay$, () => {
+        if (!isActive)
+            return;
+        pause();
+        createInterval();
+    });
+    // Cleanup on disposal
+    $effect(() => pause);
+    return {
+        pause,
+        resume,
+        reset: () => (counter = 0),
+        get isActive() {
+            return isActive;
+        },
+        get counter() {
+            return counter;
+        },
+    };
+}