@kuzntsv/uikit 1.0.39 → 1.0.42

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@kuzntsv/uikit",
-  "version": "1.0.39",
+  "version": "1.0.42",
   "peerDependencies": {
     "@angular/common": "^22.2.2",
-    "@angular/core": "^22.2.2"
+    "@angular/core": "^22.2.2",
+    "zod": "^4.6.7"
   },
   "dependencies": {
     "tslib": "^2.8.1"

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

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { AfterViewInit, ElementRef, EnvironmentProviders, InjectionToken, OnDestroy, OnInit, PipeTransform } from "@angular/core";
+import { AfterViewInit, ElementRef, EnvironmentProviders, InjectionToken, OnDestroy, OnInit, PipeTransform, WritableSignal } from "@angular/core";
 import { NotificationService, RoleService } from "@kuzntsv/uikit";
 import { Observable, Subject, Subscription } from "rxjs";
 import { SelectionModel } from "@angular/cdk/collections";
@@ -7,11 +7,13 @@ import { MatMenuTrigger } from "@angular/material/menu";
 import { MatPaginator } from "@angular/material/paginator";
 import { MatSort } from "@angular/material/sort";
 import { MatTableDataSource } from "@angular/material/table";
+import z, { z as z$1 } from "zod";
 import { FormControl, FormGroup } from "@angular/forms";
 import { MatDialog, MatDialogRef } from "@angular/material/dialog";
 import { SafeUrl } from "@angular/platform-browser";
 import { CanActivateFn, Router } from "@angular/router";
-import { HttpClient, HttpContext, HttpParams } from "@angular/common/http";
+import { HttpClient, HttpContext, HttpParams, HttpResourceRef } from "@angular/common/http";
+import { FieldTree } from "@angular/forms/signals";
 import { MatAutocompleteSelectedEvent } from "@angular/material/autocomplete";
 import { NativeDateAdapter } from "@angular/material/core";
 interface Authenticate {
@@ -531,12 +533,20 @@ export declare class BaseToolbarComponent {
     "clickedClearBtn": "clickedClearBtn";
   }, never, never, true, never>;
 }
+export declare const BaseSchema: z$1.ZodObject<{
+  id: z$1.ZodNumber;
+}, z$1.core.$strip>;
+export type BaseSchemaClass = z$1.infer<typeof BaseSchema>;
+/** @deprecated */
 export interface BaseClass {
   id: number;
 }
+/** Объект передаваемый в диалог формы редактирования, оперирует доменной моделью. */
 export interface IEditDialogData<T, K = any> {
   action: Action;
+  /** Здесь всегда доменная модель */
   entity: T;
+  /** Дополнительные данные, например, фото. */
   extraData?: K;
 }
 export declare enum Action {
@@ -812,7 +822,7 @@ export declare class BasePageClass<T> implements OnDestroy {
   openDialog(entityComponent: any, data: IEditDialogData<T>, dialog: any): any;
   openDialogRemoveConfirm(removalMessage: string): MatDialogRef<DialogComponent> | undefined;
   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) => 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<BasePageClass<any>, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<BasePageClass<any>, never, never, {}, {}, never, never, true, never>;
@@ -841,6 +851,260 @@ export declare abstract class BaseServiceClass<T extends BaseClass> {
   static ɵfac: i0.ɵɵFactoryDeclaration<BaseServiceClass<any>, never>;
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
+export declare abstract class BaseSignalEditClass<TDomain extends Record<string, any>, TForm extends Record<string, any> = TDomain> implements OnDestroy {
+  /** Заголовок. */
+  abstract title: string;
+  /** Данные диалога. */
+  protected abstract dialogData: WritableSignal<IEditDialogData<TDomain>>;
+  protected formAction: import("@angular/core").Signal<Action>;
+  protected formActionIsAdd: import("@angular/core").Signal<boolean>;
+  protected formActionIsEdit: import("@angular/core").Signal<boolean>;
+  protected domainModel: import("@angular/core").Signal<TDomain>;
+  protected formModel: WritableSignal<TForm>;
+  /** Форма. */
+  protected abstract form: FieldTree<TForm>;
+  /** Ссылка на диалог. */
+  protected abstract dialogRef?: MatDialogRef<any, IEditDialogData<TDomain> | null>;
+  /** Сервис индикатор загрузки. */
+  protected loaderService: LoaderService;
+  /** Сервис уведомлений. */
+  protected notificationService: NotificationService;
+  /** Объект для отписки (вызывается метод unsubscribe при уничтожении компонента).
+   * @deprecated
+   */
+  protected subscription: Subscription;
+  /**
+   * Маппинг: Домен -> Форма.
+   * Реализация по умолчанию делает поверхностную копию. Наследник может её переопределить.
+   */
+  protected domainModelToFormModel(domainModel: TDomain): TForm;
+  /**
+   * Маппинг: Форма -> Домен.
+   * Реализация по умолчанию объединяет старый домен и новые поля формы.
+   */
+  protected formModelToDomainModel(formModel: TForm, originalDomain?: TDomain): TDomain;
+  ngOnDestroy(): void;
+  onNoClick(event: MouseEvent): void;
+  onSubmit(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalEditClass<any, any>, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<BaseSignalEditClass<any, any>, never, never, {}, {}, never, never, true, never>;
+}
+type FilterValue = string | number | boolean | readonly string[] | readonly number[] | null | undefined;
+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 {
+  /** Сервис индикатор загрузки. */
+  protected loaderService: LoaderService;
+  /** Сервис уведомлений. */
+  protected notificationService: NotificationService;
+  /** Время на успокоение значения фильтра. */
+  defaultDebounceTime: number;
+  /**
+   * writable-сигнал, Принимаем текущее реактивное состояние фильтров с родительской страницы.
+   * Родитель передает значение через [(filters)]="pageFilters()".
+   * При любом изменении полей ввода обновляйте сигнал целиком через метод update.
+   *
+   * @example
+   *   updateCategory(newCategory: string) {
+   *     this.filters.update(prev => ({ ...prev, category: newCategory }));
+   *   }
+   */
+  initialValues: import("@angular/core").InputSignal<Readonly<Record<string, FilterValue>>>;
+  /** Входной сигнал для сброса состояния формы. */
+  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";
+      "required": false;
+      "isSignal": true;
+    };
+    "clearFilter": {
+      "alias": "clearFilter";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "filterChange": "filterChange";
+  }, never, never, true, never>;
+}
+export declare class BaseSignalPageClass<T> implements OnDestroy {
+  protected dialog: MatDialog;
+  entityService: any;
+  entityType: any;
+  entityEditComponent: any;
+  extraData?: any;
+  defaultPageIndex: number;
+  defaultPageSize: number;
+  dialogEditWidth: string;
+  dialogRemoveWidth: string;
+  routeAddress: string;
+  /** Сообщение при удалении записи(й). */
+  removalMessage: string;
+  /** Заголовок страницы. */
+  pageTitle: string;
+  /**
+   * Создание записи: вызывается перед открытием диалога.
+   */
+  beforeOpenDialogOnNewEvent: fnType<T>;
+  /**
+   * Редактирование записи: вызывается перед открытием диалога.
+   */
+  beforeOpenDialogOnEditEvent: fnType<T>;
+  /**
+   * Создание записи: вызывается перед сохранением объекта.
+   */
+  beforeSaveOnNewEvent: fnType<T>;
+  /**
+   * Редактирование записи: вызывается перед сохранением объекта.
+   */
+  beforeSaveOnEditEvent: fnType<T>;
+  /**
+   * Создание записи: вызывается после сохранения объекта.
+   */
+  afterSaveOnNewEvent: fnCbType<T>;
+  /**
+   * Редактирование записи: вызывается после сохранения объекта.
+   */
+  afterSaveOnEditEvent: fnCbType<T>;
+  editorRoles: string[];
+  executeRoles: string[];
+  /** Список ролей, для которых скрыть элемент. */
+  hideRoles: string[];
+  /** Загрузка данных. */
+  loadData$: Subject<null>;
+  /** Загрузка количества записей. */
+  loadLength$: Subject<null>;
+  /** Очистка фильтра. (для очистки присвоить пустой объект '{}'). */
+  clearFilters: import("@angular/core").WritableSignal<any>;
+  /** Разрешен выбор нескольких строк. */
+  allowMultiSelect: boolean;
+  /** Выбранные строки в таблице. */
+  selected: T[];
+  protected fnGetData: import("@angular/core").WritableSignal<fnGetDataType<T> | null>;
+  protected fnGetCount: import("@angular/core").WritableSignal<fnGetCountType<T> | null>;
+  protected fnMapEntity: import("@angular/core").WritableSignal<fnMapEntityType<T> | undefined>;
+  protected dataResource: import("@angular/core").ResourceRef<T[] | undefined>;
+  protected countResource: import("@angular/core").ResourceRef<number | undefined>;
+  /** Данные для табличного компонента. */
+  data: import("@angular/core").Signal<T[]>;
+  /** Количество записей по фильтру. */
+  length: import("@angular/core").Signal<number>;
+  /** Доступность кнопки "Изменить". */
+  editBtnDisabled: boolean;
+  /** Доступность кнопки "Удалить". */
+  removeBtnDisabled: boolean;
+  /** Разрешено ли отправлять событие rowDoubleClicked при двойном щелчке мышью. */
+  dblClickedEventEnable: boolean;
+  opt: IContextMenuOptions<T>[];
+  protected router: Router;
+  /** Сервис для работы с LocalStorage. */
+  protected localStorageService: LocalStorageService;
+  /** Сервис индикатор загрузки. */
+  protected loaderService: LoaderService;
+  /** Сервис уведомлений. */
+  protected notificationService: import("@kuzntsv/uikit").INotificationService;
+  /** Объект для отписки (вызывается метод unsubscribe при уничтожении компонента). */
+  subscription: Subscription;
+  private getInitialFilters;
+  private getInitialFilters2;
+  filters: import("@angular/core").WritableSignal<Readonly<Record<string, FilterValue>>>;
+  filters2: import("@angular/core").WritableSignal<Record<string, any>>;
+  /** Состояние сортировки, пагинации. */
+  tableState: import("@angular/core").WritableSignal<ITableState>;
+  constructor();
+  ngOnDestroy(): void;
+  subscribeToLoadData(fnGetData: fnGetDataType<T>, fnGetCount: fnGetCountType<T>, fnMapEntity?: fnMapEntityType<T>): void;
+  setFilter(key: string, value: any): void;
+  onPageChange(pageState: IPageState): void;
+  onSortChange(sortState: ISortState): void;
+  entityFactory(type: new () => T): T;
+  /** Событие изменение выбранных записей. */
+  onSelectionChange(selected: T[]): void;
+  /** Обновление доступности кнопки "Изменить" - вызывается при изменении выбранных записей. */
+  editBtnDisabledUpdate(selected: T[]): void;
+  /** Обновление доступности кнопки "Удалить" - вызывается при изменении выбранных записей. */
+  removeBtnDisabledUpdate(selected: T[]): void;
+  /** Событие двойной клик. */
+  onRowDoubleClicked(): void;
+  /** Событие создание. */
+  newEvent(): void;
+  /** Событие редактирование. */
+  editEvent(): void;
+  /** Событие удаление. */
+  removeEvent(): void;
+  /** Событие обновления данных. */
+  refreshEvent(): void;
+  /** Событие очистки фильтра. */
+  clearEvent(): void;
+  /** Изменение сообщения об удалении. */
+  onRemovalMessageChange(message: string): void;
+  /** Изменение заголовка страницы. */
+  onPageTitleChange(title: string): void;
+  openDialog(entityComponent: any, data: IEditDialogData<T>, dialog: any): any;
+  openDialogRemoveConfirm(removalMessage: string): MatDialogRef<DialogComponent> | undefined;
+  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>;
+}
+export declare abstract class BaseSignalServiceClass<T extends BaseSchemaClass> {
+  abstract baseRoute: string;
+  abstract entityType: any;
+  protected abstract readonly schema: z.ZodType<T>;
+  protected countRoute: string;
+  protected pageIndexParam: string;
+  protected pageSizeParam: string;
+  protected sortColumnParam: string;
+  protected directionParam: string;
+  protected apiContextName: string;
+  protected http: HttpClient;
+  private readonly _refreshTrigger;
+  refresh(): void;
+  getObjects(): HttpResourceRef<T[] | undefined>;
+  getObject(id: number | (() => number)): HttpResourceRef<T | undefined>;
+  getCount(): HttpResourceRef<number | undefined>;
+  getObjectsByPaging(pageIndex: () => number, pageSize: () => number, sortColumn: () => string, direction: () => string): HttpResourceRef<T[] | undefined>;
+  /**
+   * МЕТОД СОЗДАНИЯ (POST)
+   * Принимает данные БЕЗ id. Тип формируется автоматически через Zod.
+   */
+  newObject(entity: Omit<T, 'id'>): any;
+  /**
+   * Метод для СОЗДАНИЯ объекта (POST)
+   * Тип аргумента генерируется автоматически: это ваш тип T, но БЕЗ поля id.
+   */
+  create(dto: Omit<T, 'id'>): HttpResourceRef<T | undefined>;
+  editObject(entity: T): any;
+  /**
+   * Метод для ОБНОВЛЕНИЯ объекта (PUT / PATCH)
+   * Принимает id и частичный объект (все свойства T становятся необязательными, кроме id)
+   */
+  update(id: number, dto: Partial<Omit<T, 'id'>>): HttpResourceRef<T | undefined>;
+  /**
+   * Метод DELETE (Переписанный под новую архитектуру)
+   * Возвращает Observable. При подписке делает DELETE запрос,
+   * а оператор 'tap' автоматически обновляет список getObjects() при успехе.
+   */
+  deleteObject(entity: T): any;
+  protected getParams(pageIndex: number, pageSize: number, sortColumn: string, direction: string): HttpParams;
+  protected getHttpContext(): {
+    context?: HttpContext;
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<BaseSignalServiceClass<any>, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
 export declare class DisableIfRoleDirective {
   readonly forbiddenRoles: import("@angular/core").InputSignal<string[]>;
   private readonly el;