@himanshu-sorathiya/react-kit 1.0.19 → 1.0.21

package/dist/events2.js

@@ -16,7 +16,7 @@ function i(i, a, { enabled: o = !0, preventDefault: s = !0, stopPropagation: c =
 	}, [o]), e(() => {
 		let e = g && "current" in g ? g.current : g;
 		if (!e) return;
-		let t = i.toLowerCase(), n = r.includes(l) ? l : "keydown", a = u && n !== "keyup";
+		let t = String(i || "").toLowerCase(), n = r.includes(l) ? l : "keydown", a = u && n !== "keyup";
 		function o() {
 			y.current = !1;
 		}

package/dist/index.d.ts

@@ -212,26 +212,80 @@ export interface DebounceOptions {
 	leading?: boolean;
 	trailing?: boolean;
 }
-export interface UseDebounceReturn<Args extends any[]> {
+export interface UseDebounceReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	cancel: () => void;
+	flush: () => void;
+	isPending: boolean;
+}
+export declare function useDebounce(delay: number, options?: DebounceOptions): UseDebounceReturn;
+export interface UseDebouncedCallbackReturn<Args extends unknown[]> {
 	debouncedFunc: (...args: Args) => void;
 	cancel: () => void;
 	flush: () => void;
 	isPending: boolean;
 }
-export declare function useDebounce<Args extends any[]>(func: (...args: Args) => void, delay: number, options?: DebounceOptions): UseDebounceReturn<Args>;
+export declare function useDebouncedCallback<Args extends unknown[]>(func: (...args: Args) => void, delay: number, options?: DebounceOptions): UseDebouncedCallbackReturn<Args>;
+export type UseDebouncedStateReturn<T> = [
+	T,
+	(value: T) => void,
+	{
+		isPending: boolean;
+		cancel: () => void;
+		flush: () => void;
+		forceSetValue: (value: T) => void;
+	}
+];
+export declare function useDebouncedState<T>(initialValue: T | (() => T), delay: number, options?: DebounceOptions): UseDebouncedStateReturn<T>;
 export type UseDebouncedValueReturn<T> = T;
 export declare function useDebouncedValue<T>(value: T, delay: number, options?: DebounceOptions): UseDebouncedValueReturn<T>;
+export interface RateLimitOptions {
+	onRateLimitReached?: () => void;
+	refillStrategy?: "burst" | "gradual";
+}
+export interface UseRateLimitReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	remaining: number;
+	isRateLimited: boolean;
+}
+export declare function useRateLimit(limit: number, windowMs: number, options?: RateLimitOptions): UseRateLimitReturn;
+export interface UseRateLimitedCallbackReturn<Args extends unknown[]> {
+	rateLimitedFunc: (...args: Args) => void;
+	remaining: number;
+	isRateLimited: boolean;
+}
+export declare function useRateLimitedCallback<Args extends unknown[]>(func: (...args: Args) => void, limit: number, windowMs: number, options?: RateLimitOptions): UseRateLimitedCallbackReturn<Args>;
 export interface ThrottleOptions {
 	leading?: boolean;
 	trailing?: boolean;
 }
-export interface UseThrottleReturn<Args extends any[]> {
+export interface UseThrottleReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	cancel: () => void;
+	flush: () => void;
+	isPending: boolean;
+}
+export declare function useThrottle(delay: number, options?: ThrottleOptions): UseThrottleReturn;
+export interface UseThrottledCallbackReturn<Args extends unknown[]> {
 	throttledFunc: (...args: Args) => void;
 	cancel: () => void;
 	flush: () => void;
 	isPending: boolean;
 }
-export declare function useThrottle<Args extends any[]>(func: (...args: Args) => void, delay: number, options?: ThrottleOptions): UseThrottleReturn<Args>;
+export declare function useThrottledCallback<Args extends unknown[]>(func: (...args: Args) => void, delay: number, options?: ThrottleOptions): UseThrottledCallbackReturn<Args>;
+export type UseThrottledStateReturn<T> = [
+	T,
+	(value: T) => void,
+	{
+		isPending: boolean;
+		cancel: () => void;
+		flush: () => void;
+		forceSetValue: (value: T) => void;
+	}
+];
+export declare function useThrottledState<T>(initialValue: T | (() => T), delay: number, options?: ThrottleOptions): UseThrottledStateReturn<T>;
+export type UseThrottledValueReturn<T> = T;
+export declare function useThrottledValue<T>(value: T, delay: number, options?: ThrottleOptions): UseThrottledValueReturn<T>;
 export type FilterType = "text" | "number" | "boolean" | "date" | "select" | "multiselect" | "custom";
 export type TextOperator = "contains" | "equals" | "startsWith" | "endsWith" | "notContains";
 export type NumberOperator = "equals" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "between";
@@ -307,7 +361,7 @@ export interface UseFilterReturn<T> {
 	updateFilterValue: (id: string, value: unknown) => void;
 	isFilterActive: (id: string) => boolean;
 }
-export declare function useFilter<T>(data: T[], initialFilters?: FilterState<T>): UseFilterReturn<T>;
+export declare function useFilter<T>(data?: T[], initialFilters?: FilterState<T>): UseFilterReturn<T>;
 export interface FuzzySearchOptions {
 	threshold?: number;
 	caseSensitive?: boolean;
@@ -350,8 +404,8 @@ export interface UseGroupingReturn<T> {
 	resetGrouping: () => void;
 	getGroupItems: (groupKey: string) => T[];
 }
-export declare function useGrouping<T = unknown>({ items, initialGroupBy, }: {
-	items: T[];
+export declare function useGrouping<T = unknown>(options?: {
+	items?: T[];
 	initialGroupBy?: string;
 }): UseGroupingReturn<T>;
 export type SelectionId = string | number;
@@ -374,8 +428,8 @@ export interface UseMultipleSelectionReturn<T> {
 	deselectMultiple: (itemsToRemove: SelectionId[] | T[]) => void;
 	retainOnly: (itemsToRetain: SelectionId[] | T[]) => void;
 }
-export declare function useMultipleSelection<T = unknown>({ items, field, initialSelectedIds, }: {
-	items: T[];
+export declare function useMultipleSelection<T = unknown>(options?: {
+	items?: T[];
 	field?: string;
 	initialSelectedIds?: SelectionId[];
 }): UseMultipleSelectionReturn<T>;
@@ -392,7 +446,7 @@ export interface UseOrderReturn<T> {
 	resetOrder: () => void;
 	replaceOrder: (newOrderedItems: T[]) => void;
 }
-export declare function useOrder<T>(initialItems: T[]): UseOrderReturn<T>;
+export declare function useOrder<T>(initialItems?: T[]): UseOrderReturn<T>;
 export interface UsePaginationReturn<T> {
 	pageItems: T[];
 	pageSize: number;
@@ -410,7 +464,7 @@ export interface UsePaginationReturn<T> {
 	resetPageSize: () => void;
 	resetPagination: () => void;
 }
-export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
+export declare function usePagination<T>(data: T[] | undefined, initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
 type SelectionId$1 = string | number;
 export interface UseSingleSelectionReturn {
 	selectedId: SelectionId$1 | undefined;
@@ -462,7 +516,7 @@ export interface UseSortReturn<T> {
 	getNextSortingOrder: (id: string) => "asc" | "desc" | "none";
 	getSortIndex: (id: string) => number | undefined;
 }
-export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
+export declare function useSort<T>(data?: T[], initialSorts?: SortState): UseSortReturn<T>;
 export interface FuzzyHighlighterProps {
 	text: string;
 	query: string;
@@ -492,7 +546,7 @@ export interface UseExpansionReturn<T> {
 	resetExpansion: () => void;
 	replaceExpansion: (newExpandedItems: ExpansionId[] | T[]) => void;
 }
-export declare function useExpansion<T = unknown>({ items, field, initialExpandedIds, multiple, }?: {
+export declare function useExpansion<T = unknown>(options?: {
 	items?: T[];
 	field?: string;
 	initialExpandedIds?: ExpansionId[];
@@ -530,8 +584,8 @@ export interface UsePinReturn<T> {
 	pinMultiple: (newItems: PinId[] | T[]) => void;
 	unpinMultiple: (itemsToRemove: PinId[] | T[]) => void;
 }
-export declare function usePin<T = unknown>({ items, field, initialPinnedIds, maxPins, }: {
-	items: T[];
+export declare function usePin<T = unknown>(options?: {
+	items?: T[];
 	field?: string;
 	initialPinnedIds?: PinId[];
 	maxPins?: number;
@@ -551,8 +605,8 @@ export interface UseVisibilityReturn<T> {
 	resetVisibility: () => void;
 	replaceVisibility: (newVisibleItems: VisibilityId[] | T[]) => void;
 }
-export declare function useVisibility<T = unknown>({ items, field, initialVisibleIds, }: {
-	items: T[];
+export declare function useVisibility<T = unknown>(options?: {
+	items?: T[];
 	field?: string;
 	initialVisibleIds?: VisibilityId[];
 }): UseVisibilityReturn<T>;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { addBusinessDays as e, addDays as t, addHours as n, addMilliseconds as r, addMinutes as i, addMonths as a, addSeconds as o, addWeeks as s, addYears as c, clampDate as l, closestTo as u, createDate as d, differenceInBusinessDays as f, differenceInDays as p, differenceInHours as m, differenceInMilliseconds as h, differenceInMinutes as g, differenceInMonths as _, differenceInSeconds as v, differenceInWeeks as y, differenceInYears as b, durationToMilliseconds as x, eachDayOfInterval as S, eachMonthOfInterval as C, eachYearOfInterval as w, endOfDay as T, endOfHour as E, endOfMinute as D, endOfMonth as O, endOfQuarter as k, endOfWeek as A, endOfYear as j, format as M, formatDate as N, formatDuration as P, formatISO as F, formatISO9075 as I, formatRFC2822 as L, formatRFC3339 as R, formatRelativeTime as z, fromUnixTime as B, getDate as V, getDayOfWeek as H, getDayOfYear as U, getDaysInMonth as W, getHours as G, getISOWeek as K, getMilliseconds as q, getMinutes as J, getMonth as Y, getQuarter as X, getSeconds as Z, getTimestamp as Q, getYear as $, intervalToDuration as ee, isAM as te, isAfter as ne, isBefore as re, isDate as ie, isEqual as ae, isFirstDayOfMonth as oe, isFuture as se, isInLeapYear as ce, isLastDayOfMonth as le, isLeapYear as ue, isOverlapping as de, isPM as fe, isPast as pe, isSameDay as me, isSameHour as he, isSameMinute as ge, isSameMonth as _e, isSameQuarter as ve, isSameSecond as ye, isSameTime as be, isSameWeek as xe, isSameYear as Se, isThisMonth as Ce, isThisWeek as we, isThisYear as Te, isToday as Ee, isTomorrow as De, isValid as Oe, isWeekday as ke, isWeekend as Ae, isWithinRange as je, isYesterday as Me, max as Ne, min as Pe, parseISO as Fe, roundToNearestMinutes as Ie, setDate as Le, setHours as Re, setISOWeek as ze, setMilliseconds as Be, setMinutes as Ve, setMonth as He, setSeconds as Ue, setYear as We, startOfDay as Ge, startOfHour as Ke, startOfMinute as qe, startOfMonth as Je, startOfQuarter as Ye, startOfWeek as Xe, startOfYear as Ze, subDays as Qe, subHours as $e, subMilliseconds as et, subMinutes as tt, subMonths as nt, subSeconds as rt, subWeeks as it, subYears as at, toDate as ot, toISOString as st, toUnixTime as ct } from "./datetime.js";
 import { t as lt } from "./events2.js";
-import { n as ut, r as dt, t as ft } from "./performance2.js";
-import { a as pt, c as mt, i as ht, n as gt, o as _t, r as vt, s as yt, t as bt } from "./state2.js";
-import { a as xt, c as St, i as Ct, n as wt, o as Tt, r as Et, s as Dt, t as Ot } from "./ui2.js";
-export { St as FuzzyHighlighter, Ct as ModalLayout, e as addBusinessDays, t as addDays, n as addHours, r as addMilliseconds, i as addMinutes, a as addMonths, o as addSeconds, s as addWeeks, c as addYears, l as clampDate, u as closestTo, d as createDate, f as differenceInBusinessDays, p as differenceInDays, m as differenceInHours, h as differenceInMilliseconds, g as differenceInMinutes, _ as differenceInMonths, v as differenceInSeconds, y as differenceInWeeks, b as differenceInYears, x as durationToMilliseconds, S as eachDayOfInterval, C as eachMonthOfInterval, w as eachYearOfInterval, T as endOfDay, E as endOfHour, D as endOfMinute, O as endOfMonth, k as endOfQuarter, A as endOfWeek, j as endOfYear, M as format, N as formatDate, P as formatDuration, F as formatISO, I as formatISO9075, L as formatRFC2822, R as formatRFC3339, z as formatRelativeTime, B as fromUnixTime, V as getDate, H as getDayOfWeek, U as getDayOfYear, W as getDaysInMonth, G as getHours, K as getISOWeek, q as getMilliseconds, J as getMinutes, Y as getMonth, X as getQuarter, Z as getSeconds, Q as getTimestamp, $ as getYear, ee as intervalToDuration, te as isAM, ne as isAfter, re as isBefore, ie as isDate, ae as isEqual, oe as isFirstDayOfMonth, se as isFuture, ce as isInLeapYear, le as isLastDayOfMonth, ue as isLeapYear, de as isOverlapping, fe as isPM, pe as isPast, me as isSameDay, he as isSameHour, ge as isSameMinute, _e as isSameMonth, ve as isSameQuarter, ye as isSameSecond, be as isSameTime, xe as isSameWeek, Se as isSameYear, Ce as isThisMonth, we as isThisWeek, Te as isThisYear, Ee as isToday, De as isTomorrow, Oe as isValid, ke as isWeekday, Ae as isWeekend, je as isWithinRange, Me as isYesterday, Ne as max, Pe as min, Fe as parseISO, Ie as roundToNearestMinutes, Le as setDate, Re as setHours, ze as setISOWeek, Be as setMilliseconds, Ve as setMinutes, He as setMonth, Ue as setSeconds, We as setYear, Ge as startOfDay, Ke as startOfHour, qe as startOfMinute, Je as startOfMonth, Ye as startOfQuarter, Xe as startOfWeek, Ze as startOfYear, Qe as subDays, $e as subHours, et as subMilliseconds, tt as subMinutes, nt as subMonths, rt as subSeconds, it as subWeeks, at as subYears, ot as toDate, st as toISOString, ct as toUnixTime, dt as useDebounce, ut as useDebouncedValue, Et as useExpansion, mt as useFilter, yt as useFuzzySearch, _t as useGrouping, lt as useKey, xt as useModal, Tt as useModalActions, Dt as useModalState, pt as useMultipleSelection, ht as useOrder, vt as usePagination, wt as usePin, gt as useSingleSelection, bt as useSort, ft as useThrottle, Ot as useVisibility };
+import { a as ut, c as dt, i as ft, l as pt, n as mt, o as ht, r as gt, s as _t, t as vt, u as yt } from "./performance2.js";
+import { a as bt, c as xt, i as St, n as Ct, o as wt, r as Tt, s as Et, t as Dt } from "./state2.js";
+import { a as Ot, c as kt, i as At, n as jt, o as Mt, r as Nt, s as Pt, t as Ft } from "./ui2.js";
+export { kt as FuzzyHighlighter, At as ModalLayout, e as addBusinessDays, t as addDays, n as addHours, r as addMilliseconds, i as addMinutes, a as addMonths, o as addSeconds, s as addWeeks, c as addYears, l as clampDate, u as closestTo, d as createDate, f as differenceInBusinessDays, p as differenceInDays, m as differenceInHours, h as differenceInMilliseconds, g as differenceInMinutes, _ as differenceInMonths, v as differenceInSeconds, y as differenceInWeeks, b as differenceInYears, x as durationToMilliseconds, S as eachDayOfInterval, C as eachMonthOfInterval, w as eachYearOfInterval, T as endOfDay, E as endOfHour, D as endOfMinute, O as endOfMonth, k as endOfQuarter, A as endOfWeek, j as endOfYear, M as format, N as formatDate, P as formatDuration, F as formatISO, I as formatISO9075, L as formatRFC2822, R as formatRFC3339, z as formatRelativeTime, B as fromUnixTime, V as getDate, H as getDayOfWeek, U as getDayOfYear, W as getDaysInMonth, G as getHours, K as getISOWeek, q as getMilliseconds, J as getMinutes, Y as getMonth, X as getQuarter, Z as getSeconds, Q as getTimestamp, $ as getYear, ee as intervalToDuration, te as isAM, ne as isAfter, re as isBefore, ie as isDate, ae as isEqual, oe as isFirstDayOfMonth, se as isFuture, ce as isInLeapYear, le as isLastDayOfMonth, ue as isLeapYear, de as isOverlapping, fe as isPM, pe as isPast, me as isSameDay, he as isSameHour, ge as isSameMinute, _e as isSameMonth, ve as isSameQuarter, ye as isSameSecond, be as isSameTime, xe as isSameWeek, Se as isSameYear, Ce as isThisMonth, we as isThisWeek, Te as isThisYear, Ee as isToday, De as isTomorrow, Oe as isValid, ke as isWeekday, Ae as isWeekend, je as isWithinRange, Me as isYesterday, Ne as max, Pe as min, Fe as parseISO, Ie as roundToNearestMinutes, Le as setDate, Re as setHours, ze as setISOWeek, Be as setMilliseconds, Ve as setMinutes, He as setMonth, Ue as setSeconds, We as setYear, Ge as startOfDay, Ke as startOfHour, qe as startOfMinute, Je as startOfMonth, Ye as startOfQuarter, Xe as startOfWeek, Ze as startOfYear, Qe as subDays, $e as subHours, et as subMilliseconds, tt as subMinutes, nt as subMonths, rt as subSeconds, it as subWeeks, at as subYears, ot as toDate, st as toISOString, ct as toUnixTime, yt as useDebounce, pt as useDebouncedCallback, dt as useDebouncedState, _t as useDebouncedValue, Nt as useExpansion, xt as useFilter, Et as useFuzzySearch, wt as useGrouping, lt as useKey, Ot as useModal, Mt as useModalActions, Pt as useModalState, bt as useMultipleSelection, St as useOrder, Tt as usePagination, jt as usePin, ht as useRateLimit, ut as useRateLimitedCallback, Ct as useSingleSelection, Dt as useSort, ft as useThrottle, gt as useThrottledCallback, mt as useThrottledState, vt as useThrottledValue, Ft as useVisibility };

package/dist/performance.d.ts

@@ -5,25 +5,79 @@ export interface DebounceOptions {
 	leading?: boolean;
 	trailing?: boolean;
 }
-export interface UseDebounceReturn<Args extends any[]> {
+export interface UseDebounceReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	cancel: () => void;
+	flush: () => void;
+	isPending: boolean;
+}
+export declare function useDebounce(delay: number, options?: DebounceOptions): UseDebounceReturn;
+export interface UseDebouncedCallbackReturn<Args extends unknown[]> {
 	debouncedFunc: (...args: Args) => void;
 	cancel: () => void;
 	flush: () => void;
 	isPending: boolean;
 }
-export declare function useDebounce<Args extends any[]>(func: (...args: Args) => void, delay: number, options?: DebounceOptions): UseDebounceReturn<Args>;
+export declare function useDebouncedCallback<Args extends unknown[]>(func: (...args: Args) => void, delay: number, options?: DebounceOptions): UseDebouncedCallbackReturn<Args>;
+export type UseDebouncedStateReturn<T> = [
+	T,
+	(value: T) => void,
+	{
+		isPending: boolean;
+		cancel: () => void;
+		flush: () => void;
+		forceSetValue: (value: T) => void;
+	}
+];
+export declare function useDebouncedState<T>(initialValue: T | (() => T), delay: number, options?: DebounceOptions): UseDebouncedStateReturn<T>;
 export type UseDebouncedValueReturn<T> = T;
 export declare function useDebouncedValue<T>(value: T, delay: number, options?: DebounceOptions): UseDebouncedValueReturn<T>;
+export interface RateLimitOptions {
+	onRateLimitReached?: () => void;
+	refillStrategy?: "burst" | "gradual";
+}
+export interface UseRateLimitReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	remaining: number;
+	isRateLimited: boolean;
+}
+export declare function useRateLimit(limit: number, windowMs: number, options?: RateLimitOptions): UseRateLimitReturn;
+export interface UseRateLimitedCallbackReturn<Args extends unknown[]> {
+	rateLimitedFunc: (...args: Args) => void;
+	remaining: number;
+	isRateLimited: boolean;
+}
+export declare function useRateLimitedCallback<Args extends unknown[]>(func: (...args: Args) => void, limit: number, windowMs: number, options?: RateLimitOptions): UseRateLimitedCallbackReturn<Args>;
 export interface ThrottleOptions {
 	leading?: boolean;
 	trailing?: boolean;
 }
-export interface UseThrottleReturn<Args extends any[]> {
+export interface UseThrottleReturn {
+	run: <Args extends unknown[]>(func: (...args: Args) => void, ...args: Args) => void;
+	cancel: () => void;
+	flush: () => void;
+	isPending: boolean;
+}
+export declare function useThrottle(delay: number, options?: ThrottleOptions): UseThrottleReturn;
+export interface UseThrottledCallbackReturn<Args extends unknown[]> {
 	throttledFunc: (...args: Args) => void;
 	cancel: () => void;
 	flush: () => void;
 	isPending: boolean;
 }
-export declare function useThrottle<Args extends any[]>(func: (...args: Args) => void, delay: number, options?: ThrottleOptions): UseThrottleReturn<Args>;
+export declare function useThrottledCallback<Args extends unknown[]>(func: (...args: Args) => void, delay: number, options?: ThrottleOptions): UseThrottledCallbackReturn<Args>;
+export type UseThrottledStateReturn<T> = [
+	T,
+	(value: T) => void,
+	{
+		isPending: boolean;
+		cancel: () => void;
+		flush: () => void;
+		forceSetValue: (value: T) => void;
+	}
+];
+export declare function useThrottledState<T>(initialValue: T | (() => T), delay: number, options?: ThrottleOptions): UseThrottledStateReturn<T>;
+export type UseThrottledValueReturn<T> = T;
+export declare function useThrottledValue<T>(value: T, delay: number, options?: ThrottleOptions): UseThrottledValueReturn<T>;
 
 export {};

package/dist/performance.js

@@ -1,2 +1,2 @@
-import { n as e, r as t, t as n } from "./performance2.js";
-export { t as useDebounce, e as useDebouncedValue, n as useThrottle };
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "./performance2.js";
+export { l as useDebounce, r as useDebouncedCallback, t as useDebouncedState, s as useDebouncedValue, a as useRateLimit, e as useRateLimitedCallback, n as useThrottle, o as useThrottledCallback, i as useThrottledState, c as useThrottledValue };

package/dist/performance2.js

@@ -1,24 +1,20 @@
 import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
 //#region src/performance/useDebounce/useDebounce.ts
-function i(i, a, o = {}) {
-	let [s, c] = r(!1), l = o.maxWait, u = !!o.leading, d = !u && o.trailing === !1 ? !0 : o.trailing ?? !u, f = n(i), p = n(null), m = n(-1), h = n(-1), g = n(null);
-	t(() => {
-		f.current = i;
-	}, [i]);
-	let _ = e(() => {
-		p.current &&= (clearTimeout(p.current), null), m.current = -1, h.current = -1, g.current = null, c(!1);
+function i(i, a = {}) {
+	let o = Math.max(0, Number(i) || 0), [s, c] = r(!1), l = a?.maxWait, u = !!a?.leading, d = !u && a?.trailing === !1 ? !0 : a?.trailing ?? !u, f = n(null), p = n(null), m = n(null), h = n(-1), g = n(-1), _ = e(() => {
+		m.current &&= (clearTimeout(m.current), null), h.current = -1, g.current = -1, p.current = null, f.current = null, c(!1);
 	}, []), v = e(() => {
-		p.current && g.current && (clearTimeout(p.current), p.current = null, f.current(...g.current), m.current = Date.now(), h.current = -1, g.current = null, c(!1));
+		m.current && f.current && p.current && (clearTimeout(m.current), m.current = null, f.current(...p.current), h.current = Date.now(), g.current = -1, p.current = null, f.current = null, c(!1));
 	}, []);
 	return t(() => () => {
 		_();
 	}, [_]), {
-		debouncedFunc: e((...e) => {
-			c(!0), h.current = Date.now(), g.current = e, m.current === -1 && (m.current = Date.now(), u === !0 && f.current(...e)), l !== void 0 && Date.now() - m.current >= l ? (p.current && clearTimeout(p.current), f.current(...e), m.current = -1, c(!1)) : (p.current && clearTimeout(p.current), p.current = setTimeout(() => {
-				h.current !== m.current && d !== !1 && f.current(...e), m.current = -1, c(!1);
-			}, a));
+		run: e((e, ...t) => {
+			c(!0), g.current = Date.now(), p.current = t, f.current = e, h.current === -1 && (h.current = Date.now(), u === !0 && f.current(...t)), l !== void 0 && Date.now() - h.current >= l ? (m.current && clearTimeout(m.current), f.current && f.current(...t), h.current = -1, c(!1)) : (m.current && clearTimeout(m.current), m.current = setTimeout(() => {
+				g.current !== h.current && d !== !1 && f.current && p.current && f.current(...p.current), h.current = -1, c(!1);
+			}, o));
 		}, [
-			a,
+			o,
 			l,
 			d,
 			u
@@ -29,42 +25,123 @@ function i(i, a, o = {}) {
 	};
 }
 //#endregion
+//#region src/performance/useDebounce/useDebouncedCallback.ts
+function a(r, a, o = {}) {
+	let s = n(r);
+	t(() => {
+		s.current = r;
+	}, [r]);
+	let { run: c, cancel: l, flush: u, isPending: d } = i(a, o);
+	return {
+		debouncedFunc: e((...e) => {
+			c(s.current, ...e);
+		}, [c]),
+		cancel: l,
+		flush: u,
+		isPending: d
+	};
+}
+//#endregion
+//#region src/performance/useDebounce/useDebouncedState.ts
+function o(e, t, n = {}) {
+	let [i, o] = r(e), { debouncedFunc: s, cancel: c, flush: l, isPending: u } = a((e) => {
+		o(e);
+	}, t, n);
+	return [
+		i,
+		s,
+		{
+			isPending: u,
+			cancel: c,
+			flush: l,
+			forceSetValue: o
+		}
+	];
+}
+//#endregion
 //#region src/performance/useDebounce/useDebouncedValue.ts
-function a(e, n, a = {}) {
-	let [o, s] = r(e), { debouncedFunc: c } = i((e) => {
+function s(e, n, i = {}) {
+	let [o, s] = r(e), { debouncedFunc: c } = a((e) => {
 		s(e);
-	}, n, a);
+	}, n, i);
 	return t(() => {
 		c(e);
 	}, [e, c]), o;
 }
 //#endregion
-//#region src/performance/useThrottle/useThrottle.ts
-function o(i, a, o = {}) {
-	let [s, c] = r(!1), l = o.leading ?? !0, u = o.trailing ?? !0, d = n(i), f = n(null), p = n(-1), m = n(null);
+//#region src/performance/useRateLimit/useRateLimit.ts
+function c(i, a, o) {
+	let s = Math.max(1, Number(i) || 1), c = Math.max(0, Number(a) || 0), [l, u] = r(s), d = o?.refillStrategy ?? "burst", f = n(o?.onRateLimitReached);
 	t(() => {
-		d.current = i;
-	}, [i]);
-	let h = e(() => {
-		f.current &&= (clearTimeout(f.current), null), p.current = -1, m.current = null, c(!1);
+		f.current = o?.onRateLimitReached;
+	}, [o?.onRateLimitReached]);
+	let p = n(s), [m] = r(() => Date.now()), h = n(m), g = n(null);
+	return t(() => () => {
+		g.current && clearTimeout(g.current);
+	}, []), {
+		run: e((e, ...t) => {
+			let n = Date.now(), r = n - h.current;
+			if (d === "burst") r >= c && (p.current = s, h.current = n);
+			else {
+				let e = c / s, t = Math.floor(r / e);
+				t > 0 && (p.current = Math.min(s, p.current + t), h.current += t * e);
+			}
+			if (p.current > 0 ? (--p.current, u(p.current), e(...t)) : f.current && f.current(), g.current && clearTimeout(g.current), p.current < s) {
+				let e = c / s, t = d === "burst" ? c - (Date.now() - h.current) : e - (Date.now() - h.current);
+				g.current = setTimeout(() => {
+					u((e) => Math.min(s, e + 1)), h.current = Date.now(), p.current = Math.min(s, p.current + 1);
+				}, Math.max(0, t));
+			}
+		}, [
+			s,
+			c,
+			d
+		]),
+		remaining: l,
+		isRateLimited: l === 0
+	};
+}
+//#endregion
+//#region src/performance/useRateLimit/useRateLimitedCallback.ts
+function l(r, i, a, o) {
+	let s = n(r);
+	t(() => {
+		s.current = r;
+	}, [r]);
+	let { run: l, remaining: u, isRateLimited: d } = c(i, a, o);
+	return {
+		rateLimitedFunc: e((...e) => {
+			l(s.current, ...e);
+		}, [l]),
+		remaining: u,
+		isRateLimited: d
+	};
+}
+//#endregion
+//#region src/performance/useThrottle/useThrottle.ts
+function u(i, a = {}) {
+	let o = Math.max(0, Number(i) || 0), [s, c] = r(!1), l = a?.leading ?? !0, u = a?.trailing ?? !0;
+	l === !1 && u === !1 && (l = !0, u = !0);
+	let d = n(null), f = n(null), p = n(null), m = n(-1), h = e(() => {
+		p.current &&= (clearTimeout(p.current), null), m.current = -1, f.current = null, d.current = null, c(!1);
 	}, []), g = e(() => {
-		m.current && (f.current &&= (clearTimeout(f.current), null), d.current(...m.current), p.current = l ? Date.now() : -1, m.current = null, c(!1));
+		f.current && d.current && (p.current &&= (clearTimeout(p.current), null), d.current(...f.current), m.current = l ? Date.now() : -1, f.current = null, d.current = null, c(!1));
 	}, [l]);
 	return t(() => () => {
 		h();
 	}, [h]), {
-		throttledFunc: e((...e) => {
+		run: e((e, ...t) => {
 			c(!0);
-			let t = Date.now();
-			if (m.current = e, p.current === -1 ? l : t - p.current >= a) f.current &&= (clearTimeout(f.current), null), d.current(...e), p.current = t, m.current = null, c(!1);
-			else if (!f.current) {
-				let e = a - (p.current === -1 ? 0 : t - p.current);
-				f.current = setTimeout(() => {
-					u && m.current ? (d.current(...m.current), p.current = l ? Date.now() : -1) : p.current = -1, m.current = null, f.current = null, c(!1);
-				}, e);
+			let n = Date.now();
+			if (f.current = t, d.current = e, m.current === -1 ? l : n - m.current >= o) p.current &&= (clearTimeout(p.current), null), d.current(...t), m.current = n, f.current = null, c(!1);
+			else if (!p.current) {
+				let e = m.current === -1 ? 0 : n - m.current, t = o - e;
+				p.current = setTimeout(() => {
+					u && f.current && d.current ? (d.current(...f.current), m.current = l ? Date.now() : -1) : m.current = -1, f.current = null, d.current = null, p.current = null, c(!1);
+				}, t);
 			}
 		}, [
-			a,
+			o,
 			l,
 			u
 		]),
@@ -74,4 +151,48 @@ function o(i, a, o = {}) {
 	};
 }
 //#endregion
-export { a as n, i as r, o as t };
+//#region src/performance/useThrottle/useThrottledCallback.ts
+function d(r, i, a = {}) {
+	let o = n(r);
+	t(() => {
+		o.current = r;
+	}, [r]);
+	let { run: s, cancel: c, flush: l, isPending: d } = u(i, a);
+	return {
+		throttledFunc: e((...e) => {
+			s(o.current, ...e);
+		}, [s]),
+		cancel: c,
+		flush: l,
+		isPending: d
+	};
+}
+//#endregion
+//#region src/performance/useThrottle/useThrottledState.ts
+function f(e, t, n = {}) {
+	let [i, a] = r(e), { throttledFunc: o, isPending: s, cancel: c, flush: l } = d((e) => {
+		a(e);
+	}, t, n);
+	return [
+		i,
+		o,
+		{
+			isPending: s,
+			cancel: c,
+			flush: l,
+			forceSetValue: a
+		}
+	];
+}
+//#endregion
+//#region src/performance/useThrottle/useThrottledValue.ts
+function p(e, n, i = {}) {
+	let [a, o] = r(e), { throttledFunc: s } = d((e) => {
+		o(e);
+	}, n, i);
+	return t(() => {
+		s(e);
+	}, [e, s]), a;
+}
+//#endregion
+export { l as a, o as c, u as i, a as l, f as n, c as o, d as r, s, p as t, i as u };

package/dist/state.d.ts

@@ -75,7 +75,7 @@ export interface UseFilterReturn<T> {
 	updateFilterValue: (id: string, value: unknown) => void;
 	isFilterActive: (id: string) => boolean;
 }
-export declare function useFilter<T>(data: T[], initialFilters?: FilterState<T>): UseFilterReturn<T>;
+export declare function useFilter<T>(data?: T[], initialFilters?: FilterState<T>): UseFilterReturn<T>;
 export interface FuzzySearchOptions {
 	threshold?: number;
 	caseSensitive?: boolean;
@@ -118,8 +118,8 @@ export interface UseGroupingReturn<T> {
 	resetGrouping: () => void;
 	getGroupItems: (groupKey: string) => T[];
 }
-export declare function useGrouping<T = unknown>({ items, initialGroupBy, }: {
-	items: T[];
+export declare function useGrouping<T = unknown>(options?: {
+	items?: T[];
 	initialGroupBy?: string;
 }): UseGroupingReturn<T>;
 export type SelectionId = string | number;
@@ -142,8 +142,8 @@ export interface UseMultipleSelectionReturn<T> {
 	deselectMultiple: (itemsToRemove: SelectionId[] | T[]) => void;
 	retainOnly: (itemsToRetain: SelectionId[] | T[]) => void;
 }
-export declare function useMultipleSelection<T = unknown>({ items, field, initialSelectedIds, }: {
-	items: T[];
+export declare function useMultipleSelection<T = unknown>(options?: {
+	items?: T[];
 	field?: string;
 	initialSelectedIds?: SelectionId[];
 }): UseMultipleSelectionReturn<T>;
@@ -160,7 +160,7 @@ export interface UseOrderReturn<T> {
 	resetOrder: () => void;
 	replaceOrder: (newOrderedItems: T[]) => void;
 }
-export declare function useOrder<T>(initialItems: T[]): UseOrderReturn<T>;
+export declare function useOrder<T>(initialItems?: T[]): UseOrderReturn<T>;
 export interface UsePaginationReturn<T> {
 	pageItems: T[];
 	pageSize: number;
@@ -178,7 +178,7 @@ export interface UsePaginationReturn<T> {
 	resetPageSize: () => void;
 	resetPagination: () => void;
 }
-export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
+export declare function usePagination<T>(data: T[] | undefined, initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
 type SelectionId$1 = string | number;
 export interface UseSingleSelectionReturn {
 	selectedId: SelectionId$1 | undefined;
@@ -230,6 +230,6 @@ export interface UseSortReturn<T> {
 	getNextSortingOrder: (id: string) => "asc" | "desc" | "none";
 	getSortIndex: (id: string) => number | undefined;
 }
-export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
+export declare function useSort<T>(data?: T[], initialSorts?: SortState): UseSortReturn<T>;
 
 export {};