@kuzntsv/uikit 1.0.48 → 1.0.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuzntsv/uikit",
-  "version": "1.0.48",
+  "version": "1.0.50",
   "peerDependencies": {
     "@angular/common": "^22.2.2",
     "@angular/core": "^22.2.2",

package/types/kuzntsv-uikit-ui.d.ts

@@ -897,7 +897,7 @@ type SafeFilterState = Readonly<Record<string, FilterValue>>;
 type CleanFilterValue = Exclude<FilterValue, null | undefined>;
 type CleanFilterState = Readonly<Record<string, CleanFilterValue>>;
 declare function cleanFilterParams(filters: SafeFilterState): CleanFilterState;
-export declare class BaseSignalFilterClass implements OnDestroy {
+export declare class BaseSignalFilterClass<F extends SafeFilterState> {
   /** Сервис индикатор загрузки. */
   protected loaderService: LoaderService;
   /** Сервис уведомлений. */
@@ -914,21 +914,13 @@ export declare class BaseSignalFilterClass implements OnDestroy {
    *     this.filters.update(prev => ({ ...prev, category: newCategory }));
    *   }
    */
-  initialValues: import("@angular/core").InputSignal<Readonly<Record<string, FilterValue>>>;
+  filter: import("@angular/core").ModelSignal<F>;
   /** Входной сигнал для сброса состояния формы. */
   clearFilter: import("@angular/core").InputSignal<any>;
-  filterChange: import("@angular/core").OutputEmitterRef<Readonly<Record<string, FilterValue>>>;
-  filter: import("@angular/core").WritableSignal<Readonly<Record<string, FilterValue>>>;
-  /**
-   * Объект для отписки от внутренних подписок (например, valueChanges у FormControl).
-   * Метод unsubscribe вызывается при уничтожении компонента.
-   */
-  subscription: Subscription;
-  ngOnDestroy(): void;
-  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalFilterClass, never>;
-  static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalFilterClass, never, never, {
-    "initialValues": {
-      "alias": "initialValues";
+  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalFilterClass<any>, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalFilterClass<any>, never, never, {
+    "filter": {
+      "alias": "filter";
       "required": false;
       "isSignal": true;
     };
@@ -938,16 +930,19 @@ export declare class BaseSignalFilterClass implements OnDestroy {
       "isSignal": true;
     };
   }, {
-    "filterChange": "filterChange";
+    "filter": "filterChange";
   }, never, never, true, never>;
 }
-export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass> implements OnDestroy {
+export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass, F extends SafeFilterState = Record<string, never>> implements OnDestroy {
   protected dialog: MatDialog;
-  entityType: any;
-  entityService: any;
-  entityEditComponent: any;
-  extraData?: any;
+  protected abstract readonly entityType: any;
+  protected abstract readonly entityService: any;
+  protected readonly entityEditComponent?: any;
+  protected extraData?: any;
   protected abstract readonly schema: z.ZodType<T>;
+  protected readonly filterSchema?: z.ZodType<F>;
+  protected readonly defaultFilters?: F;
+  private get storagePrefix();
   defaultPageIndex: number;
   defaultPageSize: number;
   dialogEditWidth: string;
@@ -985,10 +980,6 @@ export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass> imp
   executeRoles: string[];
   /** Список ролей, для которых скрыть элемент. */
   hideRoles: string[];
-  /** Загрузка данных. */
-  /** Загрузка количества записей. */
-  /** Очистка фильтра. (для очистки присвоить пустой объект '{}'). */
-  clearFilters: import("@angular/core").WritableSignal<any>;
   /** Разрешен выбор нескольких строк. */
   allowMultiSelect: boolean;
   /** Выбранные строки в таблице. */
@@ -1021,15 +1012,21 @@ export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass> imp
   /** Объект для отписки (вызывается метод unsubscribe при уничтожении компонента). */
   subscription: Subscription;
   private getInitialFilters;
+  protected initFilters(): void;
+  private trackFilterChanges;
+  clearEvent(): void;
   private getInitialFilters2;
-  filters: import("@angular/core").WritableSignal<Readonly<Record<string, FilterValue>>>;
-  filters2: import("@angular/core").WritableSignal<Record<string, any>>;
+  filters: import("@angular/core").WritableSignal<F>;
+  /** Загрузка данных. */
+  /** Загрузка количества записей. */
+  /** Очистка фильтра. (для очистки присвоить пустой объект '{}'). */
+  clearFilters: import("@angular/core").WritableSignal<any>;
   /** Состояние сортировки, пагинации. */
   tableState: import("@angular/core").WritableSignal<ITableState>;
   constructor();
   ngOnDestroy(): void;
   subscribeToLoadData(fnGetData: fnGetDataResType<T>, fnGetCount: fnGetCountResType<T>, fnMapEntity?: fnMapEntityType<T>): void;
-  setFilter(key: string, value: any): void;
+  setFilter<K extends keyof F>(key: K, value: F[K]): void;
   onPageChange(pageState: IPageState): void;
   onSortChange(sortState: ISortState): void;
   /** Событие изменение выбранных записей. */
@@ -1049,7 +1046,6 @@ export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass> imp
   /** Событие обновления данных. */
   refreshEvent(): void;
   /** Событие очистки фильтра. */
-  clearEvent(): void;
   /** Изменение сообщения об удалении. */
   onRemovalMessageChange(message: string): void;
   /** Изменение заголовка страницы. */
@@ -1059,8 +1055,8 @@ export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass> imp
   protected onMiddleButton(baseUrl: string, queryParamName?: string, queryParamValue?: string): ($event: MouseEvent, item: T | undefined, contextMenu: MatMenuTrigger) => void;
   protected onActionMiddleButton(baseUrl: string, queryParamName?: string, queryParamValue?: string): ($event: MouseEvent, item: T | undefined) => void;
   protected dateToString(date: string | number | Date): string | null;
-  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalPageClass<any>, never>;
-  static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalPageClass<any>, never, never, {}, {}, never, never, true, never>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalPageClass<any, any>, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalPageClass<any, any>, never, never, {}, {}, never, never, true, never>;
 }
 export declare abstract class BaseSignalServiceClass<T extends BaseSchemaClass> {
   abstract baseRoute: string;
@@ -1078,6 +1074,16 @@ export declare abstract class BaseSignalServiceClass<T extends BaseSchemaClass>
   getObject(id: number | (() => number | null | undefined)): HttpResourceRef<T | null>;
   getCount(): HttpResourceRef<number>;
   getObjectsByPaging(pageIndex: number, pageSize: number, sortColumn: string, direction: string): HttpResourceRef<T[]>;
+  /**
+   * Универсальный метод получения пагинированных данных с фильтрацией.
+   * Автоматически очищает фильтры от null/undefined/пустых значений с помощью cleanFilterParams.
+   */
+  getObjectsByFilterPaging<F extends SafeFilterState>(pageIndex: number, pageSize: number, sortColumn: string, direction: string, filters: F): HttpResourceRef<T[]>;
+  /**
+   * Универсальный метод получения КОЛИЧЕСТВА записей с фильтрацией.
+   * Автоматически очищает фильтры перед отправкой.
+   */
+  getObjectsCountByFilter<F extends SafeFilterState>(filters: F): HttpResourceRef<number>;
   /**
    * МЕТОД СОЗДАНИЯ (POST)
    * Принимает данные БЕЗ id. Тип формируется автоматически через Zod.