@himanshu-sorathiya/react-kit 1.0.28 → 1.0.29

package/dist/index.d.ts

@@ -417,6 +417,162 @@ export type UseKeyReturn = () => void;
  * ```
  */
 export declare function useKey(key: string, handler: (event: KeyboardEvent) => void, options?: UseKeyOptions): UseKeyReturn;
+/**
+ * Configuration for `useBatcher`.
+ *
+ * All three flush triggers (`maxSize`, `maxWait`, `quietPeriod`) are
+ * optional and independent — configure any combination, and whichever
+ * condition is met first triggers the flush. If none are configured, the
+ * batch only ever flushes when `flush()` is called manually.
+ */
+export interface BatchOptions<Item> {
+	/**
+	 * Flushes the batch immediately once it reaches this many items.
+	 * Checked on every `add()` call, before either timer-based trigger is
+	 * considered.
+	 *
+	 * Invalid input (not a positive number) is ignored — not clamped to a
+	 * fallback — with a dev-mode warning, since there's no sensible
+	 * default size to fall back to.
+	 *
+	 * @defaultValue `undefined` (no size ceiling)
+	 */
+	maxSize?: number;
+	/**
+	 * A hard ceiling, in milliseconds, on how long a batch can sit before
+	 * flushing — measured from the moment the *first* item of the current
+	 * batch was added, not the most recent one. Guarantees a maximum
+	 * latency per item regardless of how long the batch keeps growing.
+	 *
+	 * Invalid input (not a non-negative number) is ignored with a dev-mode
+	 * warning.
+	 *
+	 * @defaultValue `undefined` (no time ceiling)
+	 */
+	maxWait?: number;
+	/**
+	 * Flushes the batch once this many milliseconds pass with no further
+	 * items added — resets on every `add()` call, unlike `maxWait`. Use
+	 * this when you want to wait for activity to genuinely settle before
+	 * flushing, rather than enforcing a hard per-item latency ceiling.
+	 *
+	 * If both `maxWait` and `quietPeriod` are configured and `quietPeriod`
+	 * is not shorter than `maxWait`, `maxWait` will almost always win the
+	 * race — a dev-mode warning flags this combination.
+	 *
+	 * Invalid input (not a non-negative number) is ignored with a dev-mode
+	 * warning.
+	 *
+	 * @defaultValue `undefined` (no quiet-period trigger)
+	 */
+	quietPeriod?: number;
+	/**
+	 * Called with a snapshot of the current batch contents every time it
+	 * changes — after every `add()`, and after every flush or `cancel()`
+	 * (with an empty array). This is the mechanism for getting live,
+	 * reactive access to what's currently queued (e.g. a "3 items
+	 * queued…" indicator) without `useBatcher` itself needing to hold the
+	 * full item list in React state.
+	 *
+	 * Safe to pass a fresh inline function on every render — it's captured
+	 * in a ref and refreshed via effect, same as `onFlush`.
+	 *
+	 * @defaultValue `undefined`
+	 */
+	onItemsChange?: (items: readonly Item[]) => void;
+}
+/**
+ * The object returned by `useBatcher`.
+ */
+export interface UseBatcherReturn<Item> {
+	/**
+	 * Adds `item` to the current batch. Never rejected, never deferred to
+	 * a future call — the item is always accepted immediately. Depending
+	 * on the configured triggers, this may also cause an immediate flush
+	 * (e.g. if `maxSize` is now reached).
+	 */
+	add: (item: Item) => void;
+	/**
+	 * Immediately flushes whatever is currently batched, bypassing
+	 * `maxWait`/`quietPeriod` entirely. A no-op if the batch is empty —
+	 * `onFlush` is never called with zero items.
+	 */
+	flush: () => void;
+	/**
+	 * Discards the current batch entirely, without ever calling
+	 * `onFlush`. Clears any pending timers.
+	 */
+	cancel: () => void;
+	/**
+	 * Suspends all automatic flush triggers (`maxSize`, `maxWait`,
+	 * `quietPeriod`). Items added via `add()` while paused still
+	 * accumulate normally — pausing stops the flushing machinery, not the
+	 * accumulation. The only way to flush while paused is a manual
+	 * `flush()` call.
+	 */
+	pause: () => void;
+	/**
+	 * Resumes automatic flushing. If the batch already meets `maxSize`
+	 * (because items kept arriving while paused), flushes immediately.
+	 * Otherwise, re-arms `maxWait`/`quietPeriod` timers from scratch —
+	 * pausing does not preserve partial progress toward either deadline;
+	 * resuming starts a fresh clock for whatever's still batched.
+	 */
+	resume: () => void;
+	/** The number of items currently in the batch. */
+	size: number;
+	/** `true` whenever `size > 0`. */
+	isPending: boolean;
+	/** `true` after `pause()`, until the next `resume()`. */
+	isPaused: boolean;
+}
+/**
+ * Groups rapid, individual `add()` calls into batches, flushing the whole
+ * accumulated group to `onFlush` at once — instead of debouncing,
+ * throttling, or rate-limiting, all of which discard some calls along the
+ * way. Nothing added to a `useBatcher` is ever dropped; it's only ever
+ * grouped.
+ *
+ * A batch flushes when any configured trigger fires first: reaching
+ * `maxSize` items, `maxWait` milliseconds since the batch's first item,
+ * or `quietPeriod` milliseconds of no new items. All three are optional
+ * and can be combined freely. If none are configured, only a manual
+ * `flush()` call ever empties the batch.
+ *
+ * Unlike the debounce/throttle/rate-limit hook families, there's no
+ * separate `Callback`/`State`/`Value` wrapper — `onFlush` is a single
+ * fixed handler (captured in a ref and always current, so a fresh inline
+ * function on every render is safe), and live access to the current batch
+ * contents is available via the `onItemsChange` option instead of a
+ * dedicated hook.
+ *
+ * @example
+ * ```tsx
+ * function AnalyticsProvider({ children }: { children: React.ReactNode }) {
+ *   const { add } = useBatcher<AnalyticsEvent>(
+ *     (events) => sendAnalyticsBatch(events),
+ *     { maxSize: 20, maxWait: 5000 },
+ *   );
+ *
+ *   // `track` can be called as often as needed — events are grouped and
+ *   // sent in batches of up to 20, at least once every 5 seconds.
+ *   const track = (event: AnalyticsEvent) => add(event);
+ *
+ *   return (
+ *     <AnalyticsContext.Provider value={{ track }}>
+ *       {children}
+ *     </AnalyticsContext.Provider>
+ *   );
+ * }
+ * ```
+ *
+ * @param onFlush - Called with every item accumulated since the last
+ * flush, as a snapshot array. Safe to pass a fresh inline function on
+ * every render.
+ * @param options - See {@link BatchOptions}.
+ * @returns See {@link UseBatcherReturn}.
+ */
+export declare function useBatcher<Item>(onFlush: (items: readonly Item[]) => void, options?: BatchOptions<Item>): UseBatcherReturn<Item>;
 /**
  * Adds an optional custom equality comparator to any hook that manages a
  * value and needs to decide whether a "new" value is actually different

package/dist/index.js

@@ -1,7 +1,7 @@
 import { t as e } from "./useEventListener.js";
 import { n as t, t as n } from "./events2.js";
-import { a as r, c as i, d as a, f as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g } from "./performance2.js";
-import { a as _, c as v, i as y, n as b, o as x, r as S, s as C, t as w } from "./state2.js";
-import { a as T, i as E, n as D, o as O, r as k, s as A, t as j } from "./storage2.js";
-import { a as M, c as N, i as P, n as F, o as I, r as L, s as R, t as z } from "./ui2.js";
-export { N as FuzzyHighlighter, P as ModalLayout, k as bigIntSerializer, E as dateSerializer, T as defaultSerializer, O as mapSerializer, A as setSerializer, t as useClickOutside, f as useDebouncedCallback, o as useDebouncedState, a as useDebouncedValue, l as useDebouncer, e as useEventListener, L as useExpansion, v as useFilter, C as useFuzzySearch, x as useGrouping, n as useKey, D as useLocalStorage, M as useModal, I as useModalActions, R as useModalState, _ as useMultipleSelection, y as useOrder, S as usePagination, F as usePin, c as useRateLimitedCallback, i as useRateLimitedState, m as useRateLimitedValue, g as useRateLimiter, j as useSessionStorage, b as useSingleSelection, w as useSort, r as useThrottledCallback, s as useThrottledState, p as useThrottledValue, d as useThrottler, u as useVirtualGrid, h as useVirtualList, z as useVisibility };
+import { a as r, c as i, d as a, f as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _ } from "./performance2.js";
+import { a as v, c as y, i as b, n as x, o as S, r as C, s as w, t as T } from "./state2.js";
+import { a as E, i as D, n as O, o as k, r as A, s as j, t as M } from "./storage2.js";
+import { a as N, c as P, i as F, n as I, o as L, r as R, s as z, t as B } from "./ui2.js";
+export { P as FuzzyHighlighter, F as ModalLayout, A as bigIntSerializer, D as dateSerializer, E as defaultSerializer, k as mapSerializer, j as setSerializer, s as useBatcher, t as useClickOutside, p as useDebouncedCallback, o as useDebouncedState, a as useDebouncedValue, u as useDebouncer, e as useEventListener, R as useExpansion, y as useFilter, w as useFuzzySearch, S as useGrouping, n as useKey, O as useLocalStorage, N as useModal, L as useModalActions, z as useModalState, v as useMultipleSelection, b as useOrder, C as usePagination, I as usePin, l as useRateLimitedCallback, i as useRateLimitedState, h as useRateLimitedValue, _ as useRateLimiter, M as useSessionStorage, x as useSingleSelection, T as useSort, r as useThrottledCallback, c as useThrottledState, m as useThrottledValue, f as useThrottler, d as useVirtualGrid, g as useVirtualList, B as useVisibility };

package/dist/performance.d.ts

@@ -2,6 +2,162 @@
 
 import { Key } from 'react';
 
+/**
+ * Configuration for `useBatcher`.
+ *
+ * All three flush triggers (`maxSize`, `maxWait`, `quietPeriod`) are
+ * optional and independent — configure any combination, and whichever
+ * condition is met first triggers the flush. If none are configured, the
+ * batch only ever flushes when `flush()` is called manually.
+ */
+export interface BatchOptions<Item> {
+	/**
+	 * Flushes the batch immediately once it reaches this many items.
+	 * Checked on every `add()` call, before either timer-based trigger is
+	 * considered.
+	 *
+	 * Invalid input (not a positive number) is ignored — not clamped to a
+	 * fallback — with a dev-mode warning, since there's no sensible
+	 * default size to fall back to.
+	 *
+	 * @defaultValue `undefined` (no size ceiling)
+	 */
+	maxSize?: number;
+	/**
+	 * A hard ceiling, in milliseconds, on how long a batch can sit before
+	 * flushing — measured from the moment the *first* item of the current
+	 * batch was added, not the most recent one. Guarantees a maximum
+	 * latency per item regardless of how long the batch keeps growing.
+	 *
+	 * Invalid input (not a non-negative number) is ignored with a dev-mode
+	 * warning.
+	 *
+	 * @defaultValue `undefined` (no time ceiling)
+	 */
+	maxWait?: number;
+	/**
+	 * Flushes the batch once this many milliseconds pass with no further
+	 * items added — resets on every `add()` call, unlike `maxWait`. Use
+	 * this when you want to wait for activity to genuinely settle before
+	 * flushing, rather than enforcing a hard per-item latency ceiling.
+	 *
+	 * If both `maxWait` and `quietPeriod` are configured and `quietPeriod`
+	 * is not shorter than `maxWait`, `maxWait` will almost always win the
+	 * race — a dev-mode warning flags this combination.
+	 *
+	 * Invalid input (not a non-negative number) is ignored with a dev-mode
+	 * warning.
+	 *
+	 * @defaultValue `undefined` (no quiet-period trigger)
+	 */
+	quietPeriod?: number;
+	/**
+	 * Called with a snapshot of the current batch contents every time it
+	 * changes — after every `add()`, and after every flush or `cancel()`
+	 * (with an empty array). This is the mechanism for getting live,
+	 * reactive access to what's currently queued (e.g. a "3 items
+	 * queued…" indicator) without `useBatcher` itself needing to hold the
+	 * full item list in React state.
+	 *
+	 * Safe to pass a fresh inline function on every render — it's captured
+	 * in a ref and refreshed via effect, same as `onFlush`.
+	 *
+	 * @defaultValue `undefined`
+	 */
+	onItemsChange?: (items: readonly Item[]) => void;
+}
+/**
+ * The object returned by `useBatcher`.
+ */
+export interface UseBatcherReturn<Item> {
+	/**
+	 * Adds `item` to the current batch. Never rejected, never deferred to
+	 * a future call — the item is always accepted immediately. Depending
+	 * on the configured triggers, this may also cause an immediate flush
+	 * (e.g. if `maxSize` is now reached).
+	 */
+	add: (item: Item) => void;
+	/**
+	 * Immediately flushes whatever is currently batched, bypassing
+	 * `maxWait`/`quietPeriod` entirely. A no-op if the batch is empty —
+	 * `onFlush` is never called with zero items.
+	 */
+	flush: () => void;
+	/**
+	 * Discards the current batch entirely, without ever calling
+	 * `onFlush`. Clears any pending timers.
+	 */
+	cancel: () => void;
+	/**
+	 * Suspends all automatic flush triggers (`maxSize`, `maxWait`,
+	 * `quietPeriod`). Items added via `add()` while paused still
+	 * accumulate normally — pausing stops the flushing machinery, not the
+	 * accumulation. The only way to flush while paused is a manual
+	 * `flush()` call.
+	 */
+	pause: () => void;
+	/**
+	 * Resumes automatic flushing. If the batch already meets `maxSize`
+	 * (because items kept arriving while paused), flushes immediately.
+	 * Otherwise, re-arms `maxWait`/`quietPeriod` timers from scratch —
+	 * pausing does not preserve partial progress toward either deadline;
+	 * resuming starts a fresh clock for whatever's still batched.
+	 */
+	resume: () => void;
+	/** The number of items currently in the batch. */
+	size: number;
+	/** `true` whenever `size > 0`. */
+	isPending: boolean;
+	/** `true` after `pause()`, until the next `resume()`. */
+	isPaused: boolean;
+}
+/**
+ * Groups rapid, individual `add()` calls into batches, flushing the whole
+ * accumulated group to `onFlush` at once — instead of debouncing,
+ * throttling, or rate-limiting, all of which discard some calls along the
+ * way. Nothing added to a `useBatcher` is ever dropped; it's only ever
+ * grouped.
+ *
+ * A batch flushes when any configured trigger fires first: reaching
+ * `maxSize` items, `maxWait` milliseconds since the batch's first item,
+ * or `quietPeriod` milliseconds of no new items. All three are optional
+ * and can be combined freely. If none are configured, only a manual
+ * `flush()` call ever empties the batch.
+ *
+ * Unlike the debounce/throttle/rate-limit hook families, there's no
+ * separate `Callback`/`State`/`Value` wrapper — `onFlush` is a single
+ * fixed handler (captured in a ref and always current, so a fresh inline
+ * function on every render is safe), and live access to the current batch
+ * contents is available via the `onItemsChange` option instead of a
+ * dedicated hook.
+ *
+ * @example
+ * ```tsx
+ * function AnalyticsProvider({ children }: { children: React.ReactNode }) {
+ *   const { add } = useBatcher<AnalyticsEvent>(
+ *     (events) => sendAnalyticsBatch(events),
+ *     { maxSize: 20, maxWait: 5000 },
+ *   );
+ *
+ *   // `track` can be called as often as needed — events are grouped and
+ *   // sent in batches of up to 20, at least once every 5 seconds.
+ *   const track = (event: AnalyticsEvent) => add(event);
+ *
+ *   return (
+ *     <AnalyticsContext.Provider value={{ track }}>
+ *       {children}
+ *     </AnalyticsContext.Provider>
+ *   );
+ * }
+ * ```
+ *
+ * @param onFlush - Called with every item accumulated since the last
+ * flush, as a snapshot array. Safe to pass a fresh inline function on
+ * every render.
+ * @param options - See {@link BatchOptions}.
+ * @returns See {@link UseBatcherReturn}.
+ */
+export declare function useBatcher<Item>(onFlush: (items: readonly Item[]) => void, options?: BatchOptions<Item>): UseBatcherReturn<Item>;
 /**
  * Adds an optional custom equality comparator to any hook that manages a
  * value and needs to decide whether a "new" value is actually different

package/dist/performance.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, i, l as a, m as o, n as s, o as c, p as l, r as u, s as d, t as f, u as p } from "./performance2.js";
-export { l as useDebouncedCallback, r as useDebouncedState, n as useDebouncedValue, o as useDebouncer, a as useRateLimitedCallback, t as useRateLimitedState, d as useRateLimitedValue, p as useRateLimiter, e as useThrottledCallback, i as useThrottledState, u as useThrottledValue, c as useThrottler, s as useVirtualGrid, f as useVirtualList };
+import { a as e, c as t, d as n, f as r, h as i, i as a, l as o, m as s, n as c, o as l, p as u, r as d, s as f, t as p, u as m } from "./performance2.js";
+export { i as useBatcher, u as useDebouncedCallback, r as useDebouncedState, n as useDebouncedValue, s as useDebouncer, o as useRateLimitedCallback, t as useRateLimitedState, f as useRateLimitedValue, m as useRateLimiter, e as useThrottledCallback, a as useThrottledState, d as useThrottledValue, l as useThrottler, c as useVirtualGrid, p as useVirtualList };

package/dist/performance2.js

@@ -1,41 +1,128 @@
 import { t as e } from "./useEventListener.js";
 import { t } from "./utils.js";
 import { useCallback as n, useEffect as r, useLayoutEffect as i, useMemo as a, useRef as o, useState as s } from "react";
+//#region src/performance/useBatcher/utils.ts
+function c(e) {
+	if (e === void 0) return;
+	let t = Math.floor(Number(e));
+	return Number.isFinite(t) && t >= 1 ? t : void 0;
+}
+function l(e) {
+	if (e === void 0) return;
+	let t = Number(e);
+	return Number.isFinite(t) && t >= 0 ? t : void 0;
+}
+//#endregion
+//#region src/performance/useBatcher/useBatcher.ts
+var u = globalThis.process?.env?.NODE_ENV !== "production";
+function d(e, t = {}) {
+	u && typeof e != "function" && console.warn(`[useBatcher] Expected \`onFlush\` to be a function, received ${typeof e}.`);
+	let i = c(t?.maxSize), a = l(t?.maxWait), d = l(t?.quietPeriod);
+	u && t?.maxSize !== void 0 && i === void 0 && console.warn(`[useBatcher] \`maxSize\` (${String(t.maxSize)}) must be a positive integer — ignoring it.`), u && t?.maxWait !== void 0 && a === void 0 && console.warn(`[useBatcher] \`maxWait\` (${String(t.maxWait)}) must be a non-negative number — ignoring it.`), u && t?.quietPeriod !== void 0 && d === void 0 && console.warn(`[useBatcher] \`quietPeriod\` (${String(t.quietPeriod)}) must be a non-negative number — ignoring it.`), u && i === void 0 && a === void 0 && d === void 0 && console.warn("[useBatcher] No `maxSize`, `maxWait`, or `quietPeriod` configured — items will only flush when `flush()` is called manually."), u && a !== void 0 && d !== void 0 && d >= a && console.warn(`[useBatcher] \`quietPeriod\` (${d}ms) is not shorter than \`maxWait\` (${a}ms) — \`maxWait\` will almost always fire first, making \`quietPeriod\` unreachable in practice.`), u && t?.onItemsChange !== void 0 && typeof t.onItemsChange != "function" && console.warn("[useBatcher] `onItemsChange` must be a function — ignoring the provided value.");
+	let [f, p] = s(0), [m, h] = s(!1), g = o([]), _ = o(!1), v = o(null), y = o(null), b = o(e), x = o(typeof t?.onItemsChange == "function" ? t.onItemsChange : void 0);
+	r(() => {
+		b.current = e;
+	}, [e]), r(() => {
+		x.current = typeof t?.onItemsChange == "function" ? t.onItemsChange : void 0;
+	}, [t?.onItemsChange]);
+	let S = n(() => {
+		x.current?.([...g.current]);
+	}, []), C = n(() => {
+		v.current !== null && (clearTimeout(v.current), v.current = null), y.current !== null && (clearTimeout(y.current), y.current = null);
+	}, []);
+	r(() => C, [C]);
+	let w = n(() => {
+		if (C(), g.current.length === 0) return;
+		let e = g.current;
+		g.current = [], p(0), S(), b.current(e);
+	}, [C, S]), T = n(() => {
+		C(), g.current = [], p(0), S();
+	}, [C, S]), E = n(() => {
+		_.current = !0, C(), h(!0);
+	}, [C]), D = n(() => {
+		if (_.current = !1, h(!1), g.current.length !== 0) {
+			if (i !== void 0 && g.current.length >= i) {
+				w();
+				return;
+			}
+			a !== void 0 && (v.current = setTimeout(() => {
+				v.current = null, w();
+			}, a)), d !== void 0 && (y.current = setTimeout(() => {
+				y.current = null, w();
+			}, d));
+		}
+	}, [
+		i,
+		a,
+		d,
+		w
+	]);
+	return {
+		add: n((e) => {
+			let t = g.current.length === 0;
+			if (g.current.push(e), p(g.current.length), S(), !_.current) {
+				if (i !== void 0 && g.current.length >= i) {
+					w();
+					return;
+				}
+				t && a !== void 0 && (v.current = setTimeout(() => {
+					v.current = null, w();
+				}, a)), d !== void 0 && (y.current !== null && clearTimeout(y.current), y.current = setTimeout(() => {
+					y.current = null, w();
+				}, d));
+			}
+		}, [
+			i,
+			a,
+			d,
+			w,
+			S
+		]),
+		flush: w,
+		cancel: T,
+		pause: E,
+		resume: D,
+		size: f,
+		isPending: f > 0,
+		isPaused: m
+	};
+}
+//#endregion
 //#region src/performance/useDebouncer/useDebouncer.ts
-var c = globalThis.process?.env?.NODE_ENV !== "production";
-function l(e, t = {}) {
+var f = globalThis.process?.env?.NODE_ENV !== "production";
+function p(e, t = {}) {
 	let i = Math.max(0, Number(e) || 0);
-	c && (typeof e != "number" || !Number.isFinite(e) || e < 0) && console.warn(`[useDebouncer] Received an invalid \`delay\` (${String(e)}) — falling back to ${i}ms.`);
-	let [a, l] = s(!1), u = t?.maxWait, d = !!t?.leading, f = t?.trailing ?? !0;
-	c && !d && !f && console.warn("[useDebouncer] Both `leading` and `trailing` are false — the debounced function will never be invoked."), c && u !== void 0 && u < i && console.warn(`[useDebouncer] \`maxWait\` (${u}ms) is smaller than \`delay\` (${i}ms) — the function will fire on almost every call.`);
+	f && (typeof e != "number" || !Number.isFinite(e) || e < 0) && console.warn(`[useDebouncer] Received an invalid \`delay\` (${String(e)}) — falling back to ${i}ms.`);
+	let [a, c] = s(!1), l = t?.maxWait, u = !!t?.leading, d = t?.trailing ?? !0;
+	f && !u && !d && console.warn("[useDebouncer] Both `leading` and `trailing` are false — the debounced function will never be invoked."), f && l !== void 0 && l < i && console.warn(`[useDebouncer] \`maxWait\` (${l}ms) is smaller than \`delay\` (${i}ms) — the function will fire on almost every call.`);
 	let p = o(null), m = o(null), h = o(null), g = o(-1), _ = n(() => {
-		h.current !== null && (clearTimeout(h.current), h.current = null), g.current = -1, m.current = null, p.current = null, l(!1);
+		h.current !== null && (clearTimeout(h.current), h.current = null), g.current = -1, m.current = null, p.current = null, c(!1);
 	}, []), v = n(() => {
 		let e = p.current, t = m.current;
-		h.current === null || e === null || t === null || (clearTimeout(h.current), h.current = null, g.current = -1, m.current = null, p.current = null, l(!1), e(...t));
+		h.current === null || e === null || t === null || (clearTimeout(h.current), h.current = null, g.current = -1, m.current = null, p.current = null, c(!1), e(...t));
 	}, []);
 	return r(() => _, [_]), {
 		run: n((e, ...t) => {
 			let n = Date.now();
-			if (p.current = e, m.current = t, g.current === -1 && (g.current = n, d)) {
+			if (p.current = e, m.current = t, g.current === -1 && (g.current = n, u)) {
 				let e = p.current, t = m.current;
 				m.current = null, e(...t);
 			}
 			let r = p.current, a = m.current;
-			if (u !== void 0 && r !== null && a !== null && n - g.current >= u) {
-				h.current !== null && (clearTimeout(h.current), h.current = null), g.current = -1, m.current = null, p.current = null, l(!1), r(...a);
+			if (l !== void 0 && r !== null && a !== null && n - g.current >= l) {
+				h.current !== null && (clearTimeout(h.current), h.current = null), g.current = -1, m.current = null, p.current = null, c(!1), r(...a);
 				return;
 			}
 			h.current !== null && clearTimeout(h.current), h.current = setTimeout(() => {
 				h.current = null;
 				let e = p.current, t = m.current;
-				g.current = -1, m.current = null, p.current = null, l(!1), f && e !== null && t !== null && e(...t);
-			}, i), l(f);
+				g.current = -1, m.current = null, p.current = null, c(!1), d && e !== null && t !== null && e(...t);
+			}, i), c(d);
 		}, [
 			i,
-			u,
-			f,
-			d
+			l,
+			d,
+			u
 		]),
 		cancel: _,
 		flush: v,
@@ -44,79 +131,79 @@ function l(e, t = {}) {
 }
 //#endregion
 //#region src/performance/useDebouncer/useDebouncedCallback.ts
-var u = globalThis.process?.env?.NODE_ENV !== "production";
-function d(e, t, i = {}) {
-	u && typeof e != "function" && console.warn(`[useDebouncedCallback] Expected \`func\` to be a function, received ${typeof e}.`);
+var m = globalThis.process?.env?.NODE_ENV !== "production";
+function h(e, t, i = {}) {
+	m && typeof e != "function" && console.warn(`[useDebouncedCallback] Expected \`func\` to be a function, received ${typeof e}.`);
 	let a = o(e);
 	r(() => {
 		a.current = e;
 	}, [e]);
-	let { run: s, cancel: c, flush: d, isPending: f } = l(t, i);
+	let { run: s, cancel: c, flush: l, isPending: u } = p(t, i);
 	return {
 		debouncedFunc: n((...e) => {
 			s(a.current, ...e);
 		}, [s]),
 		cancel: c,
-		flush: d,
-		isPending: f
+		flush: l,
+		isPending: u
 	};
 }
 //#endregion
 //#region src/shared/rateControlShared/utils.ts
-function f(e) {
+function g(e) {
 	return typeof e == "function";
 }
 //#endregion
 //#region src/performance/useDebouncer/useDebouncedState.ts
-var p = globalThis.process?.env?.NODE_ENV !== "production";
-function m(e, t, r = {}) {
-	p && r.equalityFn !== void 0 && typeof r.equalityFn != "function" && console.warn("[useDebouncedState] `equalityFn` must be a function — falling back to `Object.is`.");
-	let i = typeof r.equalityFn == "function" ? r.equalityFn : Object.is, [a, c] = s(e), l = o(a), { debouncedFunc: u, cancel: m, flush: h, isPending: g } = d(n((e) => {
+var _ = globalThis.process?.env?.NODE_ENV !== "production";
+function v(e, t, r = {}) {
+	_ && r.equalityFn !== void 0 && typeof r.equalityFn != "function" && console.warn("[useDebouncedState] `equalityFn` must be a function — falling back to `Object.is`.");
+	let i = typeof r.equalityFn == "function" ? r.equalityFn : Object.is, [a, c] = s(e), l = o(a), { debouncedFunc: u, cancel: d, flush: f, isPending: p } = h(n((e) => {
 		c((t) => i(t, e) ? t : e);
 	}, [i]), t, r);
 	return [
 		a,
 		n((e) => {
-			let t = f(e) ? e(l.current) : e;
+			let t = g(e) ? e(l.current) : e;
 			l.current = t, u(t);
 		}, [u]),
 		{
-			isPending: g,
+			isPending: p,
 			cancel: n(() => {
-				m(), c((e) => (l.current = e, e));
-			}, [m]),
-			flush: h,
+				d(), c((e) => (l.current = e, e));
+			}, [d]),
+			flush: f,
 			forceSetValue: n((e) => {
-				m(), c((t) => {
-					let n = f(e) ? e(t) : e;
+				d(), c((t) => {
+					let n = g(e) ? e(t) : e;
 					return l.current = n, n;
 				});
-			}, [m])
+			}, [d])
 		}
 	];
 }
 //#endregion
 //#region src/performance/useDebouncer/useDebouncedValue.ts
-var h = globalThis.process?.env?.NODE_ENV !== "production";
-function g(e, t, n = {}) {
-	h && n.equalityFn !== void 0 && typeof n.equalityFn != "function" && console.warn("[useDebouncedValue] `equalityFn` must be a function — falling back to `Object.is`.");
-	let i = typeof n.equalityFn == "function" ? n.equalityFn : Object.is, [a, o] = s(e), { debouncedFunc: c, cancel: l, flush: u, isPending: f } = d((e) => {
+var y = globalThis.process?.env?.NODE_ENV !== "production";
+function b(e, t, n = {}) {
+	y && n.equalityFn !== void 0 && typeof n.equalityFn != "function" && console.warn("[useDebouncedValue] `equalityFn` must be a function — falling back to `Object.is`.");
+	let i = typeof n.equalityFn == "function" ? n.equalityFn : Object.is, [a, o] = s(e), { debouncedFunc: c, cancel: l, flush: u, isPending: d } = h((e) => {
 		o((t) => i(t, e) ? t : e);
 	}, t, n);
 	return r(() => {
 		c(e);
 	}, [e, c]), [a, {
-		isPending: f,
+		isPending: d,
 		cancel: l,
 		flush: u
 	}];
 }
 //#endregion
 //#region src/performance/useRateLimiter/useRateLimiter.ts
-var _ = globalThis.process?.env?.NODE_ENV !== "production";
-function v(e, t, i) {
+var x = globalThis.process?.env?.NODE_ENV !== "production";
+function S(e, t, i) {
 	let a = Math.max(1, Math.floor(Number(e) || 1)), c = Math.max(0, Number(t) || 0);
-	_ && (typeof e != "number" || !Number.isFinite(e) || e < 1) && console.warn(`[useRateLimiter] Received an invalid \`limit\` (${String(e)}) — falling back to ${a}.`), _ && (typeof t != "number" || !Number.isFinite(t) || t < 0) && console.warn(`[useRateLimiter] Received an invalid \`windowMs\` (${String(t)}) — falling back to ${c}ms.`), _ && c === 0 && console.warn("[useRateLimiter] `windowMs` is 0 — rate limiting is effectively disabled; every call will be allowed."), _ && i?.refillStrategy !== void 0 && i.refillStrategy !== "burst" && i.refillStrategy !== "gradual" && console.warn(`[useRateLimiter] \`refillStrategy\` must be "burst" or "gradual", received "${String(i.refillStrategy)}" — falling back to "burst".`), _ && i?.onRateLimitReached !== void 0 && typeof i.onRateLimitReached != "function" && console.warn("[useRateLimiter] `onRateLimitReached` must be a function — ignoring the provided value.");
+	x && (typeof e != "number" || !Number.isFinite(e) || e < 1) && console.warn(`[useRateLimiter] Received an invalid \`limit\` (${String(e)}) — falling back to ${a}.`), x && (typeof t != "number" || !Number.isFinite(t) || t < 0) && console.warn(`[useRateLimiter] Received an invalid \`windowMs\` (${String(t)}) — falling back to ${c}ms.`), x && c === 0 && console.warn("[useRateLimiter] `windowMs` is 0 — rate limiting is effectively disabled; every call will be allowed."), x && i?.refillStrategy !== void 0 && i.refillStrategy !== "burst" && i.refillStrategy !== "gradual" && console.warn(`[useRateLimiter] \`refillStrategy\` must be "burst" or "gradual", received "${String(i.refillStrategy)}" — falling back to "burst".`), x && i?.onRateLimitReached !== void 0 && typeof i.onRateLimitReached != "function" && console.warn("[useRateLimiter] `onRateLimitReached` must be a function — ignoring the provided value.");
 	let [l, u] = s(a), d = i?.refillStrategy === "gradual" ? "gradual" : "burst", f = o(typeof i?.onRateLimitReached == "function" ? i.onRateLimitReached : void 0);
 	r(() => {
 		f.current = typeof i?.onRateLimitReached == "function" ? i.onRateLimitReached : void 0;
@@ -141,7 +228,7 @@ function v(e, t, i) {
 		d,
 		c,
 		a
-	]), v = n(function e() {
+	]), _ = n(function e() {
 		if (h.current !== null && (clearTimeout(h.current), h.current = null), p.current >= a || c === 0) return;
 		let t = c / a, n = Date.now() - m.current, r = d === "burst" ? c - n : t - n;
 		h.current = setTimeout(() => {
@@ -152,26 +239,26 @@ function v(e, t, i) {
 		c,
 		d,
 		g
-	]), y = n(() => {
+	]), v = n(() => {
 		h.current !== null && (clearTimeout(h.current), h.current = null), p.current = a, m.current = Date.now(), u(a);
 	}, [a]);
 	return {
-		run: n((e, ...t) => (g(), p.current > 0 ? (--p.current, u(p.current), v(), e(...t), !0) : (f.current?.(), v(), !1)), [g, v]),
-		reset: y,
+		run: n((e, ...t) => (g(), p.current > 0 ? (--p.current, u(p.current), _(), e(...t), !0) : (f.current?.(), _(), !1)), [g, _]),
+		reset: v,
 		remaining: l,
 		isRateLimited: l === 0
 	};
 }
 //#endregion
 //#region src/performance/useRateLimiter/useRateLimitedCallback.ts
-var y = globalThis.process?.env?.NODE_ENV !== "production";
-function b(e, t, i, a) {
-	y && typeof e != "function" && console.warn(`[useRateLimitedCallback] Expected \`func\` to be a function, received ${typeof e}.`);
+var C = globalThis.process?.env?.NODE_ENV !== "production";
+function w(e, t, i, a) {
+	C && typeof e != "function" && console.warn(`[useRateLimitedCallback] Expected \`func\` to be a function, received ${typeof e}.`);
 	let s = o(e);
 	r(() => {
 		s.current = e;
 	}, [e]);
-	let { run: c, reset: l, remaining: u, isRateLimited: d } = v(t, i, a);
+	let { run: c, reset: l, remaining: u, isRateLimited: d } = S(t, i, a);
 	return {
 		rateLimitedFunc: n((...e) => c(s.current, ...e), [c]),
 		reset: l,
@@ -181,21 +268,21 @@ function b(e, t, i, a) {
 }
 //#endregion
 //#region src/performance/useRateLimiter/useRateLimitedState.ts
-var x = globalThis.process?.env?.NODE_ENV !== "production";
-function S(e, t, r, i = {}) {
-	x && i.equalityFn !== void 0 && typeof i.equalityFn != "function" && console.warn("[useRateLimitedState] `equalityFn` must be a function — falling back to `Object.is`.");
+var T = globalThis.process?.env?.NODE_ENV !== "production";
+function E(e, t, r, i = {}) {
+	T && i.equalityFn !== void 0 && typeof i.equalityFn != "function" && console.warn("[useRateLimitedState] `equalityFn` must be a function — falling back to `Object.is`.");
 	let a = typeof i.equalityFn == "function" ? i.equalityFn : Object.is, [o, c] = s(e), l = n((e) => {
 		c((t) => {
-			let n = f(e) ? e(t) : e;
+			let n = g(e) ? e(t) : e;
 			return a(t, n) ? t : n;
 		});
-	}, [a]), { rateLimitedFunc: u, reset: d, remaining: p, isRateLimited: m } = b(l, t, r, i);
+	}, [a]), { rateLimitedFunc: u, reset: d, remaining: f, isRateLimited: p } = w(l, t, r, i);
 	return [
 		o,
 		n((e) => u(e), [u]),
 		{
-			remaining: p,
-			isRateLimited: m,
+			remaining: f,
+			isRateLimited: p,
 			reset: d,
 			forceSetValue: n((e) => {
 				l(e);
@@ -205,10 +292,10 @@ function S(e, t, r, i = {}) {
 }
 //#endregion
 //#region src/performance/useRateLimiter/useRateLimitedValue.ts
-var C = globalThis.process?.env?.NODE_ENV !== "production";
-function w(e, t, n, i = {}) {
-	C && i.equalityFn !== void 0 && typeof i.equalityFn != "function" && console.warn("[useRateLimitedValue] `equalityFn` must be a function — falling back to `Object.is`.");
-	let a = typeof i.equalityFn == "function" ? i.equalityFn : Object.is, [c, l] = s(e), { rateLimitedFunc: u, reset: d, remaining: f, isRateLimited: p } = b((e) => {
+var D = globalThis.process?.env?.NODE_ENV !== "production";
+function O(e, t, n, i = {}) {
+	D && i.equalityFn !== void 0 && typeof i.equalityFn != "function" && console.warn("[useRateLimitedValue] `equalityFn` must be a function — falling back to `Object.is`.");
+	let a = typeof i.equalityFn == "function" ? i.equalityFn : Object.is, [c, l] = s(e), { rateLimitedFunc: u, reset: d, remaining: f, isRateLimited: p } = w((e) => {
 		l((t) => a(t, e) ? t : e);
 	}, t, n, i), m = o(!0);
 	return r(() => {
@@ -225,12 +312,12 @@ function w(e, t, n, i = {}) {
 }
 //#endregion
 //#region src/performance/useThrottler/useThrottler.ts
-var T = globalThis.process?.env?.NODE_ENV !== "production";
-function E(e, t = {}) {
+var k = globalThis.process?.env?.NODE_ENV !== "production";
+function A(e, t = {}) {
 	let i = Math.max(0, Number(e) || 0);
-	T && (typeof e != "number" || !Number.isFinite(e) || e < 0) && console.warn(`[useThrottler] Received an invalid \`delay\` (${String(e)}) — falling back to ${i}ms.`);
+	k && (typeof e != "number" || !Number.isFinite(e) || e < 0) && console.warn(`[useThrottler] Received an invalid \`delay\` (${String(e)}) — falling back to ${i}ms.`);
 	let [a, c] = s(!1), l = t?.leading ?? !0, u = t?.trailing ?? !0;
-	T && !l && !u && console.warn("[useThrottler] Both `leading` and `trailing` are false — the throttled function will never be invoked.");
+	k && !l && !u && console.warn("[useThrottler] Both `leading` and `trailing` are false — the throttled function will never be invoked.");
 	let d = o(null), f = o(null), p = o(null), m = o(-1), h = n(() => {
 		p.current !== null && (clearTimeout(p.current), p.current = null), m.current = -1, f.current = null, d.current = null, c(!1);
 	}, []), g = n(() => {
@@ -268,14 +355,14 @@ function E(e, t = {}) {
 }
 //#endregion
 //#region src/performance/useThrottler/useThrottledCallback.ts
-var D = globalThis.process?.env?.NODE_ENV !== "production";
-function O(e, t, i = {}) {
-	D && typeof e != "function" && console.warn(`[useThrottledCallback] Expected \`func\` to be a function, received ${typeof e}.`);
+var j = globalThis.process?.env?.NODE_ENV !== "production";
+function M(e, t, i = {}) {
+	j && typeof e != "function" && console.warn(`[useThrottledCallback] Expected \`func\` to be a function, received ${typeof e}.`);
 	let a = o(e);
 	r(() => {
 		a.current = e;
 	}, [e]);
-	let { run: s, cancel: c, flush: l, isPending: u } = E(t, i);
+	let { run: s, cancel: c, flush: l, isPending: u } = A(t, i);
 	return {
 		throttledFunc: n((...e) => {
 			s(a.current, ...e);
@@ -287,27 +374,27 @@ function O(e, t, i = {}) {
 }
 //#endregion
 //#region src/performance/useThrottler/useThrottledState.ts
-var k = globalThis.process?.env?.NODE_ENV !== "production";
-function A(e, t, r = {}) {
-	k && r.equalityFn !== void 0 && typeof r.equalityFn != "function" && console.warn("[useThrottledState] `equalityFn` must be a function — falling back to `Object.is`.");
-	let i = typeof r.equalityFn == "function" ? r.equalityFn : Object.is, [a, c] = s(e), l = o(a), { throttledFunc: u, cancel: d, flush: p, isPending: m } = O(n((e) => {
+var N = globalThis.process?.env?.NODE_ENV !== "production";
+function P(e, t, r = {}) {
+	N && r.equalityFn !== void 0 && typeof r.equalityFn != "function" && console.warn("[useThrottledState] `equalityFn` must be a function — falling back to `Object.is`.");
+	let i = typeof r.equalityFn == "function" ? r.equalityFn : Object.is, [a, c] = s(e), l = o(a), { throttledFunc: u, cancel: d, flush: f, isPending: p } = M(n((e) => {
 		c((t) => i(t, e) ? t : e);
 	}, [i]), t, r);
 	return [
 		a,
 		n((e) => {
-			let t = f(e) ? e(l.current) : e;
+			let t = g(e) ? e(l.current) : e;
 			l.current = t, u(t);
 		}, [u]),
 		{
-			isPending: m,
+			isPending: p,
 			cancel: n(() => {
 				d(), c((e) => (l.current = e, e));
 			}, [d]),
-			flush: p,
+			flush: f,
 			forceSetValue: n((e) => {
 				d(), c((t) => {
-					let n = f(e) ? e(t) : e;
+					let n = g(e) ? e(t) : e;
 					return l.current = n, n;
 				});
 			}, [d])
@@ -316,10 +403,10 @@ function A(e, t, r = {}) {
 }
 //#endregion
 //#region src/performance/useThrottler/useThrottledValue.ts
-var j = globalThis.process?.env?.NODE_ENV !== "production";
-function M(e, t, n = {}) {
-	j && n.equalityFn !== void 0 && typeof n.equalityFn != "function" && console.warn("[useThrottledValue] `equalityFn` must be a function — falling back to `Object.is`.");
-	let i = typeof n.equalityFn == "function" ? n.equalityFn : Object.is, [a, o] = s(e), { throttledFunc: c, cancel: l, flush: u, isPending: d } = O((e) => {
+var F = globalThis.process?.env?.NODE_ENV !== "production";
+function I(e, t, n = {}) {
+	F && n.equalityFn !== void 0 && typeof n.equalityFn != "function" && console.warn("[useThrottledValue] `equalityFn` must be a function — falling back to `Object.is`.");
+	let i = typeof n.equalityFn == "function" ? n.equalityFn : Object.is, [a, o] = s(e), { throttledFunc: c, cancel: l, flush: u, isPending: d } = M((e) => {
 		o((t) => i(t, e) ? t : e);
 	}, t, n);
 	return r(() => {
@@ -332,7 +419,7 @@ function M(e, t, n = {}) {
 }
 //#endregion
 //#region src/shared/virtualShared/offsetCache.ts
-var N = class {
+var L = class {
 	_offsets = /* @__PURE__ */ new Float64Array();
 	_count = 0;
 	initializeOffsets(e, t) {
@@ -401,42 +488,42 @@ var N = class {
 };
 //#endregion
 //#region src/shared/virtualShared/utils.ts
-function P(e, t) {
+function R(e, t) {
 	let n = typeof t == "function" ? t(e) : t, r = Number(n);
 	return Number.isFinite(r) && r >= 0 ? r : 0;
 }
-function F(e, t, n) {
+function z(e, t, n) {
 	if (e <= 0) return 0;
 	if (typeof t == "number") return e * Math.max(0, t);
 	if (n) return n.getItemStartOffset(e);
 	let r = 0;
-	for (let n = 0; n < e; n++) r += P(n, t);
+	for (let n = 0; n < e; n++) r += R(n, t);
 	return r;
 }
-function I(e, t, n) {
+function B(e, t, n) {
 	if (e <= 0) return 0;
 	if (typeof t == "number") return e * Math.max(0, t);
 	if (n) return n.getTotalSize();
 	let r = 0;
-	for (let n = 0; n < e; n++) r += P(n, t);
+	for (let n = 0; n < e; n++) r += R(n, t);
 	return r;
 }
-function L(e, t) {
+function V(e, t) {
 	if (!e) return 0;
 	let n = t === "vertical";
 	return e instanceof Window ? n ? document.documentElement.clientHeight : document.documentElement.clientWidth : e instanceof Document ? n ? e.documentElement.clientHeight : e.documentElement.clientWidth : n ? e.clientHeight : e.clientWidth;
 }
-function R(e, t) {
+function H(e, t) {
 	if (!e) return 0;
 	let n = t === "vertical";
 	return e instanceof Window ? n ? e.scrollY : e.scrollX : e instanceof Document ? n ? e.documentElement.scrollTop : e.documentElement.scrollLeft : n ? e.scrollTop : e.scrollLeft;
 }
-function z(e) {
+function U(e) {
 	return e ? e instanceof Window ? document.documentElement : e instanceof Document ? e.scrollingElement ?? e.documentElement : e : null;
 }
 //#endregion
 //#region src/performance/useVirtualGrid/utils.ts
-function B(e, t, n, r, i, a) {
+function W(e, t, n, r, i, a) {
 	if (n <= 0 || t <= 0) return {
 		startIndex: 0,
 		endIndex: -1
@@ -452,7 +539,7 @@ function B(e, t, n, r, i, a) {
 		o = 0, s = -1;
 		let i = 0, a = !1;
 		for (let c = 0; c < n; c++) {
-			let n = P(c, r), l = i + n;
+			let n = R(c, r), l = i + n;
 			if (!a && l > e && (o = c, a = !0), a) if (i < e + t) s = c;
 			else break;
 			i += n;
@@ -464,8 +551,8 @@ function B(e, t, n, r, i, a) {
 		endIndex: s
 	};
 }
-function V(e, t, n, r, i, a, o) {
-	let s = o ? o.getItemSize(e) : P(e, a), c = F(e, a, o), l = c + s, u = Math.max(0, r - n), d;
+function G(e, t, n, r, i, a, o) {
+	let s = o ? o.getItemSize(e) : R(e, a), c = z(e, a, o), l = c + s, u = Math.max(0, r - n), d;
 	switch (t) {
 		case "start":
 			d = c;
@@ -485,71 +572,71 @@ function V(e, t, n, r, i, a, o) {
 }
 //#endregion
 //#region src/performance/useVirtualGrid/useVirtualGrid.ts
-function H(t) {
-	let { rowCount: c, colCount: l, estimateRowHeight: u, estimateColumnWidth: f, getScrollElement: p, overscanRows: m = 3, overscanCols: h = 3, scrollingDelay: g = 150, initialViewportHeight: _ = 0, initialViewportWidth: v = 0, initialScrollTop: y, initialScrollLeft: b, initialScrollRow: x, initialScrollCol: S, itemKey: C } = t, w = Math.max(0, Math.trunc(Number(c)) || 0), T = Math.max(0, Math.trunc(Number(l)) || 0), E = Math.max(0, Math.trunc(Number(m)) || 0), D = Math.max(0, Math.trunc(Number(h)) || 0), O = o(t);
+function K(t) {
+	let { rowCount: c, colCount: l, estimateRowHeight: u, estimateColumnWidth: d, getScrollElement: f, overscanRows: p = 3, overscanCols: m = 3, scrollingDelay: g = 150, initialViewportHeight: _ = 0, initialViewportWidth: v = 0, initialScrollTop: y, initialScrollLeft: b, initialScrollRow: x, initialScrollCol: S, itemKey: C } = t, w = Math.max(0, Math.trunc(Number(c)) || 0), T = Math.max(0, Math.trunc(Number(l)) || 0), E = Math.max(0, Math.trunc(Number(p)) || 0), D = Math.max(0, Math.trunc(Number(m)) || 0), O = o(t);
 	i(() => {
 		O.current = t;
 	});
 	let k = a(() => {
 		if (typeof u != "function") return;
-		let e = new N();
+		let e = new L();
 		return e.initializeOffsets(w, u), e;
 	}, [w, u]), A = a(() => {
-		if (typeof f != "function") return;
-		let e = new N();
-		return e.initializeOffsets(T, f), e;
-	}, [T, f]), j = o(k), M = o(A);
+		if (typeof d != "function") return;
+		let e = new L();
+		return e.initializeOffsets(T, d), e;
+	}, [T, d]), j = o(k), M = o(A);
 	i(() => {
 		j.current = k;
 	}, [k]), i(() => {
 		M.current = A;
 	}, [A]);
-	let [H, U] = s(() => {
+	let [N, P] = s(() => {
 		if (typeof y == "number") return Math.max(0, y);
 		if (typeof x == "number" && w > 0) {
 			let e = Math.max(0, Math.min(Math.trunc(Number(x)) || 0, w - 1));
-			return k ? k.getItemStartOffset(e) : F(e, u);
+			return k ? k.getItemStartOffset(e) : z(e, u);
 		}
 		return 0;
-	}), [W, G] = s(() => {
+	}), [F, I] = s(() => {
 		if (typeof b == "number") return Math.max(0, b);
 		if (typeof S == "number" && T > 0) {
 			let e = Math.max(0, Math.min(Math.trunc(Number(S)) || 0, T - 1));
-			return A ? A.getItemStartOffset(e) : F(e, f);
+			return A ? A.getItemStartOffset(e) : z(e, d);
 		}
 		return 0;
-	}), [K, q] = s(!1), [, J] = s({}), Y = o(!1), { debouncedFunc: X } = d(() => q(!1), g), Z = p();
+	}), [K, q] = s(!1), [, J] = s({}), Y = o(!1), { debouncedFunc: X } = h(() => q(!1), g), Z = f();
 	r(() => {
 		if (!Z) return;
 		if (!Y.current) {
 			Y.current = !0;
 			let e = typeof y == "number" || typeof x == "number", t = typeof b == "number" || typeof S == "number";
 			if (e || t) {
-				let n = z(Z);
+				let n = U(Z);
 				n && n.scrollTo({
-					...e && { top: H },
-					...t && { left: W },
+					...e && { top: N },
+					...t && { left: F },
 					behavior: "auto"
 				});
 				return;
 			}
 		}
-		let e = R(Z, "vertical"), t = R(Z, "horizontal");
-		U((t) => t === e ? t : e), G((e) => e === t ? e : t);
+		let e = H(Z, "vertical"), t = H(Z, "horizontal");
+		P((t) => t === e ? t : e), I((e) => e === t ? e : t);
 	}, [
 		Z,
 		y,
 		b,
 		x,
 		S,
-		H,
-		W
+		N,
+		F
 	]);
 	function ee() {
 		let { getScrollElement: e, scrollingDelay: t } = O.current, n = e();
 		if (!n) return;
-		let r = R(n, "vertical"), i = R(n, "horizontal");
-		U(r), G(i), (t ?? 150) > 0 && (q(!0), X());
+		let r = H(n, "vertical"), i = H(n, "horizontal");
+		P(r), I(i), (t ?? 150) > 0 && (q(!0), X());
 	}
 	e("scroll", ee, {
 		target: Z,
@@ -561,13 +648,13 @@ function H(t) {
 		let t = new ResizeObserver(e), n = Z instanceof Document ? Z.documentElement : Z;
 		return t.observe(n), () => t.disconnect();
 	}, [Z]);
-	let te = L(Z, "vertical") || _, ne = L(Z, "horizontal") || v, re = I(w, u, k), ie = I(T, f, A), { startIndex: Q, endIndex: ae } = B(H, te, w, u, E, k), { startIndex: $, endIndex: oe } = B(W, ne, T, f, D, A), se = [];
+	let te = V(Z, "vertical") || _, ne = V(Z, "horizontal") || v, re = B(w, u, k), ie = B(T, d, A), { startIndex: Q, endIndex: ae } = W(N, te, w, u, E, k), { startIndex: $, endIndex: oe } = W(F, ne, T, d, D, A), se = [];
 	if (Q <= ae && $ <= oe) {
-		let e = k ? k.getItemStartOffset(Q) : F(Q, u);
+		let e = k ? k.getItemStartOffset(Q) : z(Q, u);
 		for (let t = Q; t <= ae; t++) {
-			let n = k ? k.getItemSize(t) : P(t, u), r = A ? A.getItemStartOffset($) : F($, f);
+			let n = k ? k.getItemSize(t) : R(t, u), r = A ? A.getItemStartOffset($) : z($, d);
 			for (let i = $; i <= oe; i++) {
-				let a = A ? A.getItemSize(i) : P(i, f), o = C ? C(t, i) : `${t}:${i}`;
+				let a = A ? A.getItemSize(i) : R(i, d), o = C ? C(t, i) : `${t}:${i}`;
 				se.push({
 					key: o,
 					rowIndex: t,
@@ -589,7 +676,7 @@ function H(t) {
 		scrollToOffset: n((e, t) => {
 			let { getScrollElement: n, initialViewportHeight: r, initialViewportWidth: i } = O.current, a = n();
 			if (!a) return;
-			let { rowCount: o, colCount: s, estimateRowHeight: c, estimateColumnWidth: l } = O.current, u = Math.max(0, Math.trunc(Number(o)) || 0), d = Math.max(0, Math.trunc(Number(s)) || 0), f = I(u, c, j.current), p = I(d, l, M.current), m = L(a, "vertical") || r || 0, h = L(a, "horizontal") || i || 0, g = Math.max(0, Math.min(e.top, Math.max(0, f - m))), _ = Math.max(0, Math.min(e.left, Math.max(0, p - h))), v = z(a);
+			let { rowCount: o, colCount: s, estimateRowHeight: c, estimateColumnWidth: l } = O.current, u = Math.max(0, Math.trunc(Number(o)) || 0), d = Math.max(0, Math.trunc(Number(s)) || 0), f = B(u, c, j.current), p = B(d, l, M.current), m = V(a, "vertical") || r || 0, h = V(a, "horizontal") || i || 0, g = Math.max(0, Math.min(e.top, Math.max(0, f - m))), _ = Math.max(0, Math.min(e.left, Math.max(0, p - h))), v = U(a);
 			v && v.scrollTo({
 				top: g,
 				left: _,
@@ -601,7 +688,7 @@ function H(t) {
 			if (!o) return;
 			let s = Math.max(0, Math.trunc(Number(r)) || 0);
 			if (s === 0) return;
-			let c = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, s - 1)), l = L(o, "vertical") || a || 0, u = I(s, i, j.current), d = R(o, "vertical"), f = V(c, t?.align ?? "auto", l, u, d, i, j.current), p = z(o);
+			let c = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, s - 1)), l = V(o, "vertical") || a || 0, u = B(s, i, j.current), d = H(o, "vertical"), f = G(c, t?.align ?? "auto", l, u, d, i, j.current), p = U(o);
 			p && p.scrollTo({
 				top: f,
 				behavior: t?.smooth === !0 ? "smooth" : "auto"
@@ -612,7 +699,7 @@ function H(t) {
 			if (!o) return;
 			let s = Math.max(0, Math.trunc(Number(r)) || 0);
 			if (s === 0) return;
-			let c = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, s - 1)), l = L(o, "horizontal") || a || 0, u = I(s, i, M.current), d = R(o, "horizontal"), f = V(c, t?.align ?? "auto", l, u, d, i, M.current), p = z(o);
+			let c = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, s - 1)), l = V(o, "horizontal") || a || 0, u = B(s, i, M.current), d = H(o, "horizontal"), f = G(c, t?.align ?? "auto", l, u, d, i, M.current), p = U(o);
 			p && p.scrollTo({
 				left: f,
 				behavior: t?.smooth === !0 ? "smooth" : "auto"
@@ -623,7 +710,7 @@ function H(t) {
 			if (!u) return;
 			let d = Math.max(0, Math.trunc(Number(i)) || 0), f = Math.max(0, Math.trunc(Number(a)) || 0);
 			if (d === 0 || f === 0) return;
-			let p = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, d - 1)), m = Math.max(0, Math.min(Math.trunc(Number(t)) || 0, f - 1)), h = L(u, "vertical") || c || 0, g = L(u, "horizontal") || l || 0, _ = I(d, o, j.current), v = I(f, s, M.current), y = R(u, "vertical"), b = R(u, "horizontal"), x = V(p, n?.rowAlign ?? "auto", h, _, y, o, j.current), S = V(m, n?.colAlign ?? "auto", g, v, b, s, M.current), C = z(u);
+			let p = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, d - 1)), m = Math.max(0, Math.min(Math.trunc(Number(t)) || 0, f - 1)), h = V(u, "vertical") || c || 0, g = V(u, "horizontal") || l || 0, _ = B(d, o, j.current), v = B(f, s, M.current), y = H(u, "vertical"), b = H(u, "horizontal"), x = G(p, n?.rowAlign ?? "auto", h, _, y, o, j.current), S = G(m, n?.colAlign ?? "auto", g, v, b, s, M.current), C = U(u);
 			C && C.scrollTo({
 				top: x,
 				left: S,
@@ -634,13 +721,13 @@ function H(t) {
 }
 //#endregion
 //#region src/performance/useVirtualList/utils.ts
-function U(e, t) {
-	return L(e, t ? "horizontal" : "vertical");
+function q(e, t) {
+	return V(e, t ? "horizontal" : "vertical");
 }
-function W(e, t) {
-	return R(e, t ? "horizontal" : "vertical");
+function J(e, t) {
+	return H(e, t ? "horizontal" : "vertical");
 }
-function G(e, t, n, r, i, a, o, s) {
+function Y(e, t, n, r, i, a, o, s) {
 	if (r <= 0 || t <= 0) return {
 		startIndex: 0,
 		endIndex: -1
@@ -660,7 +747,7 @@ function G(e, t, n, r, i, a, o, s) {
 		c = r, l = -1;
 		let a = 0;
 		for (let o = 0; o < r; o++) {
-			let r = P(o, i), s = n - a - r;
+			let r = R(o, i), s = n - a - r;
 			if (n - a <= e) break;
 			s < e + t && (o < c && (c = o), l = o), a += r;
 		}
@@ -669,7 +756,7 @@ function G(e, t, n, r, i, a, o, s) {
 		c = 0, l = -1;
 		let n = 0, a = !1;
 		for (let o = 0; o < r; o++) {
-			let r = P(o, i), s = n + r;
+			let r = R(o, i), s = n + r;
 			if (!a && s > e && (c = o, a = !0), a) if (n < e + t) l = o;
 			else break;
 			n += r;
@@ -681,8 +768,8 @@ function G(e, t, n, r, i, a, o, s) {
 		endIndex: l
 	};
 }
-function K(e, t, n, r, i, a, o, s) {
-	let c = s ? s.getItemSize(e) : P(e, a), l = F(e, a, s), u = o ? r - l - c : l, d = u + c, f = Math.max(0, r - n), p;
+function X(e, t, n, r, i, a, o, s) {
+	let c = s ? s.getItemSize(e) : R(e, a), l = z(e, a, s), u = o ? r - l - c : l, d = u + c, f = Math.max(0, r - n), p;
 	switch (t) {
 		case "start":
 			p = o ? Math.max(0, d - n) : u;
@@ -702,14 +789,14 @@ function K(e, t, n, r, i, a, o, s) {
 }
 //#endregion
 //#region src/performance/useVirtualList/useVirtualList.ts
-function q(c) {
-	let { count: l, estimateSize: u, getScrollElement: f, overscan: p = 3, horizontal: m = !1, reverse: h = !1, scrollingDelay: g = 150, initialViewportSize: _ = 0, data: v, itemKey: y, initialOffset: b, initialScrollIndex: x } = c, S = Math.max(0, Math.trunc(Number(l)) || 0), C = Math.max(0, Math.trunc(Number(p)) || 0), w = o(c);
+function Z(c) {
+	let { count: l, estimateSize: u, getScrollElement: d, overscan: f = 3, horizontal: p = !1, reverse: m = !1, scrollingDelay: g = 150, initialViewportSize: _ = 0, data: v, itemKey: y, initialOffset: b, initialScrollIndex: x } = c, S = Math.max(0, Math.trunc(Number(l)) || 0), C = Math.max(0, Math.trunc(Number(f)) || 0), w = o(c);
 	i(() => {
 		w.current = c;
 	});
 	let T = a(() => {
 		if (typeof u != "function") return;
-		let e = new N();
+		let e = new L();
 		return e.initializeOffsets(S, u), e;
 	}, [S, u]), E = o(T);
 	i(() => {
@@ -718,55 +805,55 @@ function q(c) {
 	let [D, O] = s(() => {
 		if (typeof b == "number") return Math.max(0, b);
 		if (typeof x == "number" && S > 0) {
-			let e = Math.max(0, Math.min(Math.trunc(Number(x)) || 0, S - 1)), t = T ? T.getItemStartOffset(e) : F(e, u);
-			if (h) {
-				let n = T ? T.getItemSize(e) : P(e, u), r = I(S, u, T);
+			let e = Math.max(0, Math.min(Math.trunc(Number(x)) || 0, S - 1)), t = T ? T.getItemStartOffset(e) : z(e, u);
+			if (m) {
+				let n = T ? T.getItemSize(e) : R(e, u), r = B(S, u, T);
 				return Math.max(0, r - t - n);
 			}
 			return t;
 		}
 		return 0;
-	}), [k, A] = s(!1), [, j] = s({}), M = o(!1), { debouncedFunc: L } = d(() => A(!1), g), R = f();
+	}), [k, A] = s(!1), [, j] = s({}), M = o(!1), { debouncedFunc: N } = h(() => A(!1), g), P = d();
 	r(() => {
-		if (!R) return;
+		if (!P) return;
 		if (!M.current && (M.current = !0, typeof b == "number" || typeof x == "number")) {
-			let e = z(R);
+			let e = U(P);
 			e && e.scrollTo({
-				[m ? "left" : "top"]: D,
+				[p ? "left" : "top"]: D,
 				behavior: "auto"
 			});
 			return;
 		}
-		let e = W(R, m);
+		let e = J(P, p);
 		O((t) => t === e ? t : e);
 	}, [
-		R,
-		m,
+		P,
+		p,
 		b,
 		x,
 		D
 	]);
-	function B() {
+	function F() {
 		let { getScrollElement: e, horizontal: t } = w.current, n = e();
 		if (!n) return;
-		let r = W(n, t ?? !1);
-		O(r), (w.current.scrollingDelay ?? 150) > 0 && (A(!0), L());
+		let r = J(n, t ?? !1);
+		O(r), (w.current.scrollingDelay ?? 150) > 0 && (A(!0), N());
 	}
-	e("scroll", B, {
-		target: R,
+	e("scroll", F, {
+		target: P,
 		passive: !0
 	}), r(() => {
-		if (!R) return;
+		if (!P) return;
 		let e = () => j({});
-		if (R instanceof Window) return R.addEventListener("resize", e), () => R.removeEventListener("resize", e);
-		let t = new ResizeObserver(e), n = R instanceof Document ? R.documentElement : R;
+		if (P instanceof Window) return P.addEventListener("resize", e), () => P.removeEventListener("resize", e);
+		let t = new ResizeObserver(e), n = P instanceof Document ? P.documentElement : P;
 		return t.observe(n), () => t.disconnect();
-	}, [R]);
-	let V = U(R, m) || _, H = I(S, u, T), { startIndex: q, endIndex: J } = G(D, V, H, S, u, C, h, T), Y = [];
-	if (q <= J) {
-		let e = T ? T.getItemStartOffset(q) : F(q, u);
-		for (let n = q; n <= J; n++) {
-			let r = T ? T.getItemSize(n) : P(n, u), i = h ? H - e - r : e, a = n;
+	}, [P]);
+	let I = q(P, p) || _, V = B(S, u, T), { startIndex: H, endIndex: W } = Y(D, I, V, S, u, C, m, T), G = [];
+	if (H <= W) {
+		let e = T ? T.getItemStartOffset(H) : z(H, u);
+		for (let n = H; n <= W; n++) {
+			let r = T ? T.getItemSize(n) : R(n, u), i = m ? V - e - r : e, a = n;
 			if (y) {
 				if (typeof y == "function") a = y(n, v?.[n]);
 				else if (v && v[n] !== void 0 && v[n] !== null) {
@@ -774,7 +861,7 @@ function q(c) {
 					(typeof e == "string" || typeof e == "number") && (a = e);
 				}
 			}
-			Y.push({
+			G.push({
 				key: a,
 				index: n,
 				size: r,
@@ -782,30 +869,30 @@ function q(c) {
 			}), e += r;
 		}
 	}
-	let X = n((e, t) => {
+	let K = n((e, t) => {
 		let { getScrollElement: n, horizontal: r, count: i, estimateSize: a } = w.current, o = n();
 		if (!o) return;
-		let s = r ?? !1, c = U(o, s) || w.current.initialViewportSize || 0, l = E.current, u = I(Math.max(0, Math.trunc(Number(i)) || 0), a, l), d = Math.max(0, Math.min(e, Math.max(0, u - c))), f = z(o);
+		let s = r ?? !1, c = q(o, s) || w.current.initialViewportSize || 0, l = E.current, u = B(Math.max(0, Math.trunc(Number(i)) || 0), a, l), d = Math.max(0, Math.min(e, Math.max(0, u - c))), f = U(o);
 		if (!f) return;
 		let p = { behavior: t?.smooth === !0 ? "smooth" : "auto" };
 		s ? p.left = d : p.top = d, f.scrollTo(p);
 	}, []);
 	return {
-		virtualItems: Y,
-		totalSize: H,
+		virtualItems: G,
+		totalSize: V,
 		isScrolling: k,
 		scrollToIndex: n((e, t) => {
 			let { getScrollElement: n, count: r, estimateSize: i, horizontal: a, reverse: o } = w.current, s = n();
 			if (!s) return;
 			let c = Math.max(0, Math.trunc(Number(r)) || 0);
 			if (c === 0) return;
-			let l = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, c - 1)), u = t?.align ?? "auto", d = a ?? !1, f = o ?? !1, p = E.current, m = K(l, u, U(s, d) || w.current.initialViewportSize || 0, I(c, i, p), W(s, d), i, f, p), h = z(s);
+			let l = Math.max(0, Math.min(Math.trunc(Number(e)) || 0, c - 1)), u = t?.align ?? "auto", d = a ?? !1, f = o ?? !1, p = E.current, m = X(l, u, q(s, d) || w.current.initialViewportSize || 0, B(c, i, p), J(s, d), i, f, p), h = U(s);
 			if (!h) return;
 			let g = { behavior: t?.smooth === !0 ? "smooth" : "auto" };
 			d ? g.left = m : g.top = m, h.scrollTo(g);
 		}, []),
-		scrollToOffset: X
+		scrollToOffset: K
 	};
 }
 //#endregion
-export { O as a, S as c, g as d, m as f, A as i, b as l, l as m, H as n, E as o, d as p, M as r, w as s, q as t, v as u };
+export { M as a, E as c, b as d, v as f, d as h, P as i, w as l, p as m, K as n, A as o, h as p, I as r, O as s, Z as t, S as u };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@himanshu-sorathiya/react-kit",
-	"version": "1.0.28",
+	"version": "1.0.29",
 	"description": "An opinionated collection of react hooks, and reusable UI components.",
 	"type": "module",
 	"module": "./dist/index.js",