@ic3/reporting-api 8.0.0-alpha.5 → 8.0.0-rc.2

package/dist/PublicTemplate.d.ts

@@ -1,14 +1,85 @@
 import { ITidyTable } from "./PublicTidyTable";
-import { ChartTemplateDataMapping, TidyColumnsType } from "./PublicTidyTableTypes";
 import { ITidyTableInteraction } from "./PublicTidyTableInteractions";
 import { IWidgetPublicContext } from "./PublicContext";
-import { FormFieldDef, FormFieldObject, FormFields } from "./PublicTemplateForm";
+import { FormFieldDef, FormFieldObject, FormFields, IFormColumnChooserFieldDef } from "./PublicTemplateForm";
 import { IWidgetVariantManager } from "./IWidgetVariantManager";
 import { ITidyColumn } from "./PublicTidyColumn";
 import { ReactElement } from "react";
-import { Theme } from "@material-ui/core/styles";
+import { Theme } from "@mui/material/styles";
 declare type ChartTemplateWidgetProps = any;
 export declare type IPublicWidgetTemplateDefinition<T extends FormFieldObject> = IPublicWidgetReactTemplateDefinition<T> | IPublicWidgetJsTemplateDefinition<T>;
+export declare enum IWidgetTemplateMdxBuilderAxisPropsConstraint {
+    DateType = "DateType",
+    GeoLatLong = "GeoLatLong",
+    GeoIso2Code = "GeoIso2Code"
+}
+export interface IWidgetTemplateMdxBuilderAxisProps {
+    /**
+     * Unique name used in the UI and if mdxAxisName not defined for building the query.
+     * If name is 'rows' for example, then in the query it will use 'ON "rows"'.
+     */
+    name: string;
+    /**
+     * The axis can be empty
+     */
+    isOptional?: true;
+    /**
+     * All axes with the same (not null) value for mdxAxisName are put as a tuple on the same axis. The axis name
+     * of the first one in the set is used.
+     */
+    mdxAxisName?: string;
+    /**
+     * The test used to generated the axis role (see KPI card).
+     */
+    mdxAxisRole?: string;
+    /**
+     * Disable empty
+     */
+    disableNonEmpty?: true;
+    /**
+     * For filters add lazy load feature to the axis
+     */
+    addLazyLoad?: true;
+    /**
+     * Allow only a single member
+     */
+    singleMember?: true;
+    /**
+     * Allow a multiple hierarchies to build a crossjoin
+     */
+    multipleHierarchy?: true;
+    /**
+     * Additional constraints for the set/members
+     */
+    constraint?: IWidgetTemplateMdxBuilderAxisPropsConstraint;
+    decoration?: {
+        with?: string;
+        set: string;
+    };
+    /**
+     * Show the mdxAxis names in this order in the builder
+     */
+    showOrder?: number;
+}
+export interface IWidgetTemplateMdxBuilderMapping {
+    /**
+     * The order determines the order of the statements in the query. E.g., the first position is ON 0, the second ON 1,
+     * etc., where '0' and '1' are replaced by the name.
+     */
+    mdxAxis: Readonly<IWidgetTemplateMdxBuilderAxisProps[]>;
+    /**
+     * The generated Mdx is for a filter (the cell values are not of interest)
+     */
+    mdxIsForFilter?: true;
+    /**
+     * the cell values are not needed
+     */
+    withoutCellValues?: true;
+    /**
+     * an MDX query if the builder is empty
+     */
+    mdxQueryIfEmpty?: boolean;
+}
 /**
  * A widget that renders using React.
  *
@@ -56,6 +127,14 @@ export interface IPublicWidgetJsTemplateDefinition<T extends FormFieldObject> ex
     jsCode: (context: IWidgetPublicContext, container: HTMLDivElement) => IPublicJsChartTemplate<T>;
     reactComponent?: false;
 }
+/**
+ * List of special selection granularities (column selectors)
+ */
+export declare enum SelectionGranularityOptions {
+    PivotTableTopHeader = "ic3pivotTableTopHeader",
+    PivotTableLeftHeader = "ic3pivotTableLeftHeader",
+    PivotTableCell = "ic3pivotTableCell"
+}
 /**
  * Definition - static - of a widget template
  */
@@ -66,7 +145,7 @@ interface IPublicCommonWidgetTemplateDefinition {
      */
     type: WidgetTemplateDefinitionType;
     /**
-     * Unique within the plugin. Must not contain any dot.
+     * Unique within the plugin. Must not contain any dot (this is NOT the templateId)
      *
      * The widget chooser is using that id to localize its name and description.
      *
@@ -76,6 +155,18 @@ interface IPublicCommonWidgetTemplateDefinition {
      * </pre>
      */
     id: string;
+    /**
+     * Internal usage: while investigating lazy registration (setup upon registration).
+     */
+    debug?: string;
+    /**
+     * Internal usage: pluginId.templateId (setup upon registration).
+     */
+    qualifiedId?: string;
+    /**
+     * Internal usage: pluginId (setup upon registration).
+     */
+    pluginId?: string;
     /**
      * Used for localization right now.
      *
@@ -95,15 +186,23 @@ interface IPublicCommonWidgetTemplateDefinition {
      * in the "Maps" group in the widget chooser.
      */
     groupId: string;
-    /**
-     * Internal usage: pluginID.id
-     */
-    qualifiedId?: string;
     /**
      * A way to ensure we do not display in the widget chooser templates that cannot
      * be used because the rendering depends on a given theme.
      */
     dependsOnTheme?: string;
+    /**
+     * A sort of "preview" of the widget in the widget chooser. Providing an empty string will display a default image.
+     *
+     * <pre>
+     *     import donut from "./images/donut.svg";
+     *
+     *     {
+     *          image: "donut",
+     *     }
+     * </pre>
+     */
+    image: string;
     /**
      * No widget box decoration.
      */
@@ -122,7 +221,13 @@ interface IPublicCommonWidgetTemplateDefinition {
     withoutQuery?: boolean;
     withoutSelection?: boolean;
     withoutDrilldown?: boolean;
+    withoutEvents?: boolean;
     withoutUserMenu?: boolean;
+    withoutGlobalFilter?: boolean;
+    /**
+     * Otherwise the widget box is rendering a floating icon to mention some data errors.
+     */
+    handleCellsOnError?: boolean;
     renderIfNotInViewport?: boolean;
     /**
      * This widget needs to render even if its query has not been executed yet. The default is false.
@@ -138,12 +243,30 @@ interface IPublicCommonWidgetTemplateDefinition {
      * header is repeating on each page.
      */
     withOptionAutoExpandKeepTableHeader?: boolean;
+    /**
+     * If and only if not null, hide option 'Interactions' > 'Drilldown' > 'Pivot Table Like' and set it default value to withDrilldownPivotTableLikeAs.
+     */
+    withDrilldownPivotTableLikeAs?: boolean;
     userMenuOptions?: string[];
+    /**
+     * Additional widget user menu options when in editing mode.
+     */
     userMenuOptionsOnEditing?: string[];
+    /**
+     * Disables the user menu option to switch between selection and drilldown
+     *
+     * E.g a Pivot table can manage both modes
+     */
+    userMenuDisableInteractionMode?: boolean;
     /**
      * @deprecated
      */
     withoutTidyTable?: boolean;
+    /**
+     * This widget knows how to render a result without any data.
+     * (e.g., data picker)
+     */
+    handlesNoData?: boolean;
     /**
      * This widget is responsible to notify its rendered status. Required with asynchronous rendering
      * (e.g., Google maps).
@@ -152,27 +275,32 @@ interface IPublicCommonWidgetTemplateDefinition {
      */
     handlesWidgetStatus?: boolean;
     eventRoles?: ITemplateEventActionDef;
-    /**
-     * The meta information that defined which data column to use in the widget.
-     */
-    dataMappingMeta?: IWidgetTemplateDataMappingDef[];
+    selection?: {
+        /**
+         * The list of columns that can be part of the selection. The end-user can then select the actual
+         * columns from the Interaction/Selection configuration (see Selection Granularity).
+         */
+        allowedColumns: (column: ITidyColumn) => boolean;
+        optionValues?: undefined;
+    } | {
+        allowedColumns?: undefined;
+        optionValues?: SelectionGranularityOptions[];
+    };
+    mdxBuilderSettings?: IWidgetTemplateMdxBuilderMapping;
     /**
      * The meta information required for editing the widget options.
      */
     chartOptionsMeta?: FormFieldDef[] | FormFields<FormFieldObject>;
-    registerVariants?: (theme: Theme, manager: IWidgetVariantManager) => void;
     /**
-     * A sort of "preview" of the widget in the widget chooser. Providing an empty string will display a default image.
-     *
+     * When registering a variant add the following field editor meta:
      * <pre>
-     *     import donut from "./images/donut.svg";
-     *
-     *     {
-     *          image: "donut",
-     *     }
+     * widgetVariant: {
+     *    fieldType: "widgetVariant",
+     *    localizationTag: "variant"   // icCube localization,
+     * },
      * </pre>
      */
-    image: string;
+    registerVariants?: (theme: Theme, manager: IWidgetVariantManager) => void;
     /**
      * e.g., amCharts4.
      * */
@@ -181,9 +309,11 @@ interface IPublicCommonWidgetTemplateDefinition {
      * Whether or not that component is using React for rendering.
      */
     reactComponent?: boolean;
-    selection?: {
-        allowedColumns: (column: ITidyColumn) => boolean;
-    };
+    resolveDefinition?: (library: IResolveDefinitionLibrary) => Promise<IPublicWidgetTemplateDefinition<any>>;
+    /**
+     * When defining new widgets using amCharts 4, this method registers the icCube license.
+     */
+    registerAmCharts4?: (callback: (am4core: any) => void) => void;
 }
 /**
  * *********************************************************************************************************************
@@ -197,7 +327,6 @@ export declare enum WidgetTemplateDefinitionType {
     Misc = "misc"
 }
 export interface IChartVisualizationInput {
-    mapping: ChartTemplateDataMapping;
     table: ITidyTable;
     inter: ITidyTableInteraction;
     options: {
@@ -207,47 +336,18 @@ export interface IChartVisualizationInput {
 export interface IWidgetTemplateTidyData {
     table: ITidyTable;
     inter: ITidyTableInteraction;
-    mapping: ChartTemplateDataMapping;
 }
 export interface IChartVisualizationTypedInput<T extends FormFieldObject> {
     table: ITidyTable;
     inter: ITidyTableInteraction;
-    mapping: ChartTemplateDataMapping;
     options: T;
 }
 /**
- * The mapping meta describes the coordinate system of the chart (e.g. axis, groups, values).
- * An error occurs when the columns in the mapping do not uniquely identify each row in the table.
+ * The mapping meta are all the column that the user can select in the chart options. These options are checked for
+ * validity. The widget generates an error if columns are selected that are not in the allowed properties, or if
+ * columns are mandatory but there is no selection or fallback.
  */
-export interface IWidgetTemplateDataMappingDef {
-    /**
-     * The alias for the column.
-     */
-    mappingName: string;
-    /**
-     * When defined, adds the mapping options to a group in the widget editor.
-     */
-    mappingGroup?: string;
-    /**
-     * When defined, the value is added as a prefix to the fieldPath to defined the localization tag.
-     */
-    mappingTag?: string;
-    /**
-     * Only columns of this/these type(s) are allowed.
-     */
-    allowedTypes: TidyColumnsType[] | ((column: ITidyColumn) => boolean);
-    /**
-     * If true, fallback to a column that is both an Mdx axis and has a type that is allowed.
-     * Note, properties of columns are not considered.
-     */
-    fallback?: boolean;
-    /**
-     * A column must be mapped to this alias, either by fallback or by user input.
-     * Throw an error of no column is mapped to this alias.
-     */
-    mandatory?: boolean;
-    isForDrilldown?: boolean;
-}
+export declare type IWidgetTemplateDataMappingDef = IFormColumnChooserFieldDef;
 /**
  * Predefined roles
  */
@@ -285,4 +385,7 @@ export interface ITemplateEventActionDef {
      */
     selectionSubscribe?: string;
 }
+export interface IResolveDefinitionLibrary {
+    wrapTemplateDefinition(id: string): Promise<IPublicWidgetTemplateDefinition<any>>;
+}
 export {};

package/dist/PublicTemplate.js

@@ -1,6 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateEventActionNames = exports.WidgetTemplateDefinitionType = void 0;
+exports.TemplateEventActionNames = exports.WidgetTemplateDefinitionType = exports.SelectionGranularityOptions = exports.IWidgetTemplateMdxBuilderAxisPropsConstraint = void 0;
+var IWidgetTemplateMdxBuilderAxisPropsConstraint;
+(function (IWidgetTemplateMdxBuilderAxisPropsConstraint) {
+    IWidgetTemplateMdxBuilderAxisPropsConstraint["DateType"] = "DateType";
+    IWidgetTemplateMdxBuilderAxisPropsConstraint["GeoLatLong"] = "GeoLatLong";
+    IWidgetTemplateMdxBuilderAxisPropsConstraint["GeoIso2Code"] = "GeoIso2Code";
+})(IWidgetTemplateMdxBuilderAxisPropsConstraint = exports.IWidgetTemplateMdxBuilderAxisPropsConstraint || (exports.IWidgetTemplateMdxBuilderAxisPropsConstraint = {}));
+/**
+ * List of special selection granularities (column selectors)
+ */
+var SelectionGranularityOptions;
+(function (SelectionGranularityOptions) {
+    SelectionGranularityOptions["PivotTableTopHeader"] = "ic3pivotTableTopHeader";
+    SelectionGranularityOptions["PivotTableLeftHeader"] = "ic3pivotTableLeftHeader";
+    SelectionGranularityOptions["PivotTableCell"] = "ic3pivotTableCell";
+})(SelectionGranularityOptions = exports.SelectionGranularityOptions || (exports.SelectionGranularityOptions = {}));
 /**
  * *********************************************************************************************************************
  *                  DO NOT CHANGE THEIR VALUE : USED FOR FINDING THE DOCUMENTATION.

package/dist/PublicTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"PublicTemplate.js","sourceRoot":"","sources":["../src/PublicTemplate.ts"],"names":[],"mappings":";;;AAwOA;;;;GAIG;AACH,IAAY,4BAKX;AALD,WAAY,4BAA4B;IACpC,+CAAe,CAAA;IACf,iDAAiB,CAAA;IACjB,2CAAW,CAAA;IACX,6CAAa,CAAA;AACjB,CAAC,EALW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAKvC;AAuED;;GAEG;AACH,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAChC,mDAAuB,CAAA;IAEvB,gBAAgB;IAChB,0DAA8B,CAAA;IAC9B,iEAAqC,CAAA;AACzC,CAAC,EANW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAMnC"}
+{"version":3,"file":"PublicTemplate.js","sourceRoot":"","sources":["../src/PublicTemplate.ts"],"names":[],"mappings":";;;AAcA,IAAY,4CAIX;AAJD,WAAY,4CAA4C;IACpD,qEAAqB,CAAA;IACrB,yEAAyB,CAAA;IACzB,2EAA2B,CAAA;AAC/B,CAAC,EAJW,4CAA4C,GAA5C,oDAA4C,KAA5C,oDAA4C,QAIvD;AAmJD;;GAEG;AAEH,IAAY,2BAIX;AAJD,WAAY,2BAA2B;IACnC,6EAA8C,CAAA;IAC9C,+EAAgD,CAAA;IAChD,mEAAoC,CAAA;AACxC,CAAC,EAJW,2BAA2B,GAA3B,mCAA2B,KAA3B,mCAA2B,QAItC;AA6ND;;;;GAIG;AACH,IAAY,4BAKX;AALD,WAAY,4BAA4B;IACpC,+CAAe,CAAA;IACf,iDAAiB,CAAA;IACjB,2CAAW,CAAA;IACX,6CAAa,CAAA;AACjB,CAAC,EALW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAKvC;AAkCD;;GAEG;AACH,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAChC,mDAAuB,CAAA;IAEvB,gBAAgB;IAChB,0DAA8B,CAAA;IAC9B,iEAAqC,CAAA;AACzC,CAAC,EANW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAMnC"}

package/dist/PublicTemplateForm.d.ts

@@ -1,8 +1,8 @@
 import { IWidgetEditorPublicContext } from "./PublicContext";
 import { ITidyColumn } from "./PublicTidyColumn";
 import * as React from "react";
-import { AutocompleteRenderInputParams, AutocompleteRenderOptionState } from "@material-ui/core/Autocomplete/Autocomplete";
-import { TidyTableMappingCoordinate } from "./PublicTidyTableTypes";
+import { AutocompleteRenderInputParams, AutocompleteRenderOptionState } from "@mui/material/Autocomplete/Autocomplete";
+import { TidyColumnsType, TidyTableColumnSelector } from "./PublicTidyTableTypes";
 export declare function formFieldIsSelection(field: IFormFieldDef<any>): boolean;
 export interface IFormFieldDef<DEFAULT_VALUE_TYPE> {
     /**
@@ -19,6 +19,9 @@ export interface IFormFieldDef<DEFAULT_VALUE_TYPE> {
     defaultValuePath?: string;
     /**
      * The optional group a field belongs too
+     *
+     * @see IFormGroupsFieldDef
+     * @see IFormBooleanFieldDef
      */
     group?: string;
     /**
@@ -48,7 +51,7 @@ export interface IFormFieldDef<DEFAULT_VALUE_TYPE> {
     /**
      * An optional field path value. The value of this field depends on the value of the dependsOn field.
      */
-    dependsOn?: string;
+    dependsOn?: string | string[];
     /**
      * When defined a function that returns the visibility of the field according to the dependsOn value.
      */
@@ -64,6 +67,8 @@ export interface IFormFieldDef<DEFAULT_VALUE_TYPE> {
 }
 /**
  * The options (possibly edited and/or from the theme) of a widget.
+ *
+ * Aka Props
  */
 export interface FormFieldObject {
     readonly '0242ac130003': '0242ac130003';
@@ -78,7 +83,13 @@ export declare type FormFields<T extends FormFieldObject> = {
         defaultValue: unknown;
     } | {
         mandatory: true;
-    }) & (Required<T>[key] extends FormFieldObject ? Omit<IFormEmbeddedFieldDef<Required<T>[key]>, 'fieldPath'> : Required<T>[key] extends TidyTableMappingCoordinate ? Omit<IFormColumnCoordinateFieldDef, 'fieldPath'> : Required<T>[key] extends boolean ? Omit<IFormBooleanFieldDef, 'fieldPath'> : Required<T>[key] extends number ? Omit<IFormNumberFieldDef, 'fieldPath'> : Required<T>[key] extends string ? Omit<IFormOptionFieldSingleDef, 'fieldPath'> | Omit<IFormStringFieldDef, 'fieldPath'> | Omit<IFormTidyTableTextRowExprFieldDef, 'fieldPath'> | Omit<IFormColorEditorFieldDef, 'fieldPath'> | Omit<IFormMuiVariantFieldDef, 'fieldPath'> | Omit<IFormMarkdownFieldDef, 'fieldPath'> : Required<T>[key] extends string[] ? Omit<IFormOptionFieldMultipleDef, 'fieldPath'> | Omit<IFormPaletteEditorFieldDef, 'fieldPath'> : never);
+    }) & (Required<T>[key] extends FormFieldObject ? unknown : {
+        defaultValue?: undefined;
+        mandatory: true;
+    } | {
+        defaultValue?: any;
+        mandatory?: false;
+    }) & (Required<T>[key] extends FormFieldObject ? Omit<IFormEmbeddedFieldDef<Required<T>[key]>, 'fieldPath'> : Required<T>[key] extends IPaletteDef ? Omit<IFormPaletteEditorFieldDef, 'fieldPath'> : Required<T>[key] extends IColorDef ? Omit<IFormColorEditorFieldDef, 'fieldPath'> : Required<T>[key] extends TidyTableColumnSelector[] ? Omit<IFormColumnChooserFieldDef, 'fieldPath'> : Required<T>[key] extends TidyTableColumnSelector ? Omit<IFormColumnChooserFieldDef, 'fieldPath'> : Required<T>[key] extends boolean ? Omit<IFormBooleanFieldDef, 'fieldPath'> : Required<T>[key] extends number ? Omit<IFormNumberFieldDef, 'fieldPath'> : Required<T>[key] extends string ? Omit<IFormOptionFieldSingleDef, 'fieldPath'> | Omit<IFormStringFieldDef, 'fieldPath'> | Omit<IFormWidgetVariantFieldDef, 'fieldPath'> | Omit<IFormTidyTableTextExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableTextRowExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableHtmlRowExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableHtmlExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableNumericExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableNumericRowExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableColorRowExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableStringRowExprFieldDef, 'fieldPath'> | Omit<IFormTidyTableScaleRowExprFieldDef, 'fieldPath'> | Omit<IFormJsFieldDef, 'fieldPath'> | Omit<IFormJsonFieldDef, 'fieldPath'> | Omit<IFormMarkdownFieldDef, 'fieldPath'> : Required<T>[key] extends string[] ? Omit<IFormOptionFieldMultipleDef, 'fieldPath'> | Omit<IFormGroupsFieldDef, 'fieldPath'> : never);
 };
 export declare enum IFormFieldGroupTypes {
     Selection = "selection",
@@ -103,9 +114,9 @@ export declare type FormFieldType =
  */
 "color" | 
 /**
- * @see IFormColumnCoordinateFieldDef
+ * @see IFormColumnChooserFieldDef
  */
-"columnCoordinate" | 
+"columnsChooser" | 
 /**
  * @see IFormColumnSelectionFieldDef
  */
@@ -134,6 +145,10 @@ export declare type FormFieldType =
  * @see IFormJsFieldDef
  */
 "js" | 
+/**
+ * @see IFormJsonFieldDef
+ */
+"json" | 
 /**
  * @see IFormMarkdownFieldDef
  */
@@ -145,10 +160,6 @@ export declare type FormFieldType =
 /**
  * @see IFormMuiVariantFieldDef
  */
-"muiVariant" | 
-/**
- * @see IFormNumberFieldDef
- */
 "number" | 
 /**
  * @see IFormOptionFieldDef
@@ -190,6 +201,14 @@ export declare type FormFieldType =
  * @see IFormTidyTableNumericRowExprFieldDef
  */
 "tidyTableNumericRowExpr" | 
+/**
+ * @see IFormTidyTableStringRowExprFieldDef
+ */
+"tidyTableStringRowExpr" | 
+/**
+ * @see IFormTidyTableColorRowExprFieldDef
+ */
+"tidyTableColorRowExpr" | 
 /**
  * @see IFormTidyTableScaleRowExprFieldDef
  */
@@ -206,7 +225,7 @@ export declare type FormFieldType =
  * @see IFormWidgetVariantFieldDef
  */
 "widgetVariant";
-export declare type FormFieldTidyTableExprType = "tidyTableHtmlExpr" | "tidyTableHtmlRowExpr" | "tidyTableNumericExpr" | "tidyTableNumericRowExpr" | "tidyTableScaleRowExpr" | "tidyTableTextExpr" | "tidyTableTextRowExpr";
+export declare type FormFieldTidyTableExprType = "tidyTableHtmlExpr" | "tidyTableHtmlRowExpr" | "tidyTableNumericExpr" | "tidyTableNumericRowExpr" | "tidyTableScaleRowExpr" | "tidyTableTextExpr" | "tidyTableTextRowExpr" | "tidyTableStringRowExpr" | "tidyTableColorRowExpr";
 export declare function isTidyTableExpr(type: FormFieldType): type is FormFieldTidyTableExprType;
 export declare function isTidyTableExprTable(type: FormFieldType): boolean;
 export declare function isTidyTableExprRow(type: FormFieldType): boolean;
@@ -222,9 +241,9 @@ export declare enum AutocompleteNoOptionsText {
     NO_OPTIONS = "NO_OPTIONS",
     NO_QUERY_RESULT = "NO_QUERY_RESULT"
 }
-export declare type CodeMirrorMode = "plain" | "mdx" | "sql" | "js" | "csv" | "md" | FormFieldTidyTableExprType;
+export declare type CodeMirrorMode = "plain" | "mdx" | "sql" | "js" | "json" | "csv" | "md" | FormFieldTidyTableExprType;
 export declare function isCodeMirrorModeExpr(mode: CodeMirrorMode): boolean;
-export declare type FormFieldDialogEditorModelType = "unknown" | "markdown" | FormFieldTidyTableExprType;
+export declare type FormFieldDialogEditorModelType = "unknown" | "markdown" | "mdxExpression" | FormFieldTidyTableExprType;
 export interface IColorDef {
     /**
      * aka. name
@@ -266,10 +285,15 @@ export interface IFormAutocompleteFieldDef<OPTION> extends IFormFieldDef<OPTION>
         noOptionsText?: AutocompleteNoOptionsText;
         renderInput?: (params: AutocompleteRenderInputParams) => React.ReactNode;
         renderOption?: (props: React.HTMLAttributes<HTMLLIElement>, option: OPTION, state: AutocompleteRenderOptionState, onClose: () => void) => React.ReactNode;
+        disableClearable?: boolean;
     };
 }
 /**
+ * The "groupBoolean" allows for using that field as a group header and as a way
+ * to enable/disable the options in the group.
+ *
  * @see FormFieldDef
+ * @see IFormGroupsFieldDef
  */
 export interface IFormBooleanFieldDef extends IFormFieldDef<boolean> {
     fieldType: "boolean" | "groupBoolean";
@@ -282,14 +306,52 @@ export interface IFormColorEditorFieldDef extends IFormFieldDef<IColorDef> {
 }
 /**
  * @see FormFieldDef
+ *
+ * Use the fieldPath to access the column directly in the tidy table with table.getColumnByAlias(...).
+ * If multiple columns are in this field, it returns the first column.
+ *
+ * If the columns chooser is mandatory, the widget or transformation returns an error if there is no column either
+ * selected by the user or in the fallback.
+ *
  */
-export interface IFormColumnCoordinateFieldDef extends IFormFieldDef<never> {
-    fieldType: "columnCoordinate";
+export interface IFormColumnChooserFieldDef extends IFormFieldDef<TidyTableColumnSelector> {
+    fieldType: "columnsChooser";
     editorConf?: {
+        /**
+         * The user can select multiple columns / selectors
+         */
         multiple?: boolean;
+        /**
+         * The user can select the same column more than once
+         */
         allowDuplicate?: boolean;
-        allowedTypes?: (column: ITidyColumn) => boolean;
+        /**
+         * Only columns of this/these type(s) are allowed.
+         */
+        allowedTypes?: TidyColumnsType[] | ((column: ITidyColumn) => boolean);
+        /**
+         * The user can select properties of columns
+         */
         includeProperties?: boolean;
+        /**
+         * The user can choose a selector, see TidyTableMappingColumnSelectorOptions
+         */
+        includeSelectors?: boolean;
+        /**
+         * Fallback to a column that has a type that is allowed. Note, properties of columns are not considered.
+         *
+         * It finds the column to fallback on by
+         * 1. role equal to fieldPath and type is allowed,
+         * 2. role equal to editorConfig.alias and type is allowed,
+         * 3. type is allowed.
+         *
+         * Already mapped columns are skipped.
+         */
+        fallback?: boolean;
+        /**
+         * In the expression editor, use the alias to reference the column. Use the alias in table.getColumnByAlias(...).
+         */
+        alias?: string;
     };
 }
 /**
@@ -311,7 +373,11 @@ export interface IFormEventMappingArrayFieldDef extends IFormFieldDef<any> {
 /**
  * Contains the ordering of the groups.
  *
+ * An optional (and invisible) field that is defining how the groups are ordered (does not need to contain all
+ * the groups). When none defined, the groups order depends on the field order themselves.
+ *
  * @see FormFieldDef
+ * @see IFormBooleanFieldDef
  */
 export interface IFormGroupsFieldDef extends IFormFieldDef<string[]> {
     fieldType: "groups";
@@ -323,6 +389,12 @@ export interface IFormGroupsFieldDef extends IFormFieldDef<string[]> {
 export interface IFormJsFieldDef extends IFormFieldDef<string> {
     fieldType: "js";
 }
+/**
+ * @see FormFieldDef
+ */
+export interface IFormJsonFieldDef extends IFormFieldDef<string> {
+    fieldType: "json";
+}
 /**
  * @see FormFieldDef
  */
@@ -339,22 +411,17 @@ export interface IFormFileUploaderFieldDef extends IFormFieldDef<any> {
 export interface IFormMarkdownFieldDef extends IFormFieldDef<string> {
     fieldType: "markdown";
 }
+export declare type MdxExpressionType = "calcMeasure" | "drilldown";
 /**
  * @see FormFieldDef
  */
 export interface IFormMdxFieldDef extends IFormFieldDef<string> {
     fieldType: "mdxExpression";
-}
-/**
- * Material-UI variants (defined in the theme's components).
- *
- * @see FormFieldDef
- */
-export interface IFormMuiVariantFieldDef extends IFormFieldDef<string> {
-    fieldType: "muiVariant";
     editorConf: {
-        componentName: string;
-        predefinedVariants?: string[];
+        mdxExpressionType: MdxExpressionType;
+        metaReadOnly?: boolean;
+        schemaName?: string;
+        cubeName?: string;
     };
 }
 /**
@@ -417,6 +484,10 @@ export interface IFormEmbeddedFieldDef<T extends FormFieldObject> extends IFormF
  */
 export interface IFormPaletteEditorFieldDef extends IFormFieldDef<IPaletteDef> {
     fieldType: "palette";
+    editorConfig?: {
+        path: string;
+        reversed: boolean;
+    };
 }
 /**
  * @see FormFieldDef
@@ -443,6 +514,7 @@ export interface IFormStringFieldDef extends IFormFieldDef<string> {
          * A list of possible strings...
          */
         suggestions?: string[] | ((callback: ((candidates: string[]) => void), dependsOnValue?: any) => void);
+        copyToClipboard?: boolean;
     };
 }
 /**
@@ -481,6 +553,30 @@ export interface IFormTidyTableNumericExprFieldDef extends IFormFieldDef<string>
         defaultColumn?: boolean;
     };
 }
+/**
+ * A string expression containing tidy table value accessor (e.g., chart's value axis minimum).
+ * The evaluation context is the table.
+ *
+ * @see FormFieldDef
+ */
+export interface IFormTidyTableStringRowExprFieldDef extends IFormFieldDef<string> {
+    fieldType: "tidyTableStringRowExpr";
+    editorConf?: {
+        defaultColumn?: boolean;
+    };
+}
+/**
+ * A color (i.e., string) expression containing tidy table value accessor (e.g., chart's value axis minimum).
+ * The evaluation context is the table.
+ *
+ * @see FormFieldDef
+ */
+export interface IFormTidyTableColorRowExprFieldDef extends IFormFieldDef<string> {
+    fieldType: "tidyTableColorRowExpr";
+    editorConf?: {
+        defaultColumn?: boolean;
+    };
+}
 /**
  * A numeric expression containing tidy table value accessor (e.g., chart's value axis minimum).
  * The evaluation context is a row.
@@ -501,8 +597,8 @@ export interface IFormTidyTableNumericRowExprFieldDef extends IFormFieldDef<stri
  */
 export interface IFormTidyTableScaleRowExprFieldDef extends IFormFieldDef<string> {
     fieldType: "tidyTableScaleRowExpr";
-    editorConf?: {
-        defaultColumn?: boolean;
+    editorConf: {
+        defaultColumn: true;
     };
 }
 /**
@@ -536,6 +632,10 @@ export interface IFormTidyTableTextRowExprFieldDef extends IFormFieldDef<string>
  */
 export interface IFormWidgetVariantFieldDef extends IFormFieldDef<string> {
     fieldType: "widgetVariant";
+    editorConf?: {
+        componentName: string;
+        predefinedVariants?: string[];
+    };
 }
-export declare type FormFieldDef = IFormAutocompleteFieldDef<any> | IFormBooleanFieldDef | IFormColorEditorFieldDef | IFormColumnCoordinateFieldDef | IFormColumnSelectionFieldDef | IFormEventMappingArrayFieldDef | IFormFileUploaderFieldDef | IFormGroupsFieldDef | IFormJsFieldDef | IFormMarkdownFieldDef | IFormMdxFieldDef | IFormMuiVariantFieldDef | IFormNumberFieldDef | IFormOptionFieldDef | IFormOptionFieldSingleDef | IFormOptionFieldMultipleDef | IFormPaletteEditorFieldDef | IFormReportPathFieldDef | IFormReportPermaLinkFieldDef | IFormStringFieldDef | IFormTidyTableHtmlExprFieldDef | IFormTidyTableHtmlRowExprFieldDef | IFormTidyTableNumericExprFieldDef | IFormTidyTableNumericRowExprFieldDef | IFormTidyTableScaleRowExprFieldDef | IFormTidyTableTextExprFieldDef | IFormTidyTableTextRowExprFieldDef | IFormWidgetVariantFieldDef;
+export declare type FormFieldDef = IFormAutocompleteFieldDef<any> | IFormBooleanFieldDef | IFormColorEditorFieldDef | IFormColumnChooserFieldDef | IFormColumnSelectionFieldDef | IFormEventMappingArrayFieldDef | IFormFileUploaderFieldDef | IFormGroupsFieldDef | IFormJsFieldDef | IFormMarkdownFieldDef | IFormMdxFieldDef | IFormNumberFieldDef | IFormOptionFieldDef | IFormOptionFieldSingleDef | IFormOptionFieldMultipleDef | IFormPaletteEditorFieldDef | IFormReportPathFieldDef | IFormReportPermaLinkFieldDef | IFormStringFieldDef | IFormTidyTableHtmlExprFieldDef | IFormTidyTableHtmlRowExprFieldDef | IFormTidyTableNumericExprFieldDef | IFormTidyTableNumericRowExprFieldDef | IFormTidyTableStringRowExprFieldDef | IFormTidyTableColorRowExprFieldDef | IFormTidyTableScaleRowExprFieldDef | IFormTidyTableTextExprFieldDef | IFormTidyTableTextRowExprFieldDef | IFormWidgetVariantFieldDef;
 export declare function createGroupsMeta(groups: string[]): IFormGroupsFieldDef;