@himanshu-sorathiya/react-kit 1.0.16 → 1.0.17

package/dist/index.d.ts

@@ -141,24 +141,6 @@ export declare function useGrouping<T = unknown>({ items, initialGroupBy, }: {
 	items: T[];
 	initialGroupBy?: string;
 }): UseGroupingReturn<T>;
-export interface UsePaginationReturn<T> {
-	pageItems: T[];
-	pageSize: number;
-	pageIndex: number;
-	totalPages: number;
-	canPrevious: boolean;
-	canNext: boolean;
-	nextPage: () => void;
-	previousPage: () => void;
-	goToFirstPage: () => void;
-	goToLastPage: () => void;
-	goToPage: (newPageIndex: number) => void;
-	changePageSize: (newPageSize: number) => void;
-	resetPageIndex: () => void;
-	resetPageSize: () => void;
-	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[];
@@ -184,17 +166,6 @@ export declare function useMultipleSelection<T = unknown>({ items, field, initia
 	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;
@@ -209,30 +180,35 @@ export interface UseOrderReturn<T> {
 	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 interface UsePaginationReturn<T> {
+	pageItems: T[];
+	pageSize: number;
+	pageIndex: number;
+	totalPages: number;
+	canPrevious: boolean;
+	canNext: boolean;
+	nextPage: () => void;
+	previousPage: () => void;
+	goToFirstPage: () => void;
+	goToLastPage: () => void;
+	goToPage: (newPageIndex: number) => void;
+	changePageSize: (newPageSize: number) => void;
+	resetPageIndex: () => void;
+	resetPageSize: () => void;
+	resetPagination: () => void;
 }
-export declare function usePin<T = unknown>({ items, field, initialPinnedIds, maxPins, }: {
-	items: T[];
-	field?: string;
-	initialPinnedIds?: PinId[];
-	maxPins?: number;
-}): UsePinReturn<T>;
+export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<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 type SortType = "numeric" | "alphabetical" | "alphanumeric" | "boolean" | "date" | "basic" | "custom";
 export interface BaseSortOptions {
 	desc?: boolean;
@@ -274,6 +250,25 @@ export interface UseSortReturn<T> {
 	getSortIndex: (id: string) => number | undefined;
 }
 export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
+export type ExpansionId = string | number;
+export interface UseExpansionReturn<T> {
+	expandedIds: ExpansionId[];
+	expandedItems: T[];
+	isExpanded: (itemOrId: ExpansionId | T) => boolean;
+	expand: (itemOrId: ExpansionId | T) => void;
+	collapse: (itemOrId: ExpansionId | T) => void;
+	toggle: (itemOrId: ExpansionId | T) => void;
+	expandAll: () => void;
+	collapseAll: () => void;
+	resetExpansion: () => void;
+	replaceExpansion: (newExpandedItems: ExpansionId[] | T[]) => void;
+}
+export declare function useExpansion<T = unknown>({ items, field, initialExpandedIds, multiple, }?: {
+	items?: T[];
+	field?: string;
+	initialExpandedIds?: ExpansionId[];
+	multiple?: boolean;
+}): UseExpansionReturn<T>;
 export interface UseModalStateReturn<TData> {
 	isOpen: boolean;
 	id: string | null;
@@ -288,6 +283,30 @@ export type UseModalReturn<TData> = UseModalStateReturn<TData> & UseModalActions
 export declare function useModalState<TData = unknown>(): UseModalStateReturn<TData>;
 export declare function useModalActions(): UseModalActionsReturn;
 export declare function useModal<TData = unknown>(): UseModalReturn<TData>;
+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 VisibilityId = number | string;
 export interface UseVisibilityReturn<T> {
 	visibleIds: VisibilityId[];

package/dist/index.js

@@ -1,7 +1,7 @@
 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 { Fragment as c, jsx as l } from "react/jsx-runtime";
 import { createPortal as u } from "react-dom";
-//#region src/ui/highlight/FuzzyHighlighter.tsx
+//#region src/ui/FuzzyHighlighter/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 });
@@ -23,10 +23,10 @@ function d({ text: e, query: t, className: n = "", caseSensitive: r = !1 }) {
 	}, t) : e) });
 }
 //#endregion
-//#region src/ui/modal/ModalContext.tsx
+//#region src/ui/useModal/ModalContext.tsx
 var f = e(null), p = e(null);
 //#endregion
-//#region src/ui/modal/useModal.ts
+//#region src/ui/useModal/useModal.ts
 function m() {
 	let e = n(f);
 	if (!e) throw Error("useModalState must be used within a ModalProvider");
@@ -44,13 +44,13 @@ function g() {
 	};
 }
 //#endregion
-//#region src/ui/modal/Modal.tsx
+//#region src/ui/useModal/ModalLayout.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;
+	let { isOpen: d, id: f } = m(), { closeModal: p, clearModal: g } = h(), [_, v] = s(!1), y = o(null), b = o(null), x = f === e, S = d && x;
 	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 : u(/* @__PURE__ */ l("dialog", {
+		e && (S && !e.open ? (document.activeElement && (b.current = document.activeElement), v(!1), e.showModal()) : !S && e.open && v(!0));
+	}, [S]), typeof document > "u" || !x && !_ ? null : u(/* @__PURE__ */ l("dialog", {
 		ref: y,
 		onCancel: (e) => {
 			e.preventDefault(), p();
@@ -65,7 +65,7 @@ function _({ modalId: e, children: t, wrapperClassName: n = "", wrapperStyle: i,
 		onAnimationEnd: () => {
 			if (_) {
 				let e = y.current;
-				e && e.close(), v(!1), b && g();
+				e && e.close(), v(!1), x && g(), b.current &&= (b.current.focus(), null);
 			}
 		},
 		className: `universal-modal ${n}`.trim(),
@@ -85,7 +85,7 @@ function v(e, 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/state/filter/utils.ts
+//#region src/state/useFilter/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()),
@@ -142,7 +142,7 @@ var y = {
 	}
 };
 //#endregion
-//#region src/state/filter/useFilter.ts
+//#region src/state/useFilter/useFilter.ts
 function b(e, n = []) {
 	let r = o(n), [i, c] = s(() => n), l = a(() => {
 		let t = i.filter((e) => e.isActive !== !1).map((e) => ({
@@ -205,7 +205,7 @@ function b(e, n = []) {
 	};
 }
 //#endregion
-//#region src/state/fuzzy-search/utils.ts
+//#region src/state/useFuzzySearch/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;
@@ -254,7 +254,7 @@ function x(e, t, n = !1) {
 	return Math.max(0, _ * .45);
 }
 //#endregion
-//#region src/state/fuzzy-search/useFuzzySearch.ts
+//#region src/state/useFuzzySearch/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 = [];
@@ -336,7 +336,7 @@ function S(e, t, n, r = {}) {
 	]);
 }
 //#endregion
-//#region src/state/grouping/useGrouping.ts
+//#region src/state/useGrouping/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);
@@ -364,64 +364,8 @@ function C({ items: e, initialGroupBy: n }) {
 	};
 }
 //#endregion
-//#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), [
-			c,
-			i,
-			e
-		]),
-		pageSize: i,
-		pageIndex: c,
-		totalPages: u,
-		canPrevious: c > 0,
-		canNext: c < u - 1,
-		nextPage: t(() => {
-			l((e) => e < u - 1 ? e + 1 : e);
-		}, [u]),
-		previousPage: t(() => {
-			l((e) => e > 0 ? e - 1 : e);
-		}, []),
-		goToFirstPage: t(() => {
-			l(0);
-		}, []),
-		goToLastPage: t(() => {
-			l(u - 1);
-		}, [u]),
-		goToPage: t((e) => {
-			typeof e == "number" && e >= 0 && e <= u - 1 && l(e);
-		}, [u]),
-		changePageSize: t((t) => {
-			if (typeof t == "number" && t > 0) {
-				o(t);
-				let n = Math.max(1, Math.ceil(e.length / Math.max(1, t)));
-				l((e) => Math.min(Math.max(0, e), n - 1));
-			}
-		}, [e.length]),
-		resetPageIndex: t(() => {
-			l(Math.min(Math.max(0, r), u - 1));
-		}, [r, u]),
-		resetPageSize: t(() => {
-			o(Math.max(1, n));
-			let t = Math.max(1, Math.ceil(e.length / Math.max(1, n)));
-			l((e) => Math.min(Math.max(0, e), t - 1));
-		}, [n, e.length]),
-		resetPagination: t(() => {
-			o(Math.max(1, n));
-			let t = Math.max(1, Math.ceil(e.length / Math.max(1, n)));
-			l(Math.min(Math.max(0, r), t - 1));
-		}, [
-			n,
-			r,
-			e.length
-		])
-	};
-}
-//#endregion
-//#region src/state/selection/useMultipleSelection.ts
-function T({ items: e, field: n, initialSelectedIds: r = [] }) {
+//#region src/state/useMultipleSelection/useMultipleSelection.ts
+function w({ 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);
@@ -500,22 +444,8 @@ function T({ items: e, field: n, initialSelectedIds: r = [] }) {
 	};
 }
 //#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) {
+//#region src/state/useOrder/useOrder.ts
+function T(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;
@@ -572,104 +502,97 @@ function D(e) {
 	};
 }
 //#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);
+//#region src/state/usePagination/usePagination.ts
+function E(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), [
+			c,
+			i,
+			e
+		]),
+		pageSize: i,
+		pageIndex: c,
+		totalPages: u,
+		canPrevious: c > 0,
+		canNext: c < u - 1,
+		nextPage: t(() => {
+			l((e) => e < u - 1 ? e + 1 : e);
+		}, [u]),
+		previousPage: t(() => {
+			l((e) => e > 0 ? e - 1 : e);
+		}, []),
+		goToFirstPage: t(() => {
+			l(0);
+		}, []),
+		goToLastPage: t(() => {
+			l(u - 1);
+		}, [u]),
+		goToPage: t((e) => {
+			typeof e == "number" && e >= 0 && e <= u - 1 && l(e);
+		}, [u]),
+		changePageSize: t((t) => {
+			if (typeof t == "number" && t > 0) {
+				o(t);
+				let n = Math.max(1, Math.ceil(e.length / Math.max(1, t)));
+				l((e) => Math.min(Math.max(0, e), n - 1));
 			}
-			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
-	]);
+		}, [e.length]),
+		resetPageIndex: t(() => {
+			l(Math.min(Math.max(0, r), u - 1));
+		}, [r, u]),
+		resetPageSize: t(() => {
+			o(Math.max(1, n));
+			let t = Math.max(1, Math.ceil(e.length / Math.max(1, n)));
+			l((e) => Math.min(Math.max(0, e), t - 1));
+		}, [n, e.length]),
+		resetPagination: t(() => {
+			o(Math.max(1, n));
+			let t = Math.max(1, Math.ceil(e.length / Math.max(1, n)));
+			l(Math.min(Math.max(0, r), t - 1));
+		}, [
+			n,
+			r,
+			e.length
+		])
+	};
+}
+//#endregion
+//#region src/state/useSingleSelection/useSingleSelection.ts
+function D(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 {
-		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
+		selectedId: n,
+		hasSelection: !!n,
+		select: i,
+		deselect: a,
+		toggle: o,
+		isSelected: c,
+		resetSelection: l
 	};
 }
 //#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);
+//#region src/state/useSort/utils.ts
+function O(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = F(e, t, r, i);
 	if (a !== null) return a;
 	let o = !!e;
 	return o === !!t ? 0 : o ? 1 : -1;
 }
-function A(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = I(e, t, r, i);
+function k(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = F(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 ? I(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
+	return c || l ? F(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
 }
-function j(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = I(e, t, i, r);
+function A(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = F(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 M(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = I(e, t, i, r);
+function j(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = F(e, t, i, r);
 	if (o !== null) return o;
 	let s = String(e), c = String(t);
 	return s.localeCompare(c, void 0, {
@@ -677,21 +600,21 @@ function M(e, t, n = {}) {
 		sensitivity: a ? "variant" : "base"
 	});
 }
-function N(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = I(e, t, i, r);
+function M(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = F(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 = I(c ? void 0 : o, l ? void 0 : s, i, r), a !== null) ? a : o - s;
+	return (c || l) && (a = F(c ? void 0 : o, l ? void 0 : s, i, r), a !== null) ? a : o - s;
 }
-function P(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = I(e, t, i, r);
+function N(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = F(e, t, i, r);
 	return a === null ? e < t ? -1 : +(e > t) : a;
 }
-function F(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = I(e, t, i, r);
+function P(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = F(e, t, i, r);
 	return o === null ? typeof a == "function" ? a(e, t) : e < t ? -1 : +(e > t) : o;
 }
-function I(e, t, n = "last", r) {
+function F(e, t, n = "last", r) {
 	let i = e == null || e === "", a = t == null || t === "";
 	if (i && a) return 0;
 	if (!i && !a) return null;
@@ -708,8 +631,8 @@ function I(e, t, n = "last", r) {
 	return null;
 }
 //#endregion
-//#region src/state/sort/useSort.ts
-function L(e, n = []) {
+//#region src/state/useSort/useSort.ts
+function I(e, n = []) {
 	let r = o(n), [i, c] = s(() => n), l = a(() => {
 		let t = i.map((e) => ({
 			...e,
@@ -720,27 +643,27 @@ function L(e, n = []) {
 				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 = A(c, l, r);
+						u = k(c, l, r);
 						break;
 					case "alphabetical":
-						u = j(c, l, r);
+						u = A(c, l, r);
 						break;
 					case "alphanumeric":
-						u = M(c, l, r);
+						u = j(c, l, r);
 						break;
 					case "boolean":
-						u = k(c, l, r);
+						u = O(c, l, r);
 						break;
 					case "date":
-						u = N(c, l, r);
+						u = M(c, l, r);
 						break;
 					case "basic":
-						u = P(c, l, r);
+						u = N(c, l, r);
 						break;
 					case "custom":
-						u = F(c, l, r);
+						u = P(c, l, r);
 						break;
-					default: u = P(c, l, r);
+					default: u = N(c, l, r);
 				}
 				if (u !== 0) return u * (a === o ? 1 : -1);
 			}
@@ -804,8 +727,143 @@ function L(e, n = []) {
 	};
 }
 //#endregion
-//#region src/ui/visibility/useVisibility.ts
-function R({ items: e, field: n, initialVisibleIds: r = [] }) {
+//#region src/ui/useExpansion/useExpansion.ts
+function L({ items: e = [], field: n, initialExpandedIds: r = [], multiple: i = !1 } = {}) {
+	let c = o(r), [l, u] = s(() => new Set(r)), d = t((e) => {
+		let t = v(e, n);
+		return l.has(t);
+	}, [l, n]), f = t((e) => {
+		u((t) => {
+			let r = v(e, n);
+			if (t.has(r)) return t;
+			let a = i ? new Set(t) : /* @__PURE__ */ new Set();
+			return a.add(r), a;
+		});
+	}, [n, i]), p = t((e) => {
+		u((t) => {
+			let r = v(e, n);
+			if (!t.has(r)) return t;
+			let i = new Set(t);
+			return i.delete(r), i;
+		});
+	}, [n]), m = t((e) => {
+		u((t) => {
+			let r = v(e, n), a = i ? new Set(t) : /* @__PURE__ */ new Set();
+			return t.has(r) ? i && a.delete(r) : a.add(r), a;
+		});
+	}, [n, i]), h = t(() => {
+		if (!i) return;
+		let t = e.map((e) => v(e, n));
+		u(new Set(t));
+	}, [
+		e,
+		n,
+		i
+	]), g = t(() => {
+		u(/* @__PURE__ */ new Set());
+	}, []), _ = t(() => {
+		u(new Set(c.current));
+	}, []), y = t((e) => {
+		let t = e.map((e) => v(e, n));
+		u(new Set(t));
+	}, [n]), b = a(() => e.filter((e) => l.has(v(e, n))), [
+		e,
+		n,
+		l
+	]);
+	return {
+		expandedIds: [...l],
+		expandedItems: b,
+		isExpanded: d,
+		expand: f,
+		collapse: p,
+		toggle: m,
+		expandAll: h,
+		collapseAll: g,
+		resetExpansion: _,
+		replaceExpansion: y
+	};
+}
+//#endregion
+//#region src/ui/usePin/usePin.ts
+function R({ 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/ui/useVisibility/useVisibility.ts
+function z({ 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);
@@ -874,8 +932,8 @@ function R({ items: e, field: n, initialVisibleIds: r = [] }) {
 	};
 }
 //#endregion
-//#region src/performance/debounce/useDebounce.ts
-function z(e, n, i = {}) {
+//#region src/performance/useDebounce/useDebounce.ts
+function B(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;
@@ -904,9 +962,9 @@ function z(e, n, i = {}) {
 	};
 }
 //#endregion
-//#region src/performance/debounce/useDebouncedValue.ts
-function B(e, t, n = {}) {
-	let [i, a] = s(e), { debouncedFunc: o } = z((e) => {
+//#region src/performance/useDebounce/useDebouncedValue.ts
+function V(e, t, n = {}) {
+	let [i, a] = s(e), { debouncedFunc: o } = B((e) => {
 		a(e);
 	}, t, n);
 	return r(() => {
@@ -914,8 +972,8 @@ function B(e, t, n = {}) {
 	}, [e, o]), i;
 }
 //#endregion
-//#region src/performance/throttle/useThrottle.ts
-function V(e, n, i = {}) {
+//#region src/performance/useThrottle/useThrottle.ts
+function H(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;
@@ -949,15 +1007,15 @@ function V(e, n, i = {}) {
 	};
 }
 //#endregion
-//#region src/events/key/constants.ts
-var H = [
+//#region src/events/useKey/constants.ts
+var U = [
 	"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 } = {}) {
+//#region src/events/useKey/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;
@@ -966,7 +1024,7 @@ function U(e, t, { enabled: n = !0, preventDefault: a = !0, stopPropagation: s =
 	}, [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";
+		let n = e.toLowerCase(), r = U.includes(c) ? c : "keydown", i = l && r !== "keyup";
 		function o() {
 			v.current = !1;
 		}
@@ -1001,4 +1059,4 @@ function U(e, t, { enabled: n = !0, preventDefault: a = !0, stopPropagation: s =
 	]);
 }
 //#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 };
+export { d as FuzzyHighlighter, _ as ModalLayout, B as useDebounce, V as useDebouncedValue, L as useExpansion, b as useFilter, S as useFuzzySearch, C as useGrouping, W as useKey, g as useModal, h as useModalActions, m as useModalState, w as useMultipleSelection, T as useOrder, E as usePagination, R as usePin, D as useSingleSelection, I as useSort, H as useThrottle, z as useVisibility };

package/package.json

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