fui-material 2.8.18 → 2.8.20

package/dist/types/hooks/index.d.ts

@@ -2,3 +2,5 @@ export { default as useFApi } from "./useFApi";
 export { default as useFApiMutation } from "./useFApiMutation";
 export { default as useFApiQuery } from "./useFApiQuery";
 export { default as useFManualApiQuery } from "./useFManualApiQuery";
+export { default as useFManualPagination } from "./useFManualPagination";
+export * from "./useFManualPagination/types";

package/dist/types/hooks/useFManualApiQuery/index.d.ts

@@ -1 +1,2 @@
 export { default } from "./useFManualApiQuery";
+export * from "./useFManualApiQuery";

package/dist/types/hooks/useFManualApiQuery/useFManualApiQuery.d.ts

@@ -7,11 +7,16 @@ import { ExtraOptions } from "../types";
  */
 export interface IUseFManualApiQueryRun<T> {
     /** Новые основные параметры запроса (передаются как `data` в POST или `params` в GET) */
-    newParams?: T;
+    newParams?: Partial<T> | T;
     /** Дополнительные URL-параметры (query string) */
     newUrlParams?: Record<string, unknown>;
     /** Если `true`, сохраняет предыдущие `params`, если `newParams` не был передан */
     preserveParams?: boolean;
+    /**
+     * Если true — объединяет newParams с текущими params ({ ...params, ...newParams }).
+     * Критично для POST-пагинации, чтобы обновлять только { page: 2 } без потери фильтров.
+     */
+    mergeParams?: boolean;
     /** Добавочный суффикс к URL (например, `/export` или `/:id`) */
     dopUrl?: string;
     /** Если `true`, объединяет новые `newUrlParams` со старыми вместо перезаписи */

package/dist/types/hooks/useFManualPagination/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './useFManualPagination';
+export * from './types';

package/dist/types/hooks/useFManualPagination/types.d.ts

@@ -0,0 +1,105 @@
+import { AxiosError, AxiosRequestConfig } from "axios";
+import { IFPagination } from "@material/FPagination/FPagination";
+import { ExtraOptions } from "../types";
+export interface IBackendPageMeta {
+    /** Общее количество элементов (поддерживает totalItems и totalElements) */
+    totalItems: number;
+    /** Размер страницы */
+    size: number;
+    /** Общее количество страниц */
+    totalPages: number;
+    /** Номер текущей страницы */
+    number: number;
+}
+/**
+ * Базовый формат ответа бекенда (для обратной совместимости)
+ */
+export interface IStandardBackendResponse<TResult = unknown, TMeta = Record<string, unknown>> {
+    meta?: TMeta;
+    page: IBackendPageMeta;
+    result?: TResult;
+    [key: string]: unknown;
+}
+export interface ISubmitFiltersOptions<TFilters> {
+    /** Данные формы фильтров */
+    payload: TFilters;
+    /** Сбрасывать ли номер страницы на 1 при новой фильтрации (по умолчанию true) */
+    resetPage?: boolean;
+    /** Добавочный суффикс к URL (например, /export) */
+    dopUrl?: string;
+}
+/**
+ * Опции для универсального хука `useFManualPagination`
+ *
+ * @template TQueryFnData - Тип сырого ответа сервера (например, AsvActivitiesFetchResp или Spring Data Page)
+ * @template TData - Тип извлеченных данных после select (по умолчанию TQueryFnData)
+ * @template TFilters - Тип параметров фильтрации (POST body или query params)
+ */
+export interface IUseFManualPaginationOptions<TQueryFnData = unknown, TData = TQueryFnData, TFilters = Record<string, unknown>> extends ExtraOptions {
+    /** Базовый ключ TanStack Query */
+    queryKey: string;
+    /** URL эндпоинта */
+    url: string;
+    /** Размер страницы по умолчанию (дефолт 20) */
+    defaultPageSize?: number;
+    /** Начальные фильтры (если требуются) */
+    initialFilters?: TFilters;
+    /** Метод запроса (по умолчанию 'POST') */
+    method?: 'GET' | 'POST';
+    /** Конфиг Axios (заголовки, таймауты и др.) */
+    config?: Omit<AxiosRequestConfig, 'params' | 'data' | 'method'>;
+    /**
+     * Режим работы пагинации:
+     * - 'pagination' (по умолчанию): смена страницы заменяет данные (для классической пагинации)
+     * - 'infinite': смена страницы конкатенирует данные (для бесконечного скролла)
+     */
+    mode?: 'pagination' | 'infinite';
+    /**
+     * Селектор для извлечения данных из сырого ответа сервера (полный аналог `select` в TanStack Query).
+     * Пример: (data) => data._embedded.asvActivities
+     * Пример: (data) => data.tables
+     * Если не передан, пытается взять data.result ?? data.items ?? data.content ?? data.
+     */
+    select?: (data: TQueryFnData) => TData;
+    /**
+     * Селектор для извлечения метаданных пагинации из сырого ответа сервера.
+     * По умолчанию ищет поле `data.page` или `data.pagination` и нормализует totalItems / totalElements.
+     * Пример: (data) => data.page
+     */
+    selectPage?: (data: TQueryFnData) => IBackendPageMeta | undefined;
+    /**
+     * Кастомная функция объединения данных для режима `infinite`.
+     * По умолчанию объединяет массивы: [...(prev ?? []), ...next]
+     */
+    appendData?: (prev: TData | undefined, next: TData) => TData;
+}
+export interface IUseFManualPaginationResult<TData, TFilters = Record<string, unknown>, TQueryFnData = unknown> {
+    /** Типизированные данные после применения `select` */
+    data: TData | undefined;
+    /** Алиас для `data` (для обратной совместимости) */
+    result: TData | undefined;
+    /** Сырой ответ сервера до `select` */
+    rawResponse: TQueryFnData | undefined;
+    /** Метаданные отчета (если присутствуют в ответе) */
+    meta: Record<string, unknown> | undefined;
+    /** Нормализованные метаданные пагинации бекенда */
+    pageMeta: IBackendPageMeta | undefined;
+    /** Идет ли первичный запрос данных */
+    isLoading: boolean;
+    /** Идет ли фоновая подгрузка / смена страницы */
+    isFetching: boolean;
+    /** Идет ли подгрузка следующей страницы в режиме infinite scroll */
+    isFetchingMore: boolean;
+    /** Есть ли еще страницы для подгрузки (number < totalPages) */
+    hasMore: boolean;
+    /** Ошибка запроса */
+    error: AxiosError | null;
+    /** Запуск запроса по кнопке с передачей payload */
+    submitFilters: (options: ISubmitFiltersOptions<TFilters>) => Promise<TData>;
+    /** Ручная смена страницы (переход на конкретный номер) */
+    changePage: (newPage: number) => Promise<TData>;
+    /** Подгрузка следующей страницы (для бесконечного скролла) */
+    loadMore: () => Promise<TData | undefined>;
+    /** Готовые пропсы для передачи в <FPagination {...paginationProps} /> */
+    paginationProps: IFPagination;
+}

package/dist/types/hooks/useFManualPagination/useFManualPagination.d.ts

@@ -0,0 +1,3 @@
+import { IUseFManualPaginationOptions, IUseFManualPaginationResult } from './types';
+export declare function useFManualPagination<TQueryFnData = unknown, TData = TQueryFnData, TFilters extends Record<string, unknown> = Record<string, unknown>>(options: IUseFManualPaginationOptions<TQueryFnData, TData, TFilters>): IUseFManualPaginationResult<TData, TFilters, TQueryFnData>;
+export default useFManualPagination;

package/dist/types/material/FOpenImgFull/FOpenImgFull.d.ts

@@ -8,6 +8,8 @@ export interface IFOpenImgFull {
     setSelectedImg: (index: number) => void;
     handleClose?: () => void;
     openAndClose: boolean;
+    fileName?: string;
+    fileNames?: string[];
 }
 declare const FOpenImgFull: FC<IFOpenImgFull>;
 export default FOpenImgFull;

package/dist/types/material/FProgressiveList/FProgressiveList.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { IFProgressiveListProps } from './types';
+export declare function FProgressiveList<T>({ items, chunkSize, estimatedItemHeight, keyExtractor, className, st, showProgress, renderProgress, children, onLoadMore, hasMore, isLoadingMore, loader, threshold }: IFProgressiveListProps<T>): React.ReactElement;
+export default FProgressiveList;

package/dist/types/material/FProgressiveList/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './FProgressiveList';
+export * from './types';

package/dist/types/material/FProgressiveList/types.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+export interface IFProgressiveListProps<T> {
+    /** Массив исходных данных (например, 100 объектов таблиц) */
+    items: T[];
+    /** Количество элементов, монтируемых за один кадр анимации (по умолчанию 6) */
+    chunkSize?: number;
+    /** Примерная высота одного блока в px для исключения скачков скролла (по умолчанию 280) */
+    estimatedItemHeight?: number;
+    /** Функция генерации стабильного уникального ключа */
+    keyExtractor: (item: T, index: number) => string | number;
+    /** Дополнительный CSS класс для контейнера */
+    className?: string;
+    /** Инлайновые стили контейнера */
+    st?: React.CSSProperties;
+    /** Показывать ли индикатор достройки блоков при переданном `renderProgress` (дефолт true) */
+    showProgress?: boolean;
+    /** Кастомный рендер индикатора прогресса/догрузки. Если не передан — индикатор по умолчанию не отображается */
+    renderProgress?: (rendered: number, total: number) => React.ReactNode;
+    /** Ленивая функция отрисовки каждого элемента (Function as Child) */
+    children: (item: T, index: number) => React.ReactNode;
+    /**
+     * Коллбэк, вызываемый при доскролливании до конца списка для подгрузки следующей страницы.
+     * Защищен от преждевременного вызова: срабатывает только когда текущая пачка уже смонтирована в DOM.
+     */
+    onLoadMore?: () => void;
+    /** Флаг наличия следующих страниц на сервере (например, page.number < page.totalPages) */
+    hasMore?: boolean;
+    /** Флаг активной загрузки следующей страницы (показывает лоадер снизу) */
+    isLoadingMore?: boolean;
+    /** Кастомный элемент-лоадер внизу списка во время isLoadingMore */
+    loader?: React.ReactNode;
+    /** Отступ до низа в пикселях для упреждающего срабатывания (по умолчанию 250px) */
+    threshold?: number;
+}

package/dist/types/material/index.d.ts

@@ -54,3 +54,5 @@ export { default as FSearchableSelect } from "./FSearchableSelect";
 export { default as FSegmentedControl } from "./FSegmentedControl";
 export { default as FTableActions } from "./TableComponents/FTableActions";
 export { default as FStatusBadge } from "./FStatusBadge";
+export { default as FProgressiveList } from "./FProgressiveList";
+export * from "./FProgressiveList/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fui-material",
-  "version": "2.8.18",
+  "version": "2.8.20",
   "type": "module",
   "publishConfig": {
     "access": "public",