mdt-client 31.3.43 → 31.3.45

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mdt-client",
-	"version": "31.3.43",
+	"version": "31.3.45",
 	"description": "",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/types/common/FieldSettings.schema.d.ts

@@ -1,4 +1,5 @@
 import IMask from "imask";
+import { DurationFormatOptions, DurationUnit } from "mdtHelpers/utils/duration/durationFormatTypes";
 export interface FieldSettings {
     /**
      * Маска отображает значение в заданном формате в списке и на форме. Например, число можно отобразить как "1 234,56" или "1234.56".
@@ -14,4 +15,18 @@ export interface FieldSettings {
          */
         visibleItemsLimit?: number;
     };
+    /**
+     * Настройки для полей типа duration
+     */
+    durationOptions?: {
+        /**
+         * Единица хранимого значения.
+         * @default "milliseconds"
+         */
+        unit?: DurationUnit;
+        /**
+         * Настройки формата отображения длительности.
+         */
+        formatOptions?: DurationFormatOptions;
+    };
 }

package/types/common/form/tabs/TabsFormExtenderOptions.d.ts

@@ -1,3 +1,4 @@
+import { Valued, ViewElement } from "mdtScripts/helpers/types";
 export interface TabsFormExtenderPublicOptions {
     tabs: FormTab[];
 }
@@ -9,4 +10,5 @@ export interface FormTab {
     order?: number;
     visible?: () => boolean;
     onShow?: (init: boolean) => void;
+    rightZone?: Valued<ViewElement>;
 }

package/types/components/dropdown/menu/item/dropdownItemWrapOptions.d.ts

@@ -3,11 +3,11 @@ import { DropdownMenuItemBaseOptions, DropdownMenuItemOptions, DropdownMenuItemW
 export interface DropdownItemBaseOptions {
     className?: string;
     idx?: number;
+    role?: string;
 }
 export interface DropdownItemOptions<T extends DropdownMenuItemBaseOptions = DropdownMenuItemBaseOptions> extends DropdownItemBaseOptions {
     focused?: boolean;
     actionItemOptions: T;
-    role?: string;
 }
 export type DropdownBaseItemOptions = DropdownItemOptions<DropdownMenuItemOptions>;
 export type DropdownItemWithMoreOptions = DropdownItemOptions<DropdownMenuItemWithChildrenOptions>;

package/types/helpers/formatOptions.d.ts

@@ -1,5 +1,6 @@
 import { MaskOptions } from "mdtScripts/components/baseFormControls/maskedInput/MaskFormatter.types";
 import { PeriodBoundaryIcon } from "mdtScripts/data/periods/helpers/types";
+import { DurationFormatOptions, DurationUnit } from "mdtHelpers/utils/duration/durationFormatTypes";
 export interface FormatOptions {
     type?: string;
     title?: string;
@@ -13,4 +14,11 @@ export interface FormatOptions {
      */
     maskOptions?: MaskOptions;
     dateRangeIcon?: PeriodBoundaryIcon;
+    /**
+     * Настройки форматирования длительности (для типа duration)
+     */
+    durationOptions?: {
+        unit?: DurationUnit;
+        formatOptions?: DurationFormatOptions;
+    };
 }

package/types/helpers/pipeline/Pipeline.d.ts

@@ -9,7 +9,7 @@ export declare class Pipeline<D = any> {
     execute(args: D, onComplete: (args: D) => void, onError?: (e: AnyError) => void): void;
     executePromise(args: D): Promise<D>;
 }
-type MiddlewareSync<D> = (args: D) => D | undefined;
+export type MiddlewareSync<D> = (args: D) => D | undefined;
 export declare class PipelineSync<D = any> {
     private middlewaresStorage;
     constructor(middlewares?: MiddlewareSync<D>[]);

package/types/helpers/utils/duration/durationFormatTypes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Единица хранимого значения длительности.
+ * Определяет, в каких единицах хранится числовое значение поля.
+ */
+export type DurationUnit = "milliseconds" | "seconds" | "minutes" | "hours";
+/**
+ * Сериализуемые настройки формата длительности (подмножество Intl.DurationFormatOptions).
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat/DurationFormat
+ */
+export type DurationFormatOptions = {
+    /** Локаль форматирования (BCP 47, default: текущая локаль). Допустимы как "ru", так и "ru-RU" */
+    locale?: string;
+    /**
+     * Стиль отображения:
+     * - "long" (1 час 30 минут 5 секунд)
+     * - "short" (1 ч. 30 мин. 5 сек.)
+     * - "narrow" (1ч 30м 5с)
+     * - "digital" (1:30:05)
+     */
+    style?: "long" | "short" | "narrow" | "digital";
+};

package/types/helpers/utils/object.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Removes keys with `undefined` values from an object before passing it to Mithril as vnode attrs.
+ * Mithril (v1) renders `undefined` and `null` values as literal strings in the DOM (e.g. `id="undefined"`),
+ * because it sets attributes unconditionally without checking for nullish values.
+ */
+export declare function omitNullish<T extends Record<string, unknown>>(obj: T): Partial<T>;
 export declare function hasOwnProperty(object: Record<never, unknown>, name: string): boolean;
 export declare function shallowCopy<T>(obj: T): T;
 export declare function copyWithIgnore<T, K extends keyof T = null>(obj: T, ignore: K[]): Omit<T, K>;

package/types/services/api/ApiAccessor/job/jobApiTypes.d.ts

@@ -0,0 +1,83 @@
+import { RecordId } from "mdtScripts/common/Record";
+import { AnyObject, ObjectId, URLString } from "mdtScripts/helpers/types";
+export declare namespace ApiV1 {
+    namespace Request {
+        interface JobTask {
+            ObjectId?: number;
+            RecordId?: number;
+            RecordIds?: number[];
+            Args?: AnyObject;
+            /**
+             * Тип файла для экспорта результата выполнения задачи (например, "pdf", "docx", "txt").
+             * Определяет формат ответа сервера: если свойство указано, результат содержит URL для скачивания файла
+             */
+            File?: string;
+        }
+        namespace Job {
+            interface ExecProc {
+                process: RecordId;
+            }
+            interface ExecTask {
+                taskCode: string;
+            }
+            interface StopTask {
+                taskCode: string;
+            }
+            interface IsRunning {
+                taskCode: string;
+            }
+        }
+    }
+    namespace Response {
+        namespace Job {
+            export type ExecTask = FileExecutionResult | StoredProcExecutionResult | TextExecutionResult | EmptyExecutionResult;
+            interface FileExecutionResult {
+                Type: "File";
+                Url: URLString;
+            }
+            interface StoredProcExecutionResult {
+                Type: "StoredProc";
+                ID_ProcedureObject: ObjectId;
+            }
+            interface TextExecutionResult {
+                Type: "Text" | "Error";
+                Text: string;
+                Header: string;
+            }
+            interface EmptyExecutionResult {
+                Type: "Empty";
+            }
+            export {};
+        }
+    }
+}
+export declare namespace ApiV2 {
+    namespace Request {
+        type ExecProc = ApiV1.Request.Job.ExecProc;
+        type ExecTask = ApiV1.Request.Job.ExecTask;
+        type StopTask = ApiV1.Request.Job.StopTask;
+        type IsRunning = ApiV1.Request.Job.IsRunning;
+    }
+    namespace Response {
+        namespace Job {
+            export type ExecTask = FileExecutionResult | StoredProcExecutionResult | TextExecutionResult | EmptyExecutionResult;
+            interface FileExecutionResult {
+                type: "File";
+                url: URLString;
+            }
+            interface StoredProcExecutionResult {
+                type: "StoredProc";
+                id_ProcedureObject: ObjectId;
+            }
+            interface TextExecutionResult {
+                type: "Text";
+                text: string;
+                header: string;
+            }
+            interface EmptyExecutionResult {
+                type: "Empty";
+            }
+            export {};
+        }
+    }
+}

package/types/services/customModules/facades/ILegacyFacade.d.ts

@@ -92,6 +92,7 @@ export interface ILegacyFacade {
         HierarchyListExtender: any;
         LabelStyleHelper: any;
         LabelStyleCellView: any;
+        labelStyleView: any;
     };
     CenteredMessageCtrl: any;
     PageHeaderControls: any;

package/types/services/customModules/facades/List/IListCellFacade.d.ts

@@ -4,5 +4,6 @@ import { IListComponentFacade } from "./IListComponentFacade";
 export interface IListCellFacade extends IListComponentFacade {
     col: ILayoutColumnBase & LayoutColumnValued;
     value(): any;
+    /** Заменить содержимое ячейки */
     setContent(content: ViewElement[]): void;
 }

package/types/services/customModules/facades/List/IListControlFacade.d.ts

@@ -51,6 +51,8 @@ export interface IListControlFacade extends ParentCtrl {
     /** Изменить значение отображаемое в колонке */
     setColumnValueHandler(codeOrPath: FieldCode | FieldPath, handler: (value: any, ctx: IColumnValueHandlerCtx) => ViewElement): any;
     addColumn<Control>(column: ColumnOptions<Control>): void;
+    /** Установить контрол для колонок, удовлетворяющих предикату */
+    setColumnControl(fn: (col: ILayoutColumnBase) => boolean, control: any): void;
     /**
      * Вызывается при отображении элемента списка
      */

package/types/services/customModules/facades/internalModules/importModuleFacade.d.ts

@@ -1,19 +1,17 @@
 import { ViewControl } from "mdtScripts/helpers/types";
 import { ImportFormData, ImportUploadCtrlOptions, ImportPreviewCtrlOptions, MappingCtrlOptions, ImportDefaultValuesOptions } from "./importFormCtrl.types";
 export interface ImportModuleFacade {
-    "mdt.import": {
-        ImportForm: ImportFormFacade;
-        ImportUploadCtrl: ImportUploadCtrlFacade;
-        ImportPreviewCtrl: ImportPreviewCtrlFacade;
-        ImportMappingCtrl: ImportMappingCtrlFacade;
-        ImportDefaultValues: ImportDefaultValuesFacade;
-        ImportService: ImportServiceFacade;
-        utils: {
-            prepareFieldCodes: (record: {
-                [key: string]: any;
-            }) => {
-                [key: string]: any;
-            };
+    ImportForm: ImportFormFacade;
+    ImportUploadCtrl: ImportUploadCtrlFacade;
+    ImportPreviewCtrl: ImportPreviewCtrlFacade;
+    ImportMappingCtrl: ImportMappingCtrlFacade;
+    ImportDefaultValues: ImportDefaultValuesFacade;
+    ImportService: ImportServiceFacade;
+    utils: {
+        prepareFieldCodes: (record: {
+            [key: string]: any;
+        }) => {
+            [key: string]: any;
         };
     };
 }

package/types/services/customModules/facades/internalModules/jobFacade.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="../../../../mithril" />
+import { Field } from "ics-ui-kit/dist/vendors/react-hook-form";
+import { ApiV1, ApiV2 } from "mdtServices/api/ApiAccessor/job/jobApiTypes";
+export interface JobModuleFacade {
+    /** Выполняет запрос на выполнение службы */
+    request: (taskCode: string, context?: JobContextFacade) => PromiseLike<JobExecutionResult>;
+    /**
+     * Выполняет запрос на выполнение службы и выполняет стандартную обработку результата в зависимости от типа
+     * - "Empty": отображение информационного сообщения
+     * - "File": скачивание файла
+     * - "StoredProc": выполнение хранимой процедуры
+     * - "Text": отображение текстового результата в модальном окне
+     * */
+    exec: (taskCode: string, context?: JobContextFacade) => PromiseLike<MPromise<JobExecutionResult>>;
+}
+type JobContextFacade = ApiV1.Request.JobTask & {
+    formContext?: ParentFormContextFacade;
+};
+type JobExecutionResult = ApiV2.Response.Job.ExecTask;
+interface ParentFormContextFacade<FormType = any, FieldType = Field> {
+    parentForm?: FormType;
+    parentField?: FieldType;
+}
+export {};

package/types/services/customModules/facades/internalModules/modulesFacadeTypes.d.ts

@@ -1,4 +1,5 @@
 import type { ImportModuleFacade } from "./importModuleFacade";
+import { JobModuleFacade } from "./jobFacade";
 import { StatusModuleFacade } from "./statusFacade";
 export interface InternalModulesFacade {
     /**
@@ -8,4 +9,8 @@ export interface InternalModulesFacade {
      */
     get<T extends keyof InternalModulesTypes>(moduleName: T): InternalModulesTypes[T];
 }
-export type InternalModulesTypes = ImportModuleFacade & StatusModuleFacade;
+export type InternalModulesTypes = {
+    "mdt.import": ImportModuleFacade;
+    "mdt.status": StatusModuleFacade;
+    "mdt.job": JobModuleFacade;
+};

package/types/services/customModules/facades/internalModules/statusFacade.d.ts

@@ -1,9 +1,7 @@
 import { ObjectCode } from "../../../../helpers/types";
 import { RecordFacade } from "../record/IRecordFacade";
 export interface StatusModuleFacade {
-    "mdt.status": {
-        statusChangeHandler: (status: StatusCode, handler: ChangeStatusHandler) => void;
-    };
+    statusChangeHandler: (status: StatusCode, handler: ChangeStatusHandler) => void;
 }
 export type ChangeStatusHandler = ({ record, object }: StatusChangeHandlerContext) => void | Promise<void>;
 export type StatusCode = string;

package/types/services/customModules/facades/schema/ISchemaFacade.d.ts

@@ -3,7 +3,7 @@ import { IObjectFacade } from "./IObjectFacade";
 import { BaseBuilderTypes } from "./fieldBuilder/fieldBuilder/IFieldBuilder";
 import { IFieldFkBuilder } from "./fieldBuilder/fieldFkBuilder/IFieldFkBuilder";
 declare const allFieldPhysicalTypes: readonly ["bigint", "binary", "bit", "char", "date", "datetime", "datetime2", "datetimeoffset", "decimal", "float", "geography", "geometry", "hierarchyid", "image", "int", "money", "nchar", "ntext", "numeric", "nvarchar", "real", "smalldatetime", "smallint", "smallmoney", "sql_variant", "sysname", "text", "time", "timestamp", "tinyint", "uniqueidentifier", "varbinary", "varchar", "xml"];
-export declare const allFieldLogicalTypes: readonly ["number", "money", "long", "string", "date", "time", "datetime", "boolean", "image", "icon", "secret", "identifier", "url", "xml", "markdown", "query", "etl", "json"];
+export declare const allFieldLogicalTypes: readonly ["number", "money", "long", "string", "date", "time", "datetime", "boolean", "image", "icon", "secret", "identifier", "url", "xml", "markdown", "query", "etl", "json", "duration"];
 export type FieldPhysicalType = typeof allFieldPhysicalTypes[number];
 export type FieldLogicalType = typeof allFieldLogicalTypes[number];
 export type FieldType = FieldPhysicalType | FieldLogicalType;

package/types/services/customModules/facades/services/INavigationFacade.d.ts

@@ -1,3 +1,4 @@
+import { UiType } from "mdtScripts/helpers/IUi";
 import { AnyObject, URLString, Valued } from "mdtScripts/helpers/types";
 export interface CustomPageCtrl {
     new (node: ICustomNodeNavigationFacade): any;
@@ -81,7 +82,7 @@ interface CustomNavNodeValue {
     /** Значение узла навигации. Отображается рядом с заголовком */
     value?: string;
     /** Стиль значения узла */
-    style?: string;
+    style?: UiType;
     /** Иконка значения узла */
     icon?: string;
     /** Текст появляющийся при наведении на счетчик. Поддерживается markdown */

package/types/ui-kit/UiKitFacade.d.ts

@@ -37,6 +37,7 @@ import * as tabs from "ics-ui-kit/dist/components/tabs";
 import * as tag from "ics-ui-kit/dist/components/tag";
 import * as textarea from "ics-ui-kit/dist/components/textarea";
 import * as toast from "ics-ui-kit/dist/components/toast";
+import * as toggle from "ics-ui-kit/dist/components/toggle";
 import * as toggleGroup from "ics-ui-kit/dist/components/toggle-group";
 import * as toolbar from "ics-ui-kit/dist/components/toolbar";
 import * as tooltip from "ics-ui-kit/dist/components/tooltip";
@@ -93,6 +94,7 @@ export declare class UiKitFacade {
         readonly tag: typeof tag;
         readonly textarea: typeof textarea;
         readonly toast: typeof toast;
+        readonly toggle: typeof toggle;
         readonly "toggle-group": typeof toggleGroup;
         readonly tooltip: typeof tooltip;
         readonly toolbar: typeof toolbar;