@snabcentr/client-ui 4.2.0 → 4.3.0

package/feedback/feedback-form/sc-feedback-form.component.d.ts

@@ -0,0 +1,163 @@
+import { InputSignal, OutputEmitterRef, Signal } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
+import { ScFeedbackForms, ScISuggestionType, ScUploadedFile } from '@snabcentr/client-core';
+import { TuiLooseUnion } from '@taiga-ui/cdk';
+import { TuiDialogContext } from '@taiga-ui/core';
+import { TuiCountryIsoCode } from '@taiga-ui/i18n';
+import { TuiFileLike } from '@taiga-ui/kit';
+import { Observable, Subject } from 'rxjs';
+import { ScFeedbackFormConfig, ScFeedbackFormFieldType } from '../interfaces';
+import * as i0 from "@angular/core";
+/**
+ * Компонент формы обратной связи.
+ */
+export declare class ScFeedbackFormComponent {
+    /**
+     * Контекст диалогового окна, в котором открыт компонент.
+     */
+    protected readonly context: TuiDialogContext<void, {
+        onClickOfferHandler: () => void;
+    } & ScFeedbackFormConfig> | null;
+    /**
+     * Символьное обозначение (slug) формы.
+     */
+    readonly slugInput: InputSignal<TuiLooseUnion<ScFeedbackForms>>;
+    /**
+     * Список полей, доступных в данной форме.
+     */
+    readonly fieldsInput: InputSignal<ScFeedbackFormFieldType[]>;
+    /**
+     * Символьное обозначение (slug) формы.
+     */
+    protected readonly slug: Signal<TuiLooseUnion<ScFeedbackForms>>;
+    /**
+     * Список полей, доступных в данной форме.
+     */
+    protected readonly fields: Signal<ScFeedbackFormFieldType[]>;
+    /**
+     * Событие нажатия на кнопку договора оферты.
+     */
+    readonly clickOffer: OutputEmitterRef<void>;
+    /**
+     * Событие успешной отправки формы.
+     */
+    readonly sendSuccess: OutputEmitterRef<void>;
+    /**
+     * Сервис обратной связи.
+     */
+    private readonly feedbackService;
+    /**
+     * Сервис конвертации данных.
+     */
+    private readonly convertersService;
+    /**
+     * Максимальное количество файлов, отправляемых в форме.
+     */
+    private readonly maxFilesInForm;
+    /**
+     * Сервис данных о пользователе.
+     */
+    private readonly user$;
+    /**
+     * Поле ввода для recaptcha.
+     */
+    protected readonly recaptchaControl: FormControl<string | null>;
+    /**
+     * Группа полей ввода для формы «Пожелания и предложения по улучшению сайта».
+     */
+    protected readonly form: FormGroup<{
+        name: FormControl<string | null>;
+        phone: FormControl<string | null>;
+        email: FormControl<string | null>;
+        message: FormControl<string | null>;
+        files: FormControl<ScUploadedFile[] | null>;
+        isShouldUseMessenger: FormControl<boolean | null>;
+    }>;
+    /**
+     * Перечисление типов подсказок.
+     */
+    protected readonly suggestionType: typeof ScISuggestionType;
+    /**
+     * {@link Subject} события отправки формы.
+     */
+    protected readonly onSubmit: Subject<void>;
+    /**
+     * {@link Observable} запроса на отправку данных.
+     */
+    protected readonly request$: Observable<undefined | null>;
+    /**
+     * {@link Observable} изменения состояния загрузки данных.
+     */
+    protected readonly loading$: Observable<boolean>;
+    /**
+     * Управляет состоянием загруженных файлов.
+     */
+    protected readonly loadedFile: FormControl<TuiFileLike[] | null>;
+    /**
+     * Observable, который отслеживает, приняты ли файлы в соответствии с требованиями по типу размеру и т.д.
+     */
+    protected readonly accepted$: Observable<File[]>;
+    /**
+     * Список файлов, которые были отклонены при загрузке.
+     */
+    protected rejected: readonly File[];
+    /**
+     * Список стран.
+     */
+    protected readonly countries: readonly TuiCountryIsoCode[];
+    /**
+     * Инициализирует экземпляр класса {@link ScFeedbackFormComponent}.
+     */
+    constructor();
+    /**
+     * Удаляет валидацию со всех полей ввода.
+     */
+    private clearAllValidators;
+    /**
+     * Устанавливает валидацию со для указанных полей ввода.
+     *
+     * @param fields Поля, для которых нужно установить валидацию.
+     */
+    private setAllValidators;
+    /**
+     * Обрабатывает отклоненные файлы.
+     *
+     * @param files Список файлов, которые были отклонены.
+     */
+    protected onReject(files: readonly File[]): void;
+    /**
+     * Удаляет файл из списка загруженных и отклоненных файлов.
+     *
+     * @param file Файл, который нужно удалить.
+     */
+    protected onRemove(file: File): void;
+    /**
+     * Очищает список файлов.
+     */
+    protected onRemoveAll(): void;
+    /**
+     * Загружает файл в форму обратной связи.
+     *
+     * @param files Набор файлов.
+     */
+    private onUploadFile;
+    /**
+     * Проверяет количество файлов загруженных пользователем.
+     *
+     * @param maxLength максимальное допустимое количество файлов для отправки.
+     */
+    private maxFilesLength;
+    /**
+     * Выполняет очистку полей формы.
+     */
+    private resetForm;
+    /**
+     * Проверяет, что номер телефона подходит для использования в мессенджерах.
+     *
+     * @param value Номер телефона, который необходимо проверить.
+     * @returns Признак того, что номер телефона подходит для мессенджеров.
+     */
+    protected isValidPhoneNumberForMessenger(value: string): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScFeedbackFormComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScFeedbackFormComponent, "sc-feedback-form", never, { "slugInput": { "alias": "slug"; "required": false; "isSignal": true; }; "fieldsInput": { "alias": "fields"; "required": false; "isSignal": true; }; }, { "clickOffer": "clickOffer"; "sendSuccess": "sendSuccess"; }, never, never, true, never>;
+}

package/feedback/gratitude/sc-gratitude.component.d.ts

@@ -0,0 +1,20 @@
+import { TuiDialogContext } from '@taiga-ui/core';
+import * as i0 from "@angular/core";
+/**
+ * Компонент «Спасибо!».
+ */
+export declare class ScGratitudeComponent {
+    /**
+     * Контекст диалогового окна, в котором открыт компонент.
+     */
+    protected readonly context: TuiDialogContext<void, {
+        autoClose: number;
+        subTitle: string;
+    }> | null;
+    /**
+     * Инициализирует экземпляр класса {@link ScGratitudeComponent}.
+     */
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScGratitudeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScGratitudeComponent, "sc-gratitude", never, {}, {}, never, never, true, never>;
+}

package/feedback/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interfaces';
+export * from './feedback-form/sc-feedback-form.component';
+export * from './gratitude/sc-gratitude.component';

package/feedback/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './sc-feedback-form-config';

package/feedback/interfaces/sc-feedback-form-config.d.ts

@@ -0,0 +1,23 @@
+import { ScFeedbackForms } from '@snabcentr/client-core';
+import { TuiLooseUnion } from '@taiga-ui/cdk';
+/**
+ * Типы доступных полей для форм обратной связи.
+ */
+export type ScFeedbackFormFieldType = 'name' | 'email' | 'phone' | 'message' | 'files' | 'isShouldUseMessenger';
+/**
+ * Конфигурация формы обратной связи.
+ */
+export interface ScFeedbackFormConfig {
+    /**
+     * Уникальный идентификатор формы, используемый в API-запросах.
+     */
+    slug: TuiLooseUnion<ScFeedbackForms>;
+    /**
+     * Название формы, отображаемое пользователю.
+     */
+    title: string;
+    /**
+     * Список полей, доступных в данной форме.
+     */
+    fields: ScFeedbackFormFieldType[];
+}