@snabcentr/client-ui 4.20.1 → 4.23.0

package/form-fields/suggestion-field/sc-suggestion-field.component.d.ts

@@ -13,11 +13,6 @@ export declare class ScSuggestionFieldComponent implements OnInit {
      * Тип подсказок.
      */
     type: ScISuggestionType;
-    /**
-     * Признак, что элементы подсказок показывают пометку о полноте адреса.
-     * Отключается там, где адреса из подсказки по организации не применяются.
-     */
-    showAddressQuality: boolean;
     /**
      * Событие выбора результата подсказки.
      */
@@ -72,18 +67,12 @@ export declare class ScSuggestionFieldComponent implements OnInit {
      */
     isDisabledSuggestion(suggestion: ScSuggestion): boolean;
     /**
-     * Возвращает текст пометки о качестве адреса для элемента выпадающего списка подсказок либо null, когда пометка не требуется.
+     * Возвращает текст пометки о качестве адреса для элемента выпадающего списка подсказок по адресу либо null, когда пометка не требуется.
+     * Неполный адрес и адрес с неопределённой полнотой помечаются одинаково.
      *
      * @param quality Качество (полнота) адреса.
      */
     getAddressQualityWarning(quality: ScSuggestionAddressQuality | null | undefined): string | null;
-    /**
-     * Возвращает текст пометки о качестве юридического адреса для подсказки по организации либо null,
-     * когда пометка не требуется, в том числе когда у организации нет юридического адреса.
-     *
-     * @param suggestion Объект подсказки по организации.
-     */
-    getOrganizationAddressQualityWarning(suggestion: ScISuggestionOrganization): string | null;
     /**
      * Проверяет прекращена ли деятельность указанной организации.
      *
@@ -103,5 +92,5 @@ export declare class ScSuggestionFieldComponent implements OnInit {
      */
     private applyOrganizationSuggestion;
     static ɵfac: i0.ɵɵFactoryDeclaration<ScSuggestionFieldComponent, [{ skipSelf: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ScSuggestionFieldComponent, "sc-suggestion-field", never, { "type": { "alias": "type"; "required": false; }; "showAddressQuality": { "alias": "showAddressQuality"; "required": false; }; }, { "selectedClick": "selectedClick"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScSuggestionFieldComponent, "sc-suggestion-field", never, { "type": { "alias": "type"; "required": false; }; }, { "selectedClick": "selectedClick"; }, never, never, false, never>;
 }

package/helpers/sc-api-error-helper.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Класс-помощник для сообщений об ошибках запросов к API.
+ */
+export declare class ScApiErrorHelper {
+    /**
+     * Возвращает текст ошибки из ответа API или указанный текст, если ответ его не содержит.
+     *
+     * @param error Ошибка запроса.
+     * @param fallback Текст по умолчанию.
+     */
+    static getMessage(error: unknown, fallback: string): string;
+    /**
+     * Возвращает признак ответа 404: запись не найдена, например удалена в другой вкладке.
+     *
+     * @param error Ошибка запроса.
+     */
+    static isNotFound(error: unknown): boolean;
+}

package/helpers/sc-file-helper.d.ts

@@ -0,0 +1,13 @@
+import { ScUploadedFile } from '@snabcentr/client-core';
+import { Observable } from 'rxjs';
+/**
+ * Класс-помощник для работы с файлами, выбранными пользователем.
+ */
+export declare class ScFileHelper {
+    /**
+     * Читает файл и возвращает его для отправки в API: название и содержимое в виде data-URI. При отписке чтение прерывается.
+     *
+     * @param file Выбранный файл.
+     */
+    static readAsUploadedFile$(file: File): Observable<ScUploadedFile>;
+}

package/order/draft/helpers/sc-draft-list-helper.d.ts

@@ -0,0 +1,51 @@
+import { ScIPaginate, ScOrderDraftShort } from '@snabcentr/client-core';
+import { ScIDraftListItem } from '../models/sc-i-draft-list-item';
+/**
+ * Класс-помощник для работы со списком черновиков.
+ */
+export declare class ScDraftListHelper {
+    /**
+     * Возвращает признак, что состав страницы не изменился: то же общее количество черновиков и те же черновики в том же порядке.
+     *
+     * @param items Текущие элементы списка.
+     * @param total Текущее общее количество черновиков.
+     * @param drafts Черновики полученной страницы.
+     * @param receivedTotal Общее количество черновиков в полученных данных.
+     */
+    static isSamePage(items: ScIDraftListItem[], total: number, drafts: ScOrderDraftShort[], receivedTotal: number): boolean;
+    /**
+     * Возвращает подпись состава страницы: общее количество черновиков и номера черновиков страницы по порядку.
+     *
+     * @param page Страница списка.
+     */
+    static getSignature(page: ScIPaginate<ScOrderDraftShort>): string;
+    /**
+     * Возвращает элементы новой страницы списка. Черновики, которые уже есть в списке, сохраняют раскрытие и полные данные.
+     *
+     * @param items Текущие элементы списка.
+     * @param drafts Черновики новой страницы.
+     */
+    static fromPage(items: ScIDraftListItem[], drafts: ScOrderDraftShort[]): ScIDraftListItem[];
+    /**
+     * Возвращает список с обновлёнными краткими данными полученных черновиков, состав и порядок списка не меняются.
+     * Полные данные раскрытых черновиков не меняются: их обновляет кэш черновика.
+     *
+     * @param items Текущие элементы списка.
+     * @param drafts Полученные краткие данные черновиков.
+     */
+    static merge(items: ScIDraftListItem[], drafts: ScOrderDraftShort[]): ScIDraftListItem[];
+    /**
+     * Возвращает номера черновиков с полными данными, у которых краткие данные отличаются: название или данные актуализации.
+     *
+     * @param items Текущие элементы списка.
+     * @param drafts Полученные краткие данные черновиков.
+     */
+    static getChangedFullDraftIds(items: ScIDraftListItem[], drafts: ScOrderDraftShort[]): number[];
+    /**
+     * Обновляет элемент списка краткими данными черновика. Полные данные черновика не заменяются.
+     *
+     * @param item Элемент списка.
+     * @param short Краткие данные черновика.
+     */
+    private static update;
+}

package/order/draft/models/sc-i-draft-list-item.d.ts

@@ -0,0 +1,14 @@
+import { ScOrderDraft, ScOrderDraftShort } from '@snabcentr/client-core';
+/**
+ * Данные об элементе списка черновиков заказов.
+ */
+export interface ScIDraftListItem {
+    /**
+     * Краткие или полные данные о черновике заказа.
+     */
+    order: ScOrderDraft | ScOrderDraftShort;
+    /**
+     * Признак, что черновик раскрыт в списке.
+     */
+    isExpanded: boolean;
+}

package/order/draft/profstroy/actualization-panel/sc-profstroy-actualization-panel.component.d.ts

@@ -0,0 +1,58 @@
+import { ScOrderDraft } from '@snabcentr/client-core';
+import { ScProfstroyDraftState } from '../enums/sc-profstroy-draft-state';
+import * as i0 from "@angular/core";
+/**
+ * Компонент панели состояния актуализации черновика Профстрой с действиями актуализации и пересборки.
+ */
+export declare class ScProfstroyActualizationPanelComponent {
+    /**
+     * Список ссылок приложения.
+     */
+    private readonly urls;
+    /**
+     * Объект документа.
+     */
+    private readonly document;
+    /**
+     * Черновик Профстрой.
+     */
+    readonly draft: import("@angular/core").InputSignal<ScOrderDraft>;
+    /**
+     * Момент, на который определяется состояние. Передаётся снаружи и обновляется по таймеру проверки срока, иначе метка «Данные устарели» не сменится.
+     */
+    readonly now: import("@angular/core").InputSignal<Date>;
+    /**
+     * Признак, что действия над черновиком недоступны.
+     */
+    readonly busy: import("@angular/core").InputSignal<boolean>;
+    /**
+     * Событие запуска актуализации.
+     */
+    readonly actualize: import("@angular/core").OutputEmitterRef<void>;
+    /**
+     * Событие запуска пересборки из файла.
+     */
+    readonly reload: import("@angular/core").OutputEmitterRef<void>;
+    /**
+     * Текущее состояние черновика.
+     */
+    protected readonly state: import("@angular/core").Signal<ScProfstroyDraftState>;
+    /**
+     * Данные об отображении состояния.
+     */
+    protected readonly stateView: import("@angular/core").Signal<import("@snabcentr/client-ui").ScIProfstroyDraftStateView>;
+    /**
+     * Признак, что выполняется обработка.
+     */
+    protected readonly isProcessing: import("@angular/core").Signal<boolean>;
+    /**
+     * Признак, что срок действия актуализации ещё не истёк.
+     */
+    protected readonly isActual: import("@angular/core").Signal<boolean>;
+    /**
+     * Абсолютная ссылка на исходный файл заявки. Файл лежит на хосте API, адрес API может быть указан относительно сайта.
+     */
+    protected readonly fileUrl: import("@angular/core").Signal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScProfstroyActualizationPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScProfstroyActualizationPanelComponent, "sc-profstroy-actualization-panel", never, { "draft": { "alias": "draft"; "required": true; "isSignal": true; }; "now": { "alias": "now"; "required": true; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; }, { "actualize": "actualize"; "reload": "reload"; }, never, never, true, never>;
+}

package/order/draft/profstroy/badge/sc-profstroy-badge.component.d.ts

@@ -0,0 +1,12 @@
+import * as i0 from "@angular/core";
+/**
+ * Компонент метки «Профстрой» у черновика или заказа, созданного из файла программы «Профстрой».
+ */
+export declare class ScProfstroyBadgeComponent {
+    /**
+     * Размер метки.
+     */
+    readonly size: import("@angular/core").InputSignal<"m" | "s">;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScProfstroyBadgeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScProfstroyBadgeComponent, "sc-profstroy-badge", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/order/draft/profstroy/badges/sc-profstroy-draft-badges.component.d.ts

@@ -0,0 +1,21 @@
+import { ScOrderDraftActualization } from '@snabcentr/client-core';
+import * as i0 from "@angular/core";
+/**
+ * Компонент меток черновика Профстрой: признак и текущее состояние обработки.
+ */
+export declare class ScProfstroyDraftBadgesComponent {
+    /**
+     * Данные об актуализации черновика.
+     */
+    readonly actualization: import("@angular/core").InputSignal<ScOrderDraftActualization | undefined>;
+    /**
+     * Момент, на который определяется состояние. Передаётся снаружи и обновляется по таймеру проверки срока, иначе метка «Данные устарели» не сменится.
+     */
+    readonly now: import("@angular/core").InputSignal<Date>;
+    /**
+     * Данные об отображении состояния.
+     */
+    protected readonly stateView: import("@angular/core").Signal<import("@snabcentr/client-ui").ScIProfstroyDraftStateView>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScProfstroyDraftBadgesComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScProfstroyDraftBadgesComponent, "sc-profstroy-draft-badges", never, { "actualization": { "alias": "actualization"; "required": false; "isSignal": true; }; "now": { "alias": "now"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/order/draft/profstroy/create-dialog/sc-profstroy-draft-create-dialog.component.d.ts

@@ -0,0 +1,65 @@
+import { FormControl, FormGroup } from '@angular/forms';
+import { ScOrderDraft } from '@snabcentr/client-core';
+import { TuiDialogContext } from '@taiga-ui/core';
+import * as i0 from "@angular/core";
+/**
+ * Компонент диалога создания черновика заказа из файла программы «Профстрой».
+ */
+export declare class ScProfstroyDraftCreateDialogComponent {
+    /**
+     * Контекст диалогового окна, в котором открыт компонент.
+     */
+    protected readonly context: TuiDialogContext<ScOrderDraft | undefined, undefined>;
+    /**
+     * Сервис для работы с черновиками заказов.
+     */
+    private readonly draftsService;
+    /**
+     * Ссылка для автоматического управления уничтожением зависимостей.
+     */
+    private readonly destroyRef;
+    /**
+     * Настройки поля выбора файлов, в том числе наибольший размер файла из настроек приложения.
+     */
+    private readonly inputFilesOptions;
+    /**
+     * Допустимое расширение файла.
+     */
+    protected readonly accept = ".xlsx";
+    /**
+     * Наибольшая длина названия заявки.
+     */
+    protected readonly nameMaxLength = 255;
+    /**
+     * Форма создания черновика. Формат и размер файла проверяются на самом поле: после выбора файла поле выбора убирается вместе со своими проверками.
+     */
+    protected readonly form: FormGroup<{
+        file: FormControl<File | null>;
+        name: FormControl<string>;
+    }>;
+    /**
+     * Признак выполнения запроса создания.
+     */
+    protected readonly submitting: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Признак попытки создать заявку. До неё незаполненное поле файла ошибкой не подсвечивается: поле теряет фокус уже при открытии окна выбора файла.
+     */
+    protected readonly submitAttempted: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Удаляет выбранный файл.
+     */
+    protected removeFile(): void;
+    /**
+     * Отправляет файл и создаёт черновик. Ошибки сервера с прошлой отправки не мешают отправить форму снова.
+     */
+    protected submit(): void;
+    /**
+     * Показывает ошибку создания в форме: ошибки проверки данных у полей, ошибку чтения файла у поля файла, остальные ошибкой формы (401 обрабатывает авторизация).
+     * Диалог остаётся открытым.
+     *
+     * @param error Ошибка чтения файла или запроса.
+     */
+    private applyError;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScProfstroyDraftCreateDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ScProfstroyDraftCreateDialogComponent, "sc-profstroy-draft-create-dialog", never, {}, {}, never, never, true, never>;
+}

package/order/draft/profstroy/enums/sc-profstroy-draft-state.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Перечисление состояний черновика Профстрой для отображения пользователю.
+ */
+export declare enum ScProfstroyDraftState {
+    /**
+     * Выполняется обработка.
+     */
+    processing = "processing",
+    /**
+     * Актуализирован, срок действия не истёк.
+     */
+    actual = "actual",
+    /**
+     * Актуализирован, но срок действия истёк.
+     */
+    outdated = "outdated",
+    /**
+     * Обработка завершилась с ошибкой.
+     */
+    error = "error",
+    /**
+     * Требуется актуализация после изменения состава.
+     */
+    needsActualization = "needsActualization",
+    /**
+     * Состояние не известно.
+     */
+    unknown = "unknown"
+}

package/order/draft/profstroy/helpers/sc-profstroy-draft-helper.d.ts

@@ -0,0 +1,33 @@
+import { ScOrderDraft, ScOrderDraftActualization } from '@snabcentr/client-core';
+import { ScProfstroyDraftState } from '../enums/sc-profstroy-draft-state';
+import { ScIProfstroyDraftStateView } from '../models/sc-i-profstroy-draft-state-view';
+/**
+ * Класс-помощник для отображения черновиков Профстрой.
+ */
+export declare class ScProfstroyDraftHelper {
+    /**
+     * Данные об отображении состояний черновика.
+     */
+    private static readonly stateViews;
+    /**
+     * Возвращает состояние черновика на указанный момент.
+     *
+     * @param actualization Данные об актуализации.
+     * @param now Момент проверки.
+     */
+    static getState(actualization: ScOrderDraftActualization | undefined, now: Date): ScProfstroyDraftState;
+    /**
+     * Возвращает данные об отображении состояния черновика на указанный момент.
+     *
+     * @param actualization Данные об актуализации.
+     * @param now Момент проверки.
+     */
+    static getStateView(actualization: ScOrderDraftActualization | undefined, now: Date): ScIProfstroyDraftStateView;
+    /**
+     * Возвращает данные об отображении панели состояния черновика: для актуальной заявки пояснение зависит от того, сколько позиций попадёт в заказ.
+     *
+     * @param draft Черновик Профстрой.
+     * @param now Момент проверки.
+     */
+    static getPanelView(draft: ScOrderDraft, now: Date): ScIProfstroyDraftStateView;
+}

package/order/draft/profstroy/index.d.ts

@@ -0,0 +1,7 @@
+export * from './actualization-panel/sc-profstroy-actualization-panel.component';
+export * from './badge/sc-profstroy-badge.component';
+export * from './badges/sc-profstroy-draft-badges.component';
+export * from './create-dialog/sc-profstroy-draft-create-dialog.component';
+export * from './enums/sc-profstroy-draft-state';
+export * from './helpers/sc-profstroy-draft-helper';
+export * from './models/sc-i-profstroy-draft-state-view';

package/order/draft/profstroy/models/sc-i-profstroy-draft-state-view.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Данные об отображении состояния черновика Профстрой.
+ */
+export interface ScIProfstroyDraftStateView {
+    /**
+     * Краткое название состояния.
+     */
+    label: string;
+    /**
+     * Оформление метки и панели состояния.
+     */
+    appearance: 'info' | 'positive' | 'warning' | 'negative' | 'neutral';
+    /**
+     * Пояснение к состоянию.
+     */
+    description: string;
+}

package/order/draft/sc-draft.component.d.ts

@@ -17,6 +17,10 @@ export declare class ScDraftComponent implements OnInit {
      * Сервис для работы с черновиками заказов.
      */
     private readonly draftsService;
+    /**
+     * Сервис уведомлений.
+     */
+    private readonly alerts;
     /**
      * Сигнал с данными текущего черновика заказа (из параметра orderId в URL).
      */
@@ -37,6 +41,42 @@ export declare class ScDraftComponent implements OnInit {
      * Текущий ключ маршрута.
      */
     protected readonly isDraftPage: import("@angular/core").Signal<boolean>;
+    /**
+     * Признак черновика Профстрой.
+     */
+    protected readonly isProfstroy: import("@angular/core").Signal<boolean>;
+    /**
+     * Признак, что идёт обработка черновика Профстрой.
+     */
+    protected readonly isProcessing: import("@angular/core").Signal<boolean>;
+    /**
+     * Сервис текущего момента для проверки срока актуализации.
+     */
+    private readonly expirationClock;
+    /**
+     * Текущий момент для проверки срока актуализации из общего источника. Обновляется, пока открыт черновик Профстрой.
+     */
+    protected readonly now: import("@angular/core").Signal<Date>;
+    /**
+     * Признак выполнения актуализации или пересборки черновика Профстрой.
+     */
+    protected readonly actionRunning: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Признак, что для черновика выполняются или ждут очереди запросы изменения или перечитывания.
+     */
+    protected readonly queueBusy: import("@angular/core").Signal<boolean>;
+    /**
+     * Признак, что действия над черновиком Профстрой недоступны, пока выполняется действие или запрос черновика.
+     */
+    protected readonly busy: import("@angular/core").Signal<boolean>;
+    /**
+     * Признак, что можно менять состав черновика Профстрой.
+     */
+    protected readonly canEditProfstroy: import("@angular/core").Signal<boolean>;
+    /**
+     * Причина, по которой нельзя оформить заказ из черновика Профстрой, или пустая строка.
+     */
+    protected readonly profstroyOrderBlockReason: import("@angular/core").Signal<string>;
     /**
      * Ссылка для автоматического управления уничтожением зависимостей.
      */
@@ -45,6 +85,10 @@ export declare class ScDraftComponent implements OnInit {
      * Сервис установки SEO-данных приложения.
      */
     private readonly seoService;
+    /**
+     * Инициализирует экземпляр класса {@link ScDraftComponent}.
+     */
+    constructor();
     /** @inheritDoc */
     ngOnInit(): void;
     /**
@@ -52,9 +96,37 @@ export declare class ScDraftComponent implements OnInit {
      */
     protected goToNewOrder(): void;
     /**
-     * Удаляет черновик и перенаправляет к списку черновиков.
+     * Запускает актуализацию черновика Профстрой.
+     */
+    protected actualizeProfstroy(): void;
+    /**
+     * Запускает пересборку черновика Профстрой из файла после подтверждения.
+     */
+    protected reloadProfstroy(): void;
+    /**
+     * Удаляет черновик и перенаправляет к списку черновиков. Пока черновик удаляется, действия над ним заблокированы.
+     * Если удалить не удалось, пользователь остаётся на странице, сообщение об ошибке показывает перехватчик приложения.
      */
     protected clearDraft(): void;
+    /**
+     * Выполняет действие над черновиком Профстрой. Пока действие выполняется, остальные заблокированы.
+     * Ответ попадает в кэш черновика, после отказа 403 или 409 сервис сам перезапрашивает черновик. Сообщение об ошибке показывает перехватчик приложения.
+     *
+     * @param action Функция, возвращающая запрос действия по идентификатору черновика.
+     */
+    private runProfstroyAction;
+    /**
+     * Пока черновик Профстрой на его странице в обработке, опрашивает состояние лёгким запросом списка и после окончания обработки перезапрашивает черновик.
+     * Опрос идёт, пока перезапрошенный черновик остаётся в обработке: неудачный перезапрос повторяется на следующем шаге.
+     * Если черновика больше нет (удалён в другой вкладке), опрос завершается, а пользователь возвращается к списку. В списке черновиков состояние опрашивает сам список.
+     */
+    private watchProfstroyProcessing;
+    /**
+     * Сообщает, что черновик не найден, и возвращает к списку черновиков.
+     *
+     * @param draftId Идентификатор черновика.
+     */
+    private leaveMissingDraft;
     static ɵfac: i0.ɵɵFactoryDeclaration<ScDraftComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ScDraftComponent, "sc-draft", never, { "draft": { "alias": "draft"; "required": false; "isSignal": true; }; }, { "draft": "draftChange"; "deleteEvent": "deleteEvent"; }, never, never, true, never>;
 }

package/order/draft/services/sc-draft-expiration-clock.service.d.ts

@@ -0,0 +1,29 @@
+import { Signal } from '@angular/core';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Сервис текущего момента для меток и проверок срока актуализации черновиков Профстрой. Момент обновляется с интервалом проверки срока
+ * актуализации одним таймером на всех подписчиков, поэтому список черновиков, страница черновика и оформление заказа видят один момент.
+ * Таймер работает, только пока есть подписчики.
+ */
+export declare class ScDraftExpirationClockService {
+    /**
+     * Интервалы обновления данных.
+     */
+    private readonly updateInterval;
+    /**
+     * {@link Observable} текущего момента. Первый подписчик запускает таймер, после отписки всех подписчиков таймер останавливается.
+     * Следующие подписчики сразу получают последний момент, а не новый: он может отставать от текущего времени не больше чем
+     * на интервал проверки срока, и метки срока у нового подписчика обновятся на ближайшем тике общего таймера.
+     */
+    readonly now$: Observable<Date>;
+    /**
+     * Возвращает сигнал текущего момента, который обновляется общим таймером, только пока признак истинен. Вызывается в контексте
+     * внедрения зависимостей, например при объявлении поля компонента: подписка живёт, пока жив компонент.
+     *
+     * @param active Признак, пока он истинен, момент обновляется.
+     */
+    nowWhile(active: Signal<boolean>): Signal<Date>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScDraftExpirationClockService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ScDraftExpirationClockService>;
+}