@kuzntsv/uikit 1.0.54 → 1.0.56

package/package.json

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

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

@@ -914,10 +914,27 @@ export declare abstract 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;
   /**
@@ -925,6 +942,10 @@ export declare abstract class BaseSignalFilterClass<F extends SafeFilterState> {
    * Метод 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": {