@infomaximum/widget-sdk 4.0.0-beta3 → 4.0.0-beta31

package/dist/index.d.ts

@@ -33,7 +33,9 @@ declare enum EControlType {
     displayCondition = "displayCondition",
     eventsColor = "eventsColor",
     inputMarkdown = "inputMarkdown",
-    filter = "filter"
+    filter = "filter",
+    actionOnClick = "actionOnClick",
+    eventsPicker = "eventsPicker"
 }
 /** Конфигурация элемента управления настройкой */
 interface IControlRecord<Settings extends object, Value, ControlType = EControlType> {
@@ -77,6 +79,9 @@ interface ICalculatorIndicatorOutput {
 interface ICalculatorDimensionInput extends ICalculatorIndicatorInput {
     formula: string;
     hideEmpty?: boolean;
+    /** Временно поддерживается обратная совместимость с форматом { alias: string; formula: string }[] */
+    /** Появилась необходимость в ленточном графике, т.к. разрез длительность используется, как мера */
+    additionalFormulas?: Map<string, string>;
 }
 interface ICalculatorDimensionOutput extends ICalculatorIndicatorOutput {
 }
@@ -259,6 +264,7 @@ declare enum EDurationUnit {
 declare const mapFormulaFilterToCalculatorInput: (filterValue: IFormulaFilterValue | string) => TNullable<ICalculatorFilter>;
 declare const mapFormulaFiltersToInputs: (filters: (string | IFormulaFilterValue)[]) => ICalculatorFilter[];
 
+type TSelectivePartial<T, Keys extends keyof T> = Omit<T, Keys> & Partial<Pick<T, Keys>>;
 declare const formulaFilterMethods: {
     readonly LAST_TIME: "LAST_TIME";
     readonly EQUAL_TO: ECalculatorFilterMethods.EQUAL_TO;
@@ -288,6 +294,7 @@ declare enum EProcessFilterNames {
     /** Длительность перехода */
     durationOfTransition = "durationOfTransition"
 }
+/** @deprecated необходимо использовать @see {@link IFormulaFilterValue} */
 interface IWidgetFormulaFilterValue extends ICalculatorFilter {
     /**
      * Название фильтра
@@ -304,16 +311,16 @@ interface IProcessFilterValue {
      * События, доступные при выборе процесса.
      * Если параметр не передан, используются все события процесса на основе запроса к вычислителю.
      */
-    eventsNamesByProcessGuidMap?: Map<string, (string | null)[]>;
+    eventsNamesByProcessNameMap?: Map<string, (string | null)[]>;
 }
 interface IProcessEventFilterValue extends IProcessFilterValue {
-    processGuid: string;
+    processName: string;
     eventName: string;
 }
 interface IProcessTransitionFilterValue extends IProcessFilterValue {
-    startEventProcessGuid: string;
+    startEventProcessName: string;
     startEventName: string;
-    endEventProcessGuid: string;
+    endEventProcessName: string;
     endEventName: string;
 }
 interface IAddPresenceOfEventFilter {
@@ -328,15 +335,6 @@ interface IAddPresenceOfTransitionFilter {
 interface IAddDurationOfTransitionFilter {
     (name: EProcessFilterNames.durationOfTransition, value: IProcessTransitionFilterValue): void;
 }
-interface IWidgetFiltration {
-    /** Значения фильтров, подготовленные для передачи в вычислитель */
-    preparedFilterValues: ICalculatorFilter[];
-    /** Добавить фильтр по формуле */
-    addFormulaFilter(value: IWidgetFormulaFilterValue): void;
-    /** Удалить фильтр по формуле */
-    removeFormulaFilter(formula: string): void;
-    addProcessFilter(...args: Parameters<IAddPresenceOfEventFilter> | Parameters<IAddRepetitionOfEventFilter> | Parameters<IAddPresenceOfTransitionFilter> | Parameters<IAddDurationOfTransitionFilter>): void;
-}
 declare enum EFormulaFilterFieldKeys {
     date = "date",
     dateRange = "dateRange",
@@ -360,7 +358,7 @@ interface IFormulaFilterValue {
     /** Метод фильтрации */
     filteringMethod: valueof<typeof formulaFilterMethods>;
     /** Выбранные в списке значения в виде моделей */
-    checkedValues: string[];
+    checkedValues: (string | null)[];
     /** Значения полей формы редактора */
     formValues: Partial<{
         [EFormulaFilterFieldKeys.date]: string | null;
@@ -374,6 +372,40 @@ interface IFormulaFilterValue {
         [EFormulaFilterFieldKeys.durationUnit]: EDurationUnit;
     }>;
 }
+interface IStagesFilterItem {
+    /** Название этапа */
+    name: string;
+    /** Формула фильтра этапа */
+    formula: string;
+    isSelected: boolean;
+}
+interface IStagesFilterValue {
+    /** Ключ виджета */
+    widgetKey: string;
+    /** Заголовок фильтра */
+    name: TNullable<string>;
+    /** Этапы */
+    stages: IStagesFilterItem[];
+}
+type TWidgetFilterValue = IFormulaFilterValue | IStagesFilterValue | IProcessEventFilterValue | IProcessTransitionFilterValue;
+interface IWidgetFilter {
+    filterValue: TWidgetFilterValue;
+    preparedFilterValue: ICalculatorFilter;
+}
+interface IWidgetFiltration {
+    /** Значения фильтров, подготовленные для передачи в вычислитель */
+    preparedFilterValues: ICalculatorFilter[];
+    filters: IWidgetFilter[];
+    /** Добавить фильтр по формуле */
+    addFormulaFilter(value: IWidgetFormulaFilterValue | TSelectivePartial<IFormulaFilterValue, "format" | "formValues">): void;
+    /** Удалить фильтр по формуле */
+    removeFormulaFilter(formula: string): void;
+    addProcessFilter(...args: Parameters<IAddPresenceOfEventFilter> | Parameters<IAddRepetitionOfEventFilter> | Parameters<IAddPresenceOfTransitionFilter> | Parameters<IAddDurationOfTransitionFilter>): void;
+    /** Добавить фильтр по этапам */
+    addStagesFilter(value: Omit<IStagesFilterValue, "widgetKey">): void;
+    /** Удалить фильтр по этапам */
+    removeStagesFilter(widgetKey: string): void;
+}
 
 declare enum EWidgetFilterMode {
     DEFAULT = "DEFAULT",
@@ -389,25 +421,62 @@ type TWidgetFiltering = {
     mode: EWidgetFilterMode;
 };
 declare enum EColorMode {
+    DISABLED = "DISABLED",
     FORMULA = "FORMULA",
     BASE = "BASE",
     GRADIENT = "GRADIENT",
-    AUTO = "AUTO"
+    AUTO = "AUTO",
+    RULE = "RULE",
+    VALUES = "VALUES",
+    BY_DIMENSION = "BY_DIMENSION"
 }
-/** Настройка цвета */
-type TColor = {
-    mode: EColorMode.FORMULA;
-    formula: string;
-} | {
+type TColorBase = {
     mode: EColorMode.BASE;
     value?: string;
     defaultColor?: string;
+};
+declare enum EColorScope {
+    WORKSPACE = "WORKSPACE",
+    DASHBOARD = "DASHBOARD"
+}
+type TColorRuleCommon = {
+    mode: EColorMode.RULE;
+    ruleName: string;
+};
+type TColorRule = ({
+    scope: EColorScope.DASHBOARD | null;
 } | {
+    scope: EColorScope.WORKSPACE;
+    workspaceGroupId: number | null;
+}) & TColorRuleCommon;
+interface IColoredValue {
+    value: string;
+    color: TColorBase | TColorRule;
+}
+declare enum EMarkdownDisplayMode {
+    NONE = "NONE",
+    INDICATOR = "INDICATOR"
+}
+/** Настройка цвета */
+type TColor = {
+    mode: EColorMode.FORMULA;
+    formula: string;
+} | TColorBase | {
     mode: EColorMode.GRADIENT;
     startValue: string;
     endValue: string;
 } | {
     mode: EColorMode.AUTO;
+} | TColorRule | {
+    mode: EColorMode.VALUES;
+    dimensionFormula: string;
+    items: IColoredValue[];
+} | {
+    mode: EColorMode.BY_DIMENSION;
+    dimensionName: string;
+    items: IColoredValue[];
+} | {
+    mode: EColorMode.DISABLED;
 };
 declare enum EDisplayConditionMode {
     DISABLED = "DISABLED",
@@ -422,7 +491,7 @@ type TDisplayCondition = {
     formula: TNullable<string>;
 } | {
     mode: EDisplayConditionMode.VARIABLE;
-    variableGuid: TNullable<string>;
+    variableName: TNullable<string>;
     variableValue: TNullable<string>;
 };
 interface IRange {
@@ -441,6 +510,7 @@ type TSortDirection = ESortDirection.ascend | ESortDirection.descend;
 interface ISortOrder {
     formula: string;
     direction: TSortDirection;
+    displayCondition?: TNullable<string>;
 }
 type TWidgetSortingValueRelatedWidgetMeasure = {
     mode: ESortingValueModes.MEASURE_IN_WIDGET;
@@ -456,7 +526,7 @@ type TWidgetSortingValue = {
     formula: string;
 } | TWidgetSortingValueRelatedWidgetIndicator | {
     mode: ESortingValueModes.IN_DASHBOARD | ESortingValueModes.IN_WORKSPACE;
-    guid: string;
+    name: string;
     formula: string;
 };
 
@@ -539,7 +609,6 @@ declare enum ESortingValueModes {
     IN_WORKSPACE = "IN_WORKSPACE"
 }
 interface ICommonColumnIndicator {
-    guid: string;
     name: string;
     formula: string;
 }
@@ -585,6 +654,10 @@ interface IWidgetDimension extends IWidgetColumnIndicator {
 interface IWidgetMeasure extends IWidgetColumnIndicator {
     type: EWidgetIndicatorType.MEASURE;
 }
+interface IMarkdownMeasure extends IWidgetMeasure {
+    format: EFormatTypes;
+    displayMode: EMarkdownDisplayMode;
+}
 /** Тип показателя */
 declare enum EIndicatorType {
     /** Показатели процесса */
@@ -657,8 +730,8 @@ interface IWidgetTableColumn {
     dataType: ESimpleDataType;
 }
 interface IActionScript {
-    guid: string | undefined;
-    fieldsGuids: Set<string>;
+    name: string | undefined;
+    fieldsNames: Set<string>;
 }
 interface IWidgetTable {
     /** Имя таблицы */
@@ -666,12 +739,21 @@ interface IWidgetTable {
     /** Колонки таблицы */
     columns: Map<string, IWidgetTableColumn>;
 }
+/**
+ * simplified - упрощенный для работы фильтрации в образах открытых в дровере/модальном окне
+ *
+ * full - полный
+ */
+type TFiltrationMode = "simplified" | "full";
 /**
  * preview - упрощенный
  *
  * full - полный
  */
 type TDisplayMode = "preview" | "full";
+interface IDisplayRule {
+    color: TColor;
+}
 interface IWidgetsContext {
     /** используемый язык в системе */
     language: ELanguages;
@@ -681,8 +763,8 @@ interface IWidgetsContext {
     /** Переменные отчета */
     variables: Map<string, TWidgetVariable>;
     /** Метод установки значения переменной отчета */
-    setVariableValue(guid: string, value: TNullable<string> | string[]): void;
-    statesGuids: Set<string>;
+    setVariableValue(name: string, value: TNullable<string> | string[]): void;
+    statesNames: Set<string>;
     reportName: string;
     /**
      * режим дашборда
@@ -694,6 +776,11 @@ interface IWidgetsContext {
     userLogin: string;
     scripts: Map<string, IActionScript>;
     tables: Set<string>;
+    filtrationMode: TFiltrationMode;
+    reportDisplayRules: Map<string, IDisplayRule>;
+    workspaceDisplayRules: Map<number, Map<string, IDisplayRule>>;
+    viewKeyByName: Map<string, string>;
+    fetchColumnsByTableName(tableName: string): Promise<IWidgetTableColumn[] | undefined>;
 }
 
 declare enum EWidgetActionInputMode {
@@ -704,13 +791,75 @@ declare enum EWidgetActionInputMode {
     FORMULA = "FORMULA",
     MANUALLY = "MANUALLY"
 }
-type TWidgetActionInputValue = {
+interface IActionCommon {
+    id: number;
+    name: string;
+}
+declare enum EActionTypes {
+    URL = "URL",
+    UPDATE_VARIABLE = "UPDATE_VARIABLE",
+    RUN_SCRIPT = "RUN_SCRIPT",
+    OPEN_VIEW = "OPEN_VIEW"
+}
+interface IActionGoToUrl extends IActionCommon {
+    type: EActionTypes.URL;
+    url: string;
+    targetBlank: boolean;
+}
+interface IActionScriptField {
+    name: string;
+    id: number;
+    value: TWidgetActionInputValue;
+}
+interface IActionRunScript extends IActionCommon {
+    description: string;
+    type: EActionTypes.RUN_SCRIPT;
+    filters: (IFormulaFilterValue | string)[];
+    inputs: IActionScriptField[];
+    scriptName: string;
+    shouldRefreshWidgetsAfterExecution: boolean;
+}
+interface IActionUpdateVariable extends IActionCommon {
+    type: EActionTypes.UPDATE_VARIABLE;
+    variables: Array<string>;
+}
+declare enum EViewType {
+    CREATED_VIEW = "CREATED_VIEW",
+    GENERATED_BY_SCRIPT = "GENERATED_BY_SCRIPT"
+}
+declare enum EOpenViewMode {
+    NEW_WINDOW = "NEW_WINDOW",
+    PLACEHOLDER = "PLACEHOLDER",
+    MODAL = "MODAL",
+    DRAWER = "DRAWER"
+}
+declare enum EDrawerPlacement {
+    LEFT = "LEFT",
+    RIGHT = "RIGHT"
+}
+interface IActionOpenView extends IActionCommon {
+    type: EActionTypes.OPEN_VIEW;
+    viewName: string;
+    viewKey: string;
+    openMode: EOpenViewMode;
+    viewType: EViewType;
+    drawerPlacement: EDrawerPlacement;
+    placeholderName: string;
+    inputs: IActionScriptField[];
+    isOpenInCurrentWindow?: boolean;
+}
+type TActionsOnClick = IActionGoToUrl | IActionRunScript | IActionUpdateVariable | IActionOpenView;
+type TWidgetActionCommonInputValue = {
+    name: string;
+    isHidden: boolean;
+};
+type TWidgetActionInputValue = TWidgetActionCommonInputValue & ({
     mode: EWidgetActionInputMode.FROM_COLUMN;
     tableName: string;
     columnName: string;
 } | {
     mode: EWidgetActionInputMode.FROM_VARIABLE;
-    guid: string;
+    name: string;
 } | {
     mode: EWidgetActionInputMode.FORMULA;
     formula: string;
@@ -725,35 +874,26 @@ type TWidgetActionInputValue = {
     mode: EWidgetActionInputMode.DYNAMIC_LIST;
     formula: string;
     defaultValue: string;
-};
+    filters: (IFormulaFilterValue | string)[];
+});
 interface IWidgetActionInput {
-    guid: string;
-    value: TWidgetActionInputValue;
-}
-interface IWidgetAction {
-    id: number;
     name: string;
-    description: string;
-    filters: (IFormulaFilterValue | string)[];
-    scriptGuid?: string;
-    /**  Поле name необходимо, чтобы показать название скрипта, который был удален */
-    scriptName?: string;
-    inputs: IWidgetActionInput[];
-    shouldRefreshWidgetsAfterExecution: boolean;
+    value: TWidgetActionInputValue;
 }
-declare const isActionValid: (action: IWidgetAction, { scripts, tables }: IWidgetsContext) => boolean;
+declare const isActionValid: (action: TActionsOnClick, { scripts, tables, variables }: IWidgetsContext) => boolean;
 
 interface IBaseWidgetSettings {
-    apiVersion: string;
-    type: string;
     header?: string;
     headerSize?: number;
-    stateGuid?: string | null;
+    stateName?: string | null;
+    showMarkdown?: boolean;
+    markdownMeasures?: IMarkdownMeasure[];
+    markdownText?: string;
     filters?: (IFormulaFilterValue | string)[];
     filterMode?: EWidgetFilterMode;
     ignoreFilters?: boolean;
     sorting?: IWidgetSortingIndicator[];
-    actions?: IWidgetAction[];
+    actions?: TActionsOnClick[];
     displayCondition?: TDisplayCondition;
     displayConditionComment?: string;
 }
@@ -785,20 +925,38 @@ type TGroupLevelRecord<LevelGroupSettings extends object> = IControlRecord<Level
 interface ISelectOption {
     value: string;
     label: string;
+    disabled?: boolean;
 }
 interface ICustomAddButtonProps {
     options?: ISelectOption[];
     fetchOptions?: () => Promise<ISelectOption[]>;
     onSelect: (value: string, update: <T extends object>(f: (prevItems: T[]) => T[]) => void) => void;
 }
+interface IWidgetIndicatorMenuConfig {
+    hideTablesColumnsOptions?: boolean;
+    hideCommonOptions?: boolean;
+    hideQuantityOption?: boolean;
+}
+interface IMeasureMenuConfig extends IWidgetIndicatorMenuConfig {
+}
+interface ISortingMenuConfig extends IWidgetIndicatorMenuConfig {
+}
 /** Кнопка добавления группы в набор */
 type TAddButton = {
     title: string;
-    indicatorType: Exclude<EWidgetIndicatorType, EWidgetIndicatorType.CUSTOM>;
+    indicatorType: Exclude<EWidgetIndicatorType, EWidgetIndicatorType.CUSTOM | EWidgetIndicatorType.MEASURE | EWidgetIndicatorType.SORTING>;
 } | {
     title: string;
     indicatorType: EWidgetIndicatorType.CUSTOM;
     props: ICustomAddButtonProps;
+} | {
+    title: string;
+    indicatorType: EWidgetIndicatorType.MEASURE;
+    menuConfig?: IMeasureMenuConfig;
+} | {
+    title: string;
+    indicatorType: EWidgetIndicatorType.SORTING;
+    menuConfig?: ISortingMenuConfig;
 };
 interface IAutoIdentifiedArrayItem {
     /**
@@ -832,6 +990,10 @@ interface IGroupSetDescription<Settings extends object, GroupSettings extends ob
 }
 /** Конфигурация левой панели */
 interface IPanelDescription<Settings extends object, GroupSettings extends IGroupSettings = IGroupSettings> {
+    /** Добавить заголовок для виджета */
+    useHeader?: boolean;
+    /** Добавить описание для виджета */
+    useMarkdown?: boolean;
     /** Конфигурация настроек данных виджета */
     dataRecords?: TWidgetLevelRecord<Settings>[];
     /** Конфигурация настроек отображения виджета */
@@ -872,15 +1034,14 @@ interface IWidgetPlaceholderController {
     setConfigured(value: boolean): void;
     setDisplay(value: boolean): void;
     setEmpty(value: boolean): void;
+    setOverlay(value: boolean): void;
 }
-
-/** Вид переменной для калькулятора */
-interface ICalculatorVariable {
-    dataType: ESimpleDataType;
-    value: string | string[];
-}
-/** Коллекция значений переменных по их имени */
-interface ICalculatorVariablesValues extends Map<string, ICalculatorVariable> {
+interface IWidgetPlaceholderValues {
+    error: Error | null;
+    isConfigured: boolean;
+    isDisplay: boolean | undefined;
+    isEmpty: boolean;
+    isOverlay: boolean;
 }
 
 /** Формат входного параметра GeneralCalculator */
@@ -889,8 +1050,6 @@ interface IBaseDimensionsAndMeasuresCalculatorInput {
     dimensions: ICalculatorDimensionInput[];
     /** Меры */
     measures: ICalculatorMeasureInput[];
-    /** Значения переменных */
-    variablesValues?: ICalculatorVariablesValues;
     /** Фильтры, использующие WHERE */
     filters: ICalculatorFilter[];
     /** Фильтры, использующие HAVING */
@@ -944,8 +1103,6 @@ interface IHistogramCalculatorInput {
     dimensions: ICalculatorDimensionInput[];
     /** Лимит корзин */
     binsLimit: number;
-    /** Значения переменных */
-    variablesValues?: ICalculatorVariablesValues;
     /** Формула условия отображения */
     displayConditionFormula?: TNullable<string>;
     /** Фильтры, использующие WHERE */
@@ -990,7 +1147,7 @@ interface IEdge extends IGraphElement {
     endName: string | null;
 }
 interface IProcessGraphCalculatorInput {
-    processGuid: string;
+    processName: string;
     vertexLimit: number | null;
     edgeLimit: number;
     vertexMeasures: ICalculatorMeasureInput[];
@@ -998,8 +1155,6 @@ interface IProcessGraphCalculatorInput {
     filters: ICalculatorFilter[];
     eventFilters?: ICalculatorFilter[];
     displayConditionFormula?: TNullable<string>;
-    /** Значения переменных */
-    variablesValues?: ICalculatorVariablesValues;
 }
 interface IProcessGraphCalculatorOutput {
     vertexMaxLimit: number;
@@ -1024,8 +1179,6 @@ interface ITwoLimitsCalculatorInput {
     dimensionsSecondGroup: ICalculatorDimensionInput[];
     /** Меры */
     measures: ICalculatorMeasureInput[];
-    /** Значения переменных */
-    variablesValues?: ICalculatorVariablesValues;
     /** Фильтры, использующие WHERE */
     filters: ICalculatorFilter[];
     /** Фильтры, использующие HAVING */
@@ -1062,19 +1215,23 @@ interface ITwoLimitsCalculator extends ICalculator<ITwoLimitsCalculatorInput, IT
 }
 
 interface ITypeCalculatorInput {
-    formula: string;
-    variablesValues: ICalculatorVariablesValues;
+    dimensions: {
+        alias: string;
+        formula: string;
+    }[];
+    measures: {
+        alias: string;
+        formula: string;
+    }[];
 }
 interface ITypeCalculatorOutput {
-    type: ESimpleDataType;
+    types: Map<string, ESimpleDataType>;
 }
 interface ITypeCalculator extends ICalculator<ITypeCalculatorInput, ITypeCalculatorOutput> {
 }
 
 declare const prepareValuesForSql: (dataType: ESimpleDataType, values: (string | null)[]) => (string | null)[];
 
-declare function mapVariablesToInputs(variables: Map<string, TWidgetVariable>): ICalculatorVariablesValues;
-
 declare function checkDisplayCondition(displayCondition: TNullable<TDisplayCondition>, variables: Map<string, TWidgetVariable>): boolean;
 declare function getDisplayConditionFormula(displayCondition: TNullable<TDisplayCondition>): TNullable<string>;
 declare const replaceDisplayCondition: <I extends IWidgetColumnIndicator>(dimension: I, displayCondition: TNullable<TDisplayCondition>) => TNullable<I>;
@@ -1083,7 +1240,7 @@ declare const replaceDisplayCondition: <I extends IWidgetColumnIndicator>(dimens
 declare function mapMeasuresToInputs<T extends IWidgetMeasure>(measures: T[], variables: Map<string, TWidgetVariable>, addFormulas?: (measure: T) => Map<string, string>): ICalculatorMeasureInput[];
 
 /** Конвертировать разрезы виджета во входы для вычислителя */
-declare function mapDimensionsToInputs(dimensions: IWidgetDimension[], variables: Map<string, TWidgetVariable>): ICalculatorDimensionInput[];
+declare function mapDimensionsToInputs<T extends IWidgetDimension>(dimensions: T[], variables: Map<string, TWidgetVariable>, addFormulas?: (dimension: T) => Map<string, string>): ICalculatorDimensionInput[];
 
 /** Конвертировать процессные показатели виджета во входы для вычислителя */
 declare function mapTransitionMeasuresToInputs<T extends IProcessIndicator>(indicators: T[], process: IWidgetProcess, variables: Map<string, TWidgetVariable>, addFormulas?: (indicator: T) => Map<string, string>): ICalculatorMeasureInput[];
@@ -1098,7 +1255,7 @@ declare function mapEventMeasuresToInputs<T extends IProcessIndicator>(indicator
  * @param measuresInOriginalOrder меры виджета (конкретная мера будет браться по индексу)
  * @returns
  */
-declare function mapSortingToInputs(sortingIndicators?: IWidgetSortingIndicator[], dimensionsInOriginalOrder?: IWidgetDimension[], measuresInOriginalOrder?: IWidgetMeasure[]): ISortOrder[];
+declare function mapSortingToInputs(sortingIndicators: IWidgetSortingIndicator[] | undefined, dimensionsInOriginalOrder: IWidgetDimension[] | undefined, measuresInOriginalOrder: IWidgetMeasure[] | undefined, variables: Map<string, TWidgetVariable>): ISortOrder[];
 
 /**
  * Выбрать активный разрез иерархии на основе активных фильтров.
@@ -1124,6 +1281,18 @@ declare function bindContentsWithIndicators<Output extends ICalculatorIndicatorO
 
 declare const escapeSpecialCharacters: (formula: string) => string;
 
+/** Удалить из строки символы экранирования */
+declare function unescapeSpecialCharacters(str: string): string;
+
+/** Вид переменной для калькулятора */
+interface ICalculatorVariable {
+    dataType: ESimpleDataType;
+    value: string | string[];
+}
+/** Коллекция значений переменных по их имени */
+interface ICalculatorVariablesValues extends Map<string, ICalculatorVariable> {
+}
+
 interface ICalculatorFactory {
     general: () => IGeneralCalculator;
     pie: () => IPieCalculator;
@@ -1144,6 +1313,77 @@ interface IDefinition<WidgetSettings extends IBaseWidgetSettings, GroupSettings
     getMeasures?(settings: WidgetSettings): IWidgetMeasure[];
 }
 
+type TContextMenu = (TContextMenuList | TContextMenuButtonGroup) & {
+    event?: MouseEvent;
+    placement?: "topRight" | "topLeft" | "bottomRight" | "bottomLeft";
+    positionOrigin?: "frame" | "workArea";
+    position?: {
+        unitX?: TContextMenuPositionUnit;
+        unitY?: TContextMenuPositionUnit;
+        x?: number;
+        y?: number;
+    };
+    onClose?: () => void;
+};
+type TContextMenuPositionUnit = "%" | "px";
+type TContextMenuList = {
+    type: "list";
+    items: TContextMenuRow[];
+};
+type TContextMenuButtonGroup = {
+    type: "buttonGroup";
+    items: TContextMenuButton[];
+};
+type TContextMenuRow = {
+    key: string;
+    label: string;
+    onClick: () => void;
+};
+type TContextMenuButton = TContextMenuButtonActions | TContextMenuButtonClose | TContextMenuButtonApply | TContextMenuButtonCustom | TContextMenuButtonOptions;
+type TContextMenuButtonActions = {
+    type: "actions";
+    actions: TActionsOnClick[];
+    onClick: (action: TActionsOnClick) => void;
+};
+type TContextMenuButtonClose = {
+    type: "close";
+};
+type TContextMenuButtonApply = {
+    type: "apply";
+    onClick: () => void;
+};
+type TContextMenuButtonCustom = {
+    key: string;
+    type: "custom";
+    icon: string;
+    onClick: () => void;
+};
+type TContextMenuButtonOptions = {
+    key: string;
+    type: "options";
+    icon: string;
+    items: TContextMenuRow[];
+};
+
+type TLaunchActionParams = {
+    action: TActionsOnClick;
+    onSuccess: () => void;
+    filters: ICalculatorFilter[];
+    needConfirmation?: boolean;
+};
+interface ILaunchActionSubscribers {
+    onActionSuccess(callback: () => void): void;
+}
+type TWidgetContainer = {
+    /** Имеет ли контейнер виджета ограниченную максимальную высоту */
+    isMaxHeightLimited: boolean;
+    /** Установить минимальную высоту рабочей области виджета */
+    setContentMinHeight(value: number): void;
+};
+interface IWidgetPersistValue<T extends object = object> {
+    get(): T | null;
+    set(value: T | null): void;
+}
 interface IWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetSettings> {
     /** guid виджета */
     guid: string;
@@ -1164,19 +1404,18 @@ interface IWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetS
     rootViewContainer: HTMLDivElement;
     /** Объект для управления плейсхолдером */
     placeholder: IWidgetPlaceholderController;
-    /** Контекст виджетов */
+    /** Объект для получения значений плейсхолдера */
+    placeholderValues?: IWidgetPlaceholderValues;
+    /** Контекст виджета */
     widgetsContext: IWidgetsContext;
-    /** Вызывает модальное окно для запуска действия */
-    launchAction(params: {
-        action: IWidgetAction;
-        onSuccess: () => void;
-        filters: ICalculatorFilter[];
-    }): void;
     /** Данные о контейнере виджета */
-    widgetContainer: {
-        /** Имеет ли контейнер виджета ограниченную максимальную высоту */
-        isMaxHeightLimited: boolean;
-    };
+    widgetContainer: TWidgetContainer;
+    /** Запуск действия */
+    launchAction(params: TLaunchActionParams): ILaunchActionSubscribers;
+    /** Значение, сохраняемое в localStorage и URL */
+    persistValue: IWidgetPersistValue;
+    /** функция для управления контекстными меню */
+    setContextMenu: (key: string, value: TContextMenu | null) => void;
 }
 interface ICustomWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetSettings> extends IWidgetProps<WidgetSettings> {
     /** @deprecated - нужно использовать из widgetsContext */
@@ -1332,7 +1571,7 @@ declare const replaceFiltersBySelection: (filters: ICalculatorFilter[], selectio
  * @param {P} [props] - Дополнительные параметры локализации.
  * @returns {string} - Локализованный текст для указанного языка.
  */
-declare const getLocalizedText: <L extends TLocalizationDescription, P extends ILocalizationProps = TExtractLocalizationParams<L>>(language: ELanguages, locObj: L, props?: P | undefined) => string;
+declare const getLocalizedText: <L extends TLocalizationDescription, P extends ILocalizationProps = TExtractLocalizationParams<L>>(language: ELanguages, locObj: L, props?: P) => string;
 
 type TDefineWidgetOptions = {
     manifest?: Record<string, unknown>;
@@ -1348,4 +1587,4 @@ declare global {
     }
 }
 
-export { ECalculatorFilterMethods, EColorMode, EControlType, EDbType, EDimensionTemplateNames, EDisplayConditionMode, EDurationUnit, EEventMeasureTemplateNames, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EIndicatorType, ELastTimeUnit, EMeasureTemplateNames, EProcessFilterNames, ESimpleDataType, ESortDirection, ESortingValueModes, ETransitionMeasureTemplateNames, EWidgetActionInputMode, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, type IActionScript, type IAddDurationOfTransitionFilter, type IAddPresenceOfEventFilter, type IAddPresenceOfTransitionFilter, type IAddRepetitionOfEventFilter, type IBaseDimensionsAndMeasuresCalculator, type IBaseDimensionsAndMeasuresCalculatorInput, type IBaseDimensionsAndMeasuresCalculatorOutput, type IBaseWidgetSettings, type ICalculator, type ICalculatorDimensionInput, type ICalculatorDimensionOutput, type ICalculatorFactory, type ICalculatorFilter, type ICalculatorIndicatorInput, type ICalculatorIndicatorOutput, type ICalculatorMeasureInput, type ICalculatorMeasureOutput, type ICalculatorVariable, type ICalculatorVariablesValues, type ICommonColumnIndicator, type IControlRecord, type ICustomAddButtonProps, type ICustomWidgetProps, type IDefinition, type IDimensionSelection, type IDimensionSelectionByFormula, type IDisplayPredicate, type IDivePanelDescription, type IDividerRecord, type IEdge, type IExportColumnOrder, type IFillSettings, type IFormulaFilterValue, type IGeneralCalculator, type IGeneralCalculatorExportInput, type IGeneralCalculatorInput, type IGeneralCalculatorOutput, type IGraphElement, type IGroupSetDescription, type IGroupSetRecord, type IGroupSettings, type IHistogramBin, type IHistogramCalculator, type IHistogramCalculatorInput, type IHistogramCalculatorOutput, type ILens, type IPanelDescription, type IPanelDescriptionCreator, type IPieCalculator, type IPieCalculatorInput, type IPieCalculatorOutput, type IProcessEventFilterValue, type IProcessEventIndicator, type IProcessGraphCalculator, type IProcessGraphCalculatorInput, type IProcessGraphCalculatorOutput, type IProcessIndicator, type IProcessTransitionFilterValue, type IProcessTransitionIndicator, type IRange, type ISelectOption, type ISortOrder, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type IVertex, type IWidget, type IWidgetAction, type IWidgetActionInput, type IWidgetColumnIndicator, type IWidgetDimension, type IWidgetDimensionHierarchy, type IWidgetEntity, type IWidgetFiltration, type IWidgetFormatting, type IWidgetFormulaFilterValue, type IWidgetIndicator, type IWidgetMeasure, type IWidgetPlaceholderController, type IWidgetProcess, type IWidgetProps, type IWidgetSortingIndicator, type IWidgetTable, type IWidgetTableColumn, type IWidgetsContext, type TBoundedContentWithIndicator, type TColor, type TColumnIndicatorValue, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TGroupLevelRecord, type TProcessIndicatorValue, type TRecordAccessor, type TSortDirection, type TUpdateSelection, type TValuePath, type TWidgetActionInputValue, type TWidgetFiltering, type TWidgetLevelRecord, type TWidgetSortingValue, type TWidgetSortingValueRelatedWidgetDimension, type TWidgetSortingValueRelatedWidgetIndicator, type TWidgetSortingValueRelatedWidgetMeasure, type TWidgetVariable, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, dimensionTemplateFormulas, escapeSpecialCharacters, eventMeasureTemplateFormulas, fillTemplateString, formulaFilterMethods, generateColumnFormula, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getTransitionMeasureFormula, isActionValid, isHierarchy, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, mapVariablesToInputs, measureTemplateFormulas, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, transitionMeasureTemplateFormulas, updateDefaultModeSelection, updateMultiModeSelection, updateSingleModeSelection };
+export { EActionTypes, ECalculatorFilterMethods, EColorMode, EColorScope, EControlType, EDbType, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationUnit, EEventMeasureTemplateNames, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureTemplateNames, EOpenViewMode, EProcessFilterNames, ESimpleDataType, ESortDirection, ESortingValueModes, ETransitionMeasureTemplateNames, EViewType, EWidgetActionInputMode, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, type IActionCommon, type IActionGoToUrl, type IActionOpenView, type IActionRunScript, type IActionScript, type IActionScriptField, type IActionUpdateVariable, type IAddDurationOfTransitionFilter, type IAddPresenceOfEventFilter, type IAddPresenceOfTransitionFilter, type IAddRepetitionOfEventFilter, type IBaseDimensionsAndMeasuresCalculator, type IBaseDimensionsAndMeasuresCalculatorInput, type IBaseDimensionsAndMeasuresCalculatorOutput, type IBaseWidgetSettings, type ICalculator, type ICalculatorDimensionInput, type ICalculatorDimensionOutput, type ICalculatorFactory, type ICalculatorFilter, type ICalculatorIndicatorInput, type ICalculatorIndicatorOutput, type ICalculatorMeasureInput, type ICalculatorMeasureOutput, type ICalculatorVariable, type ICalculatorVariablesValues, type IColoredValue, type ICommonColumnIndicator, type IControlRecord, type ICustomAddButtonProps, type ICustomWidgetProps, type IDefinition, type IDimensionSelection, type IDimensionSelectionByFormula, type IDisplayPredicate, type IDisplayRule, type IDivePanelDescription, type IDividerRecord, type IEdge, type IExportColumnOrder, type IFillSettings, type IFormulaFilterValue, type IGeneralCalculator, type IGeneralCalculatorExportInput, type IGeneralCalculatorInput, type IGeneralCalculatorOutput, type IGraphElement, type IGroupSetDescription, type IGroupSetRecord, type IGroupSettings, type IHistogramBin, type IHistogramCalculator, type IHistogramCalculatorInput, type IHistogramCalculatorOutput, type ILaunchActionSubscribers, type ILens, type IMarkdownMeasure, type IMeasureMenuConfig, type IPanelDescription, type IPanelDescriptionCreator, type IPieCalculator, type IPieCalculatorInput, type IPieCalculatorOutput, type IProcessEventFilterValue, type IProcessEventIndicator, type IProcessGraphCalculator, type IProcessGraphCalculatorInput, type IProcessGraphCalculatorOutput, type IProcessIndicator, type IProcessTransitionFilterValue, type IProcessTransitionIndicator, type IRange, type ISelectOption, type ISortOrder, type ISortingMenuConfig, type IStagesFilterValue, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type IVertex, type IWidget, type IWidgetActionInput, type IWidgetColumnIndicator, type IWidgetDimension, type IWidgetDimensionHierarchy, type IWidgetEntity, type IWidgetFilter, type IWidgetFiltration, type IWidgetFormatting, type IWidgetFormulaFilterValue, type IWidgetIndicator, type IWidgetIndicatorMenuConfig, type IWidgetMeasure, type IWidgetPersistValue, type IWidgetPlaceholderController, type IWidgetPlaceholderValues, type IWidgetProcess, type IWidgetProps, type IWidgetSortingIndicator, type IWidgetTable, type IWidgetTableColumn, type IWidgetsContext, type TActionsOnClick, type TBoundedContentWithIndicator, type TColor, type TColorRule, type TColumnIndicatorValue, type TContextMenu, type TContextMenuButton, type TContextMenuButtonActions, type TContextMenuButtonApply, type TContextMenuButtonClose, type TContextMenuButtonCustom, type TContextMenuButtonGroup, type TContextMenuButtonOptions, type TContextMenuList, type TContextMenuPositionUnit, type TContextMenuRow, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TFiltrationMode, type TGroupLevelRecord, type TLaunchActionParams, type TProcessIndicatorValue, type TRecordAccessor, type TSelectivePartial, type TSortDirection, type TUpdateSelection, type TValuePath, type TWidgetActionCommonInputValue, type TWidgetActionInputValue, type TWidgetContainer, type TWidgetFilterValue, type TWidgetFiltering, type TWidgetLevelRecord, type TWidgetSortingValue, type TWidgetSortingValueRelatedWidgetDimension, type TWidgetSortingValueRelatedWidgetIndicator, type TWidgetSortingValueRelatedWidgetMeasure, type TWidgetVariable, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, dimensionTemplateFormulas, escapeSpecialCharacters, eventMeasureTemplateFormulas, fillTemplateString, formulaFilterMethods, generateColumnFormula, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getTransitionMeasureFormula, isActionValid, isHierarchy, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureTemplateFormulas, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateMultiModeSelection, updateSingleModeSelection };