@kuzntsv/uikit 1.0.53 → 1.0.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuzntsv/uikit",
-  "version": "1.0.53",
+  "version": "1.0.56",
   "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<F extends SafeFilterState> {
+export declare abstract class BaseSignalFilterClass<F extends SafeFilterState> {
   /** Сервис индикатор загрузки. */
   protected loaderService: LoaderService;
   /** Сервис уведомлений. */
@@ -914,9 +914,38 @@ export declare class BaseSignalFilterClass<F extends SafeFilterState> {
    *     this.filters.update(prev => ({ ...prev, category: newCategory }));
    *   }
    */
+  /** Двусторонняя модель теперь строго типизирована вашим SafeFilterState. */
   filters: import("@angular/core").ModelSignal<F>;
   /** Входной сигнал для сброса состояния формы. */
   clearFilter: import("@angular/core").InputSignal<any>;
+  protected isUseInternalFilterSignal: number;
+  /**
+   * Локальный сигнал формы, чтобы изолировать ввод пользователя
+   * от родительской двусторонней модели filters.
+   *
+   * ### ВАЖНО:
+   * * При использовании для создания формы и в шаблоне, необходимо задать
+   * isUseInternalFilterSignal = 1, чтобы при clearFilter чистилась правильная модель.
+   *
+   * @example
+   *   protected isUseInternalFilterSignal = 1;
+   *   protected form = form(this.internalFilterSignal, (schemaPath) => {
+   *     // Дебаунсим только текстовые инпут dept. Остальные обновятся мгновенно.
+   *     debounce(schemaPath.dept, this.defaultDebounceTime);
+   *   });
+   *
+   * */
+  protected internalFilterSignal: import("@angular/core").WritableSignal<F>;
+  protected abstract DEFAULT_FILTER: F;
+  /**
+   * Объект для отписки от внутренних подписок (например, valueChanges у FormControl).
+   * Метод unsubscribe вызывается при уничтожении компонента.
+   */
+  constructor();
+  /** Мгновенная очистка конкретного поля по крестику у двусторонней модели filters. */
+  clearField(fieldName: keyof F, defaultValue: any): void;
+  /** Мгновенная очистка конкретного поля по крестику. */
+  clearFieldInternal(fieldName: keyof F, defaultValue: any): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalFilterClass<any>, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalFilterClass<any>, never, never, {
     "filters": {
@@ -935,7 +964,6 @@ export declare class BaseSignalFilterClass<F extends SafeFilterState> {
 }
 export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass, F extends SafeFilterState = Record<string, never>> implements OnDestroy {
   protected dialog: MatDialog;
-  protected entityType: any;
   protected entityService: any;
   protected entityEditComponent?: any;
   protected extraData?: any;
@@ -1026,6 +1054,10 @@ export declare abstract class BaseSignalPageClass<T extends BaseSchemaClass, F e
   constructor();
   ngOnDestroy(): void;
   subscribeToLoadData(fnGetData: fnGetDataResType<T>, fnGetCount: fnGetCountResType<T>, fnMapEntity?: fnMapEntityType<T>): void;
+  /** Установка значение фильтра.
+   * @param key - имя фильтра.
+   * @param value - значение.
+   */
   setFilter<K extends keyof F>(key: K, value: F[K]): void;
   onPageChange(pageState: IPageState): void;
   onSortChange(sortState: ISortState): void;