@himanshu-sorathiya/react-kit 1.0.13 → 1.0.16

package/dist/index.d.ts

@@ -1,35 +1,24 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import React$1 from 'react';
 import { CSSProperties, RefObject } from 'react';
 
+export interface FuzzyHighlighterProps {
+	text: string;
+	query: string;
+	className?: string;
+	caseSensitive?: boolean;
+}
+export declare function FuzzyHighlighter({ text, query, className, caseSensitive, }: FuzzyHighlighterProps): React$1.JSX.Element;
 export interface ModalLayoutProps {
 	modalId: string;
-	children: React.ReactNode;
+	children: React$1.ReactNode;
 	wrapperClassName?: string;
-	wrapperStyle?: CSSProperties;
+	wrapperStyle?: React$1.CSSProperties;
 	containerClassName?: string;
-	containerStyle?: CSSProperties;
+	containerStyle?: React$1.CSSProperties;
 }
 export declare function ModalLayout({ modalId, children, wrapperClassName, wrapperStyle, containerClassName, containerStyle, }: ModalLayoutProps): import("react").ReactPortal | null;
-export interface DebounceOptions {
-	maxWait?: number;
-	leading?: boolean;
-	trailing?: boolean;
-}
-export interface UseDebounceReturn<Args extends any[]> {
-	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 interface DebouncedValueOptions {
-	maxWait?: number;
-	leading?: boolean;
-	trailing?: boolean;
-}
-export type UseDebouncedValueReturn<T> = T;
-export declare function useDebouncedValue<T>(value: T, delay: number, options?: DebouncedValueOptions): UseDebouncedValueReturn<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";
@@ -133,60 +122,25 @@ export type UseFuzzySearchFields<T> = {
 }[];
 export type UseFuzzySearchReturn<T> = T[];
 export declare function useFuzzySearch<T>(data: T[], query: string, fields: UseFuzzySearchFields<T>, options?: FuzzySearchOptions): UseFuzzySearchReturn<T>;
-declare const validKeyEventTypes: readonly [
-	"keydown",
-	"keyup",
-	"keypress"
-];
-export type KeyEventType = (typeof validKeyEventTypes)[number];
-export interface BaseKeyOptions {
-	enabled?: boolean;
-	target?: RefObject<HTMLElement | null> | Window;
-	preventDefault?: boolean;
-	stopPropagation?: boolean;
-	ignoreWhenFocusedInInputs?: boolean;
-	ctrlKey?: boolean;
-	shiftKey?: boolean;
-	altKey?: boolean;
-	metaKey?: boolean;
-}
-export type KeyOptions = BaseKeyOptions & ({
-	eventType?: "keydown" | "keypress";
-	preventRepeat?: boolean;
-} | {
-	eventType: "keyup";
-	preventRepeat?: never;
-});
-export type UseKeyReturn = void;
-export declare function useKey(key: string, handler: (e: KeyboardEvent) => void, { enabled, preventDefault, stopPropagation, eventType, preventRepeat, ignoreWhenFocusedInInputs, ctrlKey, shiftKey, altKey, metaKey, target, }?: KeyOptions): UseKeyReturn;
-export interface UseModalStateReturn<TData> {
-	isOpen: boolean;
-	id: string | null;
-	data: TData | undefined;
-}
-export interface UseModalActionsReturn {
-	openModal: <T = unknown>(id: string, data?: T) => void;
-	closeModal: () => void;
-	clearModal: () => void;
+export interface Group<T> {
+	key: string;
+	items: T[];
 }
-export type UseModalReturn<TData> = UseModalStateReturn<TData> & UseModalActionsReturn;
-export declare function useModalState<TData = unknown>(): UseModalStateReturn<TData>;
-export declare function useModalActions(): UseModalActionsReturn;
-export declare function useModal<TData = unknown>(): UseModalReturn<TData>;
-export interface UseOrderReturn<T> {
-	orderedItems: T[];
-	moveUp: (index: number) => void;
-	moveDown: (index: number) => void;
-	canMoveUp: (index: number) => boolean;
-	canMoveDown: (index: number) => boolean;
-	moveToTop: (index: number) => void;
-	moveToBottom: (index: number) => void;
-	move: (fromIndex: number, toIndex: number) => void;
-	swap: (indexA: number, indexB: number) => void;
-	replaceOrder: (newOrderedItems: T[]) => void;
-	resetOrder: () => void;
+export interface UseGroupingReturn<T> {
+	groupedRecord: Record<string, T[]>;
+	groupedArray: Group<T>[];
+	groupKeys: string[];
+	totalGroups: number;
+	activeGroupBy: string | undefined;
+	changeGroupBy: (newField: string) => void;
+	clearGrouping: () => void;
+	resetGrouping: () => void;
+	getGroupItems: (groupKey: string) => T[];
 }
-export declare function useOrder<T>(initialItems: T[]): UseOrderReturn<T>;
+export declare function useGrouping<T = unknown>({ items, initialGroupBy, }: {
+	items: T[];
+	initialGroupBy?: string;
+}): UseGroupingReturn<T>;
 export interface UsePaginationReturn<T> {
 	pageItems: T[];
 	pageSize: number;
@@ -205,6 +159,80 @@ export interface UsePaginationReturn<T> {
 	resetPagination: () => void;
 }
 export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
+export type SelectionId = string | number;
+export interface UseMultipleSelectionReturn<T> {
+	selectedIds: SelectionId[];
+	selectedCount: number;
+	selectedItems: T[];
+	isEmpty: boolean;
+	select: (item: SelectionId | T) => void;
+	deselect: (item: SelectionId | T) => void;
+	toggle: (item: SelectionId | T) => void;
+	isSelected: (item: SelectionId | T) => boolean;
+	resetSelection: () => void;
+	replaceSelection: (newSelectedItems: SelectionId[] | T[]) => void;
+	selectAll: () => void;
+	deselectAll: () => void;
+	toggleAll: () => void;
+	invertSelection: () => void;
+	selectMultiple: (newItems: SelectionId[] | T[]) => void;
+	deselectMultiple: (itemsToRemove: SelectionId[] | T[]) => void;
+	retainOnly: (itemsToRetain: SelectionId[] | T[]) => void;
+}
+export declare function useMultipleSelection<T = unknown>({ items, field, initialSelectedIds, }: {
+	items: T[];
+	field?: string;
+	initialSelectedIds?: SelectionId[];
+}): UseMultipleSelectionReturn<T>;
+type SelectionId$1 = string | number;
+export interface UseSingleSelectionReturn {
+	selectedId: SelectionId$1 | undefined;
+	hasSelection: boolean;
+	select: (id: SelectionId$1) => void;
+	deselect: () => void;
+	toggle: (id: SelectionId$1) => void;
+	isSelected: (id: SelectionId$1) => boolean;
+	resetSelection: () => void;
+}
+export declare function useSingleSelection(initialSelectedId?: SelectionId$1): UseSingleSelectionReturn;
+export interface UseOrderReturn<T> {
+	orderedItems: T[];
+	moveUp: (index: number) => void;
+	moveDown: (index: number) => void;
+	canMoveUp: (index: number) => boolean;
+	canMoveDown: (index: number) => boolean;
+	moveToTop: (index: number) => void;
+	moveToBottom: (index: number) => void;
+	move: (fromIndex: number, toIndex: number) => void;
+	swap: (indexA: number, indexB: number) => void;
+	resetOrder: () => void;
+	replaceOrder: (newOrderedItems: T[]) => void;
+}
+export declare function useOrder<T>(initialItems: T[]): UseOrderReturn<T>;
+export type PinId = string | number;
+export interface UsePinReturn<T> {
+	pinnedIds: PinId[];
+	pinnedItems: T[];
+	unpinnedItems: T[];
+	pinnedCount: number;
+	hasPins: boolean;
+	isAtMaxLimit: boolean;
+	pin: (itemOrId: PinId | T) => void;
+	unpin: (itemOrId: PinId | T) => void;
+	togglePin: (itemOrId: PinId | T) => void;
+	isPinned: (itemOrId: PinId | T) => boolean;
+	clearPins: () => void;
+	resetPins: () => void;
+	replacePins: (newPinnedItems: PinId[] | T[]) => void;
+	pinMultiple: (newItems: PinId[] | T[]) => void;
+	unpinMultiple: (itemsToRemove: PinId[] | T[]) => void;
+}
+export declare function usePin<T = unknown>({ items, field, initialPinnedIds, maxPins, }: {
+	items: T[];
+	field?: string;
+	initialPinnedIds?: PinId[];
+	maxPins?: number;
+}): UsePinReturn<T>;
 export type SortType = "numeric" | "alphabetical" | "alphanumeric" | "boolean" | "date" | "basic" | "custom";
 export interface BaseSortOptions {
 	desc?: boolean;
@@ -246,6 +274,54 @@ export interface UseSortReturn<T> {
 	getSortIndex: (id: string) => number | undefined;
 }
 export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
+export interface UseModalStateReturn<TData> {
+	isOpen: boolean;
+	id: string | null;
+	data: TData | undefined;
+}
+export interface UseModalActionsReturn {
+	openModal: <T = unknown>(id: string, data?: T) => void;
+	closeModal: () => void;
+	clearModal: () => void;
+}
+export type UseModalReturn<TData> = UseModalStateReturn<TData> & UseModalActionsReturn;
+export declare function useModalState<TData = unknown>(): UseModalStateReturn<TData>;
+export declare function useModalActions(): UseModalActionsReturn;
+export declare function useModal<TData = unknown>(): UseModalReturn<TData>;
+export type VisibilityId = number | string;
+export interface UseVisibilityReturn<T> {
+	visibleIds: VisibilityId[];
+	visibleItems: T[];
+	hiddenItems: T[];
+	visibleCount: number;
+	isVisible: (itemOrId: VisibilityId | T) => boolean;
+	show: (itemOrId: VisibilityId | T) => void;
+	hide: (itemOrId: VisibilityId | T) => void;
+	toggleVisibility: (itemOrId: VisibilityId | T) => void;
+	showAll: (itemsArray?: VisibilityId[] | T[]) => void;
+	hideAll: (itemsArray?: VisibilityId[] | T[]) => void;
+	resetVisibility: () => void;
+	replaceVisibility: (newItems: VisibilityId[] | T[]) => void;
+}
+export declare function useVisibility<T = unknown>({ items, field, initialVisibleIds, }: {
+	items: T[];
+	field?: string;
+	initialVisibleIds?: VisibilityId[];
+}): UseVisibilityReturn<T>;
+export interface DebounceOptions {
+	maxWait?: number;
+	leading?: boolean;
+	trailing?: boolean;
+}
+export interface UseDebounceReturn<Args extends any[]> {
+	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 type UseDebouncedValueReturn<T> = T;
+export declare function useDebouncedValue<T>(value: T, delay: number, options?: DebounceOptions): UseDebouncedValueReturn<T>;
 export interface ThrottleOptions {
 	leading?: boolean;
 	trailing?: boolean;
@@ -257,5 +333,31 @@ export interface UseThrottleReturn<Args extends any[]> {
 	isPending: boolean;
 }
 export declare function useThrottle<Args extends any[]>(func: (...args: Args) => void, delay: number, options?: ThrottleOptions): UseThrottleReturn<Args>;
+declare const validKeyEventTypes: readonly [
+	"keydown",
+	"keyup",
+	"keypress"
+];
+export type KeyEventType = (typeof validKeyEventTypes)[number];
+export interface BaseKeyOptions {
+	enabled?: boolean;
+	target?: React$1.RefObject<HTMLElement | null> | Window;
+	preventDefault?: boolean;
+	stopPropagation?: boolean;
+	ignoreWhenFocusedInInputs?: boolean;
+	ctrlKey?: boolean;
+	shiftKey?: boolean;
+	altKey?: boolean;
+	metaKey?: boolean;
+}
+export type KeyOptions = BaseKeyOptions & ({
+	eventType?: "keydown" | "keypress";
+	preventRepeat?: boolean;
+} | {
+	eventType: "keyup";
+	preventRepeat?: never;
+});
+export type UseKeyReturn = void;
+export declare function useKey(key: string, handler: (e: KeyboardEvent) => void, { enabled, preventDefault, stopPropagation, eventType, preventRepeat, ignoreWhenFocusedInInputs, ctrlKey, shiftKey, altKey, metaKey, target, }?: KeyOptions): UseKeyReturn;
 
 export {};

package/dist/index.js

@@ -1,44 +1,66 @@
 import { createContext as e, useCallback as t, useContext as n, useEffect as r, useLayoutEffect as i, useMemo as a, useRef as o, useState as s } from "react";
-import { createPortal as c } from "react-dom";
-import { jsx as l } from "react/jsx-runtime";
-//#region src/context/ModalContext.tsx
-var u = e(null), d = e(null);
+import { Fragment as c, jsx as l } from "react/jsx-runtime";
+import { createPortal as u } from "react-dom";
+//#region src/ui/highlight/FuzzyHighlighter.tsx
+function d({ text: e, query: t, className: n = "", caseSensitive: r = !1 }) {
+	let i = t.trim();
+	if (!i || !e) return /* @__PURE__ */ l(c, { children: e });
+	let a = i.split(/\s+/).filter((e) => e.length > 0);
+	if (a.length === 0) return /* @__PURE__ */ l(c, { children: e });
+	let o = `fuzzy-highlight ${n}`.trim(), s = [...a].sort((e, t) => t.length - e.length).map((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")), u = [...s];
+	if (s.length > 1) {
+		let e = a.map((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("\\s+");
+		u.unshift(e);
+	}
+	if (i.length > 1 && i === i.toUpperCase() && /^[A-Z]+$/.test(i)) {
+		let e = i.split("").map((e) => `\\b${e}`).join("[^a-z0-9]*");
+		u.unshift(e);
+	}
+	let d = `(${u.join("|")})`, f = new RegExp(d, r ? "g" : "gi");
+	return /* @__PURE__ */ l(c, { children: e.split(f).map((e, t) => f.test(e) ? /* @__PURE__ */ l("strong", {
+		className: o,
+		children: e
+	}, t) : e) });
+}
 //#endregion
-//#region src/hooks/useModal.ts
-function f() {
-	let e = n(u);
+//#region src/ui/modal/ModalContext.tsx
+var f = e(null), p = e(null);
+//#endregion
+//#region src/ui/modal/useModal.ts
+function m() {
+	let e = n(f);
 	if (!e) throw Error("useModalState must be used within a ModalProvider");
 	return e;
 }
-function p() {
-	let e = n(d);
+function h() {
+	let e = n(p);
 	if (!e) throw Error("useModalActions must be used within a ModalProvider");
 	return e;
 }
-function m() {
+function g() {
 	return {
-		...f(),
-		...p()
+		...m(),
+		...h()
 	};
 }
 //#endregion
-//#region src/components/Modal.tsx
-function h({ modalId: e, children: t, wrapperClassName: n = "", wrapperStyle: i, containerClassName: a = "", containerStyle: u }) {
-	let { isOpen: d, id: m } = f(), { closeModal: h, clearModal: g } = p(), [_, v] = s(!1), y = o(null), b = m === e, x = d && b;
+//#region src/ui/modal/Modal.tsx
+function _({ modalId: e, children: t, wrapperClassName: n = "", wrapperStyle: i, containerClassName: a = "", containerStyle: c }) {
+	let { isOpen: d, id: f } = m(), { closeModal: p, clearModal: g } = h(), [_, v] = s(!1), y = o(null), b = f === e, x = d && b;
 	return r(() => {
 		let e = y.current;
 		e && (x && !e.open ? (v(!1), e.showModal()) : !x && e.open && v(!0));
-	}, [x]), typeof document > "u" || !b && !_ ? null : c(/* @__PURE__ */ l("dialog", {
+	}, [x]), typeof document > "u" || !b && !_ ? null : u(/* @__PURE__ */ l("dialog", {
 		ref: y,
 		onCancel: (e) => {
-			e.preventDefault(), h();
+			e.preventDefault(), p();
 		},
-		onClose: h,
+		onClose: p,
 		onClick: (e) => {
 			let t = y.current;
 			if (!t) return;
 			let n = t.getBoundingClientRect();
-			(e.clientX < n.x || e.clientX > n.x + n.width || e.clientY < n.y || e.clientY > n.y + n.height) && h();
+			(e.clientX < n.x || e.clientX > n.x + n.width || e.clientY < n.y || e.clientY > n.y + n.height) && p();
 		},
 		onAnimationEnd: () => {
 			if (_) {
@@ -50,54 +72,21 @@ function h({ modalId: e, children: t, wrapperClassName: n = "", wrapperStyle: i,
 		style: i,
 		children: /* @__PURE__ */ l("div", {
 			className: `modal-container ${a}`.trim(),
-			style: u,
+			style: c,
 			children: t
 		})
 	}), document.body);
 }
 //#endregion
-//#region src/hooks/useDebounce.ts
-function g(e, n, i = {}) {
-	let [a, c] = s(!1), l = i.maxWait, u = !!i.leading, d = !u && i.trailing === !1 ? !0 : i.trailing ?? !u, f = o(e), p = o(null), m = o(-1), h = o(-1), g = o(null);
-	r(() => {
-		f.current = e;
-	}, [e]);
-	let _ = t(() => {
-		p.current &&= (clearTimeout(p.current), null), m.current = -1, h.current = -1, g.current = null, c(!1);
-	}, []), v = t(() => {
-		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));
-	}, []);
-	return r(() => () => {
-		_();
-	}, [_]), {
-		debouncedFunc: t((...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);
-			}, n));
-		}, [
-			n,
-			l,
-			d,
-			u
-		]),
-		cancel: _,
-		flush: v,
-		isPending: a
-	};
-}
-//#endregion
-//#region src/hooks/useDebouncedValue.ts
-function _(e, t, n = {}) {
-	let [i, a] = s(e), { debouncedFunc: o } = g((e) => {
-		a(e);
-	}, t, n);
-	return r(() => {
-		o(e);
-	}, [e, o]), i;
+//#region src/shared/utils.ts
+function v(e, t, n) {
+	if (typeof e != "object" || !e) return e;
+	let r = t ?? n ?? "";
+	return Array.isArray(r) ? r.reduce((e, t) => e?.[t], e) : r.includes(".") ? r.split(".").reduce((e, t) => e?.[t], e) : e?.[r];
 }
 //#endregion
-//#region src/utils/filterUtils.ts
-var v = {
+//#region src/state/filter/utils.ts
+var y = {
 	text: {
 		contains: (e, t, n) => e == null ? !1 : n?.caseSensitive ? String(e).includes(String(t)) : String(e).toLowerCase().includes(String(t).toLowerCase()),
 		equals: (e, t, n) => e == null ? !1 : n?.caseSensitive ? String(e) === String(t) : String(e).toLowerCase() === String(t).toLowerCase(),
@@ -153,48 +142,41 @@ var v = {
 	}
 };
 //#endregion
-//#region src/utils/utils.ts
-function y(e, t, n) {
-	if (typeof e != "object" || !e) return e;
-	let r = t ?? n ?? "";
-	return Array.isArray(r) ? r.reduce((e, t) => e?.[t], e) : r.includes(".") ? r.split(".").reduce((e, t) => e?.[t], e) : e?.[r];
-}
-//#endregion
-//#region src/hooks/useFilter.ts
+//#region src/state/filter/useFilter.ts
 function b(e, n = []) {
-	let [r, i] = s(n), o = a(() => {
-		let t = r.filter((e) => e.isActive !== !1).map((e) => ({
+	let r = o(n), [i, c] = s(() => n), l = a(() => {
+		let t = i.filter((e) => e.isActive !== !1).map((e) => ({
 			...e,
 			pathArray: (e.field || e.id).split(".")
 		}));
 		return e.filter((e) => t.every((t) => {
-			let { id: n, type: r, operator: i, value: a, compare: o, pathArray: s } = t, c = y(e, s, n);
-			if (r === "custom") return o ? o(c, a, e) : !0;
-			let l = v[r];
+			let { id: n, type: r, operator: i, value: a, compare: o, pathArray: s } = t, c = v(e, s, n);
+			if (r === "custom") return !o || o(c, a, e);
+			let l = y[r];
 			if (!l) return !0;
 			let u = l[i];
-			return u ? u(c, a, t) : !0;
+			return !u || u(c, a, t);
 		}));
-	}, [e, r]), c = t((e) => {
-		i((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]);
-	}, []), l = t((e) => {
-		i((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
-	}, []), u = t(() => {
-		i([]);
-	}, []), d = t(() => {
-		i(n);
-	}, [n]), f = t((e) => {
-		i(e);
+	}, [e, i]), u = t((e) => {
+		c((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]);
+	}, []), d = t((e) => {
+		c((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
+	}, []), f = t(() => {
+		c([]);
+	}, []), p = t(() => {
+		c(r.current);
+	}, []), m = t((e) => {
+		c(e);
 	}, []);
 	return {
-		filteredItems: o,
-		filters: r,
-		upsertFilter: c,
-		removeFilter: l,
-		clearFilters: u,
-		resetFilters: d,
+		filteredItems: l,
+		filters: i,
+		upsertFilter: u,
+		removeFilter: d,
+		clearFilters: f,
+		resetFilters: p,
 		toggleFilter: t((e) => {
-			i((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? {
+			c((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? {
 				...t,
 				isActive: t.isActive === !1
 			} : t) : [...t, {
@@ -203,27 +185,27 @@ function b(e, n = []) {
 			}]);
 		}, []),
 		updateFilterConfig: t((e, t) => {
-			i((n) => n.map((n) => n.id === e ? {
+			c((n) => n.map((n) => n.id === e ? {
 				...n,
 				...t
 			} : n));
 		}, []),
-		replaceFilters: f,
-		getFilterValue: t((e) => r.find((t) => t.id === e)?.value, [r]),
+		replaceFilters: m,
+		getFilterValue: t((e) => i.find((t) => t.id === e)?.value, [i]),
 		updateFilterValue: t((e, t) => {
-			i((n) => n.map((n) => n.id === e ? {
+			c((n) => n.map((n) => n.id === e ? {
 				...n,
 				value: t
 			} : n));
 		}, []),
 		isFilterActive: t((e) => {
-			let t = r.find((t) => t.id === e);
+			let t = i.find((t) => t.id === e);
 			return t ? t.isActive !== !1 : !1;
-		}, [r])
+		}, [i])
 	};
 }
 //#endregion
-//#region src/utils/fuzzySearchUtils.ts
+//#region src/state/fuzzy-search/utils.ts
 function x(e, t, n = !1) {
 	let r = e.trim(), i = t.trim(), a = r.length > 1 && r === r.toUpperCase() && /^[A-Z]+$/.test(r);
 	if (n || (r = r.toLowerCase(), i = i.toLowerCase()), r === i) return 1;
@@ -272,12 +254,12 @@ function x(e, t, n = !1) {
 	return Math.max(0, _ * .45);
 }
 //#endregion
-//#region src/hooks/useFuzzySearch.ts
+//#region src/state/fuzzy-search/useFuzzySearch.ts
 function S(e, t, n, r = {}) {
 	let i = r.threshold ?? .01, o = r.caseSensitive ?? !1, s = r.matchStrategy ?? "any", c = r.exactPhraseBonus ?? !0, l = a(() => n.length === 0 || e.length === 0 ? [] : e.map((e, t) => {
 		let r = [], i = [];
 		for (let { field: t, weight: a } of n) {
-			let n = y(e, t);
+			let n = v(e, t);
 			if (Array.isArray(n)) {
 				for (let e of n) if (e != null && e !== "" && typeof e != "object") {
 					let t = String(e);
@@ -354,118 +336,36 @@ function S(e, t, n, r = {}) {
 	]);
 }
 //#endregion
-//#region src/constants/keyConstants.ts
-var C = [
-	"keydown",
-	"keyup",
-	"keypress"
-];
-//#endregion
-//#region src/hooks/useKey.ts
-function w(e, t, { enabled: n = !0, preventDefault: a = !0, stopPropagation: s = !0, eventType: c = "keydown", preventRepeat: l = !1, ignoreWhenFocusedInInputs: u = !0, ctrlKey: d = !1, shiftKey: f = !1, altKey: p = !1, metaKey: m = !1, target: h = window } = {}) {
-	let g = o(t), _ = o(n), v = o(!1);
-	i(() => {
-		g.current = t;
-	}, [t]), r(() => {
-		_.current = n;
-	}, [n]), r(() => {
-		let t = h && "current" in h ? h.current : h;
-		if (!t) return;
-		let n = e.toLowerCase(), r = C.includes(c) ? c : "keydown", i = l && r !== "keyup";
-		function o() {
-			v.current = !1;
-		}
-		function y(e) {
-			if (!(e instanceof KeyboardEvent)) return;
-			let t = e.key.toLowerCase();
-			(t === n || d && t === "control" || f && t === "shift" || p && t === "alt" || m && t === "meta") && (v.current = !1);
-		}
-		function b(e) {
-			if (!(e instanceof KeyboardEvent) || !_.current) return;
-			let t = e.target;
-			if (!(u && t instanceof HTMLElement && (t instanceof HTMLInputElement || t instanceof HTMLTextAreaElement || t instanceof HTMLSelectElement || t.isContentEditable)) && e.ctrlKey === d && e.shiftKey === f && e.altKey === p && e.metaKey === m && n === e.key.toLowerCase()) {
-				if (i && v.current) return;
-				v.current = !0, g.current(e), a && e.preventDefault(), s && e.stopPropagation();
-			}
-		}
-		return t.addEventListener(r, b), i && (t.addEventListener("keyup", y), window.addEventListener("blur", o)), () => {
-			t.removeEventListener(r, b), i && (t.removeEventListener("keyup", y), window.removeEventListener("blur", o));
-		};
-	}, [
-		e,
-		a,
-		s,
-		c,
-		l,
-		u,
-		d,
-		f,
-		p,
-		m,
-		h
-	]);
-}
-//#endregion
-//#region src/hooks/useOrder.ts
-function T(e) {
-	let n = o(e), [r, i] = s(e);
+//#region src/state/grouping/useGrouping.ts
+function C({ items: e, initialGroupBy: n }) {
+	let [r, i] = s(n), o = a(() => r ? e.reduce((e, t) => {
+		let n = v(t, r), i = n == null ? "Unknown" : String(n);
+		return e[i] || (e[i] = []), e[i].push(t), e;
+	}, {}) : { Ungrouped: e }, [e, r]), c = a(() => Object.keys(o).map((e) => ({
+		key: e,
+		items: o[e]
+	})), [o]), l = a(() => Object.keys(o), [o]), u = t((e) => {
+		i(e);
+	}, []), d = t(() => {
+		i(void 0);
+	}, []), f = t(() => {
+		i(n);
+	}, [n]), p = t((e) => o[e] || [], [o]);
 	return {
-		orderedItems: r,
-		moveUp: t((e) => {
-			typeof e == "number" && i((t) => {
-				if (e <= 0 || e >= t.length) return t;
-				let n = [...t];
-				return [n[e], n[e - 1]] = [n[e - 1], n[e]], n;
-			});
-		}, []),
-		moveDown: t((e) => {
-			typeof e == "number" && i((t) => {
-				if (e < 0 || e >= t.length - 1) return t;
-				let n = [...t];
-				return [n[e], n[e + 1]] = [n[e + 1], n[e]], n;
-			});
-		}, []),
-		canMoveUp: t((e) => e > 0, []),
-		canMoveDown: t((e) => e < r.length - 1, [r.length]),
-		moveToTop: t((e) => {
-			typeof e == "number" && i((t) => {
-				if (e <= 0 || e >= t.length) return t;
-				let n = [...t], [r] = n.splice(e, 1);
-				return n.unshift(r), n;
-			});
-		}, []),
-		moveToBottom: t((e) => {
-			typeof e == "number" && i((t) => {
-				if (e < 0 || e >= t.length - 1) return t;
-				let n = [...t], [r] = n.splice(e, 1);
-				return n.push(r), n;
-			});
-		}, []),
-		move: t((e, t) => {
-			typeof e != "number" || typeof t != "number" || e === t || i((n) => {
-				if (e < 0 || e >= n.length || t < 0 || t >= n.length) return n;
-				let r = [...n], [i] = r.splice(e, 1);
-				return r.splice(t, 0, i), r;
-			});
-		}, []),
-		swap: t((e, t) => {
-			typeof e != "number" || typeof t != "number" || e === t || i((n) => {
-				if (e < 0 || e >= n.length || t < 0 || t >= n.length) return n;
-				let r = [...n];
-				return [r[e], r[t]] = [r[t], r[e]], r;
-			});
-		}, []),
-		replaceOrder: t((e) => {
-			i(e);
-		}, []),
-		resetOrder: t(() => {
-			i(n.current);
-		}, [])
+		groupedRecord: o,
+		groupedArray: c,
+		groupKeys: l,
+		totalGroups: l.length,
+		activeGroupBy: r,
+		changeGroupBy: u,
+		clearGrouping: d,
+		resetGrouping: f,
+		getGroupItems: p
 	};
 }
 //#endregion
-//#region src/hooks/usePagination.ts
-function E(e, n, r = 0) {
+//#region src/state/pagination/usePagination.ts
+function w(e, n, r = 0) {
 	let [i, o] = s(n), [c, l] = s(r), u = Math.max(1, Math.ceil(e.length / Math.max(1, i))), d = Math.min(Math.max(0, c), u - 1);
 	return c !== d && l(d), {
 		pageItems: a(() => typeof i != "number" || i < 1 ? [] : e.slice(c * i, (c + 1) * i), [
@@ -520,27 +420,256 @@ function E(e, n, r = 0) {
 	};
 }
 //#endregion
-//#region src/utils/sortUtils.ts
-function D(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = P(e, t, r, i);
+//#region src/state/selection/useMultipleSelection.ts
+function T({ items: e, field: n, initialSelectedIds: r = [] }) {
+	let i = o(r), [c, l] = s(() => new Set(r)), u = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.add(i), r;
+		});
+	}, [n]), d = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.delete(i), r;
+		});
+	}, [n]), f = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.has(i) ? r.delete(i) : r.add(i), r;
+		});
+	}, [n]), p = t((e) => {
+		let t = v(e, n);
+		return c.has(t);
+	}, [c, n]), m = t(() => l(new Set(i.current)), []), h = t((e) => {
+		let t = e.map((e) => v(e, n));
+		l(new Set(t));
+	}, [n]), g = t(() => {
+		let t = e.map((e) => v(e, n));
+		l(new Set(t));
+	}, [e, n]), _ = t(() => {
+		l(/* @__PURE__ */ new Set());
+	}, []), y = t(() => l((t) => {
+		if (t.size === e.length) return /* @__PURE__ */ new Set();
+		let r = e.map((e) => v(e, n));
+		return new Set(r);
+	}), [e, n]), b = t(() => l((t) => {
+		if (t.size === e.length) return /* @__PURE__ */ new Set();
+		let r = e.filter((e) => !t.has(v(e, n))).map((e) => v(e, n));
+		return new Set(r);
+	}), [e, n]), x = t((e) => {
+		l((t) => {
+			let r = new Set(t);
+			return e.map((e) => v(e, n)).forEach((e) => r.add(e)), r;
+		});
+	}, [n]), S = t((e) => {
+		l((t) => {
+			let r = new Set(t);
+			return e.map((e) => v(e, n)).forEach((e) => r.delete(e)), r;
+		});
+	}, [n]), C = t((e) => {
+		l((t) => {
+			let r = /* @__PURE__ */ new Set();
+			return e.map((e) => v(e, n)).forEach((e) => t.has(e) && r.add(e)), r;
+		});
+	}, [n]), w = a(() => e.filter((e) => {
+		let t = v(e, n);
+		return c.has(t);
+	}), [
+		e,
+		n,
+		c
+	]);
+	return {
+		selectedIds: [...c],
+		selectedCount: c.size,
+		selectedItems: w,
+		isEmpty: c.size === 0,
+		select: u,
+		deselect: d,
+		toggle: f,
+		isSelected: p,
+		replaceSelection: h,
+		resetSelection: m,
+		selectAll: g,
+		deselectAll: _,
+		toggleAll: y,
+		invertSelection: b,
+		selectMultiple: x,
+		deselectMultiple: S,
+		retainOnly: C
+	};
+}
+//#endregion
+//#region src/state/selection/useSingleSelection.ts
+function E(e) {
+	let [n, r] = s(e), i = t((e) => r(e), []), a = t(() => r(void 0), []), o = t((e) => r((t) => t === e ? void 0 : e), []), c = t((e) => n === e, [n]), l = t(() => r(e), [e]);
+	return {
+		selectedId: n,
+		hasSelection: !!n,
+		select: i,
+		deselect: a,
+		toggle: o,
+		isSelected: c,
+		resetSelection: l
+	};
+}
+//#endregion
+//#region src/state/sort/useOrder.ts
+function D(e) {
+	let n = o(e), [r, i] = s(() => e), a = t((e) => {
+		typeof e == "number" && i((t) => {
+			if (e <= 0 || e >= t.length) return t;
+			let n = [...t];
+			return [n[e], n[e - 1]] = [n[e - 1], n[e]], n;
+		});
+	}, []), c = t((e) => {
+		typeof e == "number" && i((t) => {
+			if (e < 0 || e >= t.length - 1) return t;
+			let n = [...t];
+			return [n[e], n[e + 1]] = [n[e + 1], n[e]], n;
+		});
+	}, []), l = t((e) => e > 0, []), u = t((e) => e < r.length - 1, [r.length]), d = t((e) => {
+		typeof e == "number" && i((t) => {
+			if (e <= 0 || e >= t.length) return t;
+			let n = [...t], [r] = n.splice(e, 1);
+			return n.unshift(r), n;
+		});
+	}, []), f = t((e) => {
+		typeof e == "number" && i((t) => {
+			if (e < 0 || e >= t.length - 1) return t;
+			let n = [...t], [r] = n.splice(e, 1);
+			return n.push(r), n;
+		});
+	}, []), p = t((e, t) => {
+		typeof e != "number" || typeof t != "number" || e === t || i((n) => {
+			if (e < 0 || e >= n.length || t < 0 || t >= n.length) return n;
+			let r = [...n], [i] = r.splice(e, 1);
+			return r.splice(t, 0, i), r;
+		});
+	}, []), m = t((e, t) => {
+		typeof e != "number" || typeof t != "number" || e === t || i((n) => {
+			if (e < 0 || e >= n.length || t < 0 || t >= n.length) return n;
+			let r = [...n];
+			return [r[e], r[t]] = [r[t], r[e]], r;
+		});
+	}, []), h = t(() => {
+		i(n.current);
+	}, []);
+	return {
+		orderedItems: r,
+		moveUp: a,
+		moveDown: c,
+		canMoveUp: l,
+		canMoveDown: u,
+		moveToTop: d,
+		moveToBottom: f,
+		move: p,
+		swap: m,
+		replaceOrder: t((e) => {
+			i(e);
+		}, []),
+		resetOrder: h
+	};
+}
+//#endregion
+//#region src/state/sort/usePin.ts
+function O({ items: e, field: n, initialPinnedIds: r = [], maxPins: i = 2 ** 53 - 1 }) {
+	let c = o(r), [l, u] = s(() => new Set(r)), d = t((e) => {
+		u((t) => {
+			if (t.size >= i) return t;
+			let r = new Set(t), a = v(e, n);
+			return r.add(a), r;
+		});
+	}, [n, i]), f = t((e) => {
+		u((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.delete(i), r;
+		});
+	}, [n]), p = t((e) => {
+		u((t) => {
+			let r = new Set(t), a = v(e, n);
+			if (r.has(a)) r.delete(a);
+			else {
+				if (r.size >= i) return t;
+				r.add(a);
+			}
+			return r;
+		});
+	}, [n, i]), m = t((e) => {
+		let t = v(e, n);
+		return l.has(t);
+	}, [l, n]), h = t(() => u(/* @__PURE__ */ new Set()), []), g = t(() => u(new Set(c.current)), [c]), _ = t((e) => {
+		let t = e.map((e) => v(e, n));
+		u(new Set(t.slice(0, i)));
+	}, [n, i]), y = t((e) => {
+		u((t) => {
+			let r = new Set(t), a = e.map((e) => v(e, n));
+			for (let e of a) {
+				if (r.size >= i && !r.has(e)) break;
+				r.add(e);
+			}
+			return r;
+		});
+	}, [n, i]), b = t((e) => {
+		u((t) => {
+			let r = new Set(t);
+			return e.map((e) => v(e, n)).forEach((e) => r.delete(e)), r;
+		});
+	}, [n]), x = a(() => e.filter((e) => {
+		let t = v(e, n);
+		return l.has(t);
+	}), [
+		e,
+		n,
+		l
+	]), S = a(() => e.filter((e) => {
+		let t = v(e, n);
+		return !l.has(t);
+	}), [
+		e,
+		n,
+		l
+	]);
+	return {
+		pinnedIds: [...l],
+		pinnedItems: x,
+		unpinnedItems: S,
+		pinnedCount: l.size,
+		hasPins: l.size > 0,
+		isAtMaxLimit: l.size >= i,
+		pin: d,
+		unpin: f,
+		togglePin: p,
+		isPinned: m,
+		clearPins: h,
+		resetPins: g,
+		replacePins: _,
+		pinMultiple: y,
+		unpinMultiple: b
+	};
+}
+//#endregion
+//#region src/state/sort/utils.ts
+function k(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = I(e, t, r, i);
 	if (a !== null) return a;
 	let o = !!e;
 	return o === !!t ? 0 : o ? 1 : -1;
 }
-function O(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = P(e, t, r, i);
+function A(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = I(e, t, r, i);
 	if (a !== null) return a;
 	let o = Number(e), s = Number(t), c = Number.isNaN(o), l = Number.isNaN(s);
-	return c || l ? P(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
+	return c || l ? I(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
 }
-function k(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = P(e, t, i, r);
+function j(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = I(e, t, i, r);
 	if (o !== null) return o;
 	let s = String(e), c = String(t);
 	return s.localeCompare(c, void 0, { sensitivity: a ? "variant" : "base" });
 }
-function A(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = P(e, t, i, r);
+function M(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = I(e, t, i, r);
 	if (o !== null) return o;
 	let s = String(e), c = String(t);
 	return s.localeCompare(c, void 0, {
@@ -548,21 +677,21 @@ function A(e, t, n = {}) {
 		sensitivity: a ? "variant" : "base"
 	});
 }
-function j(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = P(e, t, i, r);
+function N(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = I(e, t, i, r);
 	if (a !== null) return a;
 	let o = new Date(e).getTime(), s = new Date(t).getTime(), c = Number.isNaN(o), l = Number.isNaN(s);
-	return (c || l) && (a = P(c ? void 0 : o, l ? void 0 : s, i, r), a !== null) ? a : o - s;
+	return (c || l) && (a = I(c ? void 0 : o, l ? void 0 : s, i, r), a !== null) ? a : o - s;
 }
-function M(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = P(e, t, i, r);
+function P(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = I(e, t, i, r);
 	return a === null ? e < t ? -1 : +(e > t) : a;
 }
-function N(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = P(e, t, i, r);
+function F(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = I(e, t, i, r);
 	return o === null ? typeof a == "function" ? a(e, t) : e < t ? -1 : +(e > t) : o;
 }
-function P(e, t, n = "last", r) {
+function I(e, t, n = "last", r) {
 	let i = e == null || e === "", a = t == null || t === "";
 	if (i && a) return 0;
 	if (!i && !a) return null;
@@ -579,71 +708,71 @@ function P(e, t, n = "last", r) {
 	return null;
 }
 //#endregion
-//#region src/hooks/useSort.ts
-function F(e, n = []) {
-	let [r, i] = s(n), o = a(() => {
-		let t = r.map((e) => ({
+//#region src/state/sort/useSort.ts
+function L(e, n = []) {
+	let r = o(n), [i, c] = s(() => n), l = a(() => {
+		let t = i.map((e) => ({
 			...e,
 			pathArray: (e.field || e.id).split(".")
 		}));
 		return [...e].sort((e, n) => {
 			for (let r of t) {
-				let { type: t, id: i, desc: a = !1, invertSorting: o = !1, pathArray: s } = r, c = y(e, s, i), l = y(n, s, i), u;
+				let { type: t, id: i, desc: a = !1, invertSorting: o = !1, pathArray: s } = r, c = v(e, s, i), l = v(n, s, i), u;
 				switch (t) {
 					case "numeric":
-						u = O(c, l, r);
+						u = A(c, l, r);
 						break;
 					case "alphabetical":
-						u = k(c, l, r);
+						u = j(c, l, r);
 						break;
 					case "alphanumeric":
-						u = A(c, l, r);
+						u = M(c, l, r);
 						break;
 					case "boolean":
-						u = D(c, l, r);
+						u = k(c, l, r);
 						break;
 					case "date":
-						u = j(c, l, r);
+						u = N(c, l, r);
 						break;
 					case "basic":
-						u = M(c, l, r);
+						u = P(c, l, r);
 						break;
 					case "custom":
-						u = N(c, l, r);
+						u = F(c, l, r);
 						break;
-					default: u = M(c, l, r);
+					default: u = P(c, l, r);
 				}
 				if (u !== 0) return u * (a === o ? 1 : -1);
 			}
 			return 0;
 		});
-	}, [r, e]), c = t((e) => i((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]), []), l = t((e) => {
-		i((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
-	}, []), u = t(() => i([]), []), d = t(() => i(n), [n]), f = t((e) => i(e), []), p = t((e, t, n) => {
-		let { multi: r = !1, ...a } = n || {};
-		i((n) => {
-			let i = n.find((t) => t.id === e);
-			if (!i) {
-				let i = {
+	}, [i, e]), u = t((e) => c((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]), []), d = t((e) => {
+		c((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
+	}, []), f = t(() => c([]), []), p = t(() => c(r.current), []), m = t((e) => c(e), []), h = t((e, t, n) => {
+		let { multi: r = !1, ...i } = n || {};
+		c((n) => {
+			let a = n.find((t) => t.id === e);
+			if (!a) {
+				let a = {
 					id: e,
 					type: t,
-					...a,
+					...i,
 					desc: !1
 				};
-				return r ? [...n, i] : [i];
+				return r ? [...n, a] : [a];
 			}
-			if (!i.desc) {
+			if (!a.desc) {
 				let t = {
-					...i,
 					...a,
+					...i,
 					desc: !0
 				};
 				return r ? n.map((n) => n.id === e ? t : n) : [t];
 			}
-			if (i.disableSortRemoval || a.disableSortRemoval) {
+			if (a.disableSortRemoval || i.disableSortRemoval) {
 				let t = {
-					...i,
 					...a,
+					...i,
 					desc: !1
 				};
 				return r ? n.map((n) => n.id === e ? t : n) : [t];
@@ -652,31 +781,141 @@ function F(e, n = []) {
 		});
 	}, []);
 	return {
-		sortedItems: o,
-		sorts: r,
-		upsertSorts: c,
-		removeSort: l,
-		clearSorts: u,
-		resetSorts: d,
-		replaceSorts: f,
+		sortedItems: l,
+		sorts: i,
+		upsertSorts: u,
+		removeSort: d,
+		clearSorts: f,
+		resetSorts: p,
+		replaceSorts: m,
 		getSortDirection: t((e) => {
-			let t = r.find((t) => t.id === e);
+			let t = i.find((t) => t.id === e);
 			return t ? t.desc ? "desc" : "asc" : void 0;
-		}, [r]),
-		toggleSort: p,
+		}, [i]),
+		toggleSort: h,
 		getNextSortingOrder: t((e) => {
-			let t = r.find((t) => t.id === e);
+			let t = i.find((t) => t.id === e);
 			return t ? t.desc ? t.disableSortRemoval ? "asc" : "none" : "desc" : "asc";
-		}, [r]),
+		}, [i]),
 		getSortIndex: t((e) => {
-			let t = r.findIndex((t) => t.id === e);
+			let t = i.findIndex((t) => t.id === e);
 			return t === -1 ? void 0 : t + 1;
-		}, [r])
+		}, [i])
+	};
+}
+//#endregion
+//#region src/ui/visibility/useVisibility.ts
+function R({ items: e, field: n, initialVisibleIds: r = [] }) {
+	let i = o(r), [c, l] = s(() => new Set(r)), u = t((e) => {
+		let t = v(e, n);
+		return c.has(t);
+	}, [c, n]), d = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.add(i), r;
+		});
+	}, [n]), f = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.delete(i), r;
+		});
+	}, [n]), p = t((e) => {
+		l((t) => {
+			let r = new Set(t), i = v(e, n);
+			return r.has(i) ? r.delete(i) : r.add(i), r;
+		});
+	}, [n]), m = t((t) => {
+		l((r) => {
+			let i = new Set(r);
+			return (t ?? e).forEach((e) => {
+				i.add(v(e, n));
+			}), i;
+		});
+	}, [e, n]), h = t((t) => {
+		l((r) => {
+			let i = new Set(r);
+			return (t ?? e).forEach((e) => {
+				i.delete(v(e, n));
+			}), i;
+		});
+	}, [e, n]), g = t(() => {
+		l(() => new Set(i.current));
+	}, []), _ = t((e) => {
+		let t = e.map((e) => v(e, n));
+		l(() => new Set(t));
+	}, [n]), y = a(() => e.filter((e) => {
+		let t = v(e, n);
+		return c.has(t);
+	}), [
+		e,
+		n,
+		c
+	]), b = a(() => e.filter((e) => {
+		let t = v(e, n);
+		return !c.has(t);
+	}), [
+		e,
+		n,
+		c
+	]);
+	return {
+		visibleIds: [...c],
+		visibleItems: y,
+		hiddenItems: b,
+		visibleCount: c.size,
+		isVisible: u,
+		show: d,
+		hide: f,
+		toggleVisibility: p,
+		showAll: m,
+		hideAll: h,
+		replaceVisibility: _,
+		resetVisibility: g
+	};
+}
+//#endregion
+//#region src/performance/debounce/useDebounce.ts
+function z(e, n, i = {}) {
+	let [a, c] = s(!1), l = i.maxWait, u = !!i.leading, d = !u && i.trailing === !1 ? !0 : i.trailing ?? !u, f = o(e), p = o(null), m = o(-1), h = o(-1), g = o(null);
+	r(() => {
+		f.current = e;
+	}, [e]);
+	let _ = t(() => {
+		p.current &&= (clearTimeout(p.current), null), m.current = -1, h.current = -1, g.current = null, c(!1);
+	}, []), v = t(() => {
+		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));
+	}, []);
+	return r(() => () => {
+		_();
+	}, [_]), {
+		debouncedFunc: t((...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);
+			}, n));
+		}, [
+			n,
+			l,
+			d,
+			u
+		]),
+		cancel: _,
+		flush: v,
+		isPending: a
 	};
 }
 //#endregion
-//#region src/hooks/useThrottle.ts
-function I(e, n, i = {}) {
+//#region src/performance/debounce/useDebouncedValue.ts
+function B(e, t, n = {}) {
+	let [i, a] = s(e), { debouncedFunc: o } = z((e) => {
+		a(e);
+	}, t, n);
+	return r(() => {
+		o(e);
+	}, [e, o]), i;
+}
+//#endregion
+//#region src/performance/throttle/useThrottle.ts
+function V(e, n, i = {}) {
 	let [a, c] = s(!1), l = i.leading ?? !0, u = i.trailing ?? !0, d = o(e), f = o(null), p = o(-1), m = o(null);
 	r(() => {
 		d.current = e;
@@ -710,4 +949,56 @@ function I(e, n, i = {}) {
 	};
 }
 //#endregion
-export { h as ModalLayout, g as useDebounce, _ as useDebouncedValue, b as useFilter, S as useFuzzySearch, w as useKey, m as useModal, p as useModalActions, f as useModalState, T as useOrder, E as usePagination, F as useSort, I as useThrottle };
+//#region src/events/key/constants.ts
+var H = [
+	"keydown",
+	"keyup",
+	"keypress"
+];
+//#endregion
+//#region src/events/key/useKey.ts
+function U(e, t, { enabled: n = !0, preventDefault: a = !0, stopPropagation: s = !0, eventType: c = "keydown", preventRepeat: l = !1, ignoreWhenFocusedInInputs: u = !0, ctrlKey: d = !1, shiftKey: f = !1, altKey: p = !1, metaKey: m = !1, target: h = window } = {}) {
+	let g = o(t), _ = o(n), v = o(!1);
+	i(() => {
+		g.current = t;
+	}, [t]), r(() => {
+		_.current = n;
+	}, [n]), r(() => {
+		let t = h && "current" in h ? h.current : h;
+		if (!t) return;
+		let n = e.toLowerCase(), r = H.includes(c) ? c : "keydown", i = l && r !== "keyup";
+		function o() {
+			v.current = !1;
+		}
+		function y(e) {
+			if (!(e instanceof KeyboardEvent)) return;
+			let t = e.key.toLowerCase();
+			(t === n || d && t === "control" || f && t === "shift" || p && t === "alt" || m && t === "meta") && (v.current = !1);
+		}
+		function b(e) {
+			if (!(e instanceof KeyboardEvent) || !_.current) return;
+			let t = e.target;
+			if (!(u && t instanceof HTMLElement && (t instanceof HTMLInputElement || t instanceof HTMLTextAreaElement || t instanceof HTMLSelectElement || t.isContentEditable)) && e.ctrlKey === d && e.shiftKey === f && e.altKey === p && e.metaKey === m && n === e.key.toLowerCase()) {
+				if (i && v.current) return;
+				v.current = !0, g.current(e), a && e.preventDefault(), s && e.stopPropagation();
+			}
+		}
+		return t.addEventListener(r, b), i && (t.addEventListener("keyup", y), window.addEventListener("blur", o)), () => {
+			t.removeEventListener(r, b), i && (t.removeEventListener("keyup", y), window.removeEventListener("blur", o));
+		};
+	}, [
+		e,
+		a,
+		s,
+		c,
+		l,
+		u,
+		d,
+		f,
+		p,
+		m,
+		h
+	]);
+}
+//#endregion
+export { d as FuzzyHighlighter, _ as ModalLayout, z as useDebounce, B as useDebouncedValue, b as useFilter, S as useFuzzySearch, C as useGrouping, U as useKey, g as useModal, h as useModalActions, m as useModalState, T as useMultipleSelection, D as useOrder, w as usePagination, O as usePin, E as useSingleSelection, L as useSort, V as useThrottle, R as useVisibility };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@himanshu-sorathiya/react-kit",
-	"version": "1.0.13",
+	"version": "1.0.16",
 	"description": "An opinionated collection of react hooks, and reusable UI components.",
 	"type": "module",
 	"module": "./dist/index.js",
@@ -42,7 +42,7 @@
 		"react-dom": "^19.2.6",
 		"typescript": "~6.0.2",
 		"typescript-eslint": "^8.59.2",
-		"vite": "^8.0.12"
+		"vite": "^8.1.4"
 	},
 	"sideEffects": [
 		"**/*.css"