@infomaximum/widget-sdk 4.0.0-beta57 → 4.0.0-beta59

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { EFilteringMethodValues } from '@infomaximum/base-filter';
 
 type TNullable<T> = T | null | undefined;
 type valueof<T> = T[keyof T];
+type StringKeyOf<T> = Exclude<keyof T, number | symbol>;
 
 declare enum ESimpleDataType {
     OTHER = "OTHER",
@@ -32,8 +33,6 @@ declare enum EControlType {
     typedFormula = "typedFormula",
     inputRange = "inputRange",
     colorPicker = "colorPicker",
-    /**  @deprecated - удалится в ближайшее время */
-    filterMode = "filterMode",
     displayCondition = "displayCondition",
     eventsColor = "eventsColor",
     inputMarkdown = "inputMarkdown",
@@ -81,21 +80,15 @@ interface ICalculatorIndicatorInput {
 }
 interface ICalculatorIndicatorOutput {
     values: (string | null)[];
-    dataType: ESimpleDataType;
-    isArrayDataType: boolean;
 }
 interface ICalculatorDimensionInput extends ICalculatorIndicatorInput {
     formula: string;
     hideEmpty?: boolean;
-    /** Временно поддерживается обратная совместимость с форматом { alias: string; formula: string }[] */
-    /** Появилась необходимость в ленточном графике, т.к. разрез длительность используется, как мера */
-    additionalFormulas?: Map<string, string>;
 }
 interface ICalculatorDimensionOutput extends ICalculatorIndicatorOutput {
 }
 interface ICalculatorMeasureInput extends ICalculatorIndicatorInput {
     mainFormula: string;
-    /** Временно поддерживается обратная совместимость с форматом { alias: string; formula: string }[] */
     additionalFormulas?: Map<string, string>;
 }
 interface ICalculatorMeasureOutput extends ICalculatorIndicatorOutput {
@@ -169,7 +162,7 @@ declare enum EFormatTypes {
 }
 declare enum EFormattingPresets {
     "AUTO" = "AUTO",
-    "TUNE" = "TUNE",
+    "CUSTOM" = "CUSTOM",
     "DD/M/YYYY" = "DD/M/YYYY",
     "DD-MM-YYYY" = "DD-MM-YYYY",
     "DD-MM-YY" = "DD-MM-YY",
@@ -302,18 +295,6 @@ declare enum EProcessFilterNames {
     /** Длительность перехода */
     durationOfTransition = "durationOfTransition"
 }
-/** @deprecated необходимо использовать @see {@link IFormulaFilterValue} */
-interface IWidgetFormulaFilterValue extends ICalculatorFilter {
-    /**
-     * Название фильтра
-     * @deprecated необходимо использовать @see {@link IWidgetFormulaFilterValue.name}
-     */
-    caption?: TNullable<string>;
-    /** Название фильтра */
-    name: TNullable<string>;
-    /** Формат */
-    format?: EFormatTypes;
-}
 interface IProcessFilterValue {
     /**
      * События, доступные при выборе процесса.
@@ -419,7 +400,7 @@ interface IWidgetFiltration {
     preparedFilterValues: ICalculatorFilter[];
     filters: IWidgetFilter[];
     /** Добавить фильтр по формуле */
-    addFormulaFilter(value: IWidgetFormulaFilterValue | TSelectivePartial<IFormulaFilterValue, "format" | "formValues">): void;
+    addFormulaFilter(value: TSelectivePartial<IFormulaFilterValue, "format" | "formValues">): void;
     /** Удалить фильтр по формуле */
     removeFormulaFilter(formula: string): void;
     addProcessFilter(...args: Parameters<IAddPresenceOfEventFilter> | Parameters<IAddRepetitionOfEventFilter> | Parameters<IAddPresenceOfTransitionFilter> | Parameters<IAddDurationOfTransitionFilter>): void;
@@ -443,65 +424,10 @@ type TWidgetFiltering = {
     ignore: false;
     mode: EWidgetFilterMode;
 };
-declare enum EColorMode {
-    DISABLED = "DISABLED",
-    FORMULA = "FORMULA",
-    BASE = "BASE",
-    GRADIENT = "GRADIENT",
-    AUTO = "AUTO",
-    RULE = "RULE",
-    VALUES = "VALUES",
-    BY_DIMENSION = "BY_DIMENSION"
-}
-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;
-    classCount?: TNullable<number>;
-} | {
-    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",
     FORMULA = "FORMULA",
@@ -567,10 +493,7 @@ type TDisplayMode = "preview" | "full";
 interface IDisplayRule {
     color: TColor;
 }
-interface IWorkspaceDisplayRule extends IDisplayRule {
-    groupName: string;
-}
-interface IWidgetsContext {
+interface IGlobalContext {
     /** используемый язык в системе */
     language: ELanguages;
     processes: Map<string, IWidgetProcess>;
@@ -578,29 +501,105 @@ interface IWidgetsContext {
     workspaceMeasures: TNullable<Map<string, ICommonMeasures>>;
     reportDimensions: TNullable<Map<string, ICommonDimensions>>;
     workspaceDimensions: TNullable<Map<string, Map<string, ICommonDimensions>>>;
+    /** @deprecated удалить после окончания поддержки миграций BI-13650 */
+    workspaceGroupNameById: Map<number, string>;
     /** Переменные отчета */
     variables: Map<string, TWidgetVariable>;
     /** Метод установки значения переменной отчета */
     setVariableValue(name: string, value: TNullable<string> | string[]): void;
     states: Map<string, ICommonState>;
     reportName: string;
-    /**
-     * режим дашборда
-     * @deprecated 2401 - необходимо использовать displayMode */
-    isViewMode: boolean;
     /** Режим отображения виджета */
     displayMode: TDisplayMode;
-    /** @deprecated необходимо получать из системной переменной "Login" */
-    userLogin: string;
     scripts: Map<string, IActionScript>;
     tables: Set<string>;
     filtrationMode: TFiltrationMode;
     reportDisplayRules: Map<string, IDisplayRule>;
-    workspaceDisplayRules: Map<number, Map<string, IWorkspaceDisplayRule>>;
+    workspaceDisplayRules: Map<string, Map<string, IDisplayRule>>;
     viewNameByKey: Map<string, string>;
     fetchColumnsByTableName(tableName: string): Promise<IWidgetTableColumn[] | undefined>;
 }
 
+declare enum EColorMode {
+    /** Окрашивание отключено */
+    DISABLED = "DISABLED",
+    /** Цвет каждого значения вычисляется по формуле */
+    FORMULA = "FORMULA",
+    /** Один цвет для всех значений */
+    BASE = "BASE",
+    /** Окрашивание каждого значения по градиенту относительно минимального и максимального значений */
+    GRADIENT = "GRADIENT",
+    /** Использовать автоматический цвет: по умолчанию определяется порядковым номером показателя */
+    AUTO = "AUTO",
+    /** Использовать цвет из правила отображения (в правиле отображения рекурсивно определен цвет) */
+    RULE = "RULE",
+    /** Задать цвет конкретным значениям разреза */
+    VALUES = "VALUES",
+    /** Задать цвет конкретным значениям общего разреза. Режим используется только для настроек правила отображения */
+    BY_DIMENSION = "BY_DIMENSION"
+}
+type TColorBase = {
+    mode: EColorMode.BASE;
+    value?: string;
+};
+type TColorRule = {
+    mode: EColorMode.RULE;
+    formula: string;
+};
+interface IColoredValue {
+    value: string;
+    color: TColorBase | TColorRule;
+}
+/** Настройка цвета */
+type TColor = {
+    mode: EColorMode.FORMULA;
+    formula: string;
+} | TColorBase | {
+    mode: EColorMode.GRADIENT;
+    startValue: string;
+    endValue: string;
+    classCount?: TNullable<number>;
+} | {
+    mode: EColorMode.AUTO;
+} | TColorRule | {
+    mode: EColorMode.VALUES;
+    items: IColoredValue[];
+} | {
+    mode: EColorMode.BY_DIMENSION;
+    /** Имя разреза из области видимости правила отображения */
+    dimensionName: string;
+    items: IColoredValue[];
+} | {
+    mode: EColorMode.DISABLED;
+};
+declare const getRuleColor: (ruleFormula: string, globalContext: Pick<IGlobalContext, "reportDisplayRules" | "workspaceDisplayRules">) => TColor | undefined;
+declare const isValidColor: (color: TColor, globalContext: Pick<IGlobalContext, "reportDisplayRules" | "workspaceDisplayRules">) => boolean;
+
+interface IAutoIdentifiedArrayItem {
+    /**
+     * Идентификатор, добавляемый системой "на лету" для удобства разработки, не сохраняется на сервер.
+     * Гарантируется уникальность id в пределах settings виджета.
+     */
+    id: number;
+}
+interface IBaseWidgetSettings {
+    title?: string;
+    titleSize?: number;
+    titleColor?: TColor;
+    titleWeight?: EFontWeight;
+    stateName?: string | null;
+    showMarkdown?: boolean;
+    markdownMeasures?: IMarkdownMeasure[];
+    markdownText?: string;
+    filters?: TExtendedFormulaFilterValue[];
+    filterMode?: EWidgetFilterMode;
+    ignoreFilters?: boolean;
+    sorting?: IWidgetSortingIndicator[];
+    actions?: IWidgetAction[];
+    displayCondition?: TDisplayCondition;
+    displayConditionComment?: string;
+}
+
 declare enum EWidgetActionInputMethod {
     COLUMN = "COLUMN",
     VARIABLE = "VARIABLE",
@@ -677,15 +676,11 @@ interface IWidgetActionParameterCommon {
     isHidden: boolean;
 }
 type TWidgetActionParameter = IWidgetActionParameterCommon & (IParameterFromColumn | IParameterFromVariable | IParameterFromFormula | IParameterFromManualInput | IParameterFromStaticList | IParameterFromDynamicList);
-interface IActionOnClickParameterCommon {
-    /** @deprecated удалить [BI-13546] */
-    id: number;
+interface IActionOnClickParameterCommon extends IAutoIdentifiedArrayItem {
     name: string;
 }
 type TActionOnClickParameter = IActionOnClickParameterCommon & (IParameterFromColumn | IParameterFromVariable | IParameterFromFormula | IParameterFromEvent | IParameterFromStartEvent | IParameterFromEndEvent);
-interface IActionCommon {
-    /** @deprecated удалить [BI-13546] */
-    id: number;
+interface IActionCommon extends IAutoIdentifiedArrayItem {
     name: string;
 }
 interface IActionGoToUrl extends IActionCommon {
@@ -741,7 +736,7 @@ interface IWidgetAction extends IActionCommon {
 type TAction = TActionsOnClick | IWidgetAction;
 declare const isExecuteScriptActionValid: (action: Extract<TAction, {
     type: EActionTypes.EXECUTE_SCRIPT;
-}>, { scripts, tables, variables }: IWidgetsContext) => boolean;
+}>, { scripts, tables, variables }: Pick<IGlobalContext, "scripts" | "tables" | "variables">) => boolean;
 
 declare enum ESortDirection {
     descend = "DESC",
@@ -755,22 +750,13 @@ interface ISortOrder {
     direction: TSortDirection;
     displayCondition?: TNullable<string>;
 }
-type TWidgetSortingValueRelatedWidgetMeasure = {
-    mode: ESortingValueModes.MEASURE_IN_WIDGET;
-    index: number;
-};
-type TWidgetSortingValueRelatedWidgetDimension = {
-    mode: ESortingValueModes.DIMENSION_IN_WIDGET | ESortingValueModes.HIERARCHY;
-    index: number;
-};
-type TWidgetSortingValueRelatedWidgetIndicator = TWidgetSortingValueRelatedWidgetMeasure | TWidgetSortingValueRelatedWidgetDimension;
 type TWidgetSortingValue = {
-    mode: ESortingValueModes.FORMULA | ESortingValueModes.QUANTITY;
-    formula: string;
-} | TWidgetSortingValueRelatedWidgetIndicator | {
-    mode: ESortingValueModes.IN_DASHBOARD | ESortingValueModes.IN_WORKSPACE;
-    name: string;
+    mode: ESortingValueModes.FORMULA;
     formula: string;
+} | {
+    mode: ESortingValueModes.IN_WIDGET;
+    group: string;
+    index: number;
 };
 
 declare enum EWidgetIndicatorType {
@@ -778,18 +764,13 @@ declare enum EWidgetIndicatorType {
     EVENT_INDICATOR = "EVENT_INDICATOR",
     TRANSITION_INDICATOR = "TRANSITION_INDICATOR",
     DIMENSION = "DIMENSION",
-    DIMENSION_HIERARCHY = "DIMENSION_HIERARCHY",
-    SORTING = "SORTING",
-    CUSTOM = "CUSTOM"
+    SORTING = "SORTING"
 }
 declare enum EDbType {
     CH = "CH",
     HADOOP = "HADOOP"
 }
-interface IWidgetIndicator {
-    /** Идентификатор, генерируемый на основе текущего времени */
-    id: number;
-    type: EWidgetIndicatorType;
+interface IWidgetIndicator extends IAutoIdentifiedArrayItem {
     name: string;
 }
 type TProcessIndicatorValue = {
@@ -816,10 +797,8 @@ interface IProcessIndicator extends IWidgetIndicator {
     displayCondition?: TDisplayCondition;
 }
 interface IProcessEventIndicator extends IProcessIndicator {
-    type: EWidgetIndicatorType.EVENT_INDICATOR;
 }
 interface IProcessTransitionIndicator extends IProcessIndicator {
-    type: EWidgetIndicatorType.TRANSITION_INDICATOR;
 }
 /** Индикатор для сортировки */
 interface IWidgetSortingIndicator extends IWidgetIndicator {
@@ -837,18 +816,8 @@ declare enum EWidgetIndicatorValueModes {
 declare enum ESortingValueModes {
     /** Сортировка по формуле */
     FORMULA = "FORMULA",
-    /** Пункт "Количество" */
-    QUANTITY = "QUANTITY",
-    /** @deprecated Для сортировки по иерархии используется режим DIMENSION_IN_WIDGET */
-    HIERARCHY = "HIERARCHY",
-    /** Сортировка по мере виджета */
-    MEASURE_IN_WIDGET = "MEASURE_IN_WIDGET",
-    /** Сортировка по разрезу(в т.ч. по иерархии) виджета */
-    DIMENSION_IN_WIDGET = "DIMENSION_IN_WIDGET",
-    /** Сортировка по мере отчета */
-    IN_DASHBOARD = "IN_DASHBOARD",
-    /** Сортировка по мере пространства */
-    IN_WORKSPACE = "IN_WORKSPACE"
+    /** Сортировка по показателю(разрезу или мере) виджета */
+    IN_WIDGET = "IN_WIDGET"
 }
 interface ICommonState {
     name: string;
@@ -893,24 +862,19 @@ interface IWidgetColumnIndicator extends IWidgetIndicator {
     displayCondition?: TDisplayCondition;
     onclick?: TActionsOnClick[];
 }
-interface IWidgetDimensionHierarchy<D extends IWidgetDimension = IWidgetDimension> {
-    /** Идентификатор, генерируемый на основе текущего времени */
-    id: number;
-    type: EWidgetIndicatorType.DIMENSION_HIERARCHY;
+interface IWidgetDimensionHierarchy<D extends IWidgetDimension = IWidgetDimension> extends IAutoIdentifiedArrayItem {
     name: string;
-    dimensions: D[];
+    hierarchyDimensions: D[];
     displayCondition?: TDisplayCondition;
 }
 interface IWidgetDimension extends IWidgetColumnIndicator {
-    type: EWidgetIndicatorType.DIMENSION;
     hideEmptyValues: boolean;
 }
 interface IWidgetMeasure extends IWidgetColumnIndicator {
-    type: EWidgetIndicatorType.MEASURE;
 }
 interface IMarkdownMeasure extends IWidgetMeasure {
     format: EFormatTypes;
-    displayMode: EMarkdownDisplayMode;
+    displaySign: EMarkdownDisplayMode;
 }
 /** Тип показателя */
 declare enum EIndicatorType {
@@ -981,25 +945,7 @@ type TWidgetVariable = {
     /** @deprecated удалить после выполнения BI-13602, задача BI-13650  */
     guid: string;
 };
-declare function isHierarchy(indicator: IWidgetColumnIndicator): indicator is IWidgetDimensionHierarchy;
-
-interface IBaseWidgetSettings {
-    title?: string;
-    titleSize?: number;
-    titleColor?: TColor;
-    titleWeight?: EFontWeight;
-    stateName?: string | null;
-    showMarkdown?: boolean;
-    markdownMeasures?: IMarkdownMeasure[];
-    markdownText?: string;
-    filters?: TExtendedFormulaFilterValue[];
-    filterMode?: EWidgetFilterMode;
-    ignoreFilters?: boolean;
-    sorting?: IWidgetSortingIndicator[];
-    actions?: IWidgetAction[];
-    displayCondition?: TDisplayCondition;
-    displayConditionComment?: string;
-}
+declare function isDimensionsHierarchy(indicator: IWidgetColumnIndicator): indicator is IWidgetDimensionHierarchy;
 
 /** Формат входного параметра GeneralCalculator */
 interface IBaseDimensionsAndMeasuresCalculatorInput {
@@ -1017,12 +963,8 @@ interface IBaseDimensionsAndMeasuresCalculatorInput {
     dimensionsLimit?: number;
     /** Удалять ли строки, в которых значения всех мер пустые */
     isHideEmptyMeasures?: boolean;
-    /**
-     * Направления сортировки (в качестве ключа - формула показателя)
-     * todo: widgets - удалить вариант с Map, т.к. при сортировке важен порядок элементов,
-     * правильнее будет указывать его явно через массив.
-     */
-    sortOrders?: ISortOrder[] | Map<string, TSortDirection>;
+    /** Сортировка */
+    sortOrders?: ISortOrder[];
     /** Формула условия отображения */
     displayConditionFormula?: TNullable<string>;
 }
@@ -1144,12 +1086,8 @@ interface ITwoLimitsCalculatorInput {
     measuresLimit?: number;
     /** Удалять ли строки, в которых значения всех мер пустые */
     isHideEmptyMeasures?: boolean;
-    /**
-     * Направления сортировки (в качестве ключа - формула показателя)
-     * todo: widgets - удалить вариант с Map, т.к. при сортировке важен порядок элементов,
-     * правильнее будет указывать его явно через массив.
-     */
-    sortOrders?: ISortOrder[] | Map<string, TSortDirection>;
+    /** Сортировка */
+    sortOrders?: ISortOrder[];
     /** Формула условия отображения */
     displayConditionFormula?: TNullable<string>;
     /** Лимит строк */
@@ -1183,8 +1121,13 @@ interface ITypeCalculatorInput {
         formula: string;
     }[];
 }
+interface ITypeCalculatorOutputItem {
+    simpleType: ESimpleDataType;
+    dataType: ESimpleDataType;
+    isArrayDataType: boolean;
+}
 interface ITypeCalculatorOutput {
-    types: Map<string, ESimpleDataType>;
+    types: Map<string, ITypeCalculatorOutputItem>;
 }
 interface ITypeCalculator extends ICalculator<ITypeCalculatorInput, ITypeCalculatorOutput> {
 }
@@ -1199,7 +1142,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<T extends IWidgetDimension>(dimensions: T[], variables: Map<string, TWidgetVariable>, addFormulas?: (dimension: T) => Map<string, string>): ICalculatorDimensionInput[];
+declare function mapDimensionsToInputs<T extends IWidgetDimension>(dimensions: T[], variables: Map<string, TWidgetVariable>): ICalculatorDimensionInput[];
 
 /** Конвертировать процессные показатели виджета во входы для вычислителя */
 declare function mapTransitionMeasuresToInputs<T extends IProcessIndicator>(indicators: T[], process: IWidgetProcess, variables: Map<string, TWidgetVariable>, addFormulas?: (indicator: T) => Map<string, string>): ICalculatorMeasureInput[];
@@ -1207,14 +1150,17 @@ declare function mapTransitionMeasuresToInputs<T extends IProcessIndicator>(indi
 /** Конвертировать показатели процессных событий виджета во входы для вычислителя */
 declare function mapEventMeasuresToInputs<T extends IProcessIndicator>(indicators: T[], process: IWidgetProcess, variables: Map<string, TWidgetVariable>, addFormulas?: (indicator: T) => Map<string, string>): ICalculatorMeasureInput[];
 
-/**
- * Преобразовать объекты сортировок из settings виджета в sortOrders вычислителя
- * @param sortingIndicators объекты сортировок из settings виджета
- * @param dimensionsInOriginalOrder разрезы виджета (конкретный разрез будет браться по индексу)
- * @param measuresInOriginalOrder меры виджета (конкретная мера будет браться по индексу)
- * @returns
- */
-declare function mapSortingToInputs(sortingIndicators: IWidgetSortingIndicator[] | undefined, dimensionsInOriginalOrder: IWidgetDimension[] | undefined, measuresInOriginalOrder: IWidgetMeasure[] | undefined, variables: Map<string, TWidgetVariable>): ISortOrder[];
+/** Преобразовать объекты сортировок из settings виджета в sortOrders вычислителя */
+interface IMapSortingToInputsParams<Settings, Indicator> {
+    settings: Settings;
+    variables: Map<string, TWidgetVariable>;
+    filters: ICalculatorFilter[];
+    getIndicatorType(key: string, indicator: Indicator): EWidgetIndicatorType.DIMENSION | EWidgetIndicatorType.MEASURE;
+    /** При отсутствии сортировки использовать предустановленную сортировку(на основе sortableIndicatorsKeys) */
+    withDefaultSortOrder?: boolean;
+    sortableIndicatorsKeys?: Readonly<StringKeyOf<Settings>[]>;
+}
+declare function mapSortingToInputs<Settings extends IBaseWidgetSettings = IBaseWidgetSettings, Indicator extends IWidgetColumnIndicator = IWidgetColumnIndicator>({ settings, variables, filters, getIndicatorType, withDefaultSortOrder, sortableIndicatorsKeys, }: IMapSortingToInputsParams<Settings, Indicator>): ISortOrder[];
 
 /**
  * Выбрать активный разрез иерархии на основе активных фильтров.
@@ -1222,7 +1168,7 @@ declare function mapSortingToInputs(sortingIndicators: IWidgetSortingIndicator[]
  * Если к разрезу иерархии применяется INCLUDE-фильтр с одним значением - выбираем следующий за ним разрез
  * Если к разрезу иерархии применяется INCLUDE-фильтр с несколькими значениями - выбираем данный разрез
  */
-declare function selectDimensionFromHierarchy<H extends IWidgetDimensionHierarchy<D>, D extends IWidgetDimension>({ dimensions }: H, filters: ICalculatorFilter[]): TNullable<D>;
+declare function selectDimensionFromHierarchy<H extends IWidgetDimensionHierarchy<D>, D extends IWidgetDimension>({ hierarchyDimensions }: H, filters: ICalculatorFilter[]): TNullable<D>;
 
 declare const replaceHierarchiesWithDimensions: <D extends IWidgetDimension = IWidgetDimension>(dimensions: (D | IWidgetDimensionHierarchy<D>)[], filters: ICalculatorFilter[]) => D[];
 
@@ -1341,40 +1287,31 @@ interface ICustomAddButtonProps {
     hasDropdown?: boolean;
     onClick?: ISelectLeafOption["onSelect"];
 }
-interface IWidgetIndicatorMenuConfig {
+interface IWidgetIndicatorAddButtonProps {
     hideTablesColumnsOptions?: boolean;
     hideCommonOptions?: boolean;
     hideQuantityOption?: boolean;
 }
-interface IMeasureMenuConfig extends IWidgetIndicatorMenuConfig {
+interface IMeasureAddButtonProps extends IWidgetIndicatorAddButtonProps {
     options?: TMeasureAddButtonSelectOption[];
 }
-interface ISortingMenuConfig extends IWidgetIndicatorMenuConfig {
+interface ISortingAddButtonProps extends IWidgetIndicatorAddButtonProps {
+}
+interface IInitialSettings extends Record<string, any> {
 }
 /** Кнопка добавления группы в набор */
 type TAddButton = {
     title: string;
-    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 {
+    props?: ICustomAddButtonProps | IMeasureAddButtonProps | ISortingAddButtonProps;
     /**
-     * Идентификатор, добавляемый системой "на лету" для удобства разработки, не сохраняется на сервер.
-     * Гарантируется уникальность id в пределах settings виджета.
+     * Начальные настройки, которые получит показатель при создании через кнопку добавления.
+     * Возможность не поддерживается для иерархии разрезов.
+     *
+     * Кейс использования:
+     * - Добавление поля type разрезам и мерам виджета "Таблица", т.к. разрезы и меры хранятся в одном массиве.
      */
-    id: number;
-}
+    initialSettings?: IInitialSettings;
+};
 interface IGroupSettings extends IAutoIdentifiedArrayItem, Record<string, any> {
 }
 /** Конфигурация набора групп */
@@ -1385,6 +1322,8 @@ interface IGroupSetDescription<Settings extends object, GroupSettings extends ob
     maxCount: number;
     /** Описание доступа к настройкам групп */
     accessor: TRecordAccessor<Settings, GroupSettings[]>;
+    /** Получить тип индикатора */
+    getType?: (settings: IInitialSettings) => EWidgetIndicatorType;
     /** Кнопки добавления группы в набор */
     addButtons: TAddButton[];
     /** Создать элементы управления внутри группы (для вкладки настроек данных) */
@@ -1416,6 +1355,10 @@ interface IPanelDescription<Settings extends object, GroupSettings extends IGrou
     displayRecords?: TWidgetLevelRecord<Settings>[];
     /** Конфигурации наборов групп  */
     groupSetDescriptions?: Record<string, IGroupSetDescription<Settings, GroupSettings>>;
+    /** Добавить вкладку с действиями (по умолчанию false) */
+    useActions?: boolean;
+    /** Добавить вкладку с фильтрацией (по умолчанию true) */
+    useFiltration?: boolean;
     /** Конфигурация настроек фильтров */
     filtrationRecords?: Exclude<TWidgetLevelRecord<Settings>, IGroupSetRecord>[];
     /** Режимы фильтрации */
@@ -1446,12 +1389,19 @@ interface IWidgetProcess {
 interface IDivePanelDescription<Settings extends object, GroupSettings extends IGroupSettings = IGroupSettings> extends IPanelDescription<Settings, GroupSettings> {
 }
 interface IPanelDescriptionCreator<Settings extends IBaseWidgetSettings, GroupSettings extends IGroupSettings> {
-    (context: IWidgetsContext, panelSettings: Settings, calculatorFactory: ICalculatorFactory): IPanelDescription<Settings, GroupSettings>;
+    (context: IGlobalContext, panelSettings: Settings, calculatorFactory: ICalculatorFactory): IPanelDescription<Settings, GroupSettings>;
 }
 
 interface IWidgetPlaceholderController {
     setError(value: Error | null): void;
     setConfigured(value: boolean): void;
+    /**
+     * Устанавливает состояние видимости виджета.
+     *
+     * После вызова данного метода виджет станет доступен для отображения.
+     * Это предотвращает мерцание при первом появлении виджета на экране.
+     * Метод должен быть вызван после полной готовности виджета: все необходимые данные загружены, высота установлена.
+     */
     setDisplay(value: boolean): void;
     setEmpty(value: boolean): void;
     setOverlay(value: boolean): void;
@@ -1471,8 +1421,8 @@ interface IDefinition<WidgetSettings extends IBaseWidgetSettings, GroupSettings
     createPanelDescription: IPanelDescriptionCreator<WidgetSettings, GroupSettings>;
     /** заполняет настройки значениями по умолчанию */
     fillSettings: IFillSettings<WidgetSettings>;
-    getDimensions?(settings: WidgetSettings): (IWidgetDimension | IWidgetDimensionHierarchy)[];
-    getMeasures?(settings: WidgetSettings): IWidgetMeasure[];
+    /** возвращает ключи показателей(разрезов или мер), для которых должна работать системная сортировка */
+    getSortableIndicatorsKeys(): Readonly<StringKeyOf<WidgetSettings>[]>;
 }
 
 type TContextMenu = (TContextMenuList | TContextMenuButtonGroup) & {
@@ -1578,9 +1528,9 @@ interface IWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetS
     placeholder: IWidgetPlaceholderController;
     /** Объект для получения значений плейсхолдера */
     placeholderValues: IWidgetPlaceholderValues;
-    /** Контекст виджета */
-    widgetsContext: IWidgetsContext;
-    /**Контекст образа */
+    /** Глобальный контекст. Содержит информацию из отчета, пространства и платформы системы */
+    globalContext: IGlobalContext;
+    /** Контекст образа */
     viewContext: IViewContext;
     /** Данные о контейнере виджета */
     widgetContainer: TWidgetContainer;
@@ -1592,20 +1542,10 @@ interface IWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetS
     setContextMenu: (key: string, value: TContextMenu | null) => void;
 }
 interface ICustomWidgetProps<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetSettings> extends IWidgetProps<WidgetSettings> {
-    /** @deprecated - нужно использовать из widgetsContext */
-    language: ELanguages;
-    /**
-     * режим дашборда
-     * @deprecated 2401 - необходимо использовать displayMode из widgetsContext */
-    isViewMode: boolean;
     /** манифест виджета */
     manifest: Record<string, any>;
-    /** @deprecated - процессы приходят в widgetsContext */
-    processes: Map<string, IWidgetProcess>;
     /** body DOM элемент родительского приложения */
     bodyElement: HTMLBodyElement;
-    /** @deprecated - значения переменных на дашборде нужно использовать из widgetsContext */
-    variables: Map<string, TWidgetVariable>;
     /** Форматирование */
     formatting: IWidgetFormatting;
     /** Получить ресурс виджета по имени файла */
@@ -1648,7 +1588,7 @@ interface IWidget<WidgetSettings extends IBaseWidgetSettings> {
     unmount(container: HTMLElement): void;
 }
 interface IFillSettings<WidgetSettings extends IBaseWidgetSettings> {
-    (settings: Partial<WidgetSettings>, context: IWidgetsContext): void;
+    (settings: Partial<WidgetSettings>, context: IGlobalContext): void;
 }
 interface IWidgetEntity<WidgetSettings extends IBaseWidgetSettings, GroupSettings extends IGroupSettings> {
     new (): IWidget<WidgetSettings>;
@@ -1707,25 +1647,46 @@ declare const measureTemplateFormulas: {
 declare function getMeasureFormula({ value }: IWidgetMeasure): string;
 
 declare enum EEventMeasureTemplateNames {
-    count = "count",
+    eventsCount = "eventsCount",
     reworksCount = "reworksCount"
 }
 declare const eventMeasureTemplateFormulas: {
-    readonly count: "count()";
+    readonly eventsCount: "count()";
     readonly reworksCount: "count() - uniqExact({caseCaseIdFormula})";
 };
 declare function getEventMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
 
 declare enum ETransitionMeasureTemplateNames {
-    count = "count",
+    transitionsCount = "transitionsCount",
     medianTime = "medianTime"
 }
 declare const transitionMeasureTemplateFormulas: {
-    readonly count: "count()";
+    readonly transitionsCount: "count()";
     readonly medianTime: "medianExact(date_diff(second, begin({eventTimeFormula}), end({eventTimeFormula})))";
 };
 declare function getTransitionMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
 
+/**
+ * Регулярное выражение для поиска имени ссылки внутри формулы.
+ * Учитывает, что имя внутри формулы содержит экраны.
+ *
+ * Принцип работы:
+ * Пробовать следующие вхождения:
+ *  - \\\\ - экранированный символ обратного слэша.
+ *  - Иначе \\" - экранированный символ кавычки.
+ *  - Иначе [^"] - любой символ кроме кавычки.
+ *  Если встречается любой другой символ, то это закрывающая кавычка имени переменной.
+ */
+declare const linkNameRegExp = "(?:\\\\\\\\|\\\\\"|[^\"])+";
+declare const dashboardLinkRegExp: RegExp;
+declare const workspaceLinkRegExp: RegExp;
+interface IIndicatorLink {
+    /** string - имя группы пространства, null - используется текущий отчет */
+    scopeName: string | null;
+    indicatorName: string;
+}
+declare const parseIndicatorLink: (formula: string) => IIndicatorLink | null;
+
 interface IDimensionSelection {
     values: Set<string | null>;
     replacedFilter: ICalculatorFilter | null;
@@ -1752,8 +1713,6 @@ type TDefineWidgetOptions = {
 };
 declare global {
     interface Infomaximum {
-        /** @deprecated 2402 -  необходимо использовать window.im.widget.defineWidget */
-        defineWidget: <WidgetSettings extends IBaseWidgetSettings, GroupSettings extends IGroupSettings>(uuid: string, Widget: IWidgetEntity<WidgetSettings, GroupSettings>) => void;
         widget: {
             currentSdkVersion: number;
             defineWidget: <WidgetSettings extends IBaseWidgetSettings, GroupSettings extends IGroupSettings>(uuid: string, Widget: IWidgetEntity<WidgetSettings, GroupSettings>, options?: TDefineWidgetOptions) => void;
@@ -1761,4 +1720,4 @@ declare global {
     }
 }
 
-export { EActionTypes, ECalculatorFilterMethods, EColorMode, EColorScope, EControlType, ECustomSelectTemplates, EDbType, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationUnit, EEventMeasureTemplateNames, EFontWeight, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureTemplateNames, EProcessFilterNames, ESelectOptionTypes, ESimpleDataType, ESortDirection, ESortingValueModes, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, type IActionGoToUrl, type IActionRunScript, type IActionScript, type IActionUpdateVariable, type IAddButtonSelectOption, 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 ICommonDimensions, type ICommonMeasures, type ICommonState, 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 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 ISelectBranchOption, type ISelectDividerOption, type ISelectGroupOption, type ISelectLeafOption, type ISelectOption, type ISelectSystemOption, type ISortOrder, type ISortingMenuConfig, type IStagesFilterValue, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type IVertex, type IViewContext, type IViewInputValue, type IWidget, type IWidgetAction, 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 IWorkspaceDisplayRule, type TAction, type TActionOnClickParameter, type TActionOpenView, 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 TCustomAddButtonSelectOption, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TExtendedFormulaFilterValue, type TFiltrationMode, type TGroupLevelRecord, type TLaunchActionParams, type TMeasureAddButtonSelectOption, type TProcessIndicatorValue, type TRecordAccessor, type TSelectChildOptions, type TSelectFetchOptions, type TSelectivePartial, type TSortDirection, type TUpdateSelection, type TValuePath, type TWidgetActionParameter, 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, isExecuteScriptActionValid, isFormulaFilterValue, isHierarchy, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureTemplateFormulas, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateMultiModeSelection, updateSingleModeSelection };
+export { EActionTypes, ECalculatorFilterMethods, EColorMode, EControlType, ECustomSelectTemplates, EDbType, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationUnit, EEventMeasureTemplateNames, EFontWeight, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureTemplateNames, EProcessFilterNames, ESelectOptionTypes, ESimpleDataType, ESortDirection, ESortingValueModes, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, type IActionGoToUrl, type IActionRunScript, type IActionScript, type IActionUpdateVariable, type IAddButtonSelectOption, type IAddDurationOfTransitionFilter, type IAddPresenceOfEventFilter, type IAddPresenceOfTransitionFilter, type IAddRepetitionOfEventFilter, type IAutoIdentifiedArrayItem, 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 ICommonDimensions, type ICommonMeasures, type ICommonState, 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 IGlobalContext, type IGraphElement, type IGroupSetDescription, type IGroupSetRecord, type IGroupSettings, type IHistogramBin, type IHistogramCalculator, type IHistogramCalculatorInput, type IHistogramCalculatorOutput, type IIndicatorLink, type IInitialSettings, type ILens, type IMarkdownMeasure, type IMeasureAddButtonProps, 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 ISelectBranchOption, type ISelectDividerOption, type ISelectGroupOption, type ISelectLeafOption, type ISelectOption, type ISelectSystemOption, type ISortOrder, type ISortingAddButtonProps, type IStagesFilterValue, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type ITypeCalculatorOutputItem, type IVertex, type IViewContext, type IViewInputValue, type IWidget, type IWidgetAction, type IWidgetColumnIndicator, type IWidgetDimension, type IWidgetDimensionHierarchy, type IWidgetEntity, type IWidgetFilter, type IWidgetFiltration, type IWidgetFormatting, type IWidgetIndicator, type IWidgetIndicatorAddButtonProps, type IWidgetMeasure, type IWidgetPersistValue, type IWidgetPlaceholderController, type IWidgetPlaceholderValues, type IWidgetProcess, type IWidgetProps, type IWidgetSortingIndicator, type IWidgetTable, type IWidgetTableColumn, type TAction, type TActionOnClickParameter, type TActionOpenView, type TActionsOnClick, type TAddButton, 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 TCustomAddButtonSelectOption, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TExtendedFormulaFilterValue, type TFiltrationMode, type TGroupLevelRecord, type TLaunchActionParams, type TMeasureAddButtonSelectOption, type TProcessIndicatorValue, type TRecordAccessor, type TSelectChildOptions, type TSelectFetchOptions, type TSelectivePartial, type TSortDirection, type TUpdateSelection, type TValuePath, type TWidgetActionParameter, type TWidgetContainer, type TWidgetFilterValue, type TWidgetFiltering, type TWidgetLevelRecord, type TWidgetSortingValue, type TWidgetVariable, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, dashboardLinkRegExp, dimensionTemplateFormulas, escapeSpecialCharacters, eventMeasureTemplateFormulas, fillTemplateString, formulaFilterMethods, generateColumnFormula, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getRuleColor, getTransitionMeasureFormula, isDimensionsHierarchy, isExecuteScriptActionValid, isFormulaFilterValue, isValidColor, linkNameRegExp, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureTemplateFormulas, parseIndicatorLink, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateMultiModeSelection, updateSingleModeSelection, workspaceLinkRegExp };