@ic3/reporting-api 8.3.0-alpha.1 → 8.4.0-alpha.1

package/README.md

@@ -1,9 +1,6 @@
 ## icCube Dashboards API
 
-The icCube Dashboards API allows for:
-
-- developing new themes, widgets (charts, maps, etc...), data transformations, etc...
-- embedding icCube Dashboards into a Web application.
+The icCube Dashboards API allows for developing new themes, widgets (charts, maps, etc...), data transformations, etc...
 
 ### Getting Started
 
@@ -13,4 +10,9 @@ The API is written in Javascript/Typescript and is available as an `npm` package
 
 See this [page](./doc/Overview.md) for a detailed documentation of the API.
 
+### Embedding icCube Dashboards
+
+Since `8.4.0`, this API does not contain anymore the code for embedding icCube into an existing Web application.
+Instead, please refer to the following GitHub [project](https://github.com/ic3-software/ic3-reporting-api-embedded).
+
 _

package/dist/ApiUtils.js

@@ -8,7 +8,7 @@ const ReportingVersion_1 = __importDefault(require("./ReportingVersion"));
 class ApiUtils {
     static makePlugin(definition) {
         return () => {
-            return Object.assign({ apiVersion: new ReportingVersion_1.default("8.2.3-ct.3" || "-", "Wed, 19 Oct 2022 04:19:01 GMT" || "-") }, definition);
+            return Object.assign({ apiVersion: new ReportingVersion_1.default("8.4.0-alpha.1" || "-", "Mon, 13 Mar 2023 10:03:34 GMT" || "-") }, definition);
         };
     }
     /**

package/dist/ApiUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiUtils.js","sourceRoot":"","sources":["../src/ApiUtils.ts"],"names":[],"mappings":";;;;;;AAEA,0EAAkD;AAiDlD,MAAa,QAAQ;IAOV,MAAM,CAAC,UAAU,CAAC,UAA6B;QAElD,OAAO,GAA+B,EAAE;YAEpC,uBAEI,UAAU,EAAE,IAAI,0BAAgB,CAC5B,YAAY,IAAI,GAAG,EACnB,+BAA+B,IAAI,GAAG,CACzC,IAEE,UAAU,EAEhB;QAEL,CAAC,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,oCAAoC,CAAkC,UAAsE;QAEtJ,uCAEO,UAAU,KAEb,MAAM,EAAE,CAAC,OAA6B,EAAE,SAAyB,EAAE,EAAE;gBACjE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC1D,CAAC,EAED,cAAc,EAAE,KAAK,EAErB,6BAA6B,EAAE,KAAK,IAEvC;IAEL,CAAC;IAEM,MAAM,CAAC,wCAAwC,CAAkC,UAAoD,EAAE,OAA6C;QAEvL,OAAO,8CAEA,OAAO,GACP,UAAU,KAEb,iBAAiB,EAAE,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,GAEmB,CAAA;IAEjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,4CAA4C,CAAmC,KAAyC;QAElI,OAAO;YAEH,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;YAEtD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;gBAEjB,qDAEO,OAAO,CAAC,gBAAgB,GAExB,KAAK,CAAC,KAAK,CAAC,+BAA+B;oBAE9C;;;;;uBAKG;oBACH,iBAAiB,EAAE,UAAU,QAAQ;wBAEjC,MAAM,eAAe,GAAG,QAAQ,CAAC,wCAAwC,CAAC,IAAI,EAAE,QAAS,CAAC,CAAC;wBAE3F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;4BAEnC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,iCAE/B,eAAe;gCAElB,8DAA8D;gCAE9D,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAC3F,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,gBAAgB,IAEvD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;wBACjC,CAAC,CAAC,CAAC;oBAEP,CAAC,IACJ;YACL,CAAC;SAEwC,CAAC;IAElD,CAAC;;AA/GL,4BAiHC;AA/GG;;GAEG;AACoB,uBAAc,GAAG,OAAO,CAAC"}
+{"version":3,"file":"ApiUtils.js","sourceRoot":"","sources":["../src/ApiUtils.ts"],"names":[],"mappings":";;;;;;AAEA,0EAAkD;AAiDlD,MAAa,QAAQ;IAOV,MAAM,CAAC,UAAU,CAAC,UAA6B;QAElD,OAAO,GAA+B,EAAE;YAEpC,uBAEI,UAAU,EAAE,IAAI,0BAAgB,CAC5B,eAAe,IAAI,GAAG,EACtB,+BAA+B,IAAI,GAAG,CACzC,IAEE,UAAU,EAEhB;QAEL,CAAC,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,oCAAoC,CAAkC,UAAsE;QAEtJ,uCAEO,UAAU,KAEb,MAAM,EAAE,CAAC,OAA6B,EAAE,SAAyB,EAAE,EAAE;gBACjE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC1D,CAAC,EAED,cAAc,EAAE,KAAK,EAErB,6BAA6B,EAAE,KAAK,IAEvC;IAEL,CAAC;IAEM,MAAM,CAAC,wCAAwC,CAAkC,UAAoD,EAAE,OAA6C;QAEvL,OAAO,8CAEA,OAAO,GACP,UAAU,KAEb,iBAAiB,EAAE,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,GAEmB,CAAA;IAEjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,4CAA4C,CAAmC,KAAyC;QAElI,OAAO;YAEH,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;YAEtD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;gBAEjB,qDAEO,OAAO,CAAC,gBAAgB,GAExB,KAAK,CAAC,KAAK,CAAC,+BAA+B;oBAE9C;;;;;uBAKG;oBACH,iBAAiB,EAAE,UAAU,QAAQ;wBAEjC,MAAM,eAAe,GAAG,QAAQ,CAAC,wCAAwC,CAAC,IAAI,EAAE,QAAS,CAAC,CAAC;wBAE3F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;4BAEnC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,iCAE/B,eAAe;gCAElB,8DAA8D;gCAE9D,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAC3F,gBAAgB,EAAE,UAAU,CAAC,OAAO,CAAC,gBAAgB,IAEvD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;wBACjC,CAAC,CAAC,CAAC;oBAEP,CAAC,IACJ;YACL,CAAC;SAEwC,CAAC;IAElD,CAAC;;AA/GL,4BAiHC;AA/GG;;GAEG;AACoB,uBAAc,GAAG,OAAO,CAAC"}

package/dist/INotification.d.ts

@@ -1,5 +1,5 @@
 import { PaperOrientation, PaperSizeName } from "./ITypes";
-export declare type AppNotificationType = "edit-report" | "print-report-dialog" | "print-report" | "print-report-without-state" | "print-report-in-browser" | "save-state-to-localstorage" | "restore-state-from-localstorage" | "save-ownprops-to-localstorage" | "restore-ownprops-from-localstorage" | "save-reportwidgets-ownprops-to-localstorage" | "restore-reportwidgets-ownprops-from-localstorage";
+export type AppNotificationType = "edit-report" | "print-report-dialog" | "print-report" | "print-report-without-state" | "print-report-in-browser" | "clear-selection-all-widgets" | "initialize-selection-all-widgets" | "save-state-to-localstorage" | "restore-state-from-localstorage" | "save-ownprops-to-localstorage" | "restore-ownprops-from-localstorage" | "save-reportwidgets-ownprops-to-localstorage" | "restore-reportwidgets-ownprops-from-localstorage";
 export interface IAppNotification {
     /**
      * E.g., print-report.
@@ -56,4 +56,19 @@ export interface SaveWidgetOwnPropsToLocalStorageNotification extends IAppNotifi
 export interface RestoreWidgetOwnPropsFromLocalStorageNotification extends IAppNotification {
     readonly type: "restore-reportwidgets-ownprops-from-localstorage";
 }
-export declare type AppNotification = AppEditReportNotification | AppPrintReportDialogNotification | AppPrintReportNotification | AppPrintReportWithoutStateNotification | AppPrintReportInBrowserNotification | SaveStateToLocalStorageNotification | RestoreStateFromLocalStorageNotification | SaveOwnPropsToLocalStorageNotification | RestoreWidgetOwnPropsFromLocalStorageNotification | SaveWidgetOwnPropsToLocalStorageNotification | RestoreOwnPropsFromLocalStorageNotification;
+export interface ClearSelectionAllWidgetsNotification extends IAppNotification {
+    readonly type: "clear-selection-all-widgets";
+}
+export interface InitializeSelectionAllWidgetsNotification extends IAppNotification {
+    readonly type: "initialize-selection-all-widgets";
+}
+export type AppNotification = AppEditReportNotification | AppPrintReportDialogNotification | AppPrintReportNotification | AppPrintReportWithoutStateNotification | AppPrintReportInBrowserNotification | SaveStateToLocalStorageNotification | RestoreStateFromLocalStorageNotification | SaveOwnPropsToLocalStorageNotification | RestoreWidgetOwnPropsFromLocalStorageNotification | SaveWidgetOwnPropsToLocalStorageNotification | RestoreOwnPropsFromLocalStorageNotification | InitializeSelectionAllWidgetsNotification | ClearSelectionAllWidgetsNotification;
+export interface IAppNotificationToken {
+    type: AppNotificationType;
+    uid: number;
+}
+export interface IAppNotificationCallback {
+    onStarted: (token: IAppNotificationToken) => void;
+    onSuccess: (token: IAppNotificationToken) => void;
+    onError: (token: IAppNotificationToken, error: any) => void;
+}

package/dist/IOnNewEventJsContext.d.ts

@@ -45,7 +45,7 @@ export interface IOnNewEventJsContext {
     /**
      * Returns the widget jQuery object
      *
-     * Using JQuery might conflit with React's state.
+     * Using JQuery might conflict with React's state.
      * Use with care as you will modify the DOM directly.
      */
     getWidget$(widgetId: string): any;

package/dist/IPluginDefinition.d.ts

@@ -24,6 +24,9 @@ export interface IPluginDefinition {
     registerThemes?: (logger: ILogger, manager: IThemeManager) => void;
     registerWidgets?: (logger: ILogger, manager: IWidgetManager) => void;
     registerTidyTableTransformations?: (logger: ILogger, manager: ITidyTableTransformationManager) => void;
+    /**
+     * Register widget defaults for all themes.
+     */
     registerWidgetDefaults?: (logger: ILogger, theme: Theme, manager: IWidgetDefaultsManager) => void;
     /**
      * Allows for selecting the available widgets.

package/dist/IThemeManager.d.ts

@@ -35,7 +35,7 @@ export interface IThemeWidgetDefaults {
 /**
  * Sort of named set of predefined options.
  */
-export declare type IThemeWidgetVariant = {
+export type IThemeWidgetVariant = {
     props: {
         variant: string;
     } & Record<string, string>;

package/dist/ITypes.d.ts

@@ -1,6 +1,6 @@
-export declare type PaperSizeName = "A5" | "A4" | "A3" | "B5" | "B4" | "Letter" | "Legal" | "Ledger" | "JIS-B5" | "JIS-B4";
-export declare type PaperOrientation = "portrait" | "landscape";
-export declare type PaperSizeUnits = "px" | "mm" | "cm" | "in";
+export type PaperSizeName = "A5" | "A4" | "A3" | "B5" | "B4" | "Letter" | "Legal" | "Ledger" | "JIS-B5" | "JIS-B4";
+export type PaperOrientation = "portrait" | "landscape";
+export type PaperSizeUnits = "px" | "mm" | "cm" | "in";
 export declare enum CompareTextInterpretationType {
     MORE = "more=better",
     LESS = "less=better",

package/dist/IWidgetVariantManager.d.ts

@@ -1,6 +1,6 @@
 import { CSSInterpolation } from "@mui/system";
-declare type variantName = string;
-export declare type IThemeRegisterVariant = Record<variantName, {
+type variantName = string;
+export type IThemeRegisterVariant = Record<variantName, {
     /**
      * for styled MUI like components additional properties defining when the variant applies
      */

package/dist/LazyTreeView.d.ts

@@ -1,6 +1,6 @@
 import { EntityItem, MdxInfo, TreeRowPropsTreeData } from "./PublicTidyTableTypes";
 import React, { ReactElement } from "react";
-export declare type ScrollDirection = "forward" | "backward";
+export type ScrollDirection = "forward" | "backward";
 export interface ListOnScrollProps {
     scrollDirection: ScrollDirection;
     scrollOffset: number;

package/dist/Logger.d.ts

@@ -1,4 +1,4 @@
-export declare type LoggerComponent = "AlertDialog" | "AmCharts4" | "AmCharts4GeoMap" | "AmCharts5" | "App" | "AppCustomHeaders" | "AppStarter" | "AppStatus" | "ChartTemplateWidget" | "Demo" | "EmbeddedReport" | "ErrorRenderer" | "Font" | "General" | "GoogleMap" | "Help" | "History" | "Keyboard" | "Layout" | "LayoutPage" | "LayoutRender" | "Loader" | "Localization" | "Other" | "PivotTable" | "PivotTablePagingView" | "Plugin" | "Profiler" | "ReportAppBar" | "ReportAppMenu" | "ReportInitializer" | "ReportStarter" | "RepetitionWidget" | "Request" | "SchemaDataUpdate" | "Storage" | "Table" | "WidgetBox" | "WidgetBoxWrapper" | "WidgetTemplateLibrary";
+export type LoggerComponent = "AlertDialog" | "AmCharts4" | "AmCharts4GeoMap" | "AmCharts5" | "App" | "AppCustomHeaders" | "AppStarter" | "AppStatus" | "ChartTemplateWidget" | "Demo" | "EmbeddedReport" | "ErrorRenderer" | "Font" | "General" | "GoogleMap" | "Help" | "History" | "Keyboard" | "Layout" | "LayoutPage" | "LayoutRender" | "Loader" | "Localization" | "Operation" | "Other" | "PivotTable" | "PivotTablePagingView" | "Plugin" | "Profiler" | "ReportAppBar" | "ReportAppMenu" | "ReportInitializer" | "ReportStarter" | "RepetitionWidget" | "Request" | "SchemaDataUpdate" | "Storage" | "Table" | "WidgetBox" | "WidgetBoxWrapper" | "WidgetTemplateLibrary";
 export interface ILogger {
     resetTime(): void;
     disable(component: LoggerComponent): void;

package/dist/PublicAmCharts4Base.d.ts

@@ -0,0 +1,91 @@
+import { IWidgetPublicContext } from "./PublicContext";
+import { ITidyColorColumn, ITidyColumn } from "./PublicTidyColumn";
+import { ITidyTable } from "./PublicTidyTable";
+import { ITidyTableInteraction } from "./PublicTidyTableInteractions";
+import { Theme } from "@mui/material/styles";
+import { ITidyMath } from "./PublicTidyMath";
+import { IWidgetTemplateTidyData } from "./PublicTemplate";
+import { Am4ChartOptions } from "./theme/ThemeAmCharts4";
+import { Property } from "csstype";
+export interface PublicAmCharts4Base<CHART, OPTIONS extends Am4ChartOptions> {
+    readonly context: IWidgetPublicContext;
+    /**
+     * The theme of the report
+     */
+    readonly theme: Theme;
+    tidyMath(): ITidyMath;
+    /**
+     * Get the color manager of the chart. This manager can create color columns using the default
+     * theme palette.
+     */
+    getColorManager(): PublicAm4ColorManager;
+    /**
+     * Render the chart. Function called by plugin module.
+     */
+    renderJS(template: IWidgetTemplateTidyData, options: OPTIONS): void;
+    /**
+     * Dispose/ destroy the chart.
+     */
+    dispose(): void;
+    /**
+     * Adds an event listener to a series in the chart. This function adds the selection and the
+     * events to fire that are in 'getEventsToFire'.
+     * @param sprite a amcharts series object.
+     * @param dataKey the data key identifies the series in the chart data.
+     */
+    addClickEventOnSprite(sprite: any, dataKey: string | undefined): void;
+    /**
+     * Returns the row for a certain data item.
+     * @param dataItem the data item of a sprite (bar, line, circle, etc..)
+     * @param dataKey the data key identifies the series in the chart data.
+     */
+    getRowFromDataItem(dataItem: unknown, dataKey: string | undefined): number | undefined;
+    /**
+     * Get the tidy table. Only use this function in update methods, otherwise it might not be defined and then it
+     * throws an error.
+     */
+    getTable(): ITidyTable;
+    /**
+     * Get the options. Only use this function in update methods, otherwise it might not be defined and then it
+     * throws an error.
+     */
+    getOptions(): OPTIONS;
+    getInter(): ITidyTableInteraction;
+    getChart(): CHART;
+    /**
+     * Perform interactions on the chart. Possible interaction can be a selection,
+     * a drilldown or the firing of an event.
+     *
+     * Available interactions are set via the 'Interactions' tab in the widget editor.
+     *
+     * @param rowIdx the index of the row.
+     * @param mouseEvent the html mouse event of the click. Used for multiple selection using ctrl and shift.
+     */
+    performInteraction(rowIdx: number, mouseEvent: MouseEvent | TouchEvent): void;
+    /**
+     * Returns the am4core instance used by the amCharts4 plugin.
+     */
+    getAm4core(): any;
+    /**
+     * Returns the am4charts instance used by the amCharts4 plugin.
+     */
+    getAm4charts(): any;
+}
+export type Am4Color = Property.Color;
+export interface PublicAm4ColorManager {
+    /**
+     * Generate a color column.
+     * @param table create the color column for this table (same length).
+     * @param categoryColumn if available, use the values in this column to generate colors.
+     */
+    generateColors(table: ITidyTable, categoryColumn?: ITidyColumn): ITidyColorColumn;
+    /**
+     * Get a color
+     * @param dataKey string to generate color for
+     */
+    getColor(dataKey: unknown): Am4Color;
+    /**
+     * Returns the default single color
+     */
+    getDefaultColor(): Am4Color;
+}

package/dist/{IReporting.js → PublicAmCharts4Base.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=IReporting.js.map
+//# sourceMappingURL=PublicAmCharts4Base.js.map

package/dist/PublicAmCharts4Base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicAmCharts4Base.js","sourceRoot":"","sources":["../src/PublicAmCharts4Base.ts"],"names":[],"mappings":""}

package/dist/PublicAmchartsData.d.ts

@@ -11,6 +11,7 @@ export interface ISeriesValues {
     type: ISeriesValuesType;
     values: ITidyNumericColumn;
     colors?: ITidyColorColumn;
+    parentSeriesId?: string;
 }
 /**
  * Used for managing amcharts data in the Amcharts plugin. This class controls both the creation of the charts
@@ -23,6 +24,7 @@ export declare class PublicAmchartsData {
     private readonly onGroup;
     private readonly table;
     constructor(table: ITidyTable, onValues: ISeriesValues[], onAxis: ITidyColumn, onGroup?: ITidyColumn, onLevel?: ITidyColumn);
+    static getSeriesId(seriesId: number, rowIdx?: number, group?: ITidyColumn): string;
     /**
      * Get the data for the chart.
      */
@@ -30,23 +32,10 @@ export declare class PublicAmchartsData {
     /**
      * Create, update and remove series in the chart.
      * @param itemControl map keeping track of current series in the chart.
-     * @param create create a new series if it is not in itemControl.
-     *  - seriesId: unique id of the series
-     *  - groupKey: key for the group by (if defined). If not defined, use _
-     *  - valueKey: series value datafield
-     *  - fillKey: series fill datafield
-     *  - sValue: the onValues part used
-     * @param update update a series.
-     *  - seriesId: unique id of the series
-     *  - groupKey: key for the group by (if defined). If not defined, use _
-     *  - series: the charts series to update
-     *  - sValue: the onValues part used
-     *  - groupRows: row indices of the group. Length >= 1.
-     * @param remove remove the series.
-     * @param typeFilter if defined, only call create, update and remove where typeFilter(type) returns true.
+     * @param seriesControl object controlling the adding/removing/updating of series.
      * @param firstGroupOnly only call the first group
      */
-    updateSeries<T>(itemControl: Map<string, T>, create: (seriesId: string, groupKey: string, valueKey: string, fillKey: string, sValue: ISeriesValues) => T, update: (seriesId: string, groupKey: string, series: T, sValue: ISeriesValues, groupRows: GroupRowIndices) => void, remove: (item: T) => void, typeFilter?: (type: ISeriesValuesType) => boolean, firstGroupOnly?: boolean): void;
+    updateSeries<T>(itemControl: Map<string, T>, seriesControl: IAmchartsSeriesControl<T>, firstGroupOnly?: boolean): void;
     getAxis(): ITidyColumn;
     getLevel(): ITidyColumn | undefined;
     getGroup(): ITidyColumn | undefined;
@@ -55,6 +44,11 @@ export declare class PublicAmchartsData {
      * @param idx n
      */
     getValueColumn(idx: number): ITidyNumericColumn;
+    /**
+     * Call a function on each series and it's column
+     * @param itemControl map keeping track of current series in the chart.
+     */
+    forEachSeries<T>(itemControl: Map<string, T>, callback: (col: ITidyNumericColumn, seriesId: string, series: T) => void): void;
     /**
      * Returns the first item in the onValues argument of the constructor.
      */
@@ -64,3 +58,35 @@ export declare class PublicAmchartsData {
      */
     isMultiMeasure(): boolean;
 }
+/**
+ * Controls when to add / remove / dispose / update series. This class exists because using chart.setSeries removes
+ * trend-series. This class handles the adding and removing of series and keeps the series in the order of the data.
+ */
+export interface IAmchartsSeriesControl<T> {
+    /**
+     * If defined, only call create, update and remove where typeFilter(type) returns true.
+     */
+    typeFilter?: (type: ISeriesValuesType) => boolean;
+    /**
+     * Create a new series if it is not in itemControl. Use 'add' to add it to the chart.
+     * @param seriesId unique id of the series
+     * @param groupKey key for the group by (if defined). If not defined, use _
+     * @param valueKey series value dataField
+     * @param fillKey series fill dataField
+     * @param sValue the onValues part used
+     */
+    create: (seriesId: string, groupKey: string, valueKey: string, fillKey: string, sValue: ISeriesValues) => T;
+    /**
+     * Update a series.
+     * @param seriesId unique id of the series
+     * @param groupKey key for the group by (if defined). If not defined, use _
+     * @param series the charts series to update
+     * @param sValue the onValues part used
+     * @param groupRows row indices of the group. Length >= 1.
+     */
+    update: (seriesId: string, groupKey: string, series: T, sValue: ISeriesValues, groupRows: GroupRowIndices) => void;
+    /**
+     * Destroy an item. Called when the item can be cleared from memory. E.g., dispose() on the series.
+     */
+    remove: (item: T) => void;
+}

package/dist/PublicAmchartsData.js

@@ -21,6 +21,12 @@ class PublicAmchartsData {
         this.onLevel = onLevel;
         this.table = table;
     }
+    static getSeriesId(seriesId, rowIdx, group) {
+        if (group && rowIdx != null) {
+            return group.getAmcharts4GroupKey(rowIdx) + "." + String(seriesId);
+        }
+        return PublicTidyTableTypes_1.IAmcharts4DataKey.NULL + "." + String(seriesId);
+    }
     /**
      * Get the data for the chart.
      */
@@ -48,38 +54,25 @@ class PublicAmchartsData {
     /**
      * Create, update and remove series in the chart.
      * @param itemControl map keeping track of current series in the chart.
-     * @param create create a new series if it is not in itemControl.
-     *  - seriesId: unique id of the series
-     *  - groupKey: key for the group by (if defined). If not defined, use _
-     *  - valueKey: series value datafield
-     *  - fillKey: series fill datafield
-     *  - sValue: the onValues part used
-     * @param update update a series.
-     *  - seriesId: unique id of the series
-     *  - groupKey: key for the group by (if defined). If not defined, use _
-     *  - series: the charts series to update
-     *  - sValue: the onValues part used
-     *  - groupRows: row indices of the group. Length >= 1.
-     * @param remove remove the series.
-     * @param typeFilter if defined, only call create, update and remove where typeFilter(type) returns true.
+     * @param seriesControl object controlling the adding/removing/updating of series.
      * @param firstGroupOnly only call the first group
      */
-    updateSeries(itemControl, create, update, remove, typeFilter, firstGroupOnly) {
+    updateSeries(itemControl, seriesControl, firstGroupOnly) {
         const group = this.onGroup;
         const updated = new Set();
         const forEachSeries = (groupKey, groupIdx) => {
             this.onValues.forEach((onValue, idx) => {
-                if (typeFilter != null && !typeFilter(onValue.type)) {
+                if (seriesControl.typeFilter != null && !seriesControl.typeFilter(onValue.type)) {
                     return;
                 }
                 const seriesKey = groupKey + "." + String(idx);
                 let item = itemControl.get(seriesKey);
                 if (item == null) {
-                    const newItem = create(seriesKey, groupKey, seriesKey + "v", seriesKey + "c", onValue);
+                    const newItem = seriesControl.create(seriesKey, groupKey, seriesKey + "v", seriesKey + "c", onValue);
                     itemControl.set(seriesKey, newItem);
                     item = newItem;
                 }
-                update(seriesKey, groupKey, item, onValue, groupIdx);
+                seriesControl.update(seriesKey, groupKey, item, onValue, groupIdx);
                 updated.add(seriesKey);
             });
         };
@@ -89,13 +82,13 @@ class PublicAmchartsData {
                 const groupIdx = index.values().next();
                 if (!groupIdx.done) {
                     const firstIndex = groupIdx.value[0];
-                    const groupKey = group.getUid(firstIndex);
+                    const groupKey = group.getAmcharts4GroupKey(firstIndex);
                     forEachSeries(groupKey, groupIdx.value);
                 }
             }
             else {
                 index.forEach(groupIdx => {
-                    const groupKey = group.getUid(groupIdx[0]);
+                    const groupKey = group.getAmcharts4GroupKey(groupIdx[0]);
                     forEachSeries(groupKey, groupIdx);
                 });
             }
@@ -107,7 +100,7 @@ class PublicAmchartsData {
         itemControl.forEach((item, key) => {
             if (!updated.has(key)) {
                 itemControl.delete(key);
-                remove(item);
+                seriesControl.remove(item);
             }
         });
     }
@@ -127,6 +120,24 @@ class PublicAmchartsData {
     getValueColumn(idx) {
         return this.onValues[idx].values;
     }
+    /**
+     * Call a function on each series and it's column
+     * @param itemControl map keeping track of current series in the chart.
+     */
+    forEachSeries(itemControl, callback) {
+        this.updateSeries(itemControl, {
+            create: () => {
+                throw Error("SNBH series cannot be created");
+            },
+            update: (seriesId, groupKey, series, sValue, groupRows) => {
+                callback(sValue.values, seriesId, series);
+            },
+            remove: () => {
+                throw Error("SNBH series cannot be removed");
+            },
+            typeFilter: type => type !== ISeriesValuesType.TREND
+        }, true);
+    }
     /**
      * Returns the first item in the onValues argument of the constructor.
      */

package/dist/PublicAmchartsData.js.map

@@ -1 +1 @@
-{"version":3,"file":"PublicAmchartsData.js","sourceRoot":"","sources":["../src/PublicAmchartsData.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PublicAmchartsData.js","sourceRoot":"","sources":["../src/PublicAmchartsData.ts"],"names":[],"mappings":"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"}

package/dist/PublicContext.d.ts

@@ -8,10 +8,15 @@ import { ITidyColumn, ITidyNumericColumn } from "./PublicTidyColumn";
 import { IPublicWidgetTemplateDefinition } from "./PublicTemplate";
 import { ITidyMath } from "./PublicTidyMath";
 import { ILogger } from "./Logger";
+import { AppNotification } from "./INotification";
 export declare enum WidgetRenderLayoutStatus {
     RENDERING = "RENDERING",
     RENDERED = "RENDERED"
 }
+export declare enum WidgetWarningSeverity {
+    WARNING = 0,
+    ERROR = 1
+}
 export declare enum IContentMessageType {
     info = 0,
     error = 1
@@ -84,7 +89,7 @@ export interface IPublicContext {
      * To prevent usage of the default, pass an "empty" string that makes this method returns
      * undefined.
      */
-    createTableMarkdownExpr(field: string, table: ITidyTable, expression: string | undefined): (() => string) | undefined;
+    createTableMarkdownExpr(field: string, table: ITidyTable, currentColumn: ITidyColumn | undefined, expression: string | undefined, selectedColumns: ITidyColumn[] | undefined): (() => string) | undefined;
     /**
      * Not in widget public context because of transformation not applied from a widget context always.
      *
@@ -108,6 +113,14 @@ export interface IPublicContext {
     createTableNumericExpr(field: string, table: ITidyTable, currentColumn: ITidyColumn | undefined, expression: string | undefined, selectedColumns: ITidyColumn[] | undefined): (() => number | undefined) | undefined;
 }
 export interface IWidgetPublicContext extends IPublicContext {
+    /**
+     * Get the width of the widget box in pixels.
+     */
+    getWidgetWidth(): number | undefined;
+    /**
+     * Get the height of the widget box in pixels.
+     */
+    getWidgetHeight(): number | undefined;
     getNsId(): string;
     getWidgetId(): string;
     getWidgetPageNb(): number;
@@ -152,6 +165,10 @@ export interface IWidgetPublicContext extends IPublicContext {
      * actionName if the action is bound to a channel, send an Mdx Event (value,mdx)
      */
     fireMdxEvent(actionName: string, value: string, mdx: string): void;
+    /**
+     * Used for publishing app notifications (e.g., print the report).
+     */
+    fireAppNotification(notification: AppNotification): void;
     /**
      * Cypress testing purpose, after a rendering of the chart
      */
@@ -216,6 +233,15 @@ export interface IWidgetPublicContext extends IPublicContext {
      */
     getMapCoordinates(table: ITidyTable): [ITidyNumericColumn, ITidyNumericColumn] | [];
     getGoogleMapRenderedDelayMS(): number;
+    /**
+     * Displays an warning icon in the widget header showing the warning when the user hovers the icon.
+     * Be sure to clear all warnings before rendering using {@see widgetClearWarnings}
+     */
+    addWidgetWarning(warning: string, severity?: WidgetWarningSeverity): void;
+    /**
+     * Clear the warnings in the widget.
+     */
+    widgetClearWarnings(): void;
 }
 export interface IWidgetEditorPublicContext {
     /**

package/dist/PublicContext.js

@@ -1,11 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IContentMessageType = exports.WidgetRenderLayoutStatus = void 0;
+exports.IContentMessageType = exports.WidgetWarningSeverity = exports.WidgetRenderLayoutStatus = void 0;
 var WidgetRenderLayoutStatus;
 (function (WidgetRenderLayoutStatus) {
     WidgetRenderLayoutStatus["RENDERING"] = "RENDERING";
     WidgetRenderLayoutStatus["RENDERED"] = "RENDERED";
 })(WidgetRenderLayoutStatus = exports.WidgetRenderLayoutStatus || (exports.WidgetRenderLayoutStatus = {}));
+var WidgetWarningSeverity;
+(function (WidgetWarningSeverity) {
+    WidgetWarningSeverity[WidgetWarningSeverity["WARNING"] = 0] = "WARNING";
+    WidgetWarningSeverity[WidgetWarningSeverity["ERROR"] = 1] = "ERROR";
+})(WidgetWarningSeverity = exports.WidgetWarningSeverity || (exports.WidgetWarningSeverity = {}));
 var IContentMessageType;
 (function (IContentMessageType) {
     IContentMessageType[IContentMessageType["info"] = 0] = "info";

package/dist/PublicContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"PublicContext.js","sourceRoot":"","sources":["../src/PublicContext.ts"],"names":[],"mappings":";;;AAUA,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,mDAAuB,CAAA;IACvB,iDAAqB,CAAA;AACzB,CAAC,EAHW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAGnC;AAED,IAAY,mBAAkC;AAA9C,WAAY,mBAAmB;IAAG,6DAAI,CAAA;IAAE,+DAAK,CAAA;AAAA,CAAC,EAAlC,mBAAmB,GAAnB,2BAAmB,KAAnB,2BAAmB,QAAe"}
+{"version":3,"file":"PublicContext.js","sourceRoot":"","sources":["../src/PublicContext.ts"],"names":[],"mappings":";;;AAWA,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAChC,mDAAuB,CAAA;IACvB,iDAAqB,CAAA;AACzB,CAAC,EAHW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAGnC;AAED,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC7B,uEAAO,CAAA;IACP,mEAAK,CAAA;AACT,CAAC,EAHW,qBAAqB,GAArB,6BAAqB,KAArB,6BAAqB,QAGhC;AAED,IAAY,mBAAkC;AAA9C,WAAY,mBAAmB;IAAG,6DAAI,CAAA;IAAE,+DAAK,CAAA;AAAA,CAAC,EAAlC,mBAAmB,GAAnB,2BAAmB,KAAnB,2BAAmB,QAAe"}

package/dist/PublicLayout.d.ts

@@ -1,12 +1,12 @@
 import { PaperOrientation, PaperSizeUnits } from "./ITypes";
 import { Property } from "csstype";
-declare type CSSProperties = any;
+type CSSProperties = any;
 /**
  * <pre>
  *     unlimited: in height (page width is always known).
  * </pre>
  */
-export declare type PageSize = "known" | "manual" | "unlimited";
+export type PageSize = "known" | "manual" | "unlimited";
 export interface IPageSize {
     type: PageSize;
 }

package/dist/PublicTemplate.d.ts

@@ -38,8 +38,7 @@ export interface IWidgetLayoutInfo extends IRectangle {
     data?: IWidgetLayoutData;
     resizingConstraint?: ResizingConstraintOptions;
 }
-declare type ChartTemplateWidgetProps = any;
-export declare type IPublicWidgetTemplateDefinition<T extends FormFieldObject> = IPublicWidgetReactTemplateDefinition<T> | IPublicWidgetJsTemplateDefinition<T>;
+export type IPublicWidgetTemplateDefinition<T extends FormFieldObject> = IPublicWidgetReactTemplateDefinition<T> | IPublicWidgetJsTemplateDefinition<T>;
 export declare enum IWidgetTemplateMdxBuilderAxisPropsConstraint {
     DateType = "DateType",
     GeoLatLong = "GeoLatLong",
@@ -100,9 +99,13 @@ export interface IWidgetTemplateMdxBuilderMapping {
      */
     mdxIsForFilter?: true;
     /**
-     * The cell values are not needed
+     * The cell values are not needed.
      */
     withoutCellValues?: true;
+    /**
+     * The cell values are not needed if there is a single axis in the query.
+     */
+    withoutCellValuesSingleAxis?: true;
     /**
      * An MDX query if the builder is empty.
      */
@@ -119,7 +122,7 @@ export interface IPublicReactChartTemplate<T extends FormFieldObject> {
      * @param options the options (possibly edited and/or from the theme) of this widget
      * @param header aka. widget title
      */
-    reactElement: (data: IWidgetTemplateTidyData, options: T, header: string, props: ChartTemplateWidgetProps) => ReactElement;
+    reactElement: (data: IWidgetTemplateTidyData, options: T, header: string) => ReactElement;
 }
 /**
  * A widget that renders using plain Javascript/Typescript.
@@ -298,6 +301,9 @@ interface IPublicCommonWidgetTemplateDefinition<OPTIONS extends FormFieldObject>
      * If and only if not null, hide option 'Interactions' > 'Drilldown' > 'Pivot Table Like' and set it default value to withDrilldownPivotTableLikeAs.
      */
     withDrilldownPivotTableLikeAs?: boolean;
+    /**
+     * Extra options for in the widgets user menu when in viewer mode.
+     */
     userMenuOptions?: string[];
     /**
      * Additional widget user menu options when in editing mode.
@@ -407,6 +413,11 @@ interface IPublicCommonWidgetTemplateDefinition<OPTIONS extends FormFieldObject>
      * Defaults: all of them.
      */
     withQueryTypes?: QueryType[];
+    /**
+     * Change the data to show when the user presses show-data from the widget menu.
+     * @param ownProps
+     */
+    getShowHideDataTable?: (table: ITidyTable | undefined, options: OPTIONS, ownProps: any) => ITidyTable | undefined;
 }
 /**
  * *********************************************************************************************************************
@@ -437,7 +448,7 @@ export interface IChartVisualizationTypedInput<T extends FormFieldObject> {
  * 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 declare type IWidgetTemplateDataMappingDef = IFormColumnChooserFieldDef;
+export type IWidgetTemplateDataMappingDef = IFormColumnChooserFieldDef;
 /**
  * Predefined roles
  */

package/dist/PublicTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"PublicTemplate.js","sourceRoot":"","sources":["../src/PublicTemplate.ts"],"names":[],"mappings":";;;AA2DA,IAAY,4CAIX;AAJD,WAAY,4CAA4C;IACpD,qEAAqB,CAAA;IACrB,yEAAyB,CAAA;IACzB,2EAA2B,CAAA;AAC/B,CAAC,EAJW,4CAA4C,GAA5C,oDAA4C,KAA5C,oDAA4C,QAIvD;AA2bD;;;;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;AA6BD;;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":";;;AAyDA,IAAY,4CAIX;AAJD,WAAY,4CAA4C;IACpD,qEAAqB,CAAA;IACrB,yEAAyB,CAAA;IACzB,2EAA2B,CAAA;AAC/B,CAAC,EAJW,4CAA4C,GAA5C,oDAA4C,KAA5C,oDAA4C,QAIvD;AA0cD;;;;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;AA6BD;;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"}