@infomaximum/widget-sdk 6.0.0-view-theme.17 → 6.0.0-view-theme.19

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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-view-theme.19](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-view-theme.18...v6.0.0-view-theme.19) (2026-01-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* вместо удаленной функции в виджетах требуется использовать функцию fillTemplateSql
+* требуется поддержка в виджетах
+
+### Features
+
+* в схему формулы добавлена мета-информация о типе сущности ([45cb47f](https://github.com/Infomaximum/widget-sdk/commit/45cb47f79414d47c27529f4506bc507fee2d07cc))
+* из типа линзы убраны TNullable и Partial ([8f85239](https://github.com/Infomaximum/widget-sdk/commit/8f852393700b4914645eb6110fda3b55329cb83f))
+* метод createSettingsSchema сделан обязательным, а метод fillSettings - необязательным ([d0734a8](https://github.com/Infomaximum/widget-sdk/commit/d0734a8319e5abd96863ed345f35678170c0c0e3))
+* удалена функция fillTemplateString ([43a051d](https://github.com/Infomaximum/widget-sdk/commit/43a051dc6cdff3d774b06fe2e63f454b9f90a4d6))
+
+## [6.0.0-view-theme.18](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-view-theme.17...v6.0.0-view-theme.18) (2026-01-13)
+
+
+### Features
+
+* изменен api миграций ([ab086c6](https://github.com/Infomaximum/widget-sdk/commit/ab086c6c22ef489059b9a5ae01460af91b6f4782))
+
 ## [6.0.0-view-theme.17](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-view-theme.16...v6.0.0-view-theme.17) (2025-12-18)
 
 ## [6.0.0-view-theme.16](https://github.com/Infomaximum/widget-sdk/compare/v6.0.0-18...v6.0.0-view-theme.16) (2025-12-16)

package/dist/index.d.ts

@@ -897,12 +897,7 @@ declare const DisplayConditionSchema: (z: TZod) => zod.ZodDefault<zod.ZodDiscrim
 declare const KeyNullableSchema: (z: TZod) => zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
 /** Схема имени сущности (с возможностью находиться в неинициализированном состоянии) */
 declare const NameNullableSchema: (z: TZod) => zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
-/**
- * Схема формулы
- *
- * @note в будущем к схеме будет привязана мета-информация для того,
- * чтобы система видела расположение формул в настройках
- */
+/** Схема формулы */
 declare const FormulaSchema: (z: TZod) => zod.ZodDefault<zod.ZodString>;
 /**
  * Схема формулы, которая не может быть пустой строкой, но может быть в
@@ -955,10 +950,10 @@ declare const WidgetIndicatorSchema: (z: TZod) => zod.ZodObject<{
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     name: zod.ZodString;
 }, zod_v4_core.$strip>;
-declare const FormatSchema: (z: TZod) => zod.ZodObject<{
+declare const FormatSchema: (z: TZod) => zod.ZodDefault<zod.ZodObject<{
+    mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
     value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-    mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-}, zod_v4_core.$strip>;
+}, zod_v4_core.$strip>>;
 declare const FormattingSchema: (z: TZod) => zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
     mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
     value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -970,10 +965,10 @@ declare const WidgetColumnIndicatorSchema: (z: TZod) => zod.ZodObject<{
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     name: zod.ZodString;
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
         value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -1631,10 +1626,10 @@ declare const WidgetDimensionSchema: (z: TZod) => zod.ZodObject<{
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     name: zod.ZodString;
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
         value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -2200,10 +2195,10 @@ declare const WidgetDimensionSchema: (z: TZod) => zod.ZodObject<{
 }, zod_v4_core.$strip>;
 declare const WidgetDimensionInHierarchySchema: (z: TZod) => zod.ZodObject<{
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     value: zod.ZodOptional<zod.ZodDiscriminatedUnion<[zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EWidgetIndicatorValueModes.FORMULA>;
@@ -3922,10 +3917,10 @@ declare const WidgetMeasureSchema: (z: TZod) => zod.ZodObject<{
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     name: zod.ZodString;
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
         value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -4623,10 +4618,10 @@ declare const MarkdownMeasureSchema: (z: TZod) => zod.ZodObject<{
     id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
     name: zod.ZodString;
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
         value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -5353,10 +5348,10 @@ declare const ProcessIndicatorSchema: (z: TZod) => zod.ZodObject<{
         templateName: zod.ZodString;
     }, zod_v4_core.$strip>], "mode">>;
     dbDataType: zod.ZodOptional<zod.ZodString>;
-    format: zod.ZodOptional<zod.ZodObject<{
+    format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+        mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
         value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-        mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-    }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>>>;
     formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
         mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
         value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -8194,8 +8189,6 @@ declare const transitionMeasureTemplateFormulas: {
 
 declare const countExecutionsTemplate = "process(countIf({eventNameFormula} in {eventName}{filters}), {caseCaseIdFormula})";
 
-/** @deprecated - следует использовать fillTemplateSql */
-declare function fillTemplateString(templateString: string, params: Record<string, any>): string;
 /** Функция для безопасного заполнения SQL шаблонов с защитой от однострочных SQL комментариев в подставляемых значениях. */
 declare function fillTemplateSql(templateString: string, params: Record<string, string>): string;
 
@@ -8534,7 +8527,7 @@ interface ITypedFormulaControl {
     type: EControlType.typedFormula;
     value: {
         formula: string;
-        dbDataType: string;
+        dbDataType?: string;
     };
     props: {
         disabled?: boolean;
@@ -8544,8 +8537,8 @@ interface ITypedFormulaControl {
 interface IFormattingControl {
     type: EControlType.formatting;
     value: {
-        format: TSchemaType<typeof FormatSchema>;
-        formatting: TSchemaType<typeof FormattingSchema>;
+        format?: TSchemaType<typeof FormatSchema>;
+        formatting?: TSchemaType<typeof FormattingSchema>;
     };
     props: {
         formats?: Partial<Record<ESimpleDataType, EFormatTypes[]>>;
@@ -8734,10 +8727,10 @@ declare const BaseWidgetSettingsSchema: (z: TZod) => zod.ZodObject<{
         id: zod.ZodPipe<zod.ZodDefault<zod.ZodNumber>, zod.ZodTransform<number, number>>;
         name: zod.ZodString;
         dbDataType: zod.ZodOptional<zod.ZodString>;
-        format: zod.ZodOptional<zod.ZodObject<{
+        format: zod.ZodOptional<zod.ZodDefault<zod.ZodObject<{
+            mode: zod.ZodEnum<typeof EFormatOrFormattingMode>;
             value: zod.ZodOptional<zod.ZodEnum<typeof EFormatTypes>>;
-            mode: zod.ZodDefault<zod.ZodEnum<typeof EFormatOrFormattingMode>>;
-        }, zod_v4_core.$strip>>;
+        }, zod_v4_core.$strip>>>;
         formatting: zod.ZodOptional<zod.ZodDefault<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
             mode: zod.ZodLiteral<EFormatOrFormattingMode.BASE>;
             value: zod.ZodDefault<zod.ZodEnum<typeof EFormattingPresets>>;
@@ -10252,20 +10245,12 @@ interface ICalculatorFactory {
     type: (options?: ICalculatorOptions) => ITypeCalculator;
 }
 
-interface ILens<T extends TNullable<object>, Value> {
-    get(obj: T): TNullable<Value>;
-    set(obj: T, value: Value): void;
-}
-/**
- * Линза, которая может вернуть Partial значение из get (будет обработано на стороне control'а),
- * но требует передачи в set полного значения
- */
-interface IPartialLens<T extends TNullable<object>, Value> {
-    get(obj: T): TNullable<Partial<Value>>;
-    set(obj: T, value: Value): void;
+interface ILens<InputShape, Value> {
+    get(obj: InputShape): Value;
+    set(obj: InputShape, value: Value): void;
 }
 type TValuePath = string | string[];
-type TRecordAccessor<Settings extends object, Value> = TValuePath | IPartialLens<Settings, Value>;
+type TRecordAccessor<Settings extends object, Value> = TValuePath | ILens<Settings, Value>;
 interface IDisplayPredicate<Settings> {
     (s: Settings): boolean;
 }
@@ -10415,6 +10400,11 @@ type TWidgetIndicatorData = TWidgetDimensionData | TWidgetMeasureData;
  * Каждый объект в массиве - это группа настроек.
  *
  * Группа отображается в виде раскрываемой плашки, может представлять из себя разрез, меру, процесс и др.
+ *
+ * @remarks
+ * Если заменить createDataRecords и createDisplayRecords на общий createRecords:
+ * + Мета-описание станет более универсальным, проще писать код рендеринга.
+ * - Но если IGroupSetDescription нужен в >= 2-х вкладках - для каждой вкладки нужно дублировать IGroupSetDescription.
  */
 interface IGroupSetDescription<Settings extends object, GroupSettings extends object> {
     /** Заголовок */
@@ -10536,22 +10526,31 @@ interface IWidgetPlaceholderValues {
 interface IWidgetPresetSettings extends TSchemaType<typeof WidgetPresetSettingsSchema> {
 }
 
-type TVersion = string;
+type TVersion = `${number}`;
 type TMigrationStruct = Record<string, any>;
+/** Массив версий в строгом порядке, по которому последовательно выполняется миграция */
+declare const apiVersions: readonly ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "10.1", "10.2", "10.3", "11", "12", "13", "13.1", "14", "15", "15.1", "15.2", "16", "16.1", "16.2", "17"];
+type TApiVersion = (typeof apiVersions)[number];
+/**
+ * Актуальная версия settings, с которой работает система.
+ * Используется единая версия для settings виджетов и показателей.
+ */
+declare const apiVersion: "1" | "3" | "2" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "10.1" | "10.2" | "11" | "10.3" | "12" | "13" | "14" | "15" | "13.1" | "16" | "17" | "15.1" | "15.2" | "16.1" | "16.2";
 interface IWidgetStruct<Settings extends IBaseWidgetSettings = IBaseWidgetSettings> {
     key: string;
-    apiVersion: string;
+    apiVersion: TApiVersion;
     type: string;
     settings: Settings;
-    localApiVersion?: string;
+    localApiVersion?: TVersion;
 }
 type TMigrateProcessor<T extends TMigrationStruct> = (struct: T) => void;
-interface ISettingsMigratorParams {
-    versions: ReadonlyArray<TVersion>;
-    defaultVersion?: TVersion;
+interface IMigrateContext {
+    apiVersion: TApiVersion;
+    localApiVersion?: TVersion;
+    type?: string;
 }
 interface IWidgetMigrator<T extends TMigrationStruct = IWidgetStruct> {
-    registerProcessor(version: TVersion, processor: TMigrateProcessor<T>, type?: string, versionPath?: string): void;
+    registerProcessor(context: IMigrateContext, processor: TMigrateProcessor<T>): void;
 }
 
 /** Используется для вывода типа настроек виджета по описанной схеме в методе `createSettingsSchema`
@@ -10564,21 +10563,17 @@ interface IDefinition<WidgetSettings extends IBaseWidgetSettings = IBaseWidgetSe
     /** иконка виджета отображаемая в системе (в base64, svg или png) */
     icon?: string;
     /** возвращает zod-схему настроек виджета */
-    createSettingsSchema?: (z: typeof z, context: ISchemaContext) => ZodType<WidgetSettings>;
-    /** возвращает конфигурацию настроек для отображения */
+    createSettingsSchema: (z: typeof z, context: ISchemaContext) => ZodType<WidgetSettings>;
+    /** возвращает конфигурацию панели настроек */
     createPanelDescription: IPanelDescriptionCreator<WidgetSettings, GroupSettings>;
-    /** заполняет настройки значениями по умолчанию */
-    fillSettings: IFillSettings<WidgetSettings>;
+    /** обеспечивает консистентность настроек */
+    fillSettings?: IFillSettings<WidgetSettings>;
     /** получить начальные настройки виджета, используя заданный пользователем шаблон настроек */
     getInitialSettings?: (settings: Partial<IWidgetPresetSettings>) => Partial<IBaseWidgetSettings>;
     /** возвращает ключи показателей(разрезов или мер), для которых должна работать системная сортировка */
     getSortableIndicatorsKeys?(): Readonly<StringKeyOf<WidgetSettings>[]>;
-    /** Регистрация системных миграторов виджета */
-    registerSystemMigrateProcessors?(migrator: IWidgetMigrator<MigrationStruct>, globalContext: IGlobalContext): void;
-    /** Регистрация собственных миграторов виджета */
-    registerLocalMigrateProcessors?(migrator: IWidgetMigrator<MigrationStruct>, globalContext: IGlobalContext): void;
-    /** Возвращает массив версий локальных миграций виджета */
-    getLocalMigrateVersions(): string[];
+    /** Регистрация миграторов виджета */
+    registerMigrateProcessors?(migrator: IWidgetMigrator<MigrationStruct>, globalContext: IGlobalContext): void;
 }
 
 type TContextMenu = (TContextMenuList | TContextMenuButtonGroup) & {
@@ -10825,6 +10820,14 @@ interface IWidgetEntity<WidgetSettings extends IBaseWidgetSettings, GroupSetting
     definition: IDefinition<WidgetSettings, GroupSettings>;
 }
 
+/** Ключи мета-данных внутри схем настроек */
+declare enum ESettingsSchemaMetaKey {
+    /** Привязка значения из темы к настройке */
+    themeValue = "themeValue",
+    /** Тип сущности */
+    entity = "entity"
+}
+
 interface IDimensionSelection {
     values: Set<string | null>;
     replacedFilter: ICalculatorFilter | null;
@@ -11001,6 +11004,7 @@ interface ITheme {
     backgroundInEdit: boolean;
     spacing: boolean;
     widgets: {
+        /** @remarks Заложено для будущего использования */
         color: string;
         paddings: number | string;
         cornerRadius: number | undefined;
@@ -11047,7 +11051,6 @@ interface ITheme {
     };
     hoverColor: TLimitedColor;
 }
-declare const themeValueMetaKey = "themeValue";
 /**
  * Привязывает мета-информацию о теме к Zod-схеме
  *
@@ -11082,4 +11085,4 @@ declare global {
     }
 }
 
-export { ActionButtonSchema, ActionGoToURLSchema, ActionOnClickParameterSchema, ActionOpenInSchema, ActionOpenViewSchema, ActionRunScriptSchema, ActionSchema, ActionUpdateVariableSchema, ActionsOnClickSchema, AutoIdentifiedArrayItemSchema, BaseWidgetSettingsSchema, ColorAutoSchema, ColorBaseSchema, ColorByDimensionSchema, ColorDisabledSchema, ColorFormulaSchema, ColorGradientSchema, ColorRuleSchema, ColorSchema, ColorValuesSchema, ColoredValueSchema, ColumnIndicatorValueSchema, DimensionProcessFilterSchema, DimensionValueSchema, DisplayConditionSchema, EActionButtonsTypes, EActionTypes, EActivateConditionMode, EAutoUpdateMode, ECalculatorFilterMethods, EClickHouseBaseTypes, EColorMode, EControlType, ECustomSelectTemplates, EDataModelOption, EDimensionAggregationTemplateName, EDimensionProcessFilterTimeUnit, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationTemplateName, EDurationUnit, EEventAppearances, EEventMeasureTemplateNames, EFontWeight, EFormatOrFormattingMode, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EHeightMode, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureAggregationTemplateName, EMeasureInnerTemplateNames, EMeasureTemplateNames, EOuterAggregation, EProcessFilterNames, ESelectOptionTypes, ESimpleDataType, ESimpleInputType, ESortDirection, ESortingValueModes, ESystemRecordKey, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, ExtendedFormulaFilterValueSchema, FormatSchema, FormattingSchema, FormulaFilterValueSchema, FormulaNullableSchema, FormulaSchema, type IActionButton, type IActionGoToUrl, type IActionOnClickControl, 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 ICalculatorOptions, type ICollapseRecord, type IColorPickerControl, type IColoredValue, type ICommonDimensions, type ICommonMeasures, type ICommonState, type IControlRecord, type ICustomAddButtonProps, type ICustomWidgetProps, type IDefinition, type IDimensionProcessFilter, type IDimensionSelection, type IDimensionSelectionByFormula, type IDisplayConditionControl, type IDisplayPredicate, type IDisplayRule, type IDivePanelDescription, type IDividerRecord, type IEdge, type IEventsColorControl, type IEventsPickerControl, type IExportColumnOrder, type IFillSettings, type IFilterControl, type IFormattingControl, type IFormattingTemplateControl, type IFormulaControl, type IFormulaFilterValue, type IGeneralCalculator, type IGeneralCalculatorExportInput, type IGeneralCalculatorInput, type IGeneralCalculatorOutput, type IGlobalContext, type IGradient, type IGraphElement, type IGroupSetDescription, type IGroupSetRecord, type IGroupSettings, type IHistogramBin, type IHistogramCalculator, type IHistogramCalculatorInput, type IHistogramCalculatorOutput, type IIndicatorLink, type IInitialSettings, type IInputControl, type IInputMarkdownControl, type IInputNumberControl, type IInputRangeControl, type IInputTemplatedControl, type ILens, type IMarkdownMeasure, type IMeasureAddButtonProps, type IPanelDescription, type IPanelDescriptionCreator, type IParameterFromAggregation, type IParameterFromColumn, type IParameterFromDynamicList, type IParameterFromEndEvent, type IParameterFromEvent, type IParameterFromFormula, type IParameterFromManualInput, type IParameterFromStartEvent, type IParameterFromStaticList, type IParameterFromVariable, type IPieCalculator, type IPieCalculatorInput, type IPieCalculatorOutput, type IProcessEventFilterValue, type IProcessEventIndicator, type IProcessFilterPreviewParams, type IProcessGraphCalculator, type IProcessGraphCalculatorInput, type IProcessGraphCalculatorOutput, type IProcessIndicator, type IProcessTransitionFilterValue, type IProcessTransitionIndicator, type IRadioIconGroupControl, type IRange, type ISchemaContext, type ISelectBranchOption, type ISelectControl, type ISelectDividerOption, type ISelectGroupOption, type ISelectLeafOption, type ISelectNode, type ISelectOption, type ISelectSystemOption, type ISettingsMigratorParams, type ISizeControl, type ISortOrder, type ISortingAddButtonProps, type IStagesFilterValue, type IStaticListLabeledOption, type ISwitchControl, type ITagSetControl, type ITheme, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type ITypeCalculatorOutputItem, type ITypedFormulaControl, type IVertex, type IViewAction, type IViewContext, type IWidget, type IWidgetAction, type IWidgetColumnIndicator, type IWidgetColumnListVariable, type IWidgetDimension, type IWidgetDimensionHierarchy, type IWidgetDimensionInHierarchy, type IWidgetDynamicListVariable, type IWidgetEntity, type IWidgetFilter, type IWidgetFiltration, type IWidgetFormatting, type IWidgetIndicator, type IWidgetIndicatorAddButtonProps, type IWidgetManifest, type IWidgetMeasure, type IWidgetMigrator, type IWidgetPersistValue, type IWidgetPlaceholderController, type IWidgetPlaceholderValues, type IWidgetPresetSettings, type IWidgetProcess, type IWidgetProps, type IWidgetSortingIndicator, type IWidgetStaticListVariable, type IWidgetStaticVariable, type IWidgetStruct, type IWidgetTable, type IWidgetTableColumn, KeyNullableSchema, MarkdownMeasureSchema, MeasureValueSchema, NameNullableSchema, OuterAggregation, ParameterFromAggregationSchema, ParameterFromColumnSchema, ParameterFromDataModelSchema, ParameterFromDynamicListSchema, ParameterFromEndEventSchema, ParameterFromEventSchema, ParameterFromFormulaSchema, ParameterFromManualInputSchema, ParameterFromStartEventSchema, ParameterFromStaticListSchema, ParameterFromVariableSchema, ProcessIndicatorSchema, ProcessIndicatorValueSchema, RangeSchema, SettingsFilterSchema, SortDirectionSchema, SortOrderSchema, type TAction, type TActionOnClickParameter, type TActionOpenView, type TActionValidator, type TActionsOnClick, type TAddButton, type TBoundedContentWithIndicator, type TColor, type TColorBase, type TColorRule, type TColumnIndicatorValue, type TConditionalDimensionInHierarchy, type TContextMenu, type TContextMenuButton, type TContextMenuButtonActions, type TContextMenuButtonApply, type TContextMenuButtonClose, type TContextMenuButtonCustom, type TContextMenuButtonGroup, type TContextMenuButtonOptions, type TContextMenuList, type TContextMenuPositionUnit, type TContextMenuRow, type TControlUnion, type TCustomAddButtonSelectOption, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TExtendedFormulaFilterValue, type TFiltrationAccessibility, type TGradientsSetValue, type TGroupLevelRecord, type THintPlacement, type TLaunchActionParams, type TLimitedColor, type TMeasureAddButtonSelectOption, type TMigrateProcessor, type TMigrationStruct, type TParameterFromDataModel, type TProcessIndicatorValue, type TRecordAccessor, type TSchemaType, type TSelectChildOptions, type TSelectFetchNodes, type TSelectivePartial, type TSettingsFilter, type TSettingsOf, type TSortDirection, type TTabsHorizontalAlignment, type TUpdateSelection, type TValuePath, type TVersion, type TViewActionParameter, type TWidgetActionParameter, type TWidgetContainer, type TWidgetDimensionData, type TWidgetDimensionUnion, type TWidgetFilterValue, type TWidgetFiltering, type TWidgetIndicatorAggregationValue, type TWidgetIndicatorConversionValue, type TWidgetIndicatorDurationValue, type TWidgetIndicatorTimeValue, type TWidgetLevelRecord, type TWidgetMeasureData, type TWidgetSortingValue, type TWidgetVariable, type TWidgetsPaletteValue, type TZod, ViewActionParameterSchema, ViewActionSchema, WidgetActionParameterSchema, WidgetActionSchema, WidgetColumnIndicatorSchema, WidgetDimensionHierarchySchema, WidgetDimensionInHierarchySchema, WidgetDimensionSchema, WidgetIndicatorAggregationValueSchema, WidgetIndicatorConversionValueSchema, WidgetIndicatorDurationValueSchema, WidgetIndicatorFormulaValueSchema, WidgetIndicatorSchema, WidgetIndicatorTemplateValueSchema, WidgetIndicatorTimeValueSchema, WidgetMeasureAggregationValueSchema, WidgetMeasureSchema, WidgetPresetSettingsSchema, WidgetSortingIndicatorSchema, WidgetSortingValueSchema, applyIndexToArrayFormula, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, clearMultiLineComments, clearSingleLineComments, colors, conversionTemplate, convertFiltersToFormula, convertToFormulasChain, countExecutionsTemplate, createEscaper, createAggregationTemplate as createMeasureAggregationTemplate, curlyBracketsContentPattern, dashboardLinkRegExp, dimensionAggregationTemplates, dimensionTemplateFormulas, displayConditionTemplate, doubleQuoteContentPattern, durationTemplates, escapeCurlyBracketLinkName, escapeDoubleQuoteLinkName, eventMeasureTemplateFormulas, fillTemplateSql, fillTemplateString, formattingConfig, formulaFilterMethods, generateColumnFormula, getColorByIndex, getDefaultSortOrders, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getProcessDimensionValueFormula, getRuleColor, getTransitionMeasureFormula, inheritDisplayConditionFromHierarchy, isDimensionProcessFilter, isDimensionsHierarchy, isFormulaFilterValue, isValidColor, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSettingsFiltersToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureInnerTemplateFormulas, measureTemplateFormulas, parseClickHouseType, parseIndicatorLink, prepareConversionParams, prepareDimensionAggregationParams, prepareDurationParams, prepareFormulaForSql, prepareMeasureAggregationParams, prepareSortOrders, prepareTimeParams, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, themeValueMetaKey, themed, timeTemplates, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateSingleModeSelection, workspaceLinkRegExp };
+export { ActionButtonSchema, ActionGoToURLSchema, ActionOnClickParameterSchema, ActionOpenInSchema, ActionOpenViewSchema, ActionRunScriptSchema, ActionSchema, ActionUpdateVariableSchema, ActionsOnClickSchema, AutoIdentifiedArrayItemSchema, BaseWidgetSettingsSchema, ColorAutoSchema, ColorBaseSchema, ColorByDimensionSchema, ColorDisabledSchema, ColorFormulaSchema, ColorGradientSchema, ColorRuleSchema, ColorSchema, ColorValuesSchema, ColoredValueSchema, ColumnIndicatorValueSchema, DimensionProcessFilterSchema, DimensionValueSchema, DisplayConditionSchema, EActionButtonsTypes, EActionTypes, EActivateConditionMode, EAutoUpdateMode, ECalculatorFilterMethods, EClickHouseBaseTypes, EColorMode, EControlType, ECustomSelectTemplates, EDataModelOption, EDimensionAggregationTemplateName, EDimensionProcessFilterTimeUnit, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationTemplateName, EDurationUnit, EEventAppearances, EEventMeasureTemplateNames, EFontWeight, EFormatOrFormattingMode, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EHeightMode, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureAggregationTemplateName, EMeasureInnerTemplateNames, EMeasureTemplateNames, EOuterAggregation, EProcessFilterNames, ESelectOptionTypes, ESettingsSchemaMetaKey, ESimpleDataType, ESimpleInputType, ESortDirection, ESortingValueModes, ESystemRecordKey, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, ExtendedFormulaFilterValueSchema, FormatSchema, FormattingSchema, FormulaFilterValueSchema, FormulaNullableSchema, FormulaSchema, type IActionButton, type IActionGoToUrl, type IActionOnClickControl, 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 ICalculatorOptions, type ICollapseRecord, type IColorPickerControl, type IColoredValue, type ICommonDimensions, type ICommonMeasures, type ICommonState, type IControlRecord, type ICustomAddButtonProps, type ICustomWidgetProps, type IDefinition, type IDimensionProcessFilter, type IDimensionSelection, type IDimensionSelectionByFormula, type IDisplayConditionControl, type IDisplayPredicate, type IDisplayRule, type IDivePanelDescription, type IDividerRecord, type IEdge, type IEventsColorControl, type IEventsPickerControl, type IExportColumnOrder, type IFillSettings, type IFilterControl, type IFormattingControl, type IFormattingTemplateControl, type IFormulaControl, type IFormulaFilterValue, type IGeneralCalculator, type IGeneralCalculatorExportInput, type IGeneralCalculatorInput, type IGeneralCalculatorOutput, type IGlobalContext, type IGradient, type IGraphElement, type IGroupSetDescription, type IGroupSetRecord, type IGroupSettings, type IHistogramBin, type IHistogramCalculator, type IHistogramCalculatorInput, type IHistogramCalculatorOutput, type IIndicatorLink, type IInitialSettings, type IInputControl, type IInputMarkdownControl, type IInputNumberControl, type IInputRangeControl, type IInputTemplatedControl, type ILens, type IMarkdownMeasure, type IMeasureAddButtonProps, type IMigrateContext, type IPanelDescription, type IPanelDescriptionCreator, type IParameterFromAggregation, type IParameterFromColumn, type IParameterFromDynamicList, type IParameterFromEndEvent, type IParameterFromEvent, type IParameterFromFormula, type IParameterFromManualInput, type IParameterFromStartEvent, type IParameterFromStaticList, type IParameterFromVariable, type IPieCalculator, type IPieCalculatorInput, type IPieCalculatorOutput, type IProcessEventFilterValue, type IProcessEventIndicator, type IProcessFilterPreviewParams, type IProcessGraphCalculator, type IProcessGraphCalculatorInput, type IProcessGraphCalculatorOutput, type IProcessIndicator, type IProcessTransitionFilterValue, type IProcessTransitionIndicator, type IRadioIconGroupControl, type IRange, type ISchemaContext, type ISelectBranchOption, type ISelectControl, type ISelectDividerOption, type ISelectGroupOption, type ISelectLeafOption, type ISelectNode, type ISelectOption, type ISelectSystemOption, type ISizeControl, type ISortOrder, type ISortingAddButtonProps, type IStagesFilterValue, type IStaticListLabeledOption, type ISwitchControl, type ITagSetControl, type ITheme, type ITwoLimitsCalculator, type ITwoLimitsCalculatorExportInput, type ITwoLimitsCalculatorInput, type ITwoLimitsCalculatorOutput, type ITypeCalculator, type ITypeCalculatorInput, type ITypeCalculatorOutput, type ITypeCalculatorOutputItem, type ITypedFormulaControl, type IVertex, type IViewAction, type IViewContext, type IWidget, type IWidgetAction, type IWidgetColumnIndicator, type IWidgetColumnListVariable, type IWidgetDimension, type IWidgetDimensionHierarchy, type IWidgetDimensionInHierarchy, type IWidgetDynamicListVariable, type IWidgetEntity, type IWidgetFilter, type IWidgetFiltration, type IWidgetFormatting, type IWidgetIndicator, type IWidgetIndicatorAddButtonProps, type IWidgetManifest, type IWidgetMeasure, type IWidgetMigrator, type IWidgetPersistValue, type IWidgetPlaceholderController, type IWidgetPlaceholderValues, type IWidgetPresetSettings, type IWidgetProcess, type IWidgetProps, type IWidgetSortingIndicator, type IWidgetStaticListVariable, type IWidgetStaticVariable, type IWidgetStruct, type IWidgetTable, type IWidgetTableColumn, KeyNullableSchema, MarkdownMeasureSchema, MeasureValueSchema, NameNullableSchema, OuterAggregation, ParameterFromAggregationSchema, ParameterFromColumnSchema, ParameterFromDataModelSchema, ParameterFromDynamicListSchema, ParameterFromEndEventSchema, ParameterFromEventSchema, ParameterFromFormulaSchema, ParameterFromManualInputSchema, ParameterFromStartEventSchema, ParameterFromStaticListSchema, ParameterFromVariableSchema, ProcessIndicatorSchema, ProcessIndicatorValueSchema, RangeSchema, SettingsFilterSchema, SortDirectionSchema, SortOrderSchema, type TAction, type TActionOnClickParameter, type TActionOpenView, type TActionValidator, type TActionsOnClick, type TAddButton, type TApiVersion, type TBoundedContentWithIndicator, type TColor, type TColorBase, type TColorRule, type TColumnIndicatorValue, type TConditionalDimensionInHierarchy, type TContextMenu, type TContextMenuButton, type TContextMenuButtonActions, type TContextMenuButtonApply, type TContextMenuButtonClose, type TContextMenuButtonCustom, type TContextMenuButtonGroup, type TContextMenuButtonOptions, type TContextMenuList, type TContextMenuPositionUnit, type TContextMenuRow, type TControlUnion, type TCustomAddButtonSelectOption, type TDefineWidgetOptions, type TDisplayCondition, type TDisplayMode, type TEmptyRecord, type TExtendedFormulaFilterValue, type TFiltrationAccessibility, type TGradientsSetValue, type TGroupLevelRecord, type THintPlacement, type TLaunchActionParams, type TLimitedColor, type TMeasureAddButtonSelectOption, type TMigrateProcessor, type TMigrationStruct, type TParameterFromDataModel, type TProcessIndicatorValue, type TRecordAccessor, type TSchemaType, type TSelectChildOptions, type TSelectFetchNodes, type TSelectivePartial, type TSettingsFilter, type TSettingsOf, type TSortDirection, type TTabsHorizontalAlignment, type TUpdateSelection, type TValuePath, type TVersion, type TViewActionParameter, type TWidgetActionParameter, type TWidgetContainer, type TWidgetDimensionData, type TWidgetDimensionUnion, type TWidgetFilterValue, type TWidgetFiltering, type TWidgetIndicatorAggregationValue, type TWidgetIndicatorConversionValue, type TWidgetIndicatorDurationValue, type TWidgetIndicatorTimeValue, type TWidgetLevelRecord, type TWidgetMeasureData, type TWidgetSortingValue, type TWidgetVariable, type TWidgetsPaletteValue, type TZod, ViewActionParameterSchema, ViewActionSchema, WidgetActionParameterSchema, WidgetActionSchema, WidgetColumnIndicatorSchema, WidgetDimensionHierarchySchema, WidgetDimensionInHierarchySchema, WidgetDimensionSchema, WidgetIndicatorAggregationValueSchema, WidgetIndicatorConversionValueSchema, WidgetIndicatorDurationValueSchema, WidgetIndicatorFormulaValueSchema, WidgetIndicatorSchema, WidgetIndicatorTemplateValueSchema, WidgetIndicatorTimeValueSchema, WidgetMeasureAggregationValueSchema, WidgetMeasureSchema, WidgetPresetSettingsSchema, WidgetSortingIndicatorSchema, WidgetSortingValueSchema, apiVersion, apiVersions, applyIndexToArrayFormula, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, clearMultiLineComments, clearSingleLineComments, colors, conversionTemplate, convertFiltersToFormula, convertToFormulasChain, countExecutionsTemplate, createEscaper, createAggregationTemplate as createMeasureAggregationTemplate, curlyBracketsContentPattern, dashboardLinkRegExp, dimensionAggregationTemplates, dimensionTemplateFormulas, displayConditionTemplate, doubleQuoteContentPattern, durationTemplates, escapeCurlyBracketLinkName, escapeDoubleQuoteLinkName, eventMeasureTemplateFormulas, fillTemplateSql, formattingConfig, formulaFilterMethods, generateColumnFormula, getColorByIndex, getDefaultSortOrders, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getProcessDimensionValueFormula, getRuleColor, getTransitionMeasureFormula, inheritDisplayConditionFromHierarchy, isDimensionProcessFilter, isDimensionsHierarchy, isFormulaFilterValue, isValidColor, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSettingsFiltersToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureInnerTemplateFormulas, measureTemplateFormulas, parseClickHouseType, parseIndicatorLink, prepareConversionParams, prepareDimensionAggregationParams, prepareDurationParams, prepareFormulaForSql, prepareMeasureAggregationParams, prepareSortOrders, prepareTimeParams, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, themed, timeTemplates, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateSingleModeSelection, workspaceLinkRegExp };

package/dist/index.esm.js

@@ -2,6 +2,40 @@ import { Localization } from '@infomaximum/localization';
 export { ELanguages } from '@infomaximum/localization';
 export { EFilteringMethodValues } from '@infomaximum/base-filter';
 
+/** Массив версий в строгом порядке, по которому последовательно выполняется миграция */
+var apiVersions = [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7", // Версии от 7 и старше пока не удаляем [BI-15416]
+    "8",
+    "9",
+    "10",
+    "10.1",
+    "10.2",
+    "10.3", // 241223
+    "11",
+    "12",
+    "13", // 2503
+    "13.1", // 250314
+    "14",
+    "15", // Для версии системы 2505
+    "15.1", // Для версии системы 250609
+    "15.2", // Для версии системы 250614
+    "16", // Для версии системы 2507
+    "16.1", // Для версии системы 250703
+    "16.2", // Для версии системы 250709
+    "17", // 2508
+];
+/**
+ * Актуальная версия settings, с которой работает система.
+ * Используется единая версия для settings виджетов и показателей.
+ */
+var apiVersion = apiVersions.at(-1);
+
 var EWidgetActionInputMethod;
 (function (EWidgetActionInputMethod) {
     EWidgetActionInputMethod["COLUMN"] = "COLUMN";
@@ -656,6 +690,16 @@ var WidgetSortingValueSchema = function (z) {
     ]);
 };
 
+/** Ключи мета-данных внутри схем настроек */
+var ESettingsSchemaMetaKey;
+(function (ESettingsSchemaMetaKey) {
+    /** Привязка значения из темы к настройке */
+    ESettingsSchemaMetaKey["themeValue"] = "themeValue";
+    /** Тип сущности */
+    ESettingsSchemaMetaKey["entity"] = "entity";
+})(ESettingsSchemaMetaKey || (ESettingsSchemaMetaKey = {}));
+
+var _a$6;
 var RangeSchema = function (z) {
     return z.object({
         unit: z.string().optional(),
@@ -686,19 +730,25 @@ var KeyNullableSchema = function (z) { return z.string().nullable().default(null
 /** Схема имени сущности (с возможностью находиться в неинициализированном состоянии) */
 var NameNullableSchema = function (z) { return z.string().nullable().default(null); };
 /**
- * Схема формулы
- *
- * @note в будущем к схеме будет привязана мета-информация для того,
- * чтобы система видела расположение формул в настройках
+ * Перечисление системных типов сущностей в схеме настроек виджетов.
+ * @note при расширении лучше положить на более общий уровень.
  */
-var FormulaSchema = function (z) { return z.string().default(""); };
+var EEntity;
+(function (EEntity) {
+    EEntity["formula"] = "formula";
+})(EEntity || (EEntity = {}));
+var formulaMeta = Object.freeze((_a$6 = {}, _a$6[ESettingsSchemaMetaKey.entity] = EEntity.formula, _a$6));
+/** Схема формулы */
+var FormulaSchema = function (z) { return z.string().default("").meta(formulaMeta); };
 /**
  * Схема формулы, которая не может быть пустой строкой, но может быть в
  * неинициализированном состоянии null (вместо пустой строки)
  *
  * @note для обратной совместимости без необходимости писать миграции
  */
-var FormulaNullableSchema = function (z) { return z.string().nullable().default(null); };
+var FormulaNullableSchema = function (z) {
+    return z.string().nullable().default(null).meta(formulaMeta);
+};
 
 var WidgetIndicatorSchema = function (z) {
     return AutoIdentifiedArrayItemSchema(z).extend({
@@ -706,10 +756,12 @@ var WidgetIndicatorSchema = function (z) {
     });
 };
 var FormatSchema = function (z) {
-    return z.object({
+    return z
+        .object({
+        mode: z.enum(EFormatOrFormattingMode),
         value: z.enum(EFormatTypes).optional(),
-        mode: z.enum(EFormatOrFormattingMode).default(EFormatOrFormattingMode.BASE),
-    });
+    })
+        .default({ mode: EFormatOrFormattingMode.BASE, value: EFormatTypes.STRING });
 };
 var FormattingSchema = function (z) {
     return z
@@ -1496,13 +1548,6 @@ function sanitizeSingleLineComment(formula, wrapInBrackets) {
     return wrapInBrackets ? "(".concat(formula, "\n)") : "".concat(formula, "\n");
 }
 
-/** @deprecated - следует использовать fillTemplateSql */
-function fillTemplateString(templateString, params) {
-    return templateString.replace(/\{(.*?)\}/g, function (_, key) {
-        var _a;
-        return (_a = params[key]) !== null && _a !== void 0 ? _a : "";
-    });
-}
 /** Функция для безопасного заполнения SQL шаблонов с защитой от однострочных SQL комментариев в подставляемых значениях. */
 function fillTemplateSql(templateString, params) {
     var e_1, _a;
@@ -1527,7 +1572,10 @@ function fillTemplateSql(templateString, params) {
         }
         finally { if (e_1) throw e_1.error; }
     }
-    return fillTemplateString(templateString, newParams);
+    return templateString.replace(/\{(.*?)\}/g, function (_, key) {
+        var _a;
+        return (_a = newParams[key]) !== null && _a !== void 0 ? _a : "";
+    });
 }
 
 /** Создать функцию экранирования переданных `specialChars` внутри `str` */
@@ -2899,7 +2947,6 @@ var WidgetPresetSettingsSchema = function (z) {
     });
 };
 
-var themeValueMetaKey = "themeValue";
 /**
  * Привязывает мета-информацию о теме к Zod-схеме
  *
@@ -2920,7 +2967,7 @@ var themeValueMetaKey = "themeValue";
  */
 var themed = function (scheme, selectThemeValue) {
     var _a;
-    return scheme.meta((_a = {}, _a[themeValueMetaKey] = selectThemeValue, _a));
+    return scheme.meta((_a = {}, _a[ESettingsSchemaMetaKey.themeValue] = selectThemeValue, _a));
 };
 
 var ColorBaseSchema = function (z) {
@@ -2998,4 +3045,4 @@ var ColorSchema = function (z) {
         .default({ mode: EColorMode.AUTO });
 };
 
-export { ActionButtonSchema, ActionGoToURLSchema, ActionOnClickParameterSchema, ActionOpenInSchema, ActionOpenViewSchema, ActionRunScriptSchema, ActionSchema, ActionUpdateVariableSchema, ActionsOnClickSchema, AutoIdentifiedArrayItemSchema, BaseWidgetSettingsSchema, ColorAutoSchema, ColorBaseSchema, ColorByDimensionSchema, ColorDisabledSchema, ColorFormulaSchema, ColorGradientSchema, ColorRuleSchema, ColorSchema, ColorValuesSchema, ColoredValueSchema, ColumnIndicatorValueSchema, DimensionProcessFilterSchema, DimensionValueSchema, DisplayConditionSchema, EActionButtonsTypes, EActionTypes, EActivateConditionMode, EAutoUpdateMode, ECalculatorFilterMethods, EClickHouseBaseTypes, EColorMode, EControlType, ECustomSelectTemplates, EDataModelOption, EDimensionAggregationTemplateName, EDimensionProcessFilterTimeUnit, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationTemplateName, EDurationUnit, EEventAppearances, EEventMeasureTemplateNames, EFontWeight, EFormatOrFormattingMode, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EHeightMode, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureAggregationTemplateName, EMeasureInnerTemplateNames, EMeasureTemplateNames, EOuterAggregation, EProcessFilterNames, ESelectOptionTypes, ESimpleDataType, ESimpleInputType, ESortDirection, ESortingValueModes, ESystemRecordKey, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, ExtendedFormulaFilterValueSchema, FormatSchema, FormattingSchema, FormulaFilterValueSchema, FormulaNullableSchema, FormulaSchema, KeyNullableSchema, MarkdownMeasureSchema, MeasureValueSchema, NameNullableSchema, OuterAggregation, ParameterFromAggregationSchema, ParameterFromColumnSchema, ParameterFromDataModelSchema, ParameterFromDynamicListSchema, ParameterFromEndEventSchema, ParameterFromEventSchema, ParameterFromFormulaSchema, ParameterFromManualInputSchema, ParameterFromStartEventSchema, ParameterFromStaticListSchema, ParameterFromVariableSchema, ProcessIndicatorSchema, ProcessIndicatorValueSchema, RangeSchema, SettingsFilterSchema, SortDirectionSchema, SortOrderSchema, ViewActionParameterSchema, ViewActionSchema, WidgetActionParameterSchema, WidgetActionSchema, WidgetColumnIndicatorSchema, WidgetDimensionHierarchySchema, WidgetDimensionInHierarchySchema, WidgetDimensionSchema, WidgetIndicatorAggregationValueSchema, WidgetIndicatorConversionValueSchema, WidgetIndicatorDurationValueSchema, WidgetIndicatorFormulaValueSchema, WidgetIndicatorSchema, WidgetIndicatorTemplateValueSchema, WidgetIndicatorTimeValueSchema, WidgetMeasureAggregationValueSchema, WidgetMeasureSchema, WidgetPresetSettingsSchema, WidgetSortingIndicatorSchema, WidgetSortingValueSchema, applyIndexToArrayFormula, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, clearMultiLineComments, clearSingleLineComments, colors, conversionTemplate, convertFiltersToFormula, convertToFormulasChain, countExecutionsTemplate, createEscaper, createAggregationTemplate as createMeasureAggregationTemplate, curlyBracketsContentPattern, dashboardLinkRegExp, dimensionAggregationTemplates, dimensionTemplateFormulas, displayConditionTemplate, doubleQuoteContentPattern, durationTemplates, escapeCurlyBracketLinkName, escapeDoubleQuoteLinkName, eventMeasureTemplateFormulas, fillTemplateSql, fillTemplateString, formattingConfig, formulaFilterMethods, generateColumnFormula, getColorByIndex, getDefaultSortOrders, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getProcessDimensionValueFormula, getRuleColor, getTransitionMeasureFormula, inheritDisplayConditionFromHierarchy, isDimensionProcessFilter, isDimensionsHierarchy, isFormulaFilterValue, isValidColor, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSettingsFiltersToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureInnerTemplateFormulas, measureTemplateFormulas, parseClickHouseType, parseIndicatorLink, prepareConversionParams, prepareDimensionAggregationParams, prepareDurationParams, prepareFormulaForSql, prepareMeasureAggregationParams, prepareSortOrders, prepareTimeParams, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, themeValueMetaKey, themed, timeTemplates, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateSingleModeSelection, workspaceLinkRegExp };
+export { ActionButtonSchema, ActionGoToURLSchema, ActionOnClickParameterSchema, ActionOpenInSchema, ActionOpenViewSchema, ActionRunScriptSchema, ActionSchema, ActionUpdateVariableSchema, ActionsOnClickSchema, AutoIdentifiedArrayItemSchema, BaseWidgetSettingsSchema, ColorAutoSchema, ColorBaseSchema, ColorByDimensionSchema, ColorDisabledSchema, ColorFormulaSchema, ColorGradientSchema, ColorRuleSchema, ColorSchema, ColorValuesSchema, ColoredValueSchema, ColumnIndicatorValueSchema, DimensionProcessFilterSchema, DimensionValueSchema, DisplayConditionSchema, EActionButtonsTypes, EActionTypes, EActivateConditionMode, EAutoUpdateMode, ECalculatorFilterMethods, EClickHouseBaseTypes, EColorMode, EControlType, ECustomSelectTemplates, EDataModelOption, EDimensionAggregationTemplateName, EDimensionProcessFilterTimeUnit, EDimensionTemplateNames, EDisplayConditionMode, EDrawerPlacement, EDurationTemplateName, EDurationUnit, EEventAppearances, EEventMeasureTemplateNames, EFontWeight, EFormatOrFormattingMode, EFormatTypes, EFormattingPresets, EFormulaFilterFieldKeys, EHeightMode, EIndicatorType, ELastTimeUnit, EMarkdownDisplayMode, EMeasureAggregationTemplateName, EMeasureInnerTemplateNames, EMeasureTemplateNames, EOuterAggregation, EProcessFilterNames, ESelectOptionTypes, ESettingsSchemaMetaKey, ESimpleDataType, ESimpleInputType, ESortDirection, ESortingValueModes, ESystemRecordKey, ETransitionMeasureTemplateNames, EUnitMode, EViewMode, EViewOpenIn, EWidgetActionInputMethod, EWidgetFilterMode, EWidgetIndicatorType, EWidgetIndicatorValueModes, ExtendedFormulaFilterValueSchema, FormatSchema, FormattingSchema, FormulaFilterValueSchema, FormulaNullableSchema, FormulaSchema, KeyNullableSchema, MarkdownMeasureSchema, MeasureValueSchema, NameNullableSchema, OuterAggregation, ParameterFromAggregationSchema, ParameterFromColumnSchema, ParameterFromDataModelSchema, ParameterFromDynamicListSchema, ParameterFromEndEventSchema, ParameterFromEventSchema, ParameterFromFormulaSchema, ParameterFromManualInputSchema, ParameterFromStartEventSchema, ParameterFromStaticListSchema, ParameterFromVariableSchema, ProcessIndicatorSchema, ProcessIndicatorValueSchema, RangeSchema, SettingsFilterSchema, SortDirectionSchema, SortOrderSchema, ViewActionParameterSchema, ViewActionSchema, WidgetActionParameterSchema, WidgetActionSchema, WidgetColumnIndicatorSchema, WidgetDimensionHierarchySchema, WidgetDimensionInHierarchySchema, WidgetDimensionSchema, WidgetIndicatorAggregationValueSchema, WidgetIndicatorConversionValueSchema, WidgetIndicatorDurationValueSchema, WidgetIndicatorFormulaValueSchema, WidgetIndicatorSchema, WidgetIndicatorTemplateValueSchema, WidgetIndicatorTimeValueSchema, WidgetMeasureAggregationValueSchema, WidgetMeasureSchema, WidgetPresetSettingsSchema, WidgetSortingIndicatorSchema, WidgetSortingValueSchema, apiVersion, apiVersions, applyIndexToArrayFormula, bindContentWithIndicator, bindContentsWithIndicators, checkDisplayCondition, clearMultiLineComments, clearSingleLineComments, colors, conversionTemplate, convertFiltersToFormula, convertToFormulasChain, countExecutionsTemplate, createEscaper, createAggregationTemplate as createMeasureAggregationTemplate, curlyBracketsContentPattern, dashboardLinkRegExp, dimensionAggregationTemplates, dimensionTemplateFormulas, displayConditionTemplate, doubleQuoteContentPattern, durationTemplates, escapeCurlyBracketLinkName, escapeDoubleQuoteLinkName, eventMeasureTemplateFormulas, fillTemplateSql, formattingConfig, formulaFilterMethods, generateColumnFormula, getColorByIndex, getDefaultSortOrders, getDimensionFormula, getDisplayConditionFormula, getEventMeasureFormula, getLocalizedText, getMeasureFormula, getProcessDimensionValueFormula, getRuleColor, getTransitionMeasureFormula, inheritDisplayConditionFromHierarchy, isDimensionProcessFilter, isDimensionsHierarchy, isFormulaFilterValue, isValidColor, mapDimensionsToInputs, mapEventMeasuresToInputs, mapFormulaFilterToCalculatorInput, mapFormulaFiltersToInputs, mapMeasuresToInputs, mapSettingsFiltersToInputs, mapSortingToInputs, mapTransitionMeasuresToInputs, measureInnerTemplateFormulas, measureTemplateFormulas, parseClickHouseType, parseIndicatorLink, prepareConversionParams, prepareDimensionAggregationParams, prepareDurationParams, prepareFormulaForSql, prepareMeasureAggregationParams, prepareSortOrders, prepareTimeParams, prepareValuesForSql, replaceDisplayCondition, replaceFiltersBySelection, replaceHierarchiesWithDimensions, selectDimensionFromHierarchy, themed, timeTemplates, transitionMeasureTemplateFormulas, unescapeSpecialCharacters, updateDefaultModeSelection, updateSingleModeSelection, workspaceLinkRegExp };

package/dist/index.js

@@ -3,6 +3,40 @@
 var localization$1 = require('@infomaximum/localization');
 var baseFilter = require('@infomaximum/base-filter');
 
+/** Массив версий в строгом порядке, по которому последовательно выполняется миграция */
+var apiVersions = [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7", // Версии от 7 и старше пока не удаляем [BI-15416]
+    "8",
+    "9",
+    "10",
+    "10.1",
+    "10.2",
+    "10.3", // 241223
+    "11",
+    "12",
+    "13", // 2503
+    "13.1", // 250314
+    "14",
+    "15", // Для версии системы 2505
+    "15.1", // Для версии системы 250609
+    "15.2", // Для версии системы 250614
+    "16", // Для версии системы 2507
+    "16.1", // Для версии системы 250703
+    "16.2", // Для версии системы 250709
+    "17", // 2508
+];
+/**
+ * Актуальная версия settings, с которой работает система.
+ * Используется единая версия для settings виджетов и показателей.
+ */
+var apiVersion = apiVersions.at(-1);
+
 exports.EWidgetActionInputMethod = void 0;
 (function (EWidgetActionInputMethod) {
     EWidgetActionInputMethod["COLUMN"] = "COLUMN";
@@ -657,6 +691,16 @@ var WidgetSortingValueSchema = function (z) {
     ]);
 };
 
+/** Ключи мета-данных внутри схем настроек */
+exports.ESettingsSchemaMetaKey = void 0;
+(function (ESettingsSchemaMetaKey) {
+    /** Привязка значения из темы к настройке */
+    ESettingsSchemaMetaKey["themeValue"] = "themeValue";
+    /** Тип сущности */
+    ESettingsSchemaMetaKey["entity"] = "entity";
+})(exports.ESettingsSchemaMetaKey || (exports.ESettingsSchemaMetaKey = {}));
+
+var _a$6;
 var RangeSchema = function (z) {
     return z.object({
         unit: z.string().optional(),
@@ -687,19 +731,25 @@ var KeyNullableSchema = function (z) { return z.string().nullable().default(null
 /** Схема имени сущности (с возможностью находиться в неинициализированном состоянии) */
 var NameNullableSchema = function (z) { return z.string().nullable().default(null); };
 /**
- * Схема формулы
- *
- * @note в будущем к схеме будет привязана мета-информация для того,
- * чтобы система видела расположение формул в настройках
+ * Перечисление системных типов сущностей в схеме настроек виджетов.
+ * @note при расширении лучше положить на более общий уровень.
  */
-var FormulaSchema = function (z) { return z.string().default(""); };
+var EEntity;
+(function (EEntity) {
+    EEntity["formula"] = "formula";
+})(EEntity || (EEntity = {}));
+var formulaMeta = Object.freeze((_a$6 = {}, _a$6[exports.ESettingsSchemaMetaKey.entity] = EEntity.formula, _a$6));
+/** Схема формулы */
+var FormulaSchema = function (z) { return z.string().default("").meta(formulaMeta); };
 /**
  * Схема формулы, которая не может быть пустой строкой, но может быть в
  * неинициализированном состоянии null (вместо пустой строки)
  *
  * @note для обратной совместимости без необходимости писать миграции
  */
-var FormulaNullableSchema = function (z) { return z.string().nullable().default(null); };
+var FormulaNullableSchema = function (z) {
+    return z.string().nullable().default(null).meta(formulaMeta);
+};
 
 var WidgetIndicatorSchema = function (z) {
     return AutoIdentifiedArrayItemSchema(z).extend({
@@ -707,10 +757,12 @@ var WidgetIndicatorSchema = function (z) {
     });
 };
 var FormatSchema = function (z) {
-    return z.object({
+    return z
+        .object({
+        mode: z.enum(exports.EFormatOrFormattingMode),
         value: z.enum(exports.EFormatTypes).optional(),
-        mode: z.enum(exports.EFormatOrFormattingMode).default(exports.EFormatOrFormattingMode.BASE),
-    });
+    })
+        .default({ mode: exports.EFormatOrFormattingMode.BASE, value: exports.EFormatTypes.STRING });
 };
 var FormattingSchema = function (z) {
     return z
@@ -1497,13 +1549,6 @@ function sanitizeSingleLineComment(formula, wrapInBrackets) {
     return wrapInBrackets ? "(".concat(formula, "\n)") : "".concat(formula, "\n");
 }
 
-/** @deprecated - следует использовать fillTemplateSql */
-function fillTemplateString(templateString, params) {
-    return templateString.replace(/\{(.*?)\}/g, function (_, key) {
-        var _a;
-        return (_a = params[key]) !== null && _a !== void 0 ? _a : "";
-    });
-}
 /** Функция для безопасного заполнения SQL шаблонов с защитой от однострочных SQL комментариев в подставляемых значениях. */
 function fillTemplateSql(templateString, params) {
     var e_1, _a;
@@ -1528,7 +1573,10 @@ function fillTemplateSql(templateString, params) {
         }
         finally { if (e_1) throw e_1.error; }
     }
-    return fillTemplateString(templateString, newParams);
+    return templateString.replace(/\{(.*?)\}/g, function (_, key) {
+        var _a;
+        return (_a = newParams[key]) !== null && _a !== void 0 ? _a : "";
+    });
 }
 
 /** Создать функцию экранирования переданных `specialChars` внутри `str` */
@@ -2900,7 +2948,6 @@ var WidgetPresetSettingsSchema = function (z) {
     });
 };
 
-var themeValueMetaKey = "themeValue";
 /**
  * Привязывает мета-информацию о теме к Zod-схеме
  *
@@ -2921,7 +2968,7 @@ var themeValueMetaKey = "themeValue";
  */
 var themed = function (scheme, selectThemeValue) {
     var _a;
-    return scheme.meta((_a = {}, _a[themeValueMetaKey] = selectThemeValue, _a));
+    return scheme.meta((_a = {}, _a[exports.ESettingsSchemaMetaKey.themeValue] = selectThemeValue, _a));
 };
 
 var ColorBaseSchema = function (z) {
@@ -3079,6 +3126,8 @@ exports.WidgetMeasureSchema = WidgetMeasureSchema;
 exports.WidgetPresetSettingsSchema = WidgetPresetSettingsSchema;
 exports.WidgetSortingIndicatorSchema = WidgetSortingIndicatorSchema;
 exports.WidgetSortingValueSchema = WidgetSortingValueSchema;
+exports.apiVersion = apiVersion;
+exports.apiVersions = apiVersions;
 exports.applyIndexToArrayFormula = applyIndexToArrayFormula;
 exports.bindContentWithIndicator = bindContentWithIndicator;
 exports.bindContentsWithIndicators = bindContentsWithIndicators;
@@ -3103,7 +3152,6 @@ exports.escapeCurlyBracketLinkName = escapeCurlyBracketLinkName;
 exports.escapeDoubleQuoteLinkName = escapeDoubleQuoteLinkName;
 exports.eventMeasureTemplateFormulas = eventMeasureTemplateFormulas;
 exports.fillTemplateSql = fillTemplateSql;
-exports.fillTemplateString = fillTemplateString;
 exports.formattingConfig = formattingConfig;
 exports.formulaFilterMethods = formulaFilterMethods;
 exports.generateColumnFormula = generateColumnFormula;
@@ -3146,7 +3194,6 @@ exports.replaceDisplayCondition = replaceDisplayCondition;
 exports.replaceFiltersBySelection = replaceFiltersBySelection;
 exports.replaceHierarchiesWithDimensions = replaceHierarchiesWithDimensions;
 exports.selectDimensionFromHierarchy = selectDimensionFromHierarchy;
-exports.themeValueMetaKey = themeValueMetaKey;
 exports.themed = themed;
 exports.timeTemplates = timeTemplates;
 exports.transitionMeasureTemplateFormulas = transitionMeasureTemplateFormulas;

package/package.json

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