@himanshu-sorathiya/react-kit 1.0.12 → 1.0.14

package/dist/index.d.ts

@@ -112,12 +112,27 @@ export interface FuzzySearchOptions {
 	matchStrategy?: "any" | "all";
 	exactPhraseBonus?: boolean;
 }
-export type UseFuzzySearchFields = [
-	string,
-	number
-][];
+export interface IndexedToken {
+	text: string;
+	weight: number;
+}
+export interface FlatIndexedItem<T> {
+	item: T;
+	index: number;
+	tokens: IndexedToken[];
+	combinedFlatText: string;
+}
+export interface ScoredItem<T> {
+	item: T;
+	score: number;
+	index: number;
+}
+export type UseFuzzySearchFields<T> = {
+	field: Extract<keyof T, string>;
+	weight: number;
+}[];
 export type UseFuzzySearchReturn<T> = T[];
-export declare function useFuzzySearch<T>(data: T[], query: string, fields: UseFuzzySearchFields, options?: FuzzySearchOptions): UseFuzzySearchReturn<T>;
+export declare function useFuzzySearch<T>(data: T[], query: string, fields: UseFuzzySearchFields<T>, options?: FuzzySearchOptions): UseFuzzySearchReturn<T>;
 declare const validKeyEventTypes: readonly [
 	"keydown",
 	"keyup",
@@ -158,6 +173,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 interface UseMultipleSelectionReturn<T> {
+	selectedIds: (string | number)[];
+	selectedCount: number;
+	selectedItems: T[];
+	isEmpty: boolean;
+	select: (item: string | number | T) => void;
+	deselect: (item: string | number | T) => void;
+	toggle: (item: string | number | T) => void;
+	isSelected: (item: string | number | T) => boolean;
+	replaceSelection: (newSelectedItems: (string | number)[] | T[]) => void;
+	resetSelection: () => void;
+	selectAll: () => void;
+	deselectAll: () => void;
+	toggleAll: () => void;
+	invertSelection: () => void;
+	selectMultiple: (newItems: (string | number)[] | T[]) => void;
+	deselectMultiple: (itemsToRemove: (string | number)[] | T[]) => void;
+	retainOnly: (itemsToRetain: (string | number)[] | T[]) => void;
+}
+export declare function useMultipleSelection<T = unknown>({ items, field, initialSelectedIds, }: {
+	items: T[];
+	field?: string;
+	initialSelectedIds?: (number | string)[];
+}): UseMultipleSelectionReturn<T>;
 export interface UseOrderReturn<T> {
 	orderedItems: T[];
 	moveUp: (index: number) => void;
@@ -190,6 +229,16 @@ export interface UsePaginationReturn<T> {
 	resetPagination: () => void;
 }
 export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
+export interface UseSingleSelectionReturn {
+	selectedId: string | number | undefined;
+	hasSelection: boolean;
+	select: (id: string | number) => void;
+	deselect: () => void;
+	toggle: (id: string | number) => void;
+	isSelected: (id: string | number) => boolean;
+	resetSelection: () => void;
+}
+export declare function useSingleSelection(initialSelectedId?: number | string): UseSingleSelectionReturn;
 export type SortType = "numeric" | "alphabetical" | "alphanumeric" | "boolean" | "date" | "basic" | "custom";
 export interface BaseSortOptions {
 	desc?: boolean;

package/dist/index.js

@@ -276,7 +276,7 @@ function x(e, t, n = !1) {
 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 [t, a] of n) {
+		for (let { field: t, weight: a } of n) {
 			let n = y(e, t);
 			if (Array.isArray(n)) {
 				for (let e of n) if (e != null && e !== "" && typeof e != "object") {
@@ -406,8 +406,88 @@ function w(e, t, { enabled: n = !0, preventDefault: a = !0, stopPropagation: s =
 	]);
 }
 //#endregion
+//#region src/hooks/useMultipleSelection.ts
+function T({ items: e, field: n, initialSelectedIds: r = [] }) {
+	let [i, o] = s(new Set(r)), c = t((e) => {
+		o((t) => {
+			let r = new Set(t), i = y(e, n);
+			return r.add(i), r;
+		});
+	}, [n]), l = t((e) => {
+		o((t) => {
+			let r = new Set(t), i = y(e, n);
+			return r.delete(i), r;
+		});
+	}, [n]), u = t((e) => {
+		o((t) => {
+			let r = new Set(t), i = y(e, n);
+			return r.has(i) ? r.delete(i) : r.add(i), r;
+		});
+	}, [n]), d = t((e) => {
+		let t = y(e, n);
+		return i.has(t);
+	}, [i, n]), f = t((e) => {
+		let t = e.map((e) => y(e, n));
+		o(new Set(t));
+	}, [n]), p = t(() => o(new Set(r)), [r]), m = t(() => {
+		let t = e.map((e) => y(e, n));
+		o(new Set(t));
+	}, [e, n]), h = t(() => {
+		o(/* @__PURE__ */ new Set());
+	}, []), g = t(() => o((t) => {
+		if (t.size === e.length) return /* @__PURE__ */ new Set();
+		let r = e.map((e) => y(e, n));
+		return new Set(r);
+	}), [e, n]), _ = t(() => o((t) => {
+		if (t.size === e.length) return /* @__PURE__ */ new Set();
+		let r = e.filter((e) => !t.has(y(e, n))).map((e) => y(e, n));
+		return new Set(r);
+	}), [e, n]), v = t((e) => {
+		o((t) => {
+			let r = new Set(t);
+			return e.map((e) => y(e, n)).forEach((e) => r.add(e)), r;
+		});
+	}, [n]), b = t((e) => {
+		o((t) => {
+			let r = new Set(t);
+			return e.map((e) => y(e, n)).forEach((e) => r.delete(e)), r;
+		});
+	}, [n]), x = t((e) => {
+		o((t) => {
+			let r = /* @__PURE__ */ new Set();
+			return e.map((e) => y(e, n)).forEach((e) => t.has(e) && r.add(e)), r;
+		});
+	}, [n]), S = a(() => e.filter((e) => {
+		let t = y(e, n);
+		return i.has(t);
+	}), [
+		e,
+		n,
+		i
+	]);
+	return {
+		selectedIds: [...i],
+		selectedCount: i.size,
+		selectedItems: S,
+		isEmpty: i.size === 0,
+		select: c,
+		deselect: l,
+		toggle: u,
+		isSelected: d,
+		replaceSelection: f,
+		resetSelection: p,
+		selectAll: m,
+		deselectAll: h,
+		toggleAll: g,
+		invertSelection: _,
+		selectMultiple: v,
+		deselectMultiple: b,
+		retainOnly: x
+	};
+}
+//#endregion
 //#region src/hooks/useOrder.ts
-function T(e) {
+function E(e) {
 	let n = o(e), [r, i] = s(e);
 	return {
 		orderedItems: r,
@@ -465,7 +545,7 @@ function T(e) {
 }
 //#endregion
 //#region src/hooks/usePagination.ts
-function E(e, n, r = 0) {
+function D(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 +600,41 @@ function E(e, n, r = 0) {
 	};
 }
 //#endregion
+//#region src/hooks/useSingleSelection.ts
+function O(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/utils/sortUtils.ts
-function D(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = P(e, t, r, i);
+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 +642,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;
@@ -580,7 +674,7 @@ function P(e, t, n = "last", r) {
 }
 //#endregion
 //#region src/hooks/useSort.ts
-function F(e, n = []) {
+function L(e, n = []) {
 	let [r, i] = s(n), o = a(() => {
 		let t = r.map((e) => ({
 			...e,
@@ -591,27 +685,27 @@ function F(e, n = []) {
 				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;
 				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);
 			}
@@ -676,7 +770,7 @@ function F(e, n = []) {
 }
 //#endregion
 //#region src/hooks/useThrottle.ts
-function I(e, n, i = {}) {
+function R(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 +804,4 @@ 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 };
+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 useMultipleSelection, E as useOrder, D as usePagination, O as useSingleSelection, L as useSort, R as useThrottle };

package/package.json

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