@dxtmisha/functional-basic 1.7.1 → 1.8.1

package/dist/classes/ErrorCenter.d.ts

@@ -1,5 +1,5 @@
 import { ErrorCenterInstance } from './ErrorCenterInstance';
-import { ErrorCenterCauseItem, ErrorCenterCauseList, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerList } from '../types/errorCenter';
+import { ErrorCenterCauseItem, ErrorCenterCauseList, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerIsConsole, ErrorCenterHandlerList } from '../types/errorCenterTypes';
 /**
  * Class for managing error storage and handling.
  *
@@ -69,6 +69,13 @@ export declare class ErrorCenter {
      * @param callback callback function / функция обратного вызова
      */
     static addCallback(callback: ErrorCenterHandlerCallback): void;
+    /**
+     * Sets console output flag or filter function.
+     *
+     * Устанавливает флаг или функцию фильтрации вывода в консоль.
+     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
+     */
+    static setIsConsole(isConsole: ErrorCenterHandlerIsConsole): void;
     /**
      * Triggers error handling for a group.
      *

package/dist/classes/ErrorCenterHandler.d.ts

@@ -1,4 +1,4 @@
-import { ErrorCenterCauseItem, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerItem, ErrorCenterHandlerList } from '../types/errorCenter';
+import { ErrorCenterCauseItem, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerIsConsole, ErrorCenterHandlerItem, ErrorCenterHandlerList } from '../types/errorCenterTypes';
 /**
  * Class for managing and triggering error handlers.
  *
@@ -9,11 +9,14 @@ export declare class ErrorCenterHandler {
     protected handlers: ErrorCenterHandlerList;
     /** Callbacks executed on every error / Обратные вызовы, выполняемые при каждой ошибке */
     protected callbacks: ErrorCenterHandlerCallback[];
+    /** Console output flag or filter function / Флаг или функция фильтрации вывода в консоль */
+    protected isConsole: ErrorCenterHandlerIsConsole;
     /**
      * Constructor
      * @param handlers initial handlers list / начальный список обработчиков
+     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
      */
-    constructor(handlers?: ErrorCenterHandlerList);
+    constructor(handlers?: ErrorCenterHandlerList, isConsole?: ErrorCenterHandlerIsConsole);
     /**
      * Checks if handlers exist for a group.
      *
@@ -55,6 +58,14 @@ export declare class ErrorCenterHandler {
      * @returns this instance / текущий экземпляр
      */
     addCallback(callback: ErrorCenterHandlerCallback): this;
+    /**
+     * Sets console output flag or filter function.
+     *
+     * Устанавливает флаг или функцию фильтрации вывода в консоль.
+     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
+     * @returns this instance / текущий экземпляр
+     */
+    setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
     /**
      * Triggers handlers for a group and logs to console.
      *

package/dist/classes/ErrorCenterInstance.d.ts

@@ -1,5 +1,5 @@
 import { ErrorCenterHandler } from './ErrorCenterHandler';
-import { ErrorCenterCauseItem, ErrorCenterCauseList, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerList } from '../types/errorCenter';
+import { ErrorCenterCauseItem, ErrorCenterCauseList, ErrorCenterGroup, ErrorCenterHandlerCallback, ErrorCenterHandlerIsConsole, ErrorCenterHandlerList } from '../types/errorCenterTypes';
 /**
  * Class for managing error storage and handling within an instance.
  *
@@ -74,6 +74,14 @@ export declare class ErrorCenterInstance {
      * @returns this instance / текущий экземпляр
      */
     addCallback(callback: ErrorCenterHandlerCallback): this;
+    /**
+     * Sets console output flag or filter function for the handler.
+     *
+     * Устанавливает флаг или функцию фильтрации вывода в консоль для обработчика.
+     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
+     * @returns this instance / текущий экземпляр
+     */
+    setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
     /**
      * Triggers error handling for a group.
      *

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';
@@ -176,9 +180,10 @@ export * from './functions/uniqueArray';
 export * from './functions/writeClipboardData';
 export * from './types/apiTypes';
 export * from './types/basicTypes';
-export * from './types/errorCenter';
+export * from './types/errorCenterTypes';
 export * from './types/formattersTypes';
 export * from './types/geoTypes';
 export * from './types/metaTypes';
 export * from './types/searchTypes';
+export * from './types/sortTypes';
 export * from './types/translateTypes';