@dxtmisha/functional-basic 1.7.1 → 1.8.0

package/dist/functions/domContentLoaded.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Executes a callback function when the DOMContentLoaded event is fired.
+ * If the DOM is already loaded (readyState is 'interactive' or 'complete') or if executing in a non-DOM environment,
+ * the callback is executed immediately.
+ *
+ * Выполняет функцию обратного вызова при наступлении события DOMContentLoaded.
+ * Если DOM уже загружен (readyState равен 'interactive' или 'complete') или код выполняется вне браузера,
+ * функция обратного вызова выполняется немедленно.
+ *
+ * @param callback function to execute when DOM is loaded / функция для выполнения при загрузке DOM
+ * @returns promise resolving to the callback result / промис, разрешающийся результатом выполнения функции
+ */
+export declare function domContentLoaded<T = void>(callback: () => T | Promise<T>): Promise<T>;

package/dist/functions/getRandomItem.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns a random element from an array, object, or value.
+ * If the input is empty or invalid, returns undefined.
+ *
+ * Возвращает случайный элемент из массива, объекта или значения.
+ * Если массив/объект пуст или значение отсутствует, возвращает undefined.
+ * @param value input array, object, or value / входной массив, объект или значение
+ * @returns random element or undefined if empty / случайный элемент или undefined, если пусто
+ */
+export declare function getRandomItem<T>(value?: T | T[] | Record<string, T>): T | undefined;

package/dist/functions/sortList.d.ts

@@ -0,0 +1,11 @@
+import { SortColumnItem, SortFunction } from '../types/sortTypes';
+/**
+ * Sorts an array of items by one or more column paths, directions, or a custom comparison function.
+ *
+ * Сортирует массив элементов по одному или нескольким путям колонок, направлениям или пользовательской функции сравнения.
+ * @param list input list array of items / входной список элементов
+ * @param sortColumns list of column sorting specifications / список спецификаций сортировки колонок
+ * @param customSort optional custom comparison function / необязательная пользовательская функция сравнения
+ * @returns new sorted array of items / новый отсортированный массив элементов
+ */
+export declare function sortList<T = any>(list: T[], sortColumns: SortColumnItem[], customSort?: SortFunction<T>): T[];

package/dist/functions/toNumberPositive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts a value to a positive finite number (> 0), or returns default value (0) if invalid.
+ *
+ * Преобразует значение в конечное положительное число (> 0) или возвращает значение по умолчанию (0), если невалидно.
+ * @param value input value / входное значение
+ * @param defaultValue default fallback value if invalid / значение по умолчанию, если невалидно
+ * @returns parsed positive number or defaultValue / распарсенное положительное число или defaultValue
+ */
+export declare function toNumberPositive(value?: number | string | null, defaultValue?: number): number;

package/dist/library.d.ts

@@ -68,6 +68,7 @@ export * from './functions/capitalize';
 export * from './functions/copyObject';
 export * from './functions/copyObjectLite';
 export * from './functions/createElement';
+export * from './functions/domContentLoaded';
 export * from './functions/domQuerySelector';
 export * from './functions/domQuerySelectorAll';
 export * from './functions/encodeAttribute';
@@ -109,6 +110,7 @@ export * from './functions/getObjectByKeys';
 export * from './functions/getObjectNoUndefined';
 export * from './functions/getObjectOrNone';
 export * from './functions/getOnlyText';
+export * from './functions/getRandomItem';
 export * from './functions/getRandomText';
 export * from './functions/getRequestString';
 export * from './functions/getSearchExp';
@@ -157,6 +159,7 @@ export * from './functions/secondToTime';
 export * from './functions/setElementItem';
 export * from './functions/setValues';
 export * from './functions/sleep';
+export * from './functions/sortList';
 export * from './functions/splice';
 export * from './functions/strFill';
 export * from './functions/strSplit';
@@ -167,6 +170,7 @@ export * from './functions/toDate';
 export * from './functions/toKebabCase';
 export * from './functions/toNumber';
 export * from './functions/toNumberByMax';
+export * from './functions/toNumberPositive';
 export * from './functions/toPercent';
 export * from './functions/toPercentBy100';
 export * from './functions/toString';
@@ -181,4 +185,5 @@ export * from './types/formattersTypes';
 export * from './types/geoTypes';
 export * from './types/metaTypes';
 export * from './types/searchTypes';
+export * from './types/sortTypes';
 export * from './types/translateTypes';