mdt-client 31.0.11 → 31.0.13

package/package.json

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

package/types/helpers/types.d.ts

@@ -57,6 +57,7 @@ export declare type MithrilAttributes = _mithril.MithrilAttributes & {
 };
 export declare type MithrilVirtualElementKey = string | number;
 export declare type HTMLAnchorTarget = "_blank" | "_self" | "_parent" | "_top" | "framename";
+export declare type HTMLString = string;
 export declare type KeyboardKeyCode = string;
 export declare type AnyError = any;
 export declare type FieldPath = string;

package/types/helpers/ui/elementModificators/focusableComponent.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="../../../../mithril" />
 /// <reference types="mithril" />
-import { KeyboardKeyCode } from "../../../helpers/types";
+import { KeyboardKeyCode } from "../../types";
 import { ComponentConfigParams } from "./modificatorsTypes";
 export declare function doesKeyPressed(keyCode: KeyboardKeyCode | KeyboardKeyCode[], e: KeyboardEvent): boolean;
 export declare function getFocusableComponentAttrs(): _mithril.MithrilAttributes;

package/types/helpers/utils/valued/getValued.d.ts

@@ -0,0 +1,18 @@
+declare type ValuedParams<F> = F extends (...args: infer A) => unknown ? A : never;
+declare type ValuedExtract<F> = F extends (...args: any[]) => infer R ? R : F;
+/**
+ * @example
+const o = {
+    a1: getValued(123), // number
+    a2: getValued(() => 123), // number
+    a3: getValued(() => "str"), // string
+    a4: getValued((s: string) => `str:${s}`, "one"), // string
+    a5: getValued((s: string, n: number) => `str:${s}${n.toString()}`, "one", 123), // string
+    a6: getValued((s: string, n: string) => ({ name: s, value: n }), "one", "v"), // { name: string; value: string; }
+    a7: getValued((s: string, n: string) => ({ name: s, value: n }), "one", 123), // Error
+    a8: getValued("str", "one", 123), // Error
+    a9: getValued((s?: string, n?: string) => ({ name: s, value: n }), "one") // { name: string; value: string; }
+};
+ */
+export declare function getValued<F>(main: F, ...args: ValuedParams<F>): ValuedExtract<F>;
+export {};

package/types/services/api/ApiAccessor/apiV1Types.d.ts

@@ -1,5 +1,5 @@
 import { HierarchicalRecord, MdtRecord, RecordId } from "mdtScripts/common/Record";
-import { AnyObject, FieldCode, FieldId, ObjectCode } from "mdtScripts/helpers/types";
+import { AnyObject, FieldCode, ObjectCode } from "mdtScripts/helpers/types";
 import { PermissionLevel } from "mdtScripts/security/PermissionLevel";
 export declare namespace ApiV1 {
     namespace Request {
@@ -149,7 +149,7 @@ export declare namespace ApiV1 {
                     BaseLevel: PermissionLevel;
                     Level: PermissionLevel;
                     Fields: {
-                        [fieldId: FieldId]: {
+                        [fieldId: number]: {
                             Level: PermissionLevel;
                         };
                     };
@@ -167,6 +167,14 @@ export declare namespace ApiV1 {
             }
             type StorageProvider = "db";
         }
+        export namespace Template {
+            interface Preview {
+                Context: AnyObject;
+                Script: string;
+                Header: string;
+                Text: string;
+            }
+        }
         export {};
     }
     type AggregationType = "sum" | "avg" | "count" | "distinct" | "max" | "min";

package/types/services/customModules/facades/Form/IFormControlFacade.d.ts

@@ -58,6 +58,8 @@ export interface IFormControlFacade extends ParentCtrl {
     setControlOptions(findControl: (col: any) => boolean, controlOptions: any): any;
     /** Установить флаг доступности редактирования формы */
     setReadonly(readonly: boolean): void;
+    /** Проверка, доступна ли форма для редактирования */
+    isReadonly(): boolean;
     /** Изменить свойства существующей кнопки */
     updateCommand(findCondition: (button: ButtonFacade) => boolean, command: Partial<ButtonFacade>): void;
     /** Повторно инициализировать форму */

package/types/services/customModules/facades/Form/IFormFacade.d.ts

@@ -52,7 +52,7 @@ export interface FormViewSettings {
 }
 export interface IFormServiceFacade {
     /** Создать форму, привязанную объекту */
-    create(tableCode: string, id: RecordId, options?: any, extOptions?: any): IFormControlFacade;
+    create(tableCode: string, id?: RecordId, options?: any, extOptions?: any): IFormControlFacade;
     /** Создать кастомную форму */
     createCustom(options: IFormOptions): IFormControlFacade;
     /** Подписаться на событие инициализации формы */

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

@@ -0,0 +1,38 @@
+export interface IAppFacade {
+    /**
+     * Изменить логотип системы
+     *
+     * @param logo текст, ссылка или строка с svg
+     * @param type тип логотипа, по умолчанию svgOrText
+     *
+     * @example
+     *  **Примеры**
+
+     * Установить текст в логотип:
+     * ```js
+     * App.setLogo("ICS");
+     * ```
+
+     * Установить svg в качестве логотипа:
+     * ```js
+        const svgIcsLogo = `<svg xmlns="http://www.w3.org/2000/svg" width="90" height="32" viewBox=" 0 0 102 32" fill="none"><g clip-path="url(#clip0)"><path d="M5.47418 8.14642H0.216797L1.54442 12.9067H5.47418V32H10.3067V13.8483V8.14642H5.47418Z" fill="#ffffff" /><path d="M52.7375 13.0113L54.0651 8.14642H44.1345C40.0985 8.14642 36.8591 11.3374 36.8591 15.313C36.8591 19.2362 40.0454 22.4272 44.0283 22.4795V22.5318H49.8167C51.0912 22.5318 52.1533 23.578 52.1533 24.8334C52.1533 26.0889 51.0912 27.1351 49.8167 27.1351H38.0805L36.7529 32H49.8167C53.8527 32 57.0921 28.809 57.0921 24.8334C57.0921 20.9102 53.8527 17.6669 49.8698 17.6669H44.1345C42.8599 17.6669 41.7979 16.6207 41.7979 15.3653C41.7979 14.1098 42.8599 13.0636 44.1345 13.0636H52.7375V13.0113Z" fill="#ffffff" /> <path d="M25.1225 8.14642C18.4313 8.14642 13.0146 13.4821 13.0146 20.0732C13.0146 26.6643 18.4313 32 25.1225 32H32.8227L33.991 27.0828H25.0163C21.0334 27.0828 17.8471 23.9442 17.8471 20.0209C17.8471 16.0976 21.0334 12.959 25.0163 12.959H32.7165L33.9379 8.19873L25.1225 8.14642Z" fill="#ffffff" /> <path d="M94.1056 27.135C90.3882 27.135 87.4143 24.1533 87.4143 20.5439V14.0051V12.8019H95.2739L96.6015 7.98943H87.4143V5.16467V0.0905457H82.4756V5.16467V7.93712V13.6389V15.9929V16.2544V20.4916C82.4756 26.8212 87.6799 31.9476 94.1056 31.9476H100.106L101.434 27.0827L94.1056 27.135Z" fill="#ffffff" /> <path d="M74.4046 8.0416H69.1472L67.9258 12.7495H74.4046V31.8429H79.2902V13.6911V8.0416H74.4046Z" fill="#ffffff" /> <path d="M10.3682 4.99186V0.179291L5.48254 0.179291V4.99186H10.3682Z" fill="#29ABE2" /> <path d="M79.2646 4.81256V0L74.3789 0V4.81256H79.2646Z" fill="#29ABE2" /> <path d="M60.4912 22.4797L61.7657 17.6671H66.6514L65.3769 22.4797H60.4912Z" fill="#29ABE2" /> </g> <defs> <clipPath id="clip0"> <rect width="102" height="32" fill="white" /> </clipPath> </defs> </svg>`
+        App.setLogo(svgIcsLogo);
+     * ```
+
+     * Установить ссылку на изображение:
+     * ```js
+     * App.setLogo("https://ics-it.ru/api/static?path=_logo.svg", "url");
+     * ```
+
+     * Отключить логотип:
+     * ```js
+     * App.setLogo(null);
+     * ```
+     */
+    setLogo(logo: string | false, type?: LogoType): void;
+    /**
+     * Изменить дополнительный логотип, справа от основного, аналогично {@link setLogo}
+     */
+    setSecondLogo(logo: string | false, type?: LogoType): void;
+}
+export declare type LogoType = "textOrSvg" | "url";

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

@@ -1,9 +1,91 @@
 /** @deprecated */
 export interface ILegacyFacade {
-    /** @deprecated */
-    LayoutBuilder: any;
-    /** @deprecated */
     SchemaManagerInstance: any;
-    /** @deprecated */
     SchemaManager: any;
+    NavigationManagerInstance: any;
+    DateTextFieldCtrl: any;
+    FormlessFieldCtrl: any;
+    MonthPicker: any;
+    UiMarked: any;
+    prop: any;
+    ImageService: any;
+    FormLayoutManager: any;
+    removeSpecial: any;
+    ServerErrorCtrl: any;
+    showErrors: any;
+    CheckboxListFieldCtrl: any;
+    SplitBlockCtrl: any;
+    SplitBlockSection: any;
+    pickRecordModal: any;
+    uiCtxEvent: any;
+    uiRedraw: any;
+    ApiAccessorInstance: any;
+    ApiAccessor: any;
+    clone: any;
+    mClassNames: any;
+    isDev: any;
+    ModuleService: any;
+    ApiServiceInstance: any;
+    SecurityManagerInstance: any;
+    FormControlManagerInstance: any;
+    RecordManagerInstance: any;
+    utils: any;
+    FormServiceInstance: any;
+    ListServiceInstance: any;
+    ui: any;
+    viewer: any;
+    deleteFromArray: any;
+    onDocumentVisibilityChange: any;
+    fireEvent: any;
+    combine: any;
+    app: any;
+    ContentListCtrl: any;
+    ListCtrl: any;
+    FormCtrl: any;
+    FieldCtrl: any;
+    FkPanels: any;
+    FramePage: any;
+    PageZones: any;
+    modules: {
+        pbi: {
+            PbiFrameCtrl: any;
+        };
+        etl: {
+            FormValueManager: any;
+            EtlPanel: any;
+        };
+        mapping: {
+            MappingListExtender: any;
+            MappingManager: any;
+        };
+        admin: {
+            DesignerHelper: any;
+        };
+        binding: {
+            UnbindingForm: any;
+        };
+    };
+    pageConfig: any;
+    view: any;
+    NavigationControlManager: any;
+    messages: any;
+    registerForm: any;
+    components: any;
+    FieldControlManagerInstance: any;
+    ServerMessageCtrl: any;
+    ContainerMixin: any;
+    SelectFieldCtrl: any;
+    FormFieldMode: any;
+    FormFieldCtrl: any;
+    FullPageForm: any;
+    LabelMode: any;
+    WarningText: any;
+    showError: any;
+    SelectMixin: any;
+    CacheManager: any;
+    ControlSize: any;
+    LayoutBuilder: any;
+    ServerMessageHelper: any;
+    showSidebar: any;
+    uiShow: any;
 }

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

@@ -21,10 +21,13 @@ import { IPageFacade } from "./IPageFacade";
 import { CommandManagerFacade } from "./services/CommandManagerFacade";
 import { IRecordManagerFacade } from "./record/IRecordManagerFacade";
 import { ILegacyFacade } from "./ILegacyFacade";
+import { IAppFacade } from "./IAppFacade";
+import { InternalModulesFacade } from "./internalModules/modulesFacadeTypes";
 export declare type ModulePackageInfo = {
     version: string;
     name?: string;
 };
+export declare type ModuleCallback = () => Promise<void> | void;
 export interface IMDTFacade {
     /** Mithril библиотека */
     m: _mithril.MithrilStatic;
@@ -62,10 +65,13 @@ export interface IMDTFacade {
     Auth: IAuthFacade;
     /** Управление страницей */
     Page: IPageFacade;
+    /** Управление приложением */
+    App: IAppFacade;
     /** Управление командами */
     CommandManager: CommandManagerFacade;
     /** @deprecated */
     legacy: ILegacyFacade;
+    modules: InternalModulesFacade;
     /** Зарегистрировать модуль */
-    registerModule(callback: () => void, moduleData: ModulePackageInfo): void;
+    registerModule(callback: ModuleCallback, moduleData: ModulePackageInfo): void;
 }

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

@@ -9,6 +9,7 @@ import { FieldCode, FieldPath, ViewElement } from "../../../../helpers/types";
 import { ILayoutColumnBase } from "../../../../views/list/IListView";
 import { ClassNamesArg } from "mdtScripts/helpers/utils/classNames";
 import { IColumnFacade } from "./Column/IColumnFacade";
+import { RecordValueFacade } from "../record/IRecordFacade";
 export interface IListControlFacadeContstructor {
     new (listCtrl: any): IListControlFacade;
 }
@@ -54,19 +55,15 @@ export interface ColumnOptions<Control = any> {
     headerView: (control: Control) => ViewElement;
     headerStyle?: (control: Control) => ClassNamesArg;
     cellView: (ctx: {
-        row: ColumnValueHandlerRowFacade;
+        row: RecordValueFacade;
     }, control: Control) => ViewElement;
     cellStyle?: (ctx: {
-        row: ColumnValueHandlerRowFacade;
+        row: RecordValueFacade;
     }, control: Control) => ClassNamesArg;
     position?: (columns: IColumnFacade[]) => number;
 }
 export interface IColumnValueHandlerCtx {
-    row: ColumnValueHandlerRowFacade;
+    row: RecordValueFacade;
     col: ILayoutColumnBase;
     idx?: number;
 }
-interface ColumnValueHandlerRowFacade {
-    getValue: (path: FieldPath) => any;
-}
-export {};

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

@@ -1,5 +1,5 @@
 import { Field } from "../../../../../scripts/common/Field";
-import { ObjectCode, ViewControl } from "../../../../../scripts/helpers/types";
+import { ObjectCode, ViewControl } from "../../../../helpers/types";
 import { MdtRecord } from "../utils/IApiFacade";
 import { IListControlFacade } from "./IListControlFacade";
 export interface IListInitOptions {

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

@@ -0,0 +1,9 @@
+import { ViewControl } from "mdtScripts/helpers/types";
+export interface ImportModuleFacade {
+    "mdt.import": {
+        ImportForm: ImportFormFacade;
+    };
+}
+export interface ImportFormFacade {
+    new (objectCode: string, options?: any): ViewControl;
+}

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

@@ -0,0 +1,11 @@
+import type { ImportModuleFacade } from "./importModuleFacade";
+import { StatusModuleFacade } from "./statusFacade";
+export interface InternalModulesFacade {
+    /**
+     * Возвращает фасад модуля. Если фасада нет или модуль не подключен, то метод выбрасывает ошибку.
+     * @throws {Error} - Выбрасывает ошибку, если имя не найдено
+     * @param moduleName - имя модуля
+     */
+    get<T extends keyof InternalModulesTypes>(moduleName: T): InternalModulesTypes[T];
+}
+export declare type InternalModulesTypes = ImportModuleFacade & StatusModuleFacade;

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

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

package/types/services/customModules/facades/record/IRecordFacade.d.ts

@@ -0,0 +1,13 @@
+import { FieldCode, FieldPath, ObjectCode } from "../../../../helpers/types";
+export declare type RecordFacade = RecordValueFacade & RecordChangesFacade;
+export interface RecordValueFacade {
+    /** Получить значение записи по пути. */
+    getValue: (path: FieldPath) => any;
+}
+export interface RecordChangesFacade {
+    changes: RecordChanges;
+}
+export declare type RecordChanges = {
+    record: Record<FieldCode, any>;
+    table: ObjectCode;
+};

package/types/services/customModules/facades/utils/IApiFacade.d.ts

@@ -2,17 +2,26 @@ import { BaseQuery } from "../../../../services/api/BaseQuery";
 import { FetchResult } from "../../../../datasources/FetchResult";
 import { ApiRequestOptions } from "../../../../services/api/ApiRequestOptions";
 import { RecordId } from "../../../../common/Record";
+import { AnyObject } from "mdtScripts/helpers/types";
 export interface QueryParams {
     [param: string]: string | number;
 }
 export interface IApiFacade {
     /** Отправить запрос на получение данных по объекту */
     fetch<R = FetchResult>(objectCode: string, query?: BaseQuery): Promise<R>;
+    /** Отправить запрос к функции */
+    fetchFunction<R extends FetchResult = FetchResult>(objectCode: string, params?: AnyObject, query?: BaseQuery): Promise<R>;
     /** Отправить запрос на получение одной записи из объекта */
     fetchRecord<R = FetchResult>(objectCode: string, query?: BaseQuery): Promise<R>;
-    /** Отправить запрос к функции */
+    /**
+     * @deprecated
+     * Отправить запрос к функции
+     */
     fetchFromFunction<R extends FetchResult = FetchResult>(objectCode: string, query?: BaseQuery, params?: any[]): Promise<R>;
-    /** Отправить запрос на получение одной записи из функции */
+    /**
+     * @deprecated
+     * Отправить запрос на получение одной записи из функции
+     */
     fetchRecordFromFunction<R = any>(objectCode: string, query?: BaseQuery, params?: any[]): Promise<R>;
     /** Отправить запрос к хранимой процедуре */
     executeStoredProcedure<Result = any>(objectCode: string, params: any): PromiseLike<Result>;

package/types/services/customModules/facades/utils/IUtilsFacade.d.ts

@@ -1,10 +1,11 @@
-import { AnyObject } from "../../../../helpers/types";
 import { KeyStorage } from "../../../../helpers/utils/keyStorage/KeyStorage";
 import { FormatOptions } from "../../../../helpers/formatOptions";
 import { IListButtonExtendPipelineService } from "../services/IListButtonExtendPipelineService";
+import { getValued } from "mdtScripts/helpers/utils/valued/getValued";
+import { AnyObject } from "mdtScripts/helpers/types";
 export interface IUtilsFacade {
     ListButtonExtendPipelineService: IListButtonExtendPipelineService;
-    getText(textCode: string, args?: AnyObject): string;
+    getText(textCode: string, args?: AnyObject, complex?: true): string;
     format(value: any, options?: FormatOptions): any;
     guid(): string;
     getStorageItem<T>(key: string, defaultValue?: T): KeyStorage<T>;
@@ -14,4 +15,5 @@ export interface IUtilsFacade {
      * Увеличить лимит времени загрузки можно с помощью глобальной переменной mdt.file.download.timeLimit
      */
     downloadFile(url: string): void;
+    getValued: typeof getValued;
 }