@dxtmisha/functional-basic 0.9.0 → 0.10.1

package/dist/library.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Adds a tag to highlight the match in the string.
+ *
+ * Добавляет тег для выделения совпадения в строке.
+ * @param value initial string / исходная строка
+ * @param search search string / строка поиска
+ * @param className highlighting class / класс выделения
+ */
+export declare function addTagHighlightMatch(value: string, search?: string, className?: string): string;
+
 /**
  * Conversion of a value to a string.
  *
@@ -1811,6 +1821,215 @@ export declare function executePromise<T>(callback: (() => Promise<T>) | (() =>
  */
 export declare function forEach<T, R, D extends T[] | Record<string, T> | Map<string, T> = T[] | Record<string, T> | Map<string, T>, K = D extends T[] ? number : string>(data: D & (T[] | Record<string, T> | Map<string, T>), callback: (item: T, key: K, dataMain: typeof data) => R, saveUndefined?: boolean): R[];
 
+/**
+ * Class for formatting a list of data based on provided options.
+ *
+ * Класс для форматирования списка данных на основе предоставленных параметров.
+ * @template Item - type of items in the list/ тип элементов в списке.
+ * @template Options - type of formatting options/ тип параметров форматирования.
+ * @template List - type of the list of items/ тип списка элементов.
+ */
+export declare class Formatters<Item extends FormattersListItem, Options extends FormattersOptionsList, List extends FormattersList<Item> = FormattersList<Item>> {
+    protected options: Options;
+    protected list?: List | undefined;
+    /**
+     * Constructor
+     *
+     * Конструктор
+     * @param options formatting options for each column/ property/
+     * параметры форматирования для каждого столбца/свойства
+     * @param list initial list of data to format/ начальный список данных для форматирования
+     */
+    constructor(options: Options, list?: List | undefined);
+    /**
+     * Returns the current list of data.
+     *
+     * Возвращает текущий список данных.
+     * @returns the list of data or undefined if not set/ список данных или undefined, если не задан
+     */
+    getList(): List | undefined;
+    /**
+     * Returns the current formatting options.
+     *
+     * Возвращает текущие параметры форматирования.
+     * @returns formatting options/ параметры форматирования
+     */
+    getOptions(): Options;
+    /**
+     * Sets the list of data to be formatted.
+     *
+     * Устанавливает список данных для форматирования.
+     * @param list list of data/ список данных
+     * @returns the Formatters instance for chaining/ экземпляр Formatters для цепочки вызовов
+     */
+    setList(list: List): this;
+    /**
+     * Formats the entire list based on the provided options.
+     * Adds formatted values with the suffix 'Format' to each item.
+     *
+     * Форматирует весь список на основе предоставленных параметров.
+     * Добавляет отформатированные значения с суффиксом 'Format' к каждому элементу.
+     * @returns the list of items with additional formatted columns/
+     * список элементов с дополнительными отформатированными столбцами
+     */
+    to(): FormattersListColumns<Item, Options>;
+    /**
+     * Generates formatted data for a single item based on options.
+     *
+     * Генерирует отформатированные данные для одного элемента на основе параметров.
+     * @param item item to format/ элемент для форматирования
+     * @protected
+     */
+    protected getFormatData(item: Item): Record<string, string>;
+    /**
+     * Router-like method to delegate formatting to specific type formatters.
+     *
+     * Метод-маршрутизатор для делегирования форматирования конкретным типам форматировщиков.
+     * @param valueOriginal original value to format/ исходное значение для форматирования
+     * @param item entire item context/ весь контекст элемента
+     * @param type type of formatter to use/ тип используемого форматировщика
+     * @param options additional options for the specific formatter/
+     * дополнительные параметры для конкретного форматировщика
+     * @protected
+     * @returns Formatted string/ отформатированная строка
+     */
+    protected transformation<Type extends FormattersType>(valueOriginal: any, item: any, type?: Type, options?: FormattersOptionsInformation<Type>): string;
+    /**
+     * Formats a value as currency.
+     *
+     * Форматирует значение как валюту.
+     * @param value value to format/ значение для форматирования
+     * @param item item context/ контекст элемента
+     * @param options currency formatting options/ параметры форматирования валюты
+     * @protected
+     * @returns Formatted currency string/ отформатированная строка валюты
+     */
+    protected formatCurrency(value: any, item: Item, options?: FormattersOptionsCurrency): string;
+    /**
+     * Formats a value as a date.
+     *
+     * Форматирует значение как дату.
+     * @param value value to format/ значение для форматирования
+     * @param options date formatting options/ параметры форматирования даты
+     * @protected
+     * @returns Formatted date string/ отформатированная строка даты
+     */
+    protected formatDate(value: any, options?: FormattersOptionsDate): string;
+    /**
+     * Formats full name from multiple property names.
+     *
+     * Форматирует полное имя из нескольких имен свойств.
+     * @param item item context containing name components/ контекст элемента, содержащий компоненты имени
+     * @param options name formatting options (prop names for first, last, surname)/
+     * параметры форматирования имени (имена свойств для имени, фамилии, отчества)
+     * @protected
+     * @returns Formatted name string or empty string if components are missing/
+     * отформатированная строка имени или пустая строка, если компоненты отсутствуют
+     */
+    protected formatName(item: Item, options?: FormattersOptionsName): string;
+    /**
+     * Formats a value as a number.
+     *
+     * Форматирует значение как число.
+     * @param value value to format/ значение для форматирования
+     * @param options number formatting options/ параметры форматирования числа
+     * @protected
+     * @returns Formatted number string/ отформатированная строка числа
+     */
+    protected formatNumber(value: any, options?: FormattersOptionsNumber): string;
+    /**
+     * Formats a value based on plural rules.
+     *
+     * Форматирует значение на основе правил множественного числа.
+     * @param value numeric value for pluralization/ числовое значение для плюрализации
+     * @param options plural formatting options (words and rules)/
+     * параметры форматирования множественного числа (слова и правила)
+     * @protected
+     * @returns Formatted plural string/ отформатированная строка множественного числа
+     */
+    protected formatPlural(value: any, options?: FormattersOptionsPlural): string;
+    /**
+     * Formats a value with a specific unit.
+     *
+     * Форматирует значение с определенной единицей измерения.
+     * @param value value to format/ значение для форматирования
+     * @param options unit formatting options/ параметры форматирования единиц измерения
+     * @protected
+     * @returns Formatted unit string/ отформатированная строка единицы измерения
+     */
+    protected formatUnit(value: any, options?: FormattersOptionsUnit): string;
+}
+
+export declare type FormattersCapitalize<K extends string> = K extends `${infer First}.${infer Rest}` ? `${First}${Capitalize<FormattersCapitalize<Rest>>}` : K;
+
+export declare type FormattersColumns<T extends FormattersOptionsList> = (keyof T & string)[];
+
+export declare type FormattersDataItem<T extends FormattersListItem, KT extends string[]> = {
+    [K in keyof T | FormattersKey<KT[number]>]: K extends keyof T ? T[K] : string;
+};
+
+export declare type FormattersKey<K, A extends string = 'Format'> = K extends string ? `${FormattersCapitalize<K>}${A}` : never;
+
+export declare type FormattersList<Item extends FormattersListItem> = Item[];
+
+export declare type FormattersListColumns<T extends FormattersListItem, O extends FormattersOptionsList> = FormattersListFormat<T, FormattersColumns<O>>;
+
+export declare type FormattersListFormat<T extends FormattersListItem, K extends string[]> = FormattersDataItem<T, K>[];
+
+export declare type FormattersListItem = Record<string, any>;
+
+export declare type FormattersOptionsCurrency = {
+    currencyPropName?: string;
+    options?: string | Intl.NumberFormatOptions;
+    numberOnly?: boolean;
+};
+
+export declare type FormattersOptionsDate = {
+    type?: GeoDate;
+    options?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions;
+    hour24?: boolean;
+};
+
+export declare type FormattersOptionsInformation<Type extends FormattersType> = Type extends FormattersType.currency ? FormattersOptionsCurrency : Type extends FormattersType.date ? FormattersOptionsDate : Type extends FormattersType.name ? FormattersOptionsName : Type extends FormattersType.number ? FormattersOptionsNumber : Type extends FormattersType.plural ? FormattersOptionsPlural : Type extends FormattersType.unit ? FormattersOptionsUnit : Record<string, any>;
+
+export declare type FormattersOptionsItem<Type extends FormattersType = FormattersType, R = string> = {
+    type?: Type;
+    transformation?: (valueOriginal: any, item: any, options?: FormattersOptionsInformation<Type>) => R;
+    options?: FormattersOptionsInformation<Type>;
+};
+
+export declare type FormattersOptionsList = Record<string, FormattersOptionsItem>;
+
+export declare type FormattersOptionsName = {
+    lastPropName?: string;
+    firstPropName?: string;
+    surname?: string;
+    short?: boolean;
+};
+
+export declare type FormattersOptionsNumber = {
+    options?: Intl.NumberFormatOptions;
+};
+
+export declare type FormattersOptionsPlural = {
+    words: string;
+    options?: Intl.PluralRulesOptions;
+    optionsNumber?: Intl.NumberFormatOptions;
+};
+
+export declare type FormattersOptionsUnit = {
+    unit: string | Intl.NumberFormatOptions;
+};
+
+export declare enum FormattersType {
+    currency = "currency",
+    date = "date",
+    name = "name",
+    number = "number",
+    plural = "plural",
+    unit = "unit"
+}
+
 /**
  * Cyclically calls requestAnimationFrame until next returns true
  * The window.requestAnimationFrame() method tells the browser that you wish to perform
@@ -2643,6 +2862,14 @@ export declare function getElementItem<T extends ElementOrWindow, K extends keyo
  */
 export declare function getElementOrWindow<E extends ElementOrWindow>(element?: ElementOrString<E>): E | undefined;
 
+/**
+ * Creates a case-insensitive regular expression for an exact match of a phrase (without anchors).
+ *
+ * Создает регистронезависимое регулярное выражение для точного совпадения фразы (без якорей).
+ * @param search search string / строка поиска
+ */
+export declare function getExactSearchExp(search: string): RegExp;
+
 /**
  * The object is used for matching text with a pattern.
  *
@@ -2782,6 +3009,14 @@ export declare function getRequestString(request: Record<string, any>, sign?: st
  */
 export declare function getSearchExp(search: string): RegExp;
 
+/**
+ * Creates a case-insensitive regular expression for a search by words (separating by space).
+ *
+ * Создает регистронезависимое регулярное выражение для поиска по словам (разделение пробелом).
+ * @param search search string / строка поиска
+ */
+export declare function getSeparatingSearchExp(search: string): RegExp;
+
 /**
  * Returns the unit of measurement for 1 step
  *
@@ -2801,9 +3036,9 @@ export declare function getStepPercent(min: number | undefined, max: number): nu
 export declare function getStepValue(min: number | undefined, max: number): number;
 
 /**
- * Class for obtaining global data.
+ * Static utility class for storing and retrieving application-wide global data.
  *
- * Класс для получения глобальных данных.
+ * Статический служебный класс для хранения и получения глобальных данных приложения.
  */
 export declare class Global {
     /**
@@ -2886,6 +3121,14 @@ export declare class Hash {
      * @param callback the function is called when the data is changed/ функция вызывается при изменении данных
      */
     static addWatch<T>(name: string, callback: (value: T) => void): void;
+    /**
+     * Removing an event when data is changed.
+     *
+     * Удаление события при изменении данных.
+     * @param name variable names/ названия переменных
+     * @param callback the function is called when the data is changed/ функция вызывается при изменении данных
+     */
+    static removeWatch<T>(name: string, callback: (value: T) => void): void;
     /**
      * Update hash variable from URL string.
      *
@@ -3245,12 +3488,19 @@ export declare type ItemValue<V> = {
 export declare class Loading {
     protected static value: number;
     protected static event?: EventItem<Window, CustomEvent>;
+    protected static registrationList: LoadingRegistrationItem[];
     /**
      * Check if the loader is active now.
      *
      * Проверить, активен ли сейчас загрузчик.
      */
     static is(): boolean;
+    /**
+     * Get current loading value.
+     *
+     * Получить текущее значение загрузки.
+     */
+    static get(): number;
     /**
      * Shows the loader.
      *
@@ -3273,6 +3523,16 @@ export declare class Loading {
      * @param element element/ элемент
      */
     static registrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
+    /**
+     * Unregistration of an event.
+     *
+     * Отмена регистрации события.
+     * @param listener the object that receives a notification (an object that implements the
+     * Event interface) when an event of the specified type occurs/ объект, который принимает
+     * уведомление, когда событие указанного типа произошло
+     * @param element element/ элемент
+     */
+    static unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
     /**
      * Calls the event listener.
      *
@@ -3285,6 +3545,12 @@ declare type LoadingDetail = {
     loading: boolean;
 };
 
+declare type LoadingRegistrationItem = {
+    item: EventItem<Window, CustomEvent, LoadingDetail>;
+    listener: EventListenerDetail<CustomEvent, LoadingDetail>;
+    element?: ElementOrString<HTMLElement>;
+};
+
 /**
  * Unified class for managing all types of meta tags (standard HTML, Open Graph, Twitter Card).
  *
@@ -4470,6 +4736,18 @@ export declare class ScrollbarWidth {
      * Возвращает ширину скролла.
      */
     static get(): Promise<number>;
+    /**
+     * Returns the storage.
+     *
+     * Возвращает хранилище.
+     */
+    static getStorage(): DataStorage<number>;
+    /**
+     * Returns the calculate flag.
+     *
+     * Возвращает флаг вычисления.
+     */
+    static getCalculate(): boolean;
     /**
      * Creates elements to check the width of the scroll.
      *
@@ -4484,6 +4762,490 @@ export declare class ScrollbarWidth {
     private static init;
 }
 
+/** Search cache list / Список кэша поиска */
+export declare type SearchCache<T extends SearchItem> = SearchCacheItem<T>[];
+
+/** Search cache item / Элемент кэша поиска */
+export declare type SearchCacheItem<T extends SearchItem> = {
+    /** Original item / Исходный элемент */
+    item: T;
+    /** Search string value / Строковое значение для поиска */
+    value: string;
+};
+
+/** Type for getting a column / Тип для получения колонки */
+export declare type SearchColumn<T extends SearchItem> = {
+    [K in keyof T]-?: NonNullable<T[K]> extends object ? K | SearchColumnPath<K, keyof NonNullable<T[K]>> : K;
+}[keyof T];
+
+/** Type for generating a column path / Тип для генерации пути к колонке */
+export declare type SearchColumnPath<K, P> = K extends string ? P extends string ? `${K}.${P}` : never : never;
+
+/** Type for a list of columns / Тип для списка колонок */
+export declare type SearchColumns<T extends SearchItem> = (SearchColumn<T> & string)[];
+
+/** Type for formatting the key / Тип для форматирования ключа */
+export declare type SearchFormatCapitalize<K extends string> = K extends `${infer First}.${infer Rest}` ? `${First}${Capitalize<SearchFormatCapitalize<Rest>>}` : K;
+
+/** Type for a formatted search item / Тип для отформатированного элемента поиска */
+export declare type SearchFormatItem<T extends SearchItem, KT extends string[]> = {
+    [K in keyof T | SearchFormatKey<KT[number]>]: K extends keyof T ? T[K] : string;
+} & {
+    searchActive?: boolean;
+};
+
+/** Type for generating a search key / Тип для генерации ключа поиска */
+export declare type SearchFormatKey<K> = K extends string ? `${SearchFormatCapitalize<K>}Search` : never;
+
+/** Type for a list of formatted search items / Тип для списка отформатированных элементов поиска */
+export declare type SearchFormatList<T extends SearchItem, K extends string[]> = SearchFormatItem<T, K>[];
+
+/** Search item type/ Тип элемента поиска */
+export declare type SearchItem = Record<string, any>;
+
+/**
+ * Main class for managing a searchable list.
+ * Coordinates between options, item state, matching logic, and data storage.
+ *
+ * Основной класс для управления списком с возможностью поиска.
+ * Координирует работу опций, состояния элементов, логики сопоставления и хранения данных.
+ */
+export declare class SearchList<T extends SearchItem, K extends SearchColumns<T>> {
+    protected options: SearchListOptions;
+    protected item: SearchListItem;
+    protected matcher: SearchListMatcher;
+    protected data: SearchListData<T, K>;
+    /**
+     * Constructor for SearchList.
+     *
+     * Конструктор для SearchList.
+     * @param list initial list of items/ исходный список элементов
+     * @param columns columns to perform search on/ столбцы для выполнения поиска
+     * @param value initial search value/ начальное значение поиска
+     * @param options search options/ опции поиска
+     */
+    constructor(list: SearchListValue<T>, columns?: K, value?: string, options?: SearchOptions);
+    /**
+     * Returns the search data management instance.
+     *
+     * Возвращает экземпляр управления данными поиска.
+     * @returns SearchListData instance/ экземпляр SearchListData
+     */
+    getData(): SearchListData<T, K>;
+    /**
+     * Returns the current list of items.
+     *
+     * Возвращает текущий список элементов.
+     * @returns list of items/ список элементов
+     */
+    getList(): SearchListValue<T>;
+    /**
+     * Returns the current search columns.
+     *
+     * Возвращает текущие столбцы поиска.
+     * @returns columns or undefined/ столбцы или undefined
+     */
+    getColumns(): K | undefined;
+    /**
+     * Returns the search item instance.
+     *
+     * Возвращает экземпляр элемента поиска.
+     * @returns SearchListItem instance/ экземпляр SearchListItem
+     */
+    getItem(): SearchListItem;
+    /**
+     * Returns the current search value.
+     *
+     * Возвращает текущее значение поиска.
+     * @returns search value string or undefined/ строка значения поиска или undefined
+     */
+    getValue(): string | undefined;
+    /**
+     * Returns the search options instance.
+     *
+     * Возвращает экземпляр опций поиска.
+     * @returns SearchListOptions instance/ экземпляр SearchListOptions
+     */
+    getOptions(): SearchListOptions;
+    /**
+     * Sets a new list of items.
+     *
+     * Устанавливает новый список элементов.
+     * @param list new list/ новый список
+     * @returns this instance/ данный экземпляр
+     */
+    setList(list: SearchListValue<T>): this;
+    /**
+     * Sets new search columns.
+     *
+     * Устанавливает новые столбцы поиска.
+     * @param columns new columns/ новые столбцы
+     * @returns this instance/ данный экземпляр
+     */
+    setColumns(columns?: K): this;
+    /**
+     * Sets a new search value and updates the matcher.
+     *
+     * Устанавливает новое значение поиска и обновляет сопоставитель.
+     * @param value new search value/ новое значение поиска
+     * @returns this instance/ данный экземпляр
+     */
+    setValue(value?: string): this;
+    /**
+     * Sets new search options and updates the matcher.
+     *
+     * Устанавливает новые опции поиска и обновляет сопоставитель.
+     * @param options new options/ новые опции
+     * @returns this instance/ данный экземпляр
+     */
+    setOptions(options: SearchOptions): this;
+    /**
+     * Processes the list and returns a formatted list of items based on the current search state.
+     *
+     * Обрабатывает список и возвращает отформатированный список элементов на основе текущего состояния поиска.
+     * @returns formatted list of items/ отформатированный список элементов
+     */
+    to(): SearchFormatList<T, K>;
+    /**
+     * Callback for processing items when a search is active.
+     * Checks for selection and handles "return everything" option.
+     *
+     * Обратный вызов для обработки элементов при активном поиске.
+     * Проверяет выбор и обрабатывает опцию "возвращать всё".
+     */
+    protected readonly callbackToSelection: (item: SearchCacheItem<T>["item"], value: SearchCacheItem<T>["value"]) => SearchFormatItem<T, K> | undefined;
+    /**
+     * Callback for processing items when no search is active.
+     *
+     * Обратный вызов для обработки элементов, когда поиск не активен.
+     */
+    protected readonly callbackToNone: (item: SearchCacheItem<T>["item"]) => SearchFormatItem<T, K>;
+}
+
+/**
+ * Class for managing and formatting the search data list and its cache.
+ *
+ * Класс для управления и форматирования списка данных поиска и его кэша.
+ */
+export declare class SearchListData<T extends SearchItem, K extends SearchColumns<T>> {
+    protected list: SearchListValue<T>;
+    protected columns: K | undefined;
+    protected item: SearchListItem;
+    protected options: SearchListOptions;
+    protected listCache?: SearchCache<T>;
+    /**
+     * Constructor for SearchListData.
+     *
+     * Конструктор для SearchListData.
+     * @param list original list of items/ исходный список элементов
+     * @param columns columns to search in/ столбцы для поиска
+     * @param item current search item state/ текущее состояние элемента поиска
+     * @param options search options/ опции поиска
+     */
+    constructor(list: SearchListValue<T>, columns: K | undefined, item: SearchListItem, options: SearchListOptions);
+    /**
+     * Checks if both list and columns are provided.
+     *
+     * Проверяет, предоставлены ли и список, и столбцы.
+     * @returns boolean indicating if ready for column-based search/ логическое значение, указывающее на готовность к поиску по столбцам
+     */
+    is(): this is this & {
+        list: T[];
+        columns: string[];
+    };
+    /**
+     * Checks if the list is provided.
+     *
+     * Проверяет, предоставлен ли список.
+     * @returns boolean/ логическое значение
+     */
+    isList(): this is this & {
+        list: T[];
+    };
+    /**
+     * Returns the original list.
+     *
+     * Возвращает исходный список.
+     * @returns list value/ значение списка
+     */
+    getList(): SearchListValue<T>;
+    /**
+     * Returns the search columns.
+     *
+     * Возвращает столбцы поиска.
+     * @returns columns or undefined/ столбцы или undefined
+     */
+    getColumns(): K | undefined;
+    /**
+     * Gets the search cache, initializing it if necessary.
+     *
+     * Получает кэш поиска, инициализируя его при необходимости.
+     * @returns search cache/ кэш поиска
+     */
+    protected getCache(): SearchCache<T>;
+    /**
+     * Sets a new list and regenerates the cache.
+     *
+     * Устанавливает новый список и регенерирует кэш.
+     * @param list new list/ новый список
+     * @returns this instance/ данный экземпляр
+     */
+    setList(list: SearchListValue<T>): this;
+    /**
+     * Sets new search columns and regenerates the cache.
+     *
+     * Устанавливает новые столбцы поиска и регенерирует кэш.
+     * @param columns new columns/ новые столбцы
+     * @returns this instance/ данный экземпляр
+     */
+    setColumns(columns?: SearchColumns<T>): this;
+    /**
+     * Finds a cached item corresponding to the given original item.
+     *
+     * Находит кэшированный элемент, соответствующий данному исходному элементу.
+     * @param item original item/ исходный элемент
+     * @returns cache item or undefined/ кэшированный элемент или undefined
+     */
+    findCacheItem(item: T): SearchCacheItem<T> | undefined;
+    /**
+     * Iterates over the cached list and executes a callback for each item.
+     *
+     * Перебирает кэшированный список и выполняет обратный вызов для каждого элемента.
+     * @param callback function to execute for each item/ функция для выполнения для каждого элемента
+     * @returns formatted list/ отформатированный список
+     */
+    forEach(callback: (item: SearchCacheItem<T>['item'], value: SearchCacheItem<T>['value']) => SearchFormatItem<T, K> | undefined): SearchFormatList<T, K>;
+    /**
+     * Converts a single item to a formatted item with highlighted matches if selected.
+     *
+     * Преобразует один элемент в отформатированный элемент с выделенными совпадениями, если он выбран.
+     * @param item original item/ исходный элемент
+     * @param selection whether the item matches the search and should be highlighted/ совпадает ли элемент с поиском и должен ли он быть выделен
+     * @returns formatted item/ отформатированный элемент
+     */
+    toFormatItem(item: T, selection: boolean): SearchFormatItem<T, K>;
+    /**
+     * Formats a column path to a camelCase property name with a 'Search' suffix.
+     *
+     * Форматирует путь к столбцу в имя свойства camelCase с суффиксом 'Search'.
+     * @param column column path/ путь к столбцу
+     * @returns property name/ имя свойства
+     */
+    protected getColumnName(column: string): string;
+    /**
+     * Adds highlight tags to the given value based on the current search value.
+     *
+     * Добавляет теги выделения к данному значению на основе текущего значения поиска.
+     * @param value value to highlight/ значение для выделения
+     * @returns highlighted string/ выделенная строка
+     */
+    protected addTag(value: any): string;
+    /**
+     * Generates a search cache for the current list and columns.
+     *
+     * Генерирует кэш поиска для текущего списка и столбцов.
+     * @returns search cache/ кэш поиска
+     */
+    protected generateCache(): SearchCache<T>;
+    /**
+     * Initializes the search cache.
+     *
+     * Инициализирует кэш поиска.
+     */
+    protected initCache(): void;
+    /**
+     * Resets the search cache.
+     *
+     * Сбрасывает кэш поиска.
+     */
+    protected resetCache(): void;
+}
+
+/**
+ * Class representing a single search item's value and its search-related state.
+ *
+ * Класс, представляющий значение одного элемента поиска и его состояние, связанное с поиском.
+ */
+export declare class SearchListItem {
+    protected value: string | undefined;
+    protected options: SearchListOptions;
+    /**
+     * Constructor for SearchListItem.
+     *
+     * Конструктор для SearchListItem.
+     * @param value current search value/ текущее значение поиска
+     * @param options search options/ опции поиска
+     */
+    constructor(value: string | undefined, options: SearchListOptions);
+    /**
+     * Checks if the value is filled.
+     *
+     * Проверяет, заполнено ли значение.
+     * @returns boolean indicating if value exists/ логическое значение, указывающее на наличие значения
+     */
+    is(): this is this & {
+        value: string;
+    };
+    /**
+     * Checks if a search should be performed based on the current value and options.
+     *
+     * Проверяет, следует ли выполнять поиск на основе текущего значения и опций.
+     * @returns boolean/ логическое значение
+     */
+    isSearch(): boolean;
+    /**
+     * Returns the current search value as a string.
+     *
+     * Возвращает текущее значение поиска в виде строки.
+     * @returns search value/ значение поиска
+     */
+    get(): string;
+    /**
+     * Sets a new search value.
+     *
+     * Устанавливает новое значение поиска.
+     * @param value new search value/ новое значение поиска
+     * @returns this instance/ данный экземпляр
+     */
+    set(value?: string): this;
+}
+
+/**
+ * Class responsible for matching search values against the search list data using regular expressions.
+ *
+ * Класс, отвечающий за сопоставление значений поиска с данными списка поиска с использованием регулярных выражений.
+ */
+export declare class SearchListMatcher {
+    protected item: SearchListItem;
+    protected options: SearchListOptions;
+    protected matcher: RegExp | undefined;
+    /**
+     * Constructor for SearchListMatcher.
+     *
+     * Конструктор для SearchListMatcher.
+     * @param item search item containing the current value/ элемент поиска, содержащий текущее значение
+     * @param options search options/ опции поиска
+     */
+    constructor(item: SearchListItem, options: SearchListOptions);
+    /**
+     * Checks if the matcher is initialized.
+     *
+     * Проверяет, инициализирован ли сопоставитель.
+     * @returns boolean/ логическое значение
+     */
+    is(): boolean;
+    /**
+     * Checks if the given value matches the current search expression.
+     *
+     * Проверяет, соответствует ли данное значение текущему поисковому выражению.
+     * @param value value to check/ проверяемое значение
+     * @returns boolean indicating a match/ логическое значение, указывающее на совпадение
+     */
+    isSelection(value: SearchCacheItem<any>['value']): boolean;
+    /**
+     * Returns the current regular expression matcher.
+     *
+     * Возвращает текущий сопоставитель регулярных выражений.
+     * @returns RegExp or undefined/ RegExp или undefined
+     */
+    get(): RegExp | undefined;
+    /**
+     * Updates the matcher based on the current item value and options.
+     *
+     * Обновляет сопоставитель на основе текущего значения элемента и опций.
+     */
+    update(): void;
+    /**
+     * Initializes or resets the regular expression matcher.
+     *
+     * Инициализирует или сбрасывает сопоставитель регулярных выражений.
+     */
+    protected initMatcher(): void;
+}
+
+/**
+ * Class for managing search list options.
+ *
+ * Класс для управления опциями списка поиска.
+ */
+export declare class SearchListOptions {
+    protected options?: SearchOptions | undefined;
+    /**
+     * Constructor for SearchListOptions.
+     *
+     * Конструктор для SearchListOptions.
+     * @param options search options/ опции поиска
+     */
+    constructor(options?: SearchOptions | undefined);
+    /**
+     * Returns the current search options.
+     *
+     * Возвращает текущие опции поиска.
+     * @returns search options/ опции поиска
+     */
+    getOptions(): SearchOptions;
+    /**
+     * Returns the minimum number of characters required to trigger a search.
+     *
+     * Возвращает минимальное количество символов, необходимых для запуска поиска.
+     * @returns limit value/ значение лимита
+     */
+    getLimit(): number;
+    /**
+     * Returns whether to return all items even if they don't match the search query.
+     *
+     * Возвращает, следует ли возвращать все элементы, даже если они не соответствуют поисковому запросу.
+     * @returns boolean value/ логическое значение
+     */
+    getReturnEverything(): boolean;
+    /**
+     * Returns the search delay in milliseconds.
+     *
+     * Возвращает задержку поиска в миллисекундах.
+     * @returns delay value/ значение задержки
+     */
+    getDelay(): number;
+    /**
+     * Returns whether to perform an exact match search.
+     *
+     * Возвращает, следует ли выполнять поиск с точным совпадением.
+     * @returns boolean value/ логическое значение
+     */
+    getFindExactMatch(): boolean;
+    /**
+     * Returns the CSS class name used for highlighting matches.
+     *
+     * Возвращает имя класса CSS, используемое для выделения совпадений.
+     * @returns class name/ имя класса
+     */
+    getClassName(): string;
+    /**
+     * Sets new search options.
+     *
+     * Устанавливает новые опции поиска.
+     * @param options search options/ опции поиска
+     * @returns this instance/ данный экземпляр
+     */
+    setOptions(options: SearchOptions): this;
+}
+
+/** Search list value / Значение списка поиска */
+export declare type SearchListValue<T extends SearchItem> = T[] | undefined;
+
+/** Search options / Опции поиска */
+export declare type SearchOptions = {
+    /** Limit of output values / Лимит выводимых значений */
+    limit?: number;
+    /** Whether to return all items even if no match / Возвращать ли все элементы, даже если совпадений нет */
+    returnEverything?: boolean;
+    /** Delay before searching / Задержка перед поиском */
+    delay?: number;
+    /** Find exact match / Найти точное совпадение */
+    findExactMatch?: boolean;
+    /** CSS class for matches / CSS класс для совпадений */
+    classSearchName?: string;
+};
+
 /**
  * Converts seconds into a time string.
  *