@infomaximum/widget-sdk 6.0.0-4 → 6.0.0-5

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [6.0.0-5](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-4...v6.0.0-5) (2025-09-01)
+
+
+### Features
+
+* добавлена поддержка фильтрации шаблонов мер и агригатных разрезов [WD-1197] ([af49cc3](https://github.com/Infomaximum/widget-sdk/commit/af49cc3ff7840f0d7762c6c40eb1bf183a32d4b7))
+* добавлена фильтрация шаблонов для процессных разрезов времяни [WD-1197] ([564cd57](https://github.com/Infomaximum/widget-sdk/commit/564cd5782276c4ec74c8d26de109f0d2e9deec50))
+
 ## [6.0.0-4](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-3...v6.0.0-4) (2025-08-29)
 
 

package/dist/index.d.ts

@@ -1158,206 +1158,6 @@ interface IParsedDbType<T extends TNullable<string> = string> {
     simpleType: ESimpleDataType;
 }
 
-declare enum EDimensionTemplateNames {
-    dateTime = "dateTime",
-    date = "date",
-    year = "year",
-    yearAndQuarter = "yearAndQuarter",
-    quarter = "quarter",
-    yearAndMonth = "yearAndMonth",
-    dayOfMonth = "dayOfMonth",
-    month = "month",
-    week = "week",
-    dayOfWeek = "dayOfWeek",
-    hour = "hour"
-}
-/** Стандартные шаблоны разреза */
-declare const dimensionTemplateFormulas: Record<EDimensionTemplateNames, string>;
-
-declare function getDimensionFormula({ value }: IWidgetDimension): string;
-
-declare enum EDimensionAggregationTemplateName {
-    avg = "avg",
-    median = "median",
-    count = "count",
-    countDistinct = "countDistinct",
-    min = "min",
-    max = "max",
-    sum = "sum",
-    top = "top",
-    firstValue = "firstValue",
-    lastValue = "lastValue",
-    countExecutions = "countExecutions",
-    countReworks = "countReworks"
-}
-/** Шаблоны процессных метрик разреза с режимом AGGREGATION */
-declare const dimensionAggregationTemplates: Record<EDimensionAggregationTemplateName, string>;
-/** На основе значения режима AGGREGATION подготовить параметры для подстановки в шаблонную формулу */
-declare const prepareDimensionAggregationParams: (value: Extract<IWidgetDimension["value"], {
-    mode: EWidgetIndicatorValueModes.AGGREGATION;
-}>) => {
-    eventNameFormula: string;
-    caseCaseIdFormula: string;
-    eventName: string;
-    objectFilters: string;
-    filters: string;
-    eventTimeFormula: string;
-    columnFormula: string;
-} | null;
-
-/** Шаблоны процессных метрик разреза с режимами START_TIME/END_TIME */
-declare const timeTemplates: {
-    START_TIME: Record<EDimensionTemplateNames, string>;
-    END_TIME: Record<EDimensionTemplateNames, string>;
-};
-/** На основе значения режимов START_TIME/END_TIME подготовить параметры для подстановки в шаблонную формулу */
-declare const prepareTimeParams: (value: TWidgetIndicatorTimeValue) => {
-    eventTimeFormula: string;
-    eventNameFormula: string;
-    caseCaseIdFormula: string;
-    filters: string;
-    eventName: string;
-} | undefined;
-
-declare function getMeasureFormula({ value }: IWidgetMeasure): string;
-
-declare enum EMeasureTemplateNames {
-    avg = "avg",
-    median = "median",
-    count = "count",
-    countDistinct = "countDistinct",
-    min = "min",
-    max = "max",
-    sum = "sum"
-}
-/** Стандартные шаблоны меры */
-declare const measureTemplateFormulas: {
-    readonly avg: "avg({columnFormula})";
-    readonly count: "count({columnFormula})";
-    readonly countDistinct: "count(distinct {columnFormula})";
-    readonly median: "medianExact({columnFormula})";
-    readonly min: "min({columnFormula})";
-    readonly max: "max({columnFormula})";
-    readonly sum: "sum({columnFormula})";
-};
-
-declare enum EMeasureAggregationTemplateName {
-    agvIf = "agvIf",
-    medianIf = "medianIf",
-    countIf = "countIf",
-    countIfDistinct = "countIfDistinct",
-    minIf = "minIf",
-    maxIf = "maxIf",
-    sumIf = "sumIf",
-    top = "top",
-    firstValue = "firstValue",
-    lastValue = "lastValue",
-    countExecutions = "countExecutions",
-    countReworks = "countReworks"
-}
-/** На основе значения режима AGGREGATION подготовить параметры для подстановки в шаблонную формулу */
-declare const prepareMeasureAggregationParams: (value: Extract<IWidgetMeasure["value"], {
-    mode: EWidgetIndicatorValueModes.AGGREGATION;
-}>) => {
-    outerAggregation: EOuterAggregation;
-    eventNameFormula: string;
-    caseCaseIdFormula: string;
-    eventName: string | null;
-    objectFilters: string;
-    filters: string;
-    eventTimeFormula: string;
-    columnFormula: string;
-} | null;
-
-/** Шаблон процессной метрики меры с режимом CONVERSION */
-declare const conversionTemplate = "countIf(\n    process(\n        minIf(\n            {startEventTimeFormula}, \n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ), \n        {endCaseCaseIdFormula}\n    ) < \n    process(\n        maxIf(\n            {endEventTimeFormula}, \n            {endEventNameFormula} = '{endEventName}'{endEventFilters}\n        ), \n        {endCaseCaseIdFormula}\n    ) \n    and \n    process(\n        countIf(\n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ) != 0, \n        {endCaseCaseIdFormula}\n    ) != 0\n) / countIf(\n    process(\n        countIf(\n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ) != 0, \n        {endCaseCaseIdFormula}\n    ) != 0\n)";
-/** На основе значения режима CONVERSION подготовить параметры для подстановки в шаблонную формулу */
-declare const prepareConversionParams: (value: TWidgetIndicatorConversionValue) => {
-    objectFilters: string;
-    startEventTimeFormula: string;
-    startEventNameFormula: string;
-    startEventFilters: string;
-    startEventName: string;
-    endEventTimeFormula: string;
-    endCaseCaseIdFormula: string;
-    endEventNameFormula: string;
-    endEventName: string;
-    endEventFilters: string;
-} | null;
-
-declare function createAggregationTemplate(templateName: EMeasureAggregationTemplateName, { outerAggregation, anyEvent, }: Pick<TWidgetIndicatorAggregationValue, "anyEvent"> & {
-    outerAggregation: EOuterAggregation;
-}): string;
-
-/** Шаблоны процессных метрик меры с режимом DURATION */
-declare const durationTemplates: Record<EDurationTemplateName, string>;
-/** На основе значения режима DURATION подготовить параметры для подстановки в шаблонную формулу */
-declare const prepareDurationParams: (value: TWidgetIndicatorDurationValue) => {
-    objectFilters: string;
-    startEventTimeFormula: string;
-    startEventNameFormula: string;
-    startEventFilters: string;
-    startEventName: string;
-    startEventAggregationName: string;
-    endEventTimeFormula: string;
-    endCaseCaseIdFormula: string;
-    endEventNameFormula: string;
-    endEventName: string;
-    endEventFilters: string;
-    endEventAggregationName: string;
-} | null;
-
-declare function getEventMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
-
-declare enum EEventMeasureTemplateNames {
-    eventsCount = "eventsCount",
-    reworksCount = "reworksCount"
-}
-declare const eventMeasureTemplateFormulas: {
-    readonly eventsCount: "count()";
-    readonly reworksCount: "count() - uniqExact({caseCaseIdFormula})";
-};
-
-declare function getTransitionMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
-
-declare enum ETransitionMeasureTemplateNames {
-    transitionsCount = "transitionsCount",
-    medianTime = "medianTime"
-}
-declare const transitionMeasureTemplateFormulas: {
-    readonly transitionsCount: "count()";
-    readonly medianTime: "medianExact(date_diff(second, begin({eventTimeFormula}), end({eventTimeFormula})))";
-};
-
-declare const countExecutionsTemplate = "process(countIf({eventNameFormula} in '{eventName}'{filters}), {caseCaseIdFormula})";
-
-declare function fillTemplateString(templateString: string, params: Record<string, any>): string;
-
-declare function generateColumnFormula(tableName: string, columnName: string): string;
-
-/**
- * Паттерн подстроки, валидной для использования внутри фигурных скобок.
- * Требование к подстроке - отсутствие закрывающих фигурных скобок (кроме экранированных).
- */
-declare const curlyBracketsContentPattern: string;
-/**
- * Паттерн подстроки, валидной для использования внутри двойных кавычек.
- * Требование к подстроке - отсутствие двойных кавычек (кроме экранированных).
- */
-declare const doubleQuoteContentPattern: string;
-declare const dashboardLinkRegExp: RegExp;
-declare const workspaceLinkRegExp: RegExp;
-/** Экранирование спец.символов при подстановке названий таблиц и колонок */
-declare const escapeDoubleQuoteLinkName: (str: string) => string;
-/** Экранирование спец.символов при подстановке названий переменных и показателей */
-declare const escapeCurlyBracketLinkName: (str: string) => string;
-interface IIndicatorLink {
-    /** string - имя группы пространства, null - используется текущий отчет */
-    scopeName: string | null;
-    indicatorName: string;
-}
-declare const parseIndicatorLink: (formula: string) => IIndicatorLink | null;
-
 type THintPlacement = "top" | "left" | "right" | "bottom" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "leftTop" | "leftBottom" | "rightTop" | "rightBottom";
 declare enum EControlType {
     /** Ввод текста */
@@ -1635,6 +1435,7 @@ interface IFormulaControl {
         showModeToggle?: boolean;
         indicatorConfig?: ({
             type: "measure";
+            templates?: TWidgetMeasureData["templates"];
         } & {
             /** @deprecated временное решение для виджета "Воронка", не следует использовать [BI-14710] */
             allowClear?: boolean;
@@ -1646,7 +1447,8 @@ interface IFormulaControl {
             options?: TMeasureAddButtonSelectOption[];
         }) | {
             type: "dimension";
-            templates?: EDimensionTemplateNames[];
+            templates?: TWidgetDimensionData["templates"];
+            processTimeTemplates?: TWidgetDimensionData["processTimeTemplates"];
         };
         disabled?: boolean;
         /** Ключи процессов для фильтрации таблиц, доступных для выбора */
@@ -2072,6 +1874,206 @@ interface ICalculatorFactory {
     type: (options?: ICalculatorOptions) => ITypeCalculator;
 }
 
+declare enum EDimensionTemplateNames {
+    dateTime = "dateTime",
+    date = "date",
+    year = "year",
+    yearAndQuarter = "yearAndQuarter",
+    quarter = "quarter",
+    yearAndMonth = "yearAndMonth",
+    dayOfMonth = "dayOfMonth",
+    month = "month",
+    week = "week",
+    dayOfWeek = "dayOfWeek",
+    hour = "hour"
+}
+/** Стандартные шаблоны разреза */
+declare const dimensionTemplateFormulas: Record<EDimensionTemplateNames, string>;
+
+declare function getDimensionFormula({ value }: IWidgetDimension): string;
+
+declare enum EDimensionAggregationTemplateName {
+    avg = "avg",
+    median = "median",
+    count = "count",
+    countDistinct = "countDistinct",
+    min = "min",
+    max = "max",
+    sum = "sum",
+    top = "top",
+    firstValue = "firstValue",
+    lastValue = "lastValue",
+    countExecutions = "countExecutions",
+    countReworks = "countReworks"
+}
+/** Шаблоны процессных метрик разреза с режимом AGGREGATION */
+declare const dimensionAggregationTemplates: Record<EDimensionAggregationTemplateName, string>;
+/** На основе значения режима AGGREGATION подготовить параметры для подстановки в шаблонную формулу */
+declare const prepareDimensionAggregationParams: (value: Extract<IWidgetDimension["value"], {
+    mode: EWidgetIndicatorValueModes.AGGREGATION;
+}>) => {
+    eventNameFormula: string;
+    caseCaseIdFormula: string;
+    eventName: string;
+    objectFilters: string;
+    filters: string;
+    eventTimeFormula: string;
+    columnFormula: string;
+} | null;
+
+/** Шаблоны процессных метрик разреза с режимами START_TIME/END_TIME */
+declare const timeTemplates: {
+    START_TIME: Record<EDimensionTemplateNames, string>;
+    END_TIME: Record<EDimensionTemplateNames, string>;
+};
+/** На основе значения режимов START_TIME/END_TIME подготовить параметры для подстановки в шаблонную формулу */
+declare const prepareTimeParams: (value: TWidgetIndicatorTimeValue) => {
+    eventTimeFormula: string;
+    eventNameFormula: string;
+    caseCaseIdFormula: string;
+    filters: string;
+    eventName: string;
+} | undefined;
+
+declare function getMeasureFormula({ value }: IWidgetMeasure): string;
+
+declare enum EMeasureTemplateNames {
+    avg = "avg",
+    median = "median",
+    count = "count",
+    countDistinct = "countDistinct",
+    min = "min",
+    max = "max",
+    sum = "sum"
+}
+/** Стандартные шаблоны меры */
+declare const measureTemplateFormulas: {
+    readonly avg: "avg({columnFormula})";
+    readonly count: "count({columnFormula})";
+    readonly countDistinct: "count(distinct {columnFormula})";
+    readonly median: "medianExact({columnFormula})";
+    readonly min: "min({columnFormula})";
+    readonly max: "max({columnFormula})";
+    readonly sum: "sum({columnFormula})";
+};
+
+declare enum EMeasureAggregationTemplateName {
+    agvIf = "agvIf",
+    medianIf = "medianIf",
+    countIf = "countIf",
+    countIfDistinct = "countIfDistinct",
+    minIf = "minIf",
+    maxIf = "maxIf",
+    sumIf = "sumIf",
+    top = "top",
+    firstValue = "firstValue",
+    lastValue = "lastValue",
+    countExecutions = "countExecutions",
+    countReworks = "countReworks"
+}
+/** На основе значения режима AGGREGATION подготовить параметры для подстановки в шаблонную формулу */
+declare const prepareMeasureAggregationParams: (value: Extract<IWidgetMeasure["value"], {
+    mode: EWidgetIndicatorValueModes.AGGREGATION;
+}>) => {
+    outerAggregation: EOuterAggregation;
+    eventNameFormula: string;
+    caseCaseIdFormula: string;
+    eventName: string | null;
+    objectFilters: string;
+    filters: string;
+    eventTimeFormula: string;
+    columnFormula: string;
+} | null;
+
+/** Шаблон процессной метрики меры с режимом CONVERSION */
+declare const conversionTemplate = "countIf(\n    process(\n        minIf(\n            {startEventTimeFormula}, \n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ), \n        {endCaseCaseIdFormula}\n    ) < \n    process(\n        maxIf(\n            {endEventTimeFormula}, \n            {endEventNameFormula} = '{endEventName}'{endEventFilters}\n        ), \n        {endCaseCaseIdFormula}\n    ) \n    and \n    process(\n        countIf(\n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ) != 0, \n        {endCaseCaseIdFormula}\n    ) != 0\n) / countIf(\n    process(\n        countIf(\n            {startEventNameFormula} = '{startEventName}'{startEventFilters}\n        ) != 0, \n        {endCaseCaseIdFormula}\n    ) != 0\n)";
+/** На основе значения режима CONVERSION подготовить параметры для подстановки в шаблонную формулу */
+declare const prepareConversionParams: (value: TWidgetIndicatorConversionValue) => {
+    objectFilters: string;
+    startEventTimeFormula: string;
+    startEventNameFormula: string;
+    startEventFilters: string;
+    startEventName: string;
+    endEventTimeFormula: string;
+    endCaseCaseIdFormula: string;
+    endEventNameFormula: string;
+    endEventName: string;
+    endEventFilters: string;
+} | null;
+
+declare function createAggregationTemplate(templateName: EMeasureAggregationTemplateName, { outerAggregation, anyEvent, }: Pick<TWidgetIndicatorAggregationValue, "anyEvent"> & {
+    outerAggregation: EOuterAggregation;
+}): string;
+
+/** Шаблоны процессных метрик меры с режимом DURATION */
+declare const durationTemplates: Record<EDurationTemplateName, string>;
+/** На основе значения режима DURATION подготовить параметры для подстановки в шаблонную формулу */
+declare const prepareDurationParams: (value: TWidgetIndicatorDurationValue) => {
+    objectFilters: string;
+    startEventTimeFormula: string;
+    startEventNameFormula: string;
+    startEventFilters: string;
+    startEventName: string;
+    startEventAggregationName: string;
+    endEventTimeFormula: string;
+    endCaseCaseIdFormula: string;
+    endEventNameFormula: string;
+    endEventName: string;
+    endEventFilters: string;
+    endEventAggregationName: string;
+} | null;
+
+declare function getEventMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
+
+declare enum EEventMeasureTemplateNames {
+    eventsCount = "eventsCount",
+    reworksCount = "reworksCount"
+}
+declare const eventMeasureTemplateFormulas: {
+    readonly eventsCount: "count()";
+    readonly reworksCount: "count() - uniqExact({caseCaseIdFormula})";
+};
+
+declare function getTransitionMeasureFormula({ value }: IProcessIndicator, process: IWidgetProcess): string;
+
+declare enum ETransitionMeasureTemplateNames {
+    transitionsCount = "transitionsCount",
+    medianTime = "medianTime"
+}
+declare const transitionMeasureTemplateFormulas: {
+    readonly transitionsCount: "count()";
+    readonly medianTime: "medianExact(date_diff(second, begin({eventTimeFormula}), end({eventTimeFormula})))";
+};
+
+declare const countExecutionsTemplate = "process(countIf({eventNameFormula} in '{eventName}'{filters}), {caseCaseIdFormula})";
+
+declare function fillTemplateString(templateString: string, params: Record<string, any>): string;
+
+declare function generateColumnFormula(tableName: string, columnName: string): string;
+
+/**
+ * Паттерн подстроки, валидной для использования внутри фигурных скобок.
+ * Требование к подстроке - отсутствие закрывающих фигурных скобок (кроме экранированных).
+ */
+declare const curlyBracketsContentPattern: string;
+/**
+ * Паттерн подстроки, валидной для использования внутри двойных кавычек.
+ * Требование к подстроке - отсутствие двойных кавычек (кроме экранированных).
+ */
+declare const doubleQuoteContentPattern: string;
+declare const dashboardLinkRegExp: RegExp;
+declare const workspaceLinkRegExp: RegExp;
+/** Экранирование спец.символов при подстановке названий таблиц и колонок */
+declare const escapeDoubleQuoteLinkName: (str: string) => string;
+/** Экранирование спец.символов при подстановке названий переменных и показателей */
+declare const escapeCurlyBracketLinkName: (str: string) => string;
+interface IIndicatorLink {
+    /** string - имя группы пространства, null - используется текущий отчет */
+    scopeName: string | null;
+    indicatorName: string;
+}
+declare const parseIndicatorLink: (formula: string) => IIndicatorLink | null;
+
 interface ILens<T extends TNullable<object>, Value> {
     get(obj: T): TNullable<Value>;
     set(obj: T, value: Value): void;
@@ -2206,16 +2208,25 @@ type TWidgetDimensionData = {
     type: EWidgetIndicatorType.DIMENSION;
     /** Обобщенные типы данных, поддерживаемые разрезом */
     simpleTypes?: ESimpleDataType[];
-    /** Шаблоны формул, доступные для выбора в разрезе */
-    templates?: Partial<Record<ESimpleDataType, EDimensionTemplateNames[]>>;
-    /** Переопределение доступных форматов и их порядка */
-    formats?: Record<ESimpleDataType, EFormatTypes[]>;
+    /**
+     * Шаблоны формул, доступные к выбору шаблоны на основе колонок (по типу колонки)
+     * Фильтрация применяется только для указанных типов колонки
+     */
+    templates?: Partial<Record<ESimpleDataType, (EDimensionTemplateNames | EDimensionAggregationTemplateName)[]>>;
+    /**
+     * Шаблоны формул, доступные к выбору в процессных разрезах по времени
+     */
+    processTimeTemplates?: EDimensionTemplateNames[];
+    /** Переопределение доступных форматов */
+    formats?: Partial<Record<ESimpleDataType, EFormatTypes[]>>;
 };
 /** Конфигурация меры */
 type TWidgetMeasureData = {
     type: EWidgetIndicatorType.MEASURE;
-    /** Переопределение доступных форматов и их порядка */
-    formats?: Record<ESimpleDataType, EFormatTypes[]>;
+    /** Переопределение доступных форматов */
+    formats?: Partial<Record<ESimpleDataType, EFormatTypes[]>>;
+    /** Шаблоны формул, доступные для выбора в мере */
+    templates?: Partial<Record<ESimpleDataType, EMeasureTemplateNames[]>>;
 };
 /** Конфигурация показателя */
 type TWidgetIndicatorData = TWidgetDimensionData | TWidgetMeasureData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infomaximum/widget-sdk",
-  "version": "6.0.0-4",
+  "version": "6.0.0-5",
   "main": "./dist/index.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",