super-utilix 1.0.0 → 1.1.0

package/README.md

@@ -10,18 +10,22 @@ npm install super-utilix
 
 ## Features
 
-- 📅 **Date Utilities**: Format dates, calculate age, validate future dates, and more.
-- 🛠 **Object Utilities**: deep object manipulation, filtering, sorting, and form data conversion.
-- 🔍 **Search & Filter**: Recursive search in objects, array filtering, and query string generation.
+- 📅 **Date Utilities**: Format dates, calculate age, validate future dates, time conversion, and timestamp helpers.
+- 🛠 **Object Utilities**: Deep comparison, field removal, sorting, form data conversion, and complex object manipulations.
+- 🔍 **Search & Filter**: Recursive search in objects, array filtering, query string generation, and URL parameter handling.
 - 🔢 **Arabic Utilities**: Convert numbers to Arabic ordinal words.
-- 📝 **DOM & Events**: HTML text extraction and keyboard event handlers (Arabic, English, Numbers).
+- 📝 **DOM & Events**: HTML text extraction and keyboard event handlers (Arabic, English, Numbers, Floating Point).
 - 🔄 **CRUD Helpers**: Frontend-side state management for Create, Read, Update, Delete operations.
+- ✅ **Validation**: Date validation helpers.
 
 ---
 
 ## API Reference
 
-### 1. Arabic Utilities (`literalOrdinals`)
+### 1. Arabic Utilities
+
+#### `literalOrdinals(num, lang)`
+
 Convert numbers into their Arabic ordinal representation (e.g., 1 -> الأول).
 
 ```typescript
@@ -33,115 +37,580 @@ console.log(literalOrdinals(25, 'ar')); // "الخامس والعشرون"
 
 ### 2. Date Utilities
 
-#### `formatDateTime(date)`
-Formats a date string or object into `DD/MM/YYYY, h:mmA`.
+#### `formatDateWithPattern(date, format)`
+
+Formats a `Date` object using a custom pattern.
+Supported tokens: `YYYY`, `YY`, `MM`, `M`, `DD`, `D`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `A`, `a`.
+
 ```typescript
+import { formatDateWithPattern } from 'super-utilix';
+
+formatDateWithPattern(new Date(), 'YYYY-MM-DD hh:mm A'); // "2023-12-25 02:30 PM"
+```
+
+#### `formatDateTime(date, format?)`
+
+Formats a date string or object. Default format: `DD/MM/YYYY, h:mmA`.
+
+```typescript
+import { formatDateTime } from 'super-utilix';
+
 formatDateTime('2023-12-25T14:30:00'); // "25/12/2023, 2:30PM"
 ```
 
-#### `formatDate(date)`
-Formats a date string or object into `DD/MM/YYYY`.
+#### `formatDate(date, format?)`
+
+Formats a date string or object. Default format: `DD/MM/YYYY`.
+
 ```typescript
+import { formatDate } from 'super-utilix';
+
 formatDate('2023-12-25'); // "25/12/2023"
 ```
 
-#### `calculateDetailedAge(birthDate, t, currentDate, gender)`
+#### `getTime(inputDate)`
+
+Extracts time in `HH:mm` format from a date.
+
+```typescript
+import { getTime } from 'super-utilix';
+
+getTime('2023-12-25T14:30:00'); // "14:30"
+```
+
+#### `isNotFutureDate(date)`
+
+Checks if a date is not in the future (compared to tomorrow's start).
+
+```typescript
+import { isNotFutureDate } from 'super-utilix';
+
+isNotFutureDate('2050-01-01'); // false
+```
+
+#### `calculateDetailedAge(birthDate, t?, currentDate?, gender?)`
+
 Calculates detailed age (years, months, days) with localization support.
+
+- `t`: Optional translation function `(key: string) => string`.
+- `currentDate`: Defaults to now.
+- `gender`: Optional gender string for localization.
+
 ```typescript
+import { calculateDetailedAge } from 'super-utilix';
+
 const age = calculateDetailedAge('1990-01-01');
 console.log(age.message); // "33 years - 11 months - 24 days..."
 ```
 
 #### `calculateAge(birthDate)`
-Returns the age in years from a given birth date.
+
+Returns the age in years from a given birth date string.
+Supports `YYYY-MM-DD` and `DD/MM/YYYY` formats.
+
 ```typescript
+import { calculateAge } from 'super-utilix';
+
 calculateAge('1990-01-01'); // 33
+calculateAge('01/01/1990'); // 33
+```
+
+#### `birthDateToAge(birthDate)`
+
+Returns object `{ years, months, days }` from a birth date.
+
+```typescript
+import { birthDateToAge } from 'super-utilix';
+
+console.log(birthDateToAge('1990-01-01'));
+// { years: 33, months: 11, days: 24 }
+```
+
+#### `ageToBirthDate(age)`
+
+Calculates birth date from an age object `{ years, months, days }`.
+
+```typescript
+import { ageToBirthDate } from 'super-utilix';
+
+const birthDate = ageToBirthDate({ years: 30, months: 5, days: 10 });
+console.log(birthDate); // Date object
+```
+
+#### `ageToBirthDateChangeSegment(oldAge, age)`
+
+Calculates a new birth date based on changed age segments.
+
+```typescript
+import { ageToBirthDateChangeSegment } from 'super-utilix';
+
+const newBirthDate = ageToBirthDateChangeSegment(
+  { years: 30, months: 0, days: 0 },
+  { years: 31, months: 0, days: 0 },
+);
+```
+
+#### `convertTimeToTimestamp(timeString)`
+
+Converts a time string in format `"DD HH:mm:ss"` (e.g., `"01 10:30:00"`) to milliseconds.
+
+```typescript
+import { convertTimeToTimestamp } from 'super-utilix';
+
+const ms = convertTimeToTimestamp('01 10:30:00');
+console.log(ms); // Total milliseconds
 ```
 
 ### 3. Object Utilities
 
 #### `removeEmptyFields(obj)`
-Removes fields with `null`, `undefined`, or empty string values from an object.
+
+Removes fields with `null`, `undefined`, or empty string values.
+
 ```typescript
-const clean = removeEmptyFields({ name: 'Ali', age: null, city: '' });
-// { name: 'Ali' }
+import { removeEmptyFields } from 'super-utilix';
+
+removeEmptyFields({ name: 'Ali', age: null }); // { name: 'Ali' }
 ```
 
 #### `objectToFormData(obj)`
-Converts a potentially nested object into a `FormData` object (useful for API requests).
+
+Converts a potentially nested object into a `FormData` object.
+
 ```typescript
-const formData = objectToFormData({ name: 'Ali', file: fileObj });
+import { objectToFormData } from 'super-utilix';
+
+const formData = objectToFormData({ name: 'Ali', file: new File([], 'test.png') });
 ```
 
-#### `compareObjects(original, updated, keysToIgnore)`
-Deeply compares two objects to check if they are equivalent, optionally ignoring specific keys.
+#### `compareObjects(original, updated, keysToIgnore?)`
+
+Deeply compares two objects, optionally ignoring specific keys.
+
 ```typescript
-const isEqual = compareObjects({ a: 1 }, { a: 1, b: 2 }, ['b']); // true
+import { compareObjects } from 'super-utilix';
+
+compareObjects({ a: 1 }, { a: 1, b: 2 }, ['b']); // true
 ```
 
 #### `getChangedFields(original, updated)`
-Returns an object containing only the fields that have changed between two objects.
+
+Returns an object containing only the fields that have changed.
+
 ```typescript
+import { getChangedFields } from 'super-utilix';
+
 const changes = getChangedFields({ a: 1 }, { a: 2 }); // { a: 2 }
 ```
 
+#### `capitalizeString(str)`
+
+Capitalizes the first letter of a string.
+
+```typescript
+import { capitalizeString } from 'super-utilix';
+
+capitalizeString('hello'); // "Hello"
+```
+
+#### `removeIdFromObjects(objects)`
+
+Removes `_id` field from an array of objects.
+
+```typescript
+import { removeIdFromObjects } from 'super-utilix';
+
+const result = removeIdFromObjects([{ _id: '1', name: 'Ali' }]);
+// [{ name: 'Ali' }]
+```
+
+#### `removeItemsWithIds(array, idsToRemove)`
+
+Removes items from an array that match the given IDs.
+
+```typescript
+import { removeItemsWithIds } from 'super-utilix';
+
+const result = removeItemsWithIds([{ _id: '1' }, { _id: '2' }], ['1']);
+// [{ _id: '2' }]
+```
+
+#### `createOptionsArray(data, valueField, ...labelFields)`
+
+Creates an array of options `{ value, label }` for select inputs.
+
+```typescript
+import { createOptionsArray } from 'super-utilix';
+
+const users = [{ id: 1, firstName: 'Ali', lastName: 'Khan' }];
+const options = createOptionsArray(users, 'id', 'firstName', 'lastName');
+// [{ value: 1, label: "Ali Khan" }]
+```
+
+#### `filterUsersOption(option, inputValue)`
+
+Filter helper for user select options (matches name or email).
+
+```typescript
+import { filterUsersOption } from 'super-utilix';
+
+// Used in filter logic
+const isMatch = filterUsersOption(
+  { label: { props: { children: ['Ali', 'ali@example.com'] } } },
+  'Ali',
+);
+```
+
+#### `removeKeys(obj, keys)`
+
+Removes specified keys from an object.
+
+```typescript
+import { removeKeys } from 'super-utilix';
+
+const result = removeKeys({ a: 1, b: 2 }, ['b']); // { a: 1 }
+```
+
+#### `getArrayKeys(obj)`
+
+Returns an array of keys that have array values in the object.
+
+```typescript
+import { getArrayKeys } from 'super-utilix';
+
+getArrayKeys({ a: [1, 2], b: 3 }); // [{ a: [1, 2] }]
+```
+
+#### `convertObjectToArray(obj)`
+
+Converts an object `{ key: value }` into an array `[{ key: value }]`.
+
+```typescript
+import { convertObjectToArray } from 'super-utilix';
+
+convertObjectToArray({ a: 1, b: 2 }); // [{ a: 1 }, { b: 2 }]
+```
+
+#### `comparePermissionLists(list1, list2)`
+
+Compares two lists of permissions.
+
+```typescript
+import { comparePermissionLists } from 'super-utilix';
+
+const isEqual = comparePermissionLists([{ read: ['users'] }], [{ read: ['users'] }]); // true
+```
+
+#### `sortObjectByKeys(obj)`
+
+Sorts object keys alphabetically.
+
+```typescript
+import { sortObjectByKeys } from 'super-utilix';
+
+sortObjectByKeys({ b: 2, a: 1 }); // { a: 1, b: 2 }
+```
+
+#### `sortObjectByValues(obj)`
+
+Sorts object properties by numeric values.
+
+```typescript
+import { sortObjectByValues } from 'super-utilix';
+
+sortObjectByValues({ a: 2, b: 1 }); // { b: 1, a: 2 }
+```
+
+#### `removeFields(obj, fieldsToRemove)`
+
+Recursively removes specified fields from an object or array.
+
+```typescript
+import { removeFields } from 'super-utilix';
+
+removeFields({ a: 1, nested: { a: 1, b: 2 } }, ['a']);
+// { nested: { b: 2 } }
+```
+
+#### `removeFieldsTopLevel(obj, fieldsToRemove)`
+
+Removes specified fields from an object or array (shallow).
+
+```typescript
+import { removeFieldsTopLevel } from 'super-utilix';
+
+removeFieldsTopLevel({ a: 1, nested: { a: 1 } }, ['a']);
+// { nested: { a: 1 } }
+```
+
+#### `getLabelByItemsAndId(id, items, fields)`
+
+Finds a label from items array by ID.
+
+```typescript
+import { getLabelByItemsAndId } from 'super-utilix';
+
+getLabelByItemsAndId(1, [{ id: 1, name: 'Ali' }], 'name'); // "Ali"
+```
+
+#### `getLabelByItemsAndOptions(id, items)`
+
+Finds a label from options array (`{ value, label }`) by ID.
+
+```typescript
+import { getLabelByItemsAndOptions } from 'super-utilix';
+
+getLabelByItemsAndOptions(1, [{ value: 1, label: 'Ali' }]); // "Ali"
+```
+
 ### 4. Search & Filter Utilities
 
-#### `searchInObjects(data, query, childrenField, fieldsToSearch)`
-Recursively searches through an array of objects (and their children) for a query string.
+#### `searchInObjects(data, query, childrenField, fieldsToSearch?)`
+
+Recursively searches through an array of objects (and their children).
+
+```typescript
+import { searchInObjects } from 'super-utilix';
+
+const data = [{ id: 1, name: 'Parent', children: [{ id: 2, name: 'Child' }] }];
+const result = searchInObjects(data, 'Child', 'children', ['name']);
+```
+
+#### `searchInObjectsWithParents(data, query, childrenField, fieldsToSearch?)`
+
+Same as `searchInObjects` but retains the parent structure for matching children.
+
+```typescript
+import { searchInObjectsWithParents } from 'super-utilix';
+
+const result = searchInObjectsWithParents(data, 'Child', 'children', ['name']);
+```
+
+#### `addSearchParam(searchParams, setSearchParams, key, value)`
+
+Helper to update URL search parameters.
+
 ```typescript
-const result = searchInObjects(treeData, 'node', 'children', ['name']);
+import { addSearchParam } from 'super-utilix';
+
+// Inside a component or hook
+addSearchParam(searchParams, setSearchParams, 'page', '2');
 ```
 
 #### `filterInArray(field, values, data)`
+
 Filters an array of objects based on whether a field's value exists in a provided array.
+
 ```typescript
+import { filterInArray } from 'super-utilix';
+
 filterInArray('id', [1, 2], [{ id: 1 }, { id: 3 }]); // [{ id: 1 }]
 ```
 
+#### `filterInObjects(data, query, childrenField, fieldsToFilter?)`
+
+Recursively filters objects based on a query string matching specified fields.
+
+```typescript
+import { filterInObjects } from 'super-utilix';
+
+const result = filterInObjects(data, ['Child'], 'children', ['name']);
+```
+
+### 5. Query String Utilities
+
 #### `toQueryString(params)`
-Converts an object into a URL query string, automatically removing empty fields.
+
+Converts an object into a URL query string, removing empty fields.
+
 ```typescript
+import { toQueryString } from 'super-utilix';
+
 toQueryString({ page: 1, search: 'test' }); // "page=1&search=test"
 ```
 
-### 5. Event Handlers (Input Validation)
+#### `createSearchQuery(params)`
+
+Creates a query string from parameters, handling arrays and primitives.
+
+```typescript
+import { createSearchQuery } from 'super-utilix';
+
+createSearchQuery({ ids: [1, 2], type: 'all' }); // "ids=1&ids=2&type=all"
+```
+
+#### `serializeFormQuery(params)`
+
+Serializes form params for backend requests.
+
+```typescript
+import { serializeFormQuery } from 'super-utilix';
+
+serializeFormQuery({ ids: [1, 2] }); // "ids=1,2"
+```
+
+#### `arrFromQuery(query)`
+
+Converts a comma-separated query string back to an array of numbers.
+
+```typescript
+import { arrFromQuery } from 'super-utilix';
+
+arrFromQuery('1,2,3'); // [1, 2, 3]
+```
+
+#### `uniqueId()`
+
+Generates a unique timestamp-based ID.
+
+```typescript
+import { uniqueId } from 'super-utilix';
+
+console.log(uniqueId()); // 168...
+```
+
+#### `pureURLS3(url)`
+
+Cleans up S3 URLs to remove query parameters and domain prefix.
+
+```typescript
+import { pureURLS3 } from 'super-utilix';
+
+pureURLS3('http://bucket.s3.com/folder/file.png?token=...'); // "folder/file.png"
+```
+
+#### `prePareFilters(searchParams)`
+
+Parses and prepares filter parameters from URL search params.
+
+```typescript
+import { prePareFilters } from 'super-utilix';
+
+const filters = prePareFilters(new URLSearchParams('filters=%5B...%5D'));
+```
+
+### 6. Event Handlers (Input Validation)
+
+#### `handleKeyDownNumber`
+
+Prevents non-numeric input.
 
-#### `handleKeyDownNumber(event)`
-Prevents non-numeric input in text fields.
 ```typescript
+import { handleKeyDownNumber } from 'super-utilix';
+
 <input onKeyDown={handleKeyDownNumber} />
 ```
 
-#### `handleKeyDownArabic(event)`
-Restricts input to Arabic characters and common symbols.
+#### `handleKeyDownNumberNoCopy`
+
+Prevents non-numeric input and disables copy/paste.
+
+```typescript
+import { handleKeyDownNumberNoCopy } from 'super-utilix';
+
+<input onKeyDown={handleKeyDownNumberNoCopy} />
+```
+
+#### `handleKeyDownFloatNumber`
+
+Allows numbers and one decimal point.
+
+```typescript
+import { handleKeyDownFloatNumber } from 'super-utilix';
+
+<input onKeyDown={handleKeyDownFloatNumber} />
+```
+
+#### `handleKeyDownArabic`
 
-#### `handleKeyDownEnglish(event)`
-Restricts input to English characters and common symbols.
+Restricts input to Arabic characters.
 
-### 6. DOM Utilities
+```typescript
+import { handleKeyDownArabic } from 'super-utilix';
+
+<input onKeyDown={handleKeyDownArabic} />
+```
+
+#### `handleKeyDownEnglish`
+
+Restricts input to English characters.
+
+```typescript
+import { handleKeyDownEnglish } from 'super-utilix';
+
+<input onKeyDown={handleKeyDownEnglish} />
+```
+
+### 7. DOM Utilities
 
 #### `getTextOnlyFromHtml(html)`
-Extracts plain text from an HTML string using `DOMParser`.
+
+Extracts plain text from an HTML string.
+
 ```typescript
+import { getTextOnlyFromHtml } from 'super-utilix';
+
 getTextOnlyFromHtml('<p>Hello <b>World</b></p>'); // "Hello World"
 ```
 
-### 7. CRUD Operations (Frontend)
-Helper functions to manage state arrays for CRUD operations.
+### 8. CRUD Operations (Frontend)
 
-- `handleCreateFront`: Adds a new item to the list.
-- `handleUpdateFront`: Updates an existing item in the list.
-- `handleDeleteFront`: Removes an item from the list.
+Helper functions to manage state arrays for Create, Read, Update, Delete.
+
+#### Usage of CRUD Helpers
 
 ```typescript
+import {
+  handleCreateFront,
+  handleCreateFrontUnique,
+  handleUpdateFront,
+  handleDeleteFront,
+} from 'super-utilix';
+
+// Create
 handleCreateFront({ items, setItems, itemData: { name: 'New Item' } });
+
+// Create Unique
+handleCreateFrontUnique({ items, setItems, itemData, uniqueField: 'id' });
+
+// Update
+handleUpdateFront({ id: 1, items, setItems, itemData: { name: 'Updated' } });
+
+// Delete
+handleDeleteFront({ id: 1, items, setItems });
 ```
 
-### 8. Validation
+### 9. Validation
 
-#### `validateDay(value)`, `validateMonth(value)`, `validateYear(value)`
-Validates and sanitizes date inputs (e.g., ensures day is between 1-31).
+#### `validateDay(value)`
+
+Ensures day is between 1-31.
+
+```typescript
+import { validateDay } from 'super-utilix';
+
+validateDay('32'); // "31"
+```
+
+#### `validateMonth(value)`
+
+Ensures month is between 1-12.
+
+```typescript
+import { validateMonth } from 'super-utilix';
+
+validateMonth('13'); // "12"
+```
+
+#### `validateYear(value)`
+
+Ensures year is valid (>= 1900).
+
+```typescript
+import { validateYear } from 'super-utilix';
+
+validateYear('1800'); // "1900"
+```
 
 ## License
 

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var b=Object.defineProperty,E=Object.defineProperties,U=Object.getOwnPropertyDescriptor,R=Object.getOwnPropertyDescriptors,N=Object.getOwnPropertyNames,D=Object.getOwnPropertySymbols;var A=Object.prototype.hasOwnProperty,Y=Object.prototype.propertyIsEnumerable;var F=(e,t,r)=>t in e?b(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,l=(e,t)=>{for(var r in t||(t={}))A.call(t,r)&&F(e,r,t[r]);if(D)for(var r of D(t))Y.call(t,r)&&F(e,r,t[r]);return e},j=(e,t)=>E(e,R(t));var k=(e,t)=>{var r={};for(var n in e)A.call(e,n)&&t.indexOf(n)<0&&(r[n]=e[n]);if(e!=null&&D)for(var n of D(e))t.indexOf(n)<0&&Y.call(e,n)&&(r[n]=e[n]);return r};var K=(e,t)=>{for(var r in t)b(e,r,{get:t[r],enumerable:!0})},B=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of N(t))!A.call(e,s)&&s!==r&&b(e,s,{get:()=>t[s],enumerable:!(n=U(t,s))||n.enumerable});return e};var H=e=>B(b({},"__esModule",{value:!0}),e);var Kt={};K(Kt,{addSearchParam:()=>Lt,ageToBirthDate:()=>q,ageToBirthDateChangeSegment:()=>tt,arrFromQuery:()=>$t,birthDateToAge:()=>v,calculateAge:()=>rt,calculateDetailedAge:()=>V,capitalizeString:()=>yt,compareObjects:()=>wt,comparePermissionLists:()=>xt,convertObjectToArray:()=>bt,convertTimeToTimestamp:()=>et,createOptionsArray:()=>ht,createSearchQuery:()=>jt,filterInArray:()=>ut,filterInObjects:()=>lt,filterUsersOption:()=>dt,formatDate:()=>Z,formatDateTime:()=>J,formatDateWithPattern:()=>O,getArrayKeys:()=>Dt,getChangedFields:()=>C,getLabelByItemsAndId:()=>St,getLabelByItemsAndOptions:()=>Mt,getTextOnlyFromHtml:()=>st,getTime:()=>X,handleCreateFront:()=>z,handleCreateFrontUnique:()=>Q,handleDeleteFront:()=>W,handleKeyDownArabic:()=>ot,handleKeyDownEnglish:()=>at,handleKeyDownFloatNumber:()=>ft,handleKeyDownNumber:()=>it,handleKeyDownNumberNoCopy:()=>ct,handleUpdateFront:()=>_,isNotFutureDate:()=>G,literalOrdinals:()=>$,objectToFormData:()=>L,prePareFilters:()=>Pt,pureURLS3:()=>Yt,removeEmptyFields:()=>M,removeFields:()=>T,removeFieldsFromObject:()=>S,removeFieldsTopLevel:()=>Tt,removeIdFromObjects:()=>gt,removeItemsWithIds:()=>pt,removeKeys:()=>mt,searchInObjects:()=>Et,searchInObjectsWithParents:()=>Ct,serializeFormQuery:()=>kt,sortObjectByKeys:()=>At,sortObjectByValues:()=>Ot,toQueryString:()=>Ft,uniqueId:()=>It,validateDay:()=>Ut,validateMonth:()=>Rt,validateYear:()=>Nt});module.exports=H(Kt);var $=(e,t)=>{if(t==="ar"){let r=["","\u0627\u0644\u0623\u0648\u0644","\u0627\u0644\u062B\u0627\u0646\u064A","\u0627\u0644\u062B\u0627\u0644\u062B","\u0627\u0644\u0631\u0627\u0628\u0639","\u0627\u0644\u062E\u0627\u0645\u0633","\u0627\u0644\u0633\u0627\u062F\u0633","\u0627\u0644\u0633\u0627\u0628\u0639","\u0627\u0644\u062B\u0627\u0645\u0646","\u0627\u0644\u062A\u0627\u0633\u0639"],n=["\u0627\u0644\u062D\u0627\u062F\u064A \u0639\u0634\u0631","\u0627\u0644\u062B\u0627\u0646\u064A \u0639\u0634\u0631","\u0627\u0644\u062B\u0627\u0644\u062B \u0639\u0634\u0631","\u0627\u0644\u0631\u0627\u0628\u0639 \u0639\u0634\u0631","\u0627\u0644\u062E\u0627\u0645\u0633 \u0639\u0634\u0631","\u0627\u0644\u0633\u0627\u062F\u0633 \u0639\u0634\u0631","\u0627\u0644\u0633\u0627\u0628\u0639 \u0639\u0634\u0631","\u0627\u0644\u062B\u0627\u0645\u0646 \u0639\u0634\u0631","\u0627\u0644\u062A\u0627\u0633\u0639 \u0639\u0634\u0631"],s=["","\u0627\u0644\u0639\u0627\u0634\u0631","\u0627\u0644\u0639\u0634\u0631\u0648\u0646","\u0627\u0644\u062B\u0644\u0627\u062B\u0648\u0646","\u0627\u0644\u0623\u0631\u0628\u0639\u0648\u0646","\u0627\u0644\u062E\u0645\u0633\u0648\u0646","\u0627\u0644\u0633\u062A\u0648\u0646","\u0627\u0644\u0633\u0628\u0639\u0648\u0646","\u0627\u0644\u062B\u0645\u0627\u0646\u0648\u0646","\u0627\u0644\u062A\u0633\u0639\u0648\u0646"],o=["","\u0627\u0644\u0645\u0627\u0626\u0629","\u0627\u0644\u0645\u0626\u062A\u0627\u0646","\u0627\u0644\u062B\u0644\u0627\u062B\u0645\u0627\u0626\u0629","\u0627\u0644\u0623\u0631\u0628\u0639\u0645\u0627\u0626\u0629","\u0627\u0644\u062E\u0645\u0633\u0645\u0627\u0626\u0629","\u0627\u0644\u0633\u062A\u0645\u0627\u0626\u0629","\u0627\u0644\u0633\u0628\u0639\u0645\u0627\u0626\u0629","\u0627\u0644\u062B\u0645\u0627\u0646\u0645\u0627\u0626\u0629","\u0627\u0644\u062A\u0633\u0639\u0645\u0627\u0626\u0629"];if(e===1)return"\u0627\u0644\u0623\u0648\u0644";let a=Math.floor(e/100),u=e%100;if(a>0)return u===0?o[a]:`${o[a]} \u0648${$(u,t)}`;if(e>=2&&e<=9)return r[e];if(e>=11&&e<=19)return n[e-11];if(e%10===0&&e<100)return s[e/10];let i=e%10,c=Math.floor(e/10)*10;return c===10?`\u0627\u0644${r[i]} \u0639\u0634\u0631`:i===1?`\u0627\u0644\u062D\u0627\u062F\u064A \u0648${s[c/10]}`:i===2?`\u0627\u0644\u062B\u0627\u0646\u064A \u0648${s[c/10]}`:`${r[i]} \u0648${s[c/10]}`}else{let r=["th","st","nd","rd"],n=e%100;return e+(r[(n-20)%10]||r[n]||r[0])}};var z=({items:e,setItems:t,itemData:r})=>{if(!e||!t||!r)return;let n=l({id:Number(new Date().getTime())},r);n&&t([...e,n])},Q=({items:e,setItems:t,itemData:r,uniqueField:n})=>{if(!e||!t||!r)return;e.some(o=>n&&typeof r=="object"&&r!==null?o[n]===r[n]:o===r)||t([...e,r])},_=({id:e,items:t,setItems:r,itemData:n})=>{!e||!t||!r||!n||r(t==null?void 0:t.map(s=>s.id===e?l(l({},s),n):s))},W=({id:e,items:t,setItems:r})=>{!e||!t||!r||r(t==null?void 0:t.filter(n=>{var s;return typeof n=="object"&&n!==null&&!Array.isArray(e)?n.id!==e:Array.isArray(e)?!e.includes((s=n.id)!=null?s:n):n!==e}))};var O=(e,t)=>{let r=e.getDate(),n=e.getMonth()+1,s=e.getFullYear(),o=e.getHours(),a=o%12||12,u=e.getMinutes(),i=e.getSeconds(),c=o>=12?"PM":"AM",f={YYYY:String(s),YY:String(s).slice(-2),MM:String(n).padStart(2,"0"),M:String(n),DD:String(r).padStart(2,"0"),D:String(r),HH:String(o).padStart(2,"0"),H:String(o),hh:String(a).padStart(2,"0"),h:String(a),mm:String(u).padStart(2,"0"),m:String(u),ss:String(i).padStart(2,"0"),s:String(i),A:c,a:c.toLowerCase()};return t.replace(/YYYY|YY|MM|M|DD|D|HH|H|hh|h|mm|m|ss|s|A|a/g,y=>f[y])},J=(e,t="DD/MM/YYYY, h:mmA")=>{if(!e)return"";let r=new Date(e);return O(r,t)},Z=(e,t="DD/MM/YYYY")=>{if(!e)return"";let r=new Date(e);return O(r,t)},G=e=>{let t=new Date(e),r=new Date;return r.setDate(r.getDate()+1),r.setHours(0,0,0,0),t<r};function X(e){if(!e)return"";let t=new Date(e),r=o=>o.toString().padStart(2,"0"),n=r(t.getHours()),s=r(t.getMinutes());return`${n}:${s}`}var V=(e,t=void 0,r=new Date,n)=>{var f,y,g,p,h;let s={age:{years:0,months:0,days:0},message:(f=t==null?void 0:t("no_age"))!=null?f:"No age"};if(e==null)return s;let o=e instanceof Date?e:nt(e)?new Date(e):new Date(Number(e)),a=r instanceof Date?r:new Date(Number(r));if(isNaN(o.getTime())||isNaN(a.getTime())||a<o)return s;let u=a.getFullYear()-o.getFullYear(),i=a.getMonth()-o.getMonth(),c=a.getDate()-o.getDate();if(c<0){let m=new Date(a.getFullYear(),a.getMonth(),0);c+=m.getDate(),i--}return i<0&&(u--,i+=12),{age:{years:u,months:i,days:c},message:`${u} ${(y=t==null?void 0:t("years"))!=null?y:"years"} - ${i} ${(g=t==null?void 0:t("months"))!=null?g:"months"} - ${c} ${(p=t==null?void 0:t("days"))!=null?p:"days"} / ${(h=t==null?void 0:t(n!=null?n:""))!=null?h:n}`}},v=e=>{if(!e)return null;let t=new Date(e),r=new Date,n=r.getFullYear()-t.getFullYear(),s=r.getMonth()-t.getMonth(),o=r.getDate()-t.getDate();return o<0&&(s--,o+=new Date(r.getFullYear(),r.getMonth(),0).getDate()),s<0&&(n--,s+=12),{years:n,months:s,days:o}},q=e=>{let t=new Date,r=t.getFullYear()-e.years,n=t.getMonth()-e.months,s=t.getDate()-e.days,o=new Date(t.getFullYear(),t.getMonth(),t.getDate());return o.setFullYear(r),o.setMonth(n),o.setDate(s),o},tt=(e,t)=>{let r=new Date,n=e&&e.years?e.years-t.years:r.getFullYear()-t.years,s=e&&e.months?e.months-t.months:r.getMonth()-t.months,o=e&&e.days?e.days-t.days:r.getDate()-t.days,a=new Date(r.getFullYear(),r.getMonth(),r.getDate());return a.setFullYear(n),a.setMonth(s),a.setDate(o),a};function et(e){let[t,r]=e.split(" "),n=parseInt(t.replace(/^0+/,""),10),[s,o,a]=(r||"00:00:00").split(":").map(i=>parseInt(i,10));return n*24*60*60*1e3+s*60*60*1e3+o*60*1e3+a*1e3}var rt=e=>{let t=new Date,r;if(e.includes("/")){let[o,a,u]=e.split("/").map(Number);r=new Date(u,a-1,o)}else if(!isNaN(Date.parse(e)))r=new Date(e);else throw new Error("Unsupported date format");let n=t.getFullYear()-r.getFullYear(),s=t.getMonth()-r.getMonth();return(s<0||s===0&&t.getDate()<r.getDate())&&n--,n};function nt(e){let t=new Date(e);return!isNaN(t.getTime())&&t.toISOString()===e}var st=e=>{var n;let t=new DOMParser,r=e&&t.parseFromString(e,"text/html");return(n=r&&r.body.textContent)!=null?n:""};var ot=e=>{let{key:t,ctrlKey:r,metaKey:n}=e;t==="Backspace"||t==="Delete"||t==="ArrowLeft"||t==="ArrowRight"||t==="ArrowUp"||t==="ArrowDown"||t==="Tab"||t==="Enter"||(r||n)&&(t==="c"||t==="v"||t==="x"||t==="a")||/[\u0600-\u06FF0-9\s!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~]/.test(t)||e.preventDefault()},at=e=>{let{key:t,ctrlKey:r,metaKey:n}=e;t==="Backspace"||t==="Delete"||t==="ArrowLeft"||t==="ArrowRight"||t==="ArrowUp"||t==="ArrowDown"||t==="Tab"||t==="Enter"||(r||n)&&(t==="c"||t==="v"||t==="x"||t==="a")||/[A-Za-z0-9\s!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~]/.test(t)||e.preventDefault()},it=e=>{let{key:t,ctrlKey:r,metaKey:n}=e;t==="Backspace"||t==="Delete"||t==="ArrowLeft"||t==="ArrowRight"||t==="ArrowUp"||t==="ArrowDown"||t==="Tab"||t==="Enter"||(r||n)&&(t==="c"||t==="v"||t==="x"||t==="a")||/[0-9]/.test(t)||e.preventDefault()},ct=e=>{let{key:t}=e;t==="Backspace"||t==="Delete"||t==="ArrowLeft"||t==="ArrowRight"||t==="ArrowUp"||t==="ArrowDown"||t==="Tab"||t==="Enter"||/[0-9]/.test(t)||e.preventDefault()},ft=e=>{let{key:t,ctrlKey:r,metaKey:n}=e,s=e.currentTarget;t==="Backspace"||t==="Delete"||t==="ArrowLeft"||t==="ArrowRight"||t==="ArrowUp"||t==="ArrowDown"||t==="Tab"||t==="Enter"||(r||n)&&(t==="c"||t==="v"||t==="x"||t==="a")||t==="."&&!s.value.includes(".")||!/[0-9]/.test(t)&&t!=="."&&e.preventDefault()};function ut(e,t,r){return t.length===0?r:r.filter(n=>t.includes(n[e]))}function lt(e=[],t,r="children",n){if(!e)return[];if(!t||(t==null?void 0:t.length)===0)return e;let s=a=>(n?n.map(i=>a[i]).filter(Boolean):Object.values(a)).some(i=>typeof i=="string"&&t.some(c=>i.includes(c))),o=a=>{let u=[];return a.forEach(i=>{s(i)&&u.push(i),i[r]&&(u=u.concat(o(i[r])))}),u};return o(e)}var yt=e=>e.charAt(0).toUpperCase()+e.slice(1);function M(e){return Object.fromEntries(Object.entries(e).filter(([,t])=>(t==null?void 0:t.length)!==0&&t!==null&&t!==void 0))}function gt(e){return e.map(n=>{var s=n,{_id:t}=s,r=k(s,["_id"]);return r})}function pt(e,t){return e.filter(r=>!(r!=null&&r._id)||!t.includes(r==null?void 0:r._id))}function ht(e,t,...r){return e.map(n=>({value:n[t],label:r.map(s=>n[s]).join(" ")}))}function dt(e,t){var s,o,a,u,i,c,f,y,g,p,h,m;let r=`${(i=(u=(a=(o=(s=e==null?void 0:e.label)==null?void 0:s.props)==null?void 0:o.children)==null?void 0:a[0])==null?void 0:u.props)==null?void 0:i.children}`,n=(p=(g=(y=(f=(c=e==null?void 0:e.label)==null?void 0:c.props)==null?void 0:f.children)==null?void 0:y[1])==null?void 0:g.props)==null?void 0:p.children;return((h=r==null?void 0:r.toLowerCase())==null?void 0:h.includes(t==null?void 0:t.toLowerCase()))||((m=n==null?void 0:n.toLowerCase())==null?void 0:m.includes(t==null?void 0:t.toLowerCase()))}function mt(e,t){let r=l({},e);for(let n of t)delete r[n];return r}function Dt(e){let t=[];for(let r in e)Array.isArray(e[r])&&t.push({[r]:e[r]});return t}function bt(e){return e?Object.entries(e).map(([t,r])=>({[t]:r})):[]}function xt(e,t){if(e.length!==t.length)return!1;for(let r=0;r<e.length;r++){let n=Object.keys(e[r]),s=Object.keys(t[r]);if(n.length!==s.length)return!1;for(let o of n){if(!s.includes(o))return!1;let a=e[r][o],u=t[r][o];if(a.length!==u.length)return!1;for(let i of a)if(!u.includes(i))return!1}}return!0}function L(e,t=new FormData,r=""){for(let n in e){if(!Object.prototype.hasOwnProperty.call(e,n))continue;let s=r?`${r}[${n}]`:n;typeof e[n]=="object"&&!(e[n]instanceof File)?L(e[n],t,s):t.append(s,e[n])}return t}function I(e){return e instanceof Date}function x(e){return e!==null&&typeof e=="object"}function w(e){return Array.isArray(e)}function P(e,t){let r={};for(let n in e)t.includes(n)||(r[n]=e[n]);return r}function d(e,t){if(e===t)return!0;if(e==null||t==null||typeof e!=typeof t)return!1;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if(Array.isArray(e)&&Array.isArray(t)){if(e.length!==t.length)return!1;for(let r=0;r<e.length;r++)if(!d(e[r],t[r]))return!1;return!0}if(typeof e=="object"&&typeof t=="object"){let r=Object.keys(e),n=Object.keys(t);if(r.length!==n.length)return!1;for(let s of r)if(!n.includes(s)||!d(e[s],t[s]))return!1;return!0}return!1}function wt(e,t,r=[]){let n=P(e,r),s=P(t,r);return d(n,s)}function C(e,t){if(!e&&!t)return{};if(!e)return t!=null?t:{};if(!t)return{};let r={};return Object.keys(t).forEach(n=>{let s=e==null?void 0:e[n],o=t==null?void 0:t[n];if(I(o)&&I(s)){s.getTime()!==o.getTime()&&(r[n]=o);return}if(x(o)&&!x(s)){r[n]=o;return}if(x(o)&&!w(o)&&x(s)&&!w(s)){let a=C(s,o);Object.keys(a).length>0&&(r[n]=a);return}if(w(o)||w(s)){d(s,o)||(r[n]=o);return}d(s,o)||(r[n]=o)}),r}function At(e){let t=Object.entries(e).sort((r,n)=>r[0].localeCompare(n[0]));return Object.fromEntries(t)}function Ot(e){let t=Object.entries(e).sort((r,n)=>typeof r[1]=="number"&&typeof n[1]=="number"?r[1]-n[1]:0);return Object.fromEntries(t)}function T(e,t){if(Array.isArray(e))return e.map(r=>T(r,t));if(typeof e=="object"&&e!==null){let r={};for(let n in e)t.includes(n)||(r[n]=T(e[n],t));return r}return e}function Tt(e,t){return e==null?e:Array.isArray(e)?e.map(r=>typeof r=="object"&&r!==null?S(r,t):r):typeof e=="object"&&e!==null?S(e,t):e}function S(e,t){let r=l({},e);for(let n of t||[])delete r[n];return r}var St=(e,t,r="name")=>{if(!t||!e)return;let n=t==null?void 0:t.find(s=>s.id===e);return n?Array.isArray(r)?r.map(s=>n[s]).join(" "):n[r]:""},Mt=(e,t)=>{if(!t||!e)return;let r=t==null?void 0:t.find(n=>n.value===e||(n==null?void 0:n.id)===e||(n==null?void 0:n._id)===e);return r?r.label:""};function Ft(e){return e?Object.entries(M(e)).filter(([,t])=>t!==void 0).map(([t,r])=>`${encodeURIComponent(t)}=${encodeURIComponent(String(r))}`).join("&"):""}function Yt(e){return e!=null&&e.startsWith("http")?e.split(".com/")[1].split("?")[0]:e}var jt=e=>{let t=new URLSearchParams;for(let[r,n]of Object.entries(e))if(Array.isArray(n))for(let s of n)t.append(r,s.toString());else n!==void 0&&t.append(r,n.toString());return t.toString()},kt=e=>Object.entries(e).map(([t,r])=>Array.isArray(r)?r.length===0?"":`${t}=${r.join(",")}`:r===void 0||r===""?"":`${t}=${r}`).filter(t=>t!=="").join("&"),$t=e=>!e||e===null||e===""?[]:e.split(",").map(t=>parseInt(t)),It=()=>Date.now()+Math.floor(Math.random()*1e4),Pt=e=>{let t=e.get("filters");if(!t)return null;try{let r=decodeURIComponent(t);return JSON.parse(r)}catch(r){return console.error("Error parsing filters from URL:",r),null}};var Lt=(e,t,r,n)=>{let s=new URLSearchParams(e);s.set(r,n),t(s)};function Ct(e=[],t="",r="children",n){var u;if(!e)return[];if(!t)return e;let s=(u=t.trim())==null?void 0:u.toLowerCase(),o=i=>(n?n.map(f=>i[f]).filter(Boolean):Object.values(i)).some(f=>typeof f=="string"&&(f==null?void 0:f.toLowerCase().includes(s))),a=i=>i.map(c=>{let f=c[r]?a(c[r]):[];return o(c)||f.length>0?j(l({},c),{[r]:f.length>0?f:void 0}):null}).filter(c=>c!==null);return a(e)}function Et(e=[],t="",r="children",n){var u;if(!e)return[];if(!t)return e;let s=(u=t==null?void 0:t.trim())==null?void 0:u.toLowerCase(),o=i=>(n?n.map(f=>i[f]).filter(Boolean):Object.values(i)).some(f=>typeof f=="string"&&(f==null?void 0:f.toLowerCase().includes(s))),a=i=>{let c=[];return i.forEach(f=>{o(f)&&c.push(f),f[r]&&(c=c.concat(a(f[r])))}),c};return a(e)}var Ut=e=>{let t=e.replace(/\D/g,"");return t?Math.min(Math.max(parseInt(t,10),1),31).toString():""},Rt=e=>{let t=e.replace(/\D/g,"");return t?Math.min(Math.max(parseInt(t,10),1),12).toString():""},Nt=e=>{let t=e.replace(/\D/g,"");return t?t.length<4?t:parseInt(t,10)<1900?"1900":t:""};0&&(module.exports={addSearchParam,ageToBirthDate,ageToBirthDateChangeSegment,arrFromQuery,birthDateToAge,calculateAge,calculateDetailedAge,capitalizeString,compareObjects,comparePermissionLists,convertObjectToArray,convertTimeToTimestamp,createOptionsArray,createSearchQuery,filterInArray,filterInObjects,filterUsersOption,formatDate,formatDateTime,formatDateWithPattern,getArrayKeys,getChangedFields,getLabelByItemsAndId,getLabelByItemsAndOptions,getTextOnlyFromHtml,getTime,handleCreateFront,handleCreateFrontUnique,handleDeleteFront,handleKeyDownArabic,handleKeyDownEnglish,handleKeyDownFloatNumber,handleKeyDownNumber,handleKeyDownNumberNoCopy,handleUpdateFront,isNotFutureDate,literalOrdinals,objectToFormData,prePareFilters,pureURLS3,removeEmptyFields,removeFields,removeFieldsFromObject,removeFieldsTopLevel,removeIdFromObjects,removeItemsWithIds,removeKeys,searchInObjects,searchInObjectsWithParents,serializeFormQuery,sortObjectByKeys,sortObjectByValues,toQueryString,uniqueId,validateDay,validateMonth,validateYear});
+//# sourceMappingURL=index.cjs.map