@himanshu-sorathiya/react-kit 1.0.4 → 1.0.6

package/dist/index.d.ts

@@ -1,10 +1,46 @@
 // Generated by dts-bundle-generator v9.5.1
 
-export interface ModalProps {
+export interface ModalLayoutProps {
 	children: React.ReactNode;
 	className?: string;
 }
-export declare function Modal({ children, className }: ModalProps): import("react").ReactPortal;
+export declare function ModalLayout({ children, className }: ModalLayoutProps): import("react").ReactPortal;
+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";
+export type BooleanOperator = "equals";
+export type DateOperator = "equals" | "before" | "after" | "between";
+export type SelectOperator = "equals" | "notEquals";
+export type MultiselectOperator = "in" | "notIn" | "intersects";
+export type CustomOperator = "custom";
+export type FilterOperator = TextOperator | NumberOperator | BooleanOperator | DateOperator | SelectOperator | MultiselectOperator | CustomOperator;
+export interface FilterOptions {
+	caseSensitive?: boolean;
+	compare?: (itemValue: any, filterValue: any, item: any) => boolean;
+}
+export interface FilterConfig extends FilterOptions {
+	id: string;
+	field: string;
+	type: FilterType;
+	operator: FilterOperator;
+	value: any;
+}
+export type FilterState = FilterConfig[];
+export interface UseFilterReturn<T> {
+	filteredItems: T[];
+	filters: FilterState;
+	addFilter: (filter: FilterConfig) => void;
+	removeFilter: (id: string | string[]) => void;
+	clearFilters: () => void;
+	resetFilters: () => void;
+	setFilters: (filters: FilterConfig[]) => void;
+	toggleFilter: (filter: FilterConfig) => void;
+	updateFilterConfig: (id: string, partialConfig: Partial<Omit<FilterConfig, "id">>) => void;
+	getFilterValue: (id: string) => any;
+	updateFilterValue: (id: string, value: any) => void;
+	isFilterActive: (id: string) => boolean;
+}
+export declare function useFilter<T>(data: T[], initialFilters?: FilterState): UseFilterReturn<T>;
 export interface UseModalReturn<TData> {
 	id: string | null;
 	data: TData | undefined;
@@ -29,5 +65,36 @@ export interface UsePaginationReturn<T> {
 	resetPageSize: () => void;
 }
 export declare function usePagination<T>(data: T[], initialPageSize: number, initialPageIndex?: number): UsePaginationReturn<T>;
+export type SortType = "numeric" | "alphabetical" | "alphanumeric" | "boolean" | "date" | "basic" | "custom";
+export interface SortOptions {
+	desc?: boolean;
+	caseSensitive?: boolean;
+	disableSortRemoval?: boolean;
+	invertSorting?: boolean;
+	sortUndefined?: "first" | "last" | false | -1 | 1;
+	compare?: (a: any, b: any) => number;
+}
+export interface SortConfig extends SortOptions {
+	id: string;
+	type: SortType;
+	field?: string;
+}
+export type SortState = Array<SortConfig>;
+export interface UseSortReturn<T> {
+	sortedItems: T[];
+	sorts: SortState;
+	addSort: (sort: SortConfig) => void;
+	removeSort: (id: string | string[]) => void;
+	clearSorts: () => void;
+	resetSorts: () => void;
+	setSorts: (sorts: SortState) => void;
+	getSortDirection: (id: string) => "asc" | "desc" | undefined;
+	toggleSort: (id: string, type: SortType, options?: SortOptions & {
+		multi?: boolean;
+	}) => void;
+	getNextSortingOrder: (id: string) => "asc" | "desc" | "none";
+	getSortIndex: (id: string) => number | undefined;
+}
+export declare function useSort<T>(data: T[], initialSorts?: SortState): UseSortReturn<T>;
 
 export {};

package/dist/index.js

@@ -30,7 +30,7 @@ function u() {
 }
 //#endregion
 //#region src/components/Modal.tsx
-function d({ children: e, className: n = "" }) {
+function d({ children: e, className: n }) {
 	let { id: i, closeModal: o } = u(), s = r(null);
 	return t(() => {
 		let e = s.current;
@@ -40,7 +40,7 @@ function d({ children: e, className: n = "" }) {
 		onCancel: (e) => {
 			e.preventDefault(), o();
 		},
-		className: `universal-modal ${n ?? ""}`,
+		className: `universal-modal ${n}`,
 		children: /* @__PURE__ */ c("div", {
 			className: "modal-container",
 			children: e
@@ -48,8 +48,114 @@ function d({ children: e, className: n = "" }) {
 	}), document.body);
 }
 //#endregion
+//#region src/utils/filterUtils.ts
+var f = {
+	text: {
+		contains: (e, t, n) => n?.caseSensitive ? String(e).includes(String(t)) : String(e).toLowerCase().includes(String(t).toLowerCase()),
+		equals: (e, t, n) => n?.caseSensitive ? String(e) === String(t) : String(e).toLowerCase() === String(t).toLowerCase(),
+		startsWith: (e, t, n) => n?.caseSensitive ? String(e).startsWith(String(t)) : String(e).toLowerCase().startsWith(String(t).toLowerCase()),
+		endsWith: (e, t, n) => n?.caseSensitive ? String(e).endsWith(String(t)) : String(e).toLowerCase().endsWith(String(t).toLowerCase()),
+		notContains: (e, t, n) => n?.caseSensitive ? !String(e).includes(String(t)) : !String(e).toLowerCase().includes(String(t).toLowerCase())
+	},
+	number: {
+		equals: (e, t) => Number(e) === Number(t),
+		greaterThan: (e, t) => Number(e) > Number(t),
+		lessThan: (e, t) => Number(e) < Number(t),
+		greaterThanOrEqual: (e, t) => Number(e) >= Number(t),
+		lessThanOrEqual: (e, t) => Number(e) <= Number(t),
+		between: (e, t) => Number(e) >= Number(t.min) && Number(e) <= Number(t.max)
+	},
+	boolean: { equals: (e, t) => !!e == !!t },
+	date: {
+		equals: (e, t) => {
+			if (!e || !t) return !1;
+			let n = new Date(e).getTime(), r = new Date(t).getTime();
+			return Number.isNaN(n) || Number.isNaN(r) ? !1 : n === r;
+		},
+		before: (e, t) => {
+			if (!e || !t) return !1;
+			let n = new Date(e).getTime(), r = new Date(t).getTime();
+			return Number.isNaN(n) || Number.isNaN(r) ? !1 : n < r;
+		},
+		after: (e, t) => {
+			if (!e || !t) return !1;
+			let n = new Date(e).getTime(), r = new Date(t).getTime();
+			return Number.isNaN(n) || Number.isNaN(r) ? !1 : n > r;
+		},
+		between: (e, t) => {
+			if (!e || !t?.min || !t?.max) return !1;
+			let n = new Date(e).getTime(), r = new Date(t.min).getTime(), i = new Date(t.max).getTime();
+			return Number.isNaN(n) || Number.isNaN(r) || Number.isNaN(i) ? !1 : n >= r && n <= i;
+		}
+	},
+	select: {
+		equals: (e, t) => e === t,
+		notEquals: (e, t) => e !== t
+	},
+	multiselect: {
+		in: (e, t) => t.includes(e),
+		notIn: (e, t) => !t.includes(e),
+		intersects: (e, t) => e.some((e) => t.includes(e))
+	}
+};
+//#endregion
+//#region src/utils/utils.ts
+function p(e, t, n) {
+	if (typeof e != "object" || !e) return e;
+	let r = (t || n) ?? "";
+	return r.includes(".") ? r.split(".").reduce((e, t) => e?.[t], e) : e?.[r];
+}
+//#endregion
+//#region src/hooks/useFilter.ts
+function m(t, r = []) {
+	let [a, o] = i(r), s = n(() => t.filter((e) => a.every((t) => {
+		let { id: n, field: r, type: i, operator: a, value: o, compare: s } = t, c = p(e, r, n);
+		if (i === "custom" || a === "custom") return s ? s(c, o, e) : !0;
+		let l = f[i];
+		if (!l) return !0;
+		let u = l[a];
+		return u ? u(c, o, t) : !0;
+	})), [t, a]), c = e((e) => {
+		o((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]);
+	}, []), l = e((e) => {
+		o((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
+	}, []), u = e(() => {
+		o([]);
+	}, []), d = e(() => {
+		o(r);
+	}, [r]), m = e((e) => {
+		o(e);
+	}, []), h = e((e) => a.find((t) => t.id === e)?.value, [a]), g = e((e, t) => {
+		o((n) => n.map((n) => n.id === e ? {
+			...n,
+			value: t
+		} : n));
+	}, []), _ = e((e) => a.some((t) => t.id === e), [a]);
+	return {
+		filteredItems: s,
+		filters: a,
+		addFilter: c,
+		removeFilter: l,
+		clearFilters: u,
+		resetFilters: d,
+		toggleFilter: e((e) => {
+			o((t) => t.some((t) => t.id === e.id) ? t.filter((t) => t.id !== e.id) : [...t, e]);
+		}, []),
+		updateFilterConfig: e((e, t) => {
+			o((n) => n.map((n) => n.id === e ? {
+				...n,
+				...t
+			} : n));
+		}, []),
+		setFilters: m,
+		getFilterValue: h,
+		updateFilterValue: g,
+		isFilterActive: _
+	};
+}
+//#endregion
 //#region src/hooks/usePagination.ts
-function f(t, r, a = 0) {
+function h(t, r, a = 0) {
 	let [o, s] = i(r), [c, l] = i(a), u = Math.max(1, Math.ceil(t.length / Math.max(1, o))), d = Math.min(Math.max(0, c), u - 1);
 	return c !== d && l(d), {
 		currentItems: n(() => typeof o != "number" || o < 1 ? [] : t.slice(c * o, (c + 1) * o), [
@@ -95,4 +201,153 @@ function f(t, r, a = 0) {
 	};
 }
 //#endregion
-export { d as Modal, u as useModal, f as usePagination };
+//#region src/utils/sortUtils.ts
+function g(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = C(e, t, r, i);
+	if (a !== null) return a;
+	let o = !!e;
+	return o === !!t ? 0 : o ? 1 : -1;
+}
+function _(e, t, n = {}) {
+	let { sortUndefined: r, desc: i = !1 } = n, a = C(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 ? C(c ? void 0 : o, l ? void 0 : s, r, i) ?? 0 : o - s;
+}
+function v(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = C(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 y(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, caseSensitive: a = !1 } = n, o = C(e, t, i, r);
+	if (o !== null) return o;
+	let s = String(e), c = String(t);
+	return s.localeCompare(c, void 0, {
+		numeric: !0,
+		sensitivity: a ? "variant" : "base"
+	});
+}
+function b(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = C(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 x(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i } = n, a = C(e, t, i, r);
+	return a === null ? e < t ? -1 : +(e > t) : a;
+}
+function S(e, t, n = {}) {
+	let { desc: r = !1, sortUndefined: i, compare: a } = n, o = C(e, t, i, r);
+	return o === null ? typeof a == "function" ? a(e, t) : e < t ? -1 : +(e > t) : o;
+}
+function C(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;
+	if (n === "first") return i === void 0 ? -1 : 1;
+	if (n === "last") return i === void 0 ? 1 : -1;
+	if (n === -1) {
+		let e = r ? 1 : -1;
+		return i === void 0 ? e : -e;
+	}
+	if (n === 1) {
+		let e = r ? 1 : -1;
+		return i === void 0 ? -e : e;
+	}
+	return null;
+}
+//#endregion
+//#region src/hooks/useSort.ts
+function w(t, r = []) {
+	let [a, o] = i(r);
+	return {
+		sortedItems: n(() => t.toSorted((e, t) => {
+			for (let n of a) {
+				let { type: r, field: i, id: a, desc: o = !1, invertSorting: s = !1 } = n, c = p(e, i, a), l = p(t, i, a), u;
+				switch (r) {
+					case "numeric":
+						u = _(c, l, n);
+						break;
+					case "alphabetical":
+						u = v(c, l, n);
+						break;
+					case "alphanumeric":
+						u = y(c, l, n);
+						break;
+					case "boolean":
+						u = g(c, l, n);
+						break;
+					case "date":
+						u = b(c, l, n);
+						break;
+					case "basic":
+						u = x(c, l, n);
+						break;
+					case "custom":
+						u = S(c, l, n);
+						break;
+					default: u = x(c, l, n);
+				}
+				if (u !== 0) return u * (o === s ? 1 : -1);
+			}
+			return 0;
+		}), [a, t]),
+		sorts: a,
+		addSort: e((e) => o((t) => t.some((t) => t.id === e.id) ? t.map((t) => t.id === e.id ? e : t) : [...t, e]), []),
+		removeSort: e((e) => {
+			o((t) => Array.isArray(e) ? t.filter((t) => !e.includes(t.id)) : t.filter((t) => t.id !== e));
+		}, []),
+		clearSorts: e(() => o([]), []),
+		resetSorts: e(() => o(r), [r]),
+		setSorts: e((e) => o(e), []),
+		getSortDirection: e((e) => {
+			let t = a.find((t) => t.id === e);
+			return t ? t.desc ? "desc" : "asc" : void 0;
+		}, [a]),
+		toggleSort: e((e, t, n) => {
+			let { multi: r = !1, ...i } = n || {};
+			o((n) => {
+				let a = n.find((t) => t.id === e);
+				if (!a) {
+					let a = {
+						id: e,
+						type: t,
+						...i,
+						desc: !1
+					};
+					return r ? [...n, a] : [a];
+				}
+				if (!a.desc) {
+					let t = {
+						...a,
+						...i,
+						desc: !0
+					};
+					return r ? n.map((n) => n.id === e ? t : n) : [t];
+				}
+				if (a.disableSortRemoval || i.disableSortRemoval) {
+					let t = {
+						...a,
+						...i,
+						desc: !1
+					};
+					return r ? n.map((n) => n.id === e ? t : n) : [t];
+				}
+				return r ? n.filter((t) => t.id !== e) : [];
+			});
+		}, []),
+		getNextSortingOrder: e((e) => {
+			let t = a.find((t) => t.id === e);
+			return t ? t.desc ? t.disableSortRemoval ? "asc" : "none" : "desc" : "asc";
+		}, [a]),
+		getSortIndex: e((e) => {
+			let t = a.findIndex((t) => t.id === e);
+			return t === -1 ? void 0 : t + 1;
+		}, [a])
+	};
+}
+//#endregion
+export { d as ModalLayout, m as useFilter, u as useModal, h as usePagination, w as useSort };

package/package.json

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

package/dist/index.css

@@ -1,2 +0,0 @@
-:where(html){scrollbar-gutter:stable both}:where(body:has(dialog[open])){overflow:hidden}:where(dialog.universal-modal){box-sizing:border-box;max-width:var(--modal-max-width,500px);background:0 0;border:none;width:calc(100% - 2rem);padding:0}:where(dialog.universal-modal .modal-container){box-sizing:border-box;padding:var(--modal-padding,24px);background-color:var(--modal-bg,#fff);border-radius:var(--modal-radius,8px);box-shadow:var(--modal-shadow,0 4px 12px #00000026)}dialog.universal-modal::backdrop{background-color:var(--modal-backdrop-bg,#00000080);-webkit-backdrop-filter:blur(var(--modal-backdrop-blur,none));backdrop-filter:blur(var(--modal-backdrop-blur,none))}:where(dialog.universal-modal[open]){animation:.2s ease-out modal-fade-in}@keyframes modal-fade-in{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}
-/*$vite$:1*/