@himanshu-sorathiya/react-kit 1.0.8 → 1.0.10

package/dist/index.d.ts

@@ -62,6 +62,18 @@ export interface UseFilterReturn<T> {
 	isFilterActive: (id: string) => boolean;
 }
 export declare function useFilter<T>(data: T[], initialFilters?: FilterState): UseFilterReturn<T>;
+export interface FuzzySearchOptions {
+	threshold?: number;
+	caseSensitive?: boolean;
+	matchStrategy?: "any" | "all";
+	exactPhraseBonus?: boolean;
+}
+export type UseFuzzySearchFields = [
+	string,
+	number
+][];
+export type UseFuzzySearchReturn<T> = T[];
+export declare function useFuzzySearch<T>(data: T[], query: string, fields: UseFuzzySearchFields, options?: FuzzySearchOptions): UseFuzzySearchReturn<T>;
 declare const validKeyEventTypes: readonly [
 	"keydown",
 	"keyup",
@@ -146,5 +158,16 @@ export interface UseSortReturn<T> {
 	getSortIndex: (id: string) => number | undefined;
 }
 export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
+export interface ThrottleOptions {
+	leading?: boolean;
+	trailing?: boolean;
+}
+export interface UseThrottleReturn<Args extends any[]> {
+	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 {};

package/dist/index.js

@@ -176,38 +176,169 @@ function g(e, n = []) {
 	};
 }
 //#endregion
+//#region src/utils/fuzzySearchUtils.ts
+function _(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;
+	if (r === "" || i === "") return 0;
+	if (a) {
+		let e = i.split(/[^a-z0-9]+/i).filter((e) => e.length > 0);
+		if (e.length >= r.length) {
+			let t = 0, n = 0;
+			for (let i = 0; i < r.length; i++) {
+				let a = r[i];
+				for (; n < e.length;) {
+					if ((e[n] ?? "")[0] === a) {
+						t++, n++;
+						break;
+					}
+					n++;
+				}
+			}
+			if (t === r.length) return .85;
+		}
+	}
+	let o = !1;
+	for (let e = 0; e < r.length; e++) if (i.includes(r[e] ?? "")) {
+		o = !0;
+		break;
+	}
+	if (!o) return 0;
+	let s = i.indexOf(r);
+	if (s !== -1) {
+		let e = s === 0, t = s / i.length * (e ? .01 : .1), n = (i.length - r.length) / i.length * (e ? .01 : .05);
+		return Math.max(.7, .95 - t - n);
+	}
+	let c = 0, l = -1, u = 0, d = 0, f = 0;
+	for (let e = 0; e < r.length; e++) {
+		let t = r[e];
+		if (!t) continue;
+		let n = i.indexOf(t, f);
+		if (n !== -1) c++, l !== -1 && (n > l ? u += n - l : (d++, u += 1)), l = n, f = n + 1, f >= i.length && (f = 0);
+		else {
+			let e = i.indexOf(t);
+			e !== -1 && (c++, d++, l = e, f = e + 1);
+		}
+	}
+	if (c < r.length / 2) return 0;
+	let p = c / r.length, m = .6 ** d, h = c > 1 ? u / (c - 1) : 1, g = Math.max(.4, 1 - h / i.length), _ = p * m * g;
+	return Math.max(0, _ * .45);
+}
+//#endregion
+//#region src/hooks/useFuzzySearch.ts
+function v(e, t, n, r = {}) {
+	let a = r.threshold ?? .01, o = r.caseSensitive ?? !1, s = r.matchStrategy ?? "any", c = r.exactPhraseBonus ?? !0, l = i(() => n.length === 0 || e.length === 0 ? [] : e.map((e, t) => {
+		let r = [], i = [];
+		for (let [t, a] of n) {
+			let n = h(e, t);
+			if (Array.isArray(n)) {
+				for (let e of n) if (e != null && e !== "" && typeof e != "object") {
+					let t = String(e);
+					i.push(t);
+					let n = t.split(/[^a-z0-9]+/i).filter((e) => e.length > 0);
+					for (let e of n) r.push({
+						text: e,
+						weight: a
+					});
+				}
+			} else if (n != null && n !== "" && typeof n != "object") {
+				let e = String(n);
+				i.push(e);
+				let t = e.split(/[^a-z0-9]+/i).filter((e) => e.length > 0);
+				for (let e of t) r.push({
+					text: e,
+					weight: a
+				});
+			}
+		}
+		return {
+			item: e,
+			index: t,
+			tokens: r,
+			combinedFlatText: i.join(" ")
+		};
+	}), [e, n]);
+	return i(() => {
+		let n = t.trim();
+		if (!n || l.length === 0) return e;
+		let r = n.split(/\s+/).filter((e) => e.length > 0);
+		if (r.length === 0) return e;
+		let i = [], u = .3;
+		for (let e of l) {
+			let t = 0, n = 0, l = !1;
+			for (let i of r) {
+				let r = 0, a = o ? i : i.toLowerCase();
+				for (let t of e.tokens) {
+					let e = (o ? t.text : t.text.toLowerCase()).split(/\s+/).filter((e) => e.length > 0);
+					for (let n of e) {
+						if (!n.includes(a)) {
+							if (n.length < i.length / 2) continue;
+							let e = Math.abs(i.length - n.length), t = Math.max(i.length, n.length);
+							if (t > 0 && (t - e) / t < u) continue;
+						}
+						let e = _(i, n, o) * t.weight;
+						e > r && (r = e);
+					}
+				}
+				r >= u && n++, t += r;
+			}
+			if (s === "all" && n < r.length && (l = !0), !l) {
+				let n = t / r.length;
+				if (c && r.length > 1) {
+					let t = r.map((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("\\s+");
+					new RegExp(t, o ? "g" : "gi").test(e.combinedFlatText) && (n += .15);
+				}
+				n >= a && i.push({
+					item: e.item,
+					score: n,
+					index: e.index
+				});
+			}
+		}
+		return i.toSorted((e, t) => t.score === e.score ? e.index - t.index : t.score - e.score).map((e) => e.item);
+	}, [
+		l,
+		e,
+		t,
+		a,
+		o,
+		s,
+		c
+	]);
+}
+//#endregion
 //#region src/constants/keyConstants.ts
-var _ = [
+var y = [
 	"keydown",
 	"keyup",
 	"keypress"
 ];
 //#endregion
 //#region src/hooks/useKey.ts
-function v(e, t, { enabled: n = !0, preventDefault: i = !0, stopPropagation: o = !0, eventType: s = "keydown", requireReset: c = !1, ignoreInputs: l = !0, ctrlKey: u = !1, shiftKey: d = !1, altKey: f = !1, metaKey: p = !1, target: m = window } = {}) {
-	let h = a(t), g = a(n), v = a(!1), y = m && "current" in m && m.current || window;
+function b(e, t, { enabled: n = !0, preventDefault: i = !0, stopPropagation: o = !0, eventType: s = "keydown", requireReset: c = !1, ignoreInputs: l = !0, ctrlKey: u = !1, shiftKey: d = !1, altKey: f = !1, metaKey: p = !1, target: m = window } = {}) {
+	let h = a(t), g = a(n), _ = a(!1), v = m && "current" in m && m.current || window;
 	r(() => {
 		h.current = t;
 	}, [t]), r(() => {
 		g.current = n;
 	}, [n]), r(() => {
-		if (!y) return;
-		let t = _.includes(s) ? s : "keydown";
+		if (!v) return;
+		let t = y.includes(s) ? s : "keydown";
 		function n(t) {
 			if (!(t instanceof KeyboardEvent)) return;
 			let n = t.key.toLowerCase();
-			(n === e.toLowerCase() || u && n === "control" || d && n === "shift" || f && n === "alt" || p && n === "meta") && (v.current = !1);
+			(n === e.toLowerCase() || u && n === "control" || d && n === "shift" || f && n === "alt" || p && n === "meta") && (_.current = !1);
 		}
 		function r(t) {
 			if (!(t instanceof KeyboardEvent) || !g.current) return;
 			let n = t.target;
 			if (!(l && n instanceof HTMLElement && (n instanceof HTMLInputElement || n instanceof HTMLTextAreaElement || n instanceof HTMLSelectElement || n.isContentEditable)) && t.ctrlKey === u && t.shiftKey === d && t.altKey === f && t.metaKey === p && e.toLowerCase() === t.key.toLowerCase()) {
-				if (c && v.current) return;
-				v.current = !0, h.current(t), i && t.preventDefault(), o && t.stopPropagation();
+				if (c && _.current) return;
+				_.current = !0, h.current(t), i && t.preventDefault(), o && t.stopPropagation();
 			}
 		}
-		return y.addEventListener(t, r), y.addEventListener("keyup", n), () => {
-			y.removeEventListener(t, r), y.removeEventListener("keyup", n);
+		return v.addEventListener(t, r), v.addEventListener("keyup", n), () => {
+			v.removeEventListener(t, r), v.removeEventListener("keyup", n);
 		};
 	}, [
 		e,
@@ -220,12 +351,12 @@ function v(e, t, { enabled: n = !0, preventDefault: i = !0, stopPropagation: o =
 		d,
 		f,
 		p,
-		y
+		v
 	]);
 }
 //#endregion
 //#region src/hooks/usePagination.ts
-function y(e, n, r = 0) {
+function x(e, n, r = 0) {
 	let [a, s] = o(n), [c, l] = o(r), u = Math.max(1, Math.ceil(e.length / Math.max(1, a))), d = Math.min(Math.max(0, c), u - 1);
 	return c !== d && l(d), {
 		currentItems: i(() => typeof a != "number" || a < 1 ? [] : e.slice(c * a, (c + 1) * a), [
@@ -272,26 +403,26 @@ function y(e, n, r = 0) {
 }
 //#endregion
 //#region src/utils/sortUtils.ts
-function b(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = D(e, t, r, i);
+function S(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = k(e, t, r, i);
 	if (a !== null) return a;
 	let o = !!e;
 	return o === !!t ? 0 : o ? 1 : -1;
 }
-function x(e, t, n = {}) {
-	let { sortUndefined: r, desc: i = !1 } = n, a = D(e, t, r, i);
+function C(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = k(e, t, r, i);
 	if (a !== null) return a;
 	let o = e === "" || e === null ? NaN : Number(e), s = t === "" || t === null ? NaN : Number(t), c = Number.isNaN(o), l = Number.isNaN(s);
-	return c || l ? D(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
+	return c || l ? k(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
 }
-function S(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = D(e, t, i, r);
+function w(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = k(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 C(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = D(e, t, i, r);
+function T(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = k(e, t, i, r);
 	if (o !== null) return o;
 	let s = String(e), c = String(t);
 	return s.localeCompare(c, void 0, {
@@ -299,21 +430,21 @@ function C(e, t, n = {}) {
 		sensitivity: a ? "variant" : "base"
 	});
 }
-function w(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = D(e, t, i, r);
+function E(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = k(e, t, i, r);
 	if (a !== null) return a;
 	let o = new Date(e).getTime(), s = new Date(t).getTime();
 	return (Number.isNaN(o) ? 0 : o) - (Number.isNaN(s) ? 0 : s);
 }
-function T(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i } = n, a = D(e, t, i, r);
+function D(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = k(e, t, i, r);
 	return a === null ? e < t ? -1 : +(e > t) : a;
 }
-function E(e, t, n = {}) {
-	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = D(e, t, i, r);
+function O(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = k(e, t, i, r);
 	return o === null ? typeof a == "function" ? a(e, t) : e < t ? -1 : +(e > t) : o;
 }
-function D(e, t, n = !1, r) {
+function k(e, t, n = !1, r) {
 	let i = e ?? void 0, a = t ?? void 0;
 	if (i !== void 0 && a !== void 0) return null;
 	if (i === void 0 && a === void 0 || n === !1) return 0;
@@ -331,7 +462,7 @@ function D(e, t, n = !1, r) {
 }
 //#endregion
 //#region src/hooks/useSort.ts
-function O(e, n = []) {
+function A(e, n = []) {
 	let [r, a] = o(n);
 	return {
 		sortedItems: i(() => e.toSorted((e, t) => {
@@ -339,27 +470,27 @@ function O(e, n = []) {
 				let { type: r, field: i, id: a, desc: o = !1, invertSorting: s = !1 } = n, c = h(e, i, a), l = h(t, i, a), u;
 				switch (r) {
 					case "numeric":
-						u = x(c, l, n);
+						u = C(c, l, n);
 						break;
 					case "alphabetical":
-						u = S(c, l, n);
+						u = w(c, l, n);
 						break;
 					case "alphanumeric":
-						u = C(c, l, n);
+						u = T(c, l, n);
 						break;
 					case "boolean":
-						u = b(c, l, n);
+						u = S(c, l, n);
 						break;
 					case "date":
-						u = w(c, l, n);
+						u = E(c, l, n);
 						break;
 					case "basic":
-						u = T(c, l, n);
+						u = D(c, l, n);
 						break;
 					case "custom":
-						u = E(c, l, n);
+						u = O(c, l, n);
 						break;
-					default: u = T(c, l, n);
+					default: u = D(c, l, n);
 				}
 				if (u !== 0) return u * (o === s ? 1 : -1);
 			}
@@ -420,4 +551,39 @@ function O(e, n = []) {
 	};
 }
 //#endregion
-export { d as ModalLayout, f as useDebounce, p as useDebouncedValue, g as useFilter, v as useKey, u as useModal, y as usePagination, O as useSort };
+//#region src/hooks/useThrottle.ts
+function j(e, n, i = {}) {
+	let [s, c] = o(!1), l = i.leading ?? !0, u = i.trailing ?? !0, d = a(e), f = a(null), p = a(-1), m = a(null);
+	r(() => {
+		d.current = e;
+	}, [e]);
+	let h = t(() => {
+		f.current &&= (clearTimeout(f.current), null), p.current = -1, m.current = null, c(!1);
+	}, []), g = t(() => {
+		m.current && (f.current &&= (clearTimeout(f.current), null), d.current(...m.current), p.current = l ? Date.now() : -1, m.current = null, c(!1));
+	}, [l]);
+	return r(() => () => {
+		h();
+	}, [h]), {
+		throttledFunc: t((...e) => {
+			c(!0);
+			let t = Date.now();
+			if (m.current = e, p.current === -1 ? l : t - p.current >= n) f.current &&= (clearTimeout(f.current), null), d.current(...e), p.current = t, m.current = null, c(!1);
+			else if (!f.current) {
+				let e = n - (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);
+			}
+		}, [
+			n,
+			l,
+			u
+		]),
+		cancel: h,
+		flush: g,
+		isPending: s
+	};
+}
+//#endregion
+export { d as ModalLayout, f as useDebounce, p as useDebouncedValue, g as useFilter, v as useFuzzySearch, b as useKey, u as useModal, x as usePagination, A as useSort, j as useThrottle };

package/package.json

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