@ag-grid-enterprise/charts - npm Package Compare versions

Comparing version 31.2.1 to 31.3.0

dist/package/package.json

 {
   "name": "@ag-grid-enterprise/charts",
-  "version": "31.2.1",
+  "version": "31.3.0",
   "description": "Advanced Data Grid / Data Table supporting Javascript / Typescript / React / Angular / Vue",
@@ -15,6 +15,6 @@ "main": "./dist/package/main.cjs.js",
   "dependencies": {
-    "@ag-grid-community/core": "31.2.1",
-    "@ag-grid-enterprise/core": "31.2.1",
-    "@ag-grid-enterprise/range-selection": "31.2.1",
-    "ag-charts-community": "9.2.0"
+    "@ag-grid-community/core": "31.3.0",
+    "@ag-grid-enterprise/core": "31.3.0",
+    "@ag-grid-enterprise/range-selection": "31.3.0",
+    "ag-charts-community": "9.3.0"
   },
@@ -21,0 +21,0 @@ "devDependencies": {

dist/types/package.json

 {
   "name": "@ag-grid-enterprise/charts",
-  "version": "31.2.1",
+  "version": "31.3.0",
   "description": "Advanced Data Grid / Data Table supporting Javascript / Typescript / React / Angular / Vue",
@@ -15,6 +15,6 @@ "main": "./src/main.js",
   "dependencies": {
-    "@ag-grid-community/core": "31.2.1",
-    "@ag-grid-enterprise/core": "31.2.1",
-    "@ag-grid-enterprise/range-selection": "31.2.1",
-    "ag-charts-community": "9.2.0"
+    "@ag-grid-community/core": "31.3.0",
+    "@ag-grid-enterprise/core": "31.3.0",
+    "@ag-grid-enterprise/range-selection": "31.3.0",
+    "ag-charts-community": "9.3.0"
   },
@@ -21,0 +21,0 @@ "devDependencies": {

dist/types/src/charts/chartComp/chartController.d.ts

@@ -1,5 +0,5 @@
-import { BeanStub, ChartModel, ChartType, SeriesChartType, AgChartThemeOverrides, UpdateChartParams, IAggFunc } from "@ag-grid-community/core";
+import { BeanStub, ChartModel, ChartType, SeriesChartType, AgChartThemeOverrides, UpdateChartParams, IAggFunc, SeriesGroupType } from "@ag-grid-community/core";
 import { ChartDataModel, ColState } from "./model/chartDataModel";
 import { ChartProxy, UpdateParams } from "./chartProxies/chartProxy";
-import { _Theme, AgChartThemePalette } from "ag-charts-community";
+import { _Theme, AgChartThemePalette, AgCartesianAxisType } from "ag-charts-community";
 import { ChartSeriesType } from './utils/seriesTypeMapper';
@@ -27,3 +27,7 @@ export declare const DEFAULT_THEMES: string[];
     updateForRangeChange(): void;
-    updateForPanelChange(updatedColState: ColState, resetOrder?: boolean): void;
+    updateForPanelChange(params: {
+        updatedColState: ColState;
+        resetOrder?: boolean;
+        skipAnimation?: boolean;
+    }): void;
     updateThemeOverrides(updatedOverrides: AgChartThemeOverrides): void;
@@ -78,2 +82,3 @@ getChartUpdateParams(updatedOverrides?: AgChartThemeOverrides): UpdateParams;
     getChartSeriesTypes(chartType?: ChartType): ChartSeriesType[];
+    getChartSeriesType(): ChartSeriesType;
     isEnterprise: () => boolean;
@@ -84,3 +89,6 @@ private getCellRanges;
     private getCellRangeParams;
-    private raiseChartModelUpdateEvent;
+    setCategoryAxisType(categoryAxisType?: AgCartesianAxisType): void;
+    getSeriesGroupType(): SeriesGroupType | undefined;
+    setSeriesGroupType(seriesGroupType?: SeriesGroupType): void;
+    raiseChartModelUpdateEvent(): void;
     raiseChartUpdatedEvent(): void;
@@ -87,0 +95,0 @@ raiseChartApiUpdateEvent(): void;

dist/types/src/charts/chartComp/chartProxies/cartesian/areaChartProxy.d.ts

 import { AgAreaSeriesOptions, AgCartesianAxisOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class AreaChartProxy extends CartesianChartProxy {
+export declare class AreaChartProxy extends CartesianChartProxy<'area'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ protected getAxes(params: UpdateParams): AgCartesianAxisOptions[];

dist/types/src/charts/chartComp/chartProxies/cartesian/barChartProxy.d.ts

 import { AgBarSeriesOptions, AgCartesianAxisOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class BarChartProxy extends CartesianChartProxy {
+export declare class BarChartProxy extends CartesianChartProxy<'bar'> {
     constructor(params: ChartProxyParams);
@@ -10,2 +10,3 @@ protected getAxes(params: UpdateParams): AgCartesianAxisOptions[];
     private isNormalised;
+    protected isHorizontal(): boolean;
 }

dist/types/src/charts/chartComp/chartProxies/cartesian/cartesianChartProxy.d.ts

 import { ChartProxy, ChartProxyParams, UpdateParams } from "../chartProxy";
-import { AgAreaSeriesOptions, AgBaseSeriesOptions, AgCartesianAxisOptions, AgLineSeriesOptions } from "ag-charts-community";
-export declare abstract class CartesianChartProxy extends ChartProxy {
+import { AgAreaSeriesOptions, AgCartesianAxisOptions, AgCartesianChartOptions, AgCartesianSeriesOptions, AgLineSeriesOptions } from "ag-charts-community";
+export declare abstract class CartesianChartProxy<TSeries extends 'area' | 'bar' | 'histogram' | 'line' | 'scatter' | 'bubble' | 'waterfall' | 'box-plot' | 'range-area' | 'range-bar'> extends ChartProxy<AgCartesianChartOptions, TSeries> {
     protected crossFilteringAllPoints: Set<string>;
     protected crossFilteringSelectedPoints: string[];
     protected constructor(params: ChartProxyParams);
-    protected abstract getAxes(params: UpdateParams): AgCartesianAxisOptions[];
-    protected abstract getSeries(params: UpdateParams): AgBaseSeriesOptions<any>[];
-    update(params: UpdateParams): void;
+    protected abstract getAxes(params: UpdateParams, commonChartOptions: AgCartesianChartOptions): AgCartesianAxisOptions[];
+    protected abstract getSeries(params: UpdateParams): AgCartesianSeriesOptions[];
+    protected getUpdateOptions(params: UpdateParams, commonChartOptions: AgCartesianChartOptions): AgCartesianChartOptions;
     protected getData(params: UpdateParams, axes: AgCartesianAxisOptions[]): any[];
     private getDataTransformedData;
-    protected getXAxisType(params: UpdateParams): "category" | "time" | "grouped-category";
-    private static isTimeAxis;
+    protected getXAxisType(params: UpdateParams): "number" | "category" | "time" | "grouped-category";
+    private isXAxisOfType;
+    private transformTimeData;
     crossFilteringReset(): void;
@@ -20,2 +21,3 @@ protected crossFilteringPointSelected(point: string): boolean;
     private crossFilteringAddSelectedPoint;
+    protected isHorizontal(commonChartOptions: AgCartesianChartOptions): boolean;
 }

dist/types/src/charts/chartComp/chartProxies/cartesian/histogramChartProxy.d.ts

 import { AgCartesianAxisOptions, AgHistogramSeriesOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class HistogramChartProxy extends CartesianChartProxy {
+export declare class HistogramChartProxy extends CartesianChartProxy<'histogram'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ protected getSeries(params: UpdateParams): AgHistogramSeriesOptions[];

dist/types/src/charts/chartComp/chartProxies/cartesian/lineChartProxy.d.ts

 import { AgCartesianAxisOptions, AgLineSeriesOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class LineChartProxy extends CartesianChartProxy {
+export declare class LineChartProxy extends CartesianChartProxy<'line'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ protected getAxes(params: UpdateParams): AgCartesianAxisOptions[];

dist/types/src/charts/chartComp/chartProxies/cartesian/scatterChartProxy.d.ts

 import { AgBubbleSeriesOptions, AgCartesianAxisOptions, AgScatterSeriesOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class ScatterChartProxy extends CartesianChartProxy {
+export declare class ScatterChartProxy extends CartesianChartProxy<'scatter' | 'bubble'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ protected getAxes(_params: UpdateParams): AgCartesianAxisOptions[];

dist/types/src/charts/chartComp/chartProxies/cartesian/waterfallChartProxy.d.ts

@@ -1,8 +0,8 @@
-import { AgCartesianAxisOptions, AgWaterfallSeriesOptions } from "ag-charts-community";
+import { AgCartesianAxisOptions, AgCartesianChartOptions, AgWaterfallSeriesOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "./cartesianChartProxy";
-export declare class WaterfallChartProxy extends CartesianChartProxy {
+export declare class WaterfallChartProxy extends CartesianChartProxy<'waterfall'> {
     constructor(params: ChartProxyParams);
-    protected getAxes(params: UpdateParams): AgCartesianAxisOptions[];
+    protected getAxes(params: UpdateParams, commonChartOptions: AgCartesianChartOptions): AgCartesianAxisOptions[];
     protected getSeries(params: UpdateParams): AgWaterfallSeriesOptions[];
 }

dist/types/src/charts/chartComp/chartProxies/chartProxy.d.ts

@@ -1,3 +0,3 @@
-import { AgChartTheme as GridAgChartTheme, ChartType, SeriesChartType } from "@ag-grid-community/core";
-import { AgChartInstance, AgChartTheme, AgChartThemeOverrides, AgChartThemePalette } from "ag-charts-community";
+import { AgChartTheme as GridAgChartTheme, ChartType, SeriesChartType, SeriesGroupType } from "@ag-grid-community/core";
+import { AgChartInstance, AgChartOptions, AgChartTheme, AgChartThemeOverrides, AgChartThemePalette } from "ag-charts-community";
 import { CrossFilteringContext } from "../../chartService";
@@ -33,2 +33,3 @@ import { ChartSeriesType } from "../utils/seriesTypeMapper";
     data: any[];
+    groupData?: any[];
     grouping: boolean;
@@ -45,8 +46,9 @@ categories: {
     updatedOverrides?: AgChartThemeOverrides;
+    seriesGroupType?: SeriesGroupType;
 }
-export declare abstract class ChartProxy {
+export declare abstract class ChartProxy<TOptions extends AgChartOptions = AgChartOptions, TSeries extends ChartSeriesType = ChartSeriesType> {
     protected readonly chartProxyParams: ChartProxyParams;
     private readonly isEnterpriseCharts;
     protected readonly chartType: ChartType;
-    protected readonly standaloneChartType: ChartSeriesType;
+    protected readonly standaloneChartType: TSeries;
     protected readonly chart: AgChartInstance;
@@ -57,4 +59,5 @@ protected readonly crossFiltering: boolean;
     protected constructor(chartProxyParams: ChartProxyParams);
-    abstract crossFilteringReset(): void;
-    abstract update(params: UpdateParams): void;
+    protected abstract getUpdateOptions(params: UpdateParams, commonChartOptions: TOptions): TOptions;
+    crossFilteringReset(): void;
+    update(params: UpdateParams): void;
     updateThemeOverrides(themeOverrides: AgChartThemeOverrides): void;
@@ -74,8 +77,7 @@ getChart(): import("../utils/integration").AgChartActual;
     lookupCustomChartTheme(themeName: string): AgChartTheme;
-    protected transformData(data: any[], categoryKey: string, categoryAxis?: boolean): any[];
-    protected getCommonChartOptions(updatedOverrides?: AgChartThemeOverrides): any;
-    /**
-     * Retrieve default theme overrides for the current chart type
-     */
-    protected getChartThemeDefaults(): AgChartThemeOverrides | undefined;
+    getSeriesGroupType(): SeriesGroupType | undefined;
+    protected transformCategoryData(data: any[], categoryKey: string): any[];
+    private getCommonChartOptions;
+    private getChartThemeDefaults;
+    protected getSeriesChartThemeDefaults(): AgChartThemeOverrides[TSeries];
     private getActiveFormattingPanelOverrides;
@@ -82,0 +84,0 @@ destroy({ keepChartInstance }?: {

dist/types/src/charts/chartComp/chartProxies/chartTheme.d.ts

 import { AgChartTheme, AgChartThemeOverrides } from 'ag-charts-community';
 import { ChartProxy, ChartProxyParams } from './chartProxy';
-export declare function createAgChartTheme(chartProxyParams: ChartProxyParams, proxy: ChartProxy, isEnterprise: boolean): AgChartTheme;
-export declare function applyThemeOverrides(baseTheme: AgChartTheme, overrides: Array<AgChartThemeOverrides | null | undefined>): AgChartTheme;
+export declare function createAgChartTheme(chartProxyParams: ChartProxyParams, proxy: ChartProxy, isEnterprise: boolean, chartThemeDefaults?: AgChartThemeOverrides, updatedOverrides?: AgChartThemeOverrides): AgChartTheme;
 export declare function isStockTheme(themeName: string): boolean;
 export declare function lookupCustomChartTheme(chartProxyParams: ChartProxyParams, name: string): AgChartTheme;

dist/types/src/charts/chartComp/chartProxies/combo/comboChartProxy.d.ts

 import { AgCartesianAxisOptions } from "ag-charts-community";
 import { ChartProxyParams, UpdateParams } from "../chartProxy";
 import { CartesianChartProxy } from "../cartesian/cartesianChartProxy";
-export declare class ComboChartProxy extends CartesianChartProxy {
+export declare class ComboChartProxy extends CartesianChartProxy<'line' | 'bar' | 'area'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ getAxes(params: UpdateParams): AgCartesianAxisOptions[];

dist/types/src/charts/chartComp/chartProxies/hierarchical/hierarchicalChartProxy.d.ts

@@ -1,9 +0,9 @@
-import { AgHierarchySeriesOptions } from 'ag-charts-community';
+import { AgChartThemeOverrides, AgHierarchyChartOptions } from 'ag-charts-community';
 import { ChartProxy, ChartProxyParams, UpdateParams } from '../chartProxy';
-export declare abstract class HierarchicalChartProxy extends ChartProxy {
-    protected readonly chartProxyParams: ChartProxyParams;
-    protected constructor(chartProxyParams: ChartProxyParams);
-    update(params: UpdateParams): void;
-    protected abstract getSeries(params: UpdateParams, labelKey: string): AgHierarchySeriesOptions[];
-    protected getData(params: UpdateParams): any[];
+export declare class HierarchicalChartProxy<TSeries extends 'sunburst' | 'treemap'> extends ChartProxy<AgHierarchyChartOptions, TSeries> {
+    constructor(chartProxyParams: ChartProxyParams);
+    protected getUpdateOptions(params: UpdateParams, commonChartOptions: AgHierarchyChartOptions): AgHierarchyChartOptions;
+    protected getSeriesChartThemeDefaults(): AgChartThemeOverrides['treemap' | 'sunburst'];
+    private getSeries;
+    private getData;
 }

dist/types/src/charts/chartComp/chartProxies/hierarchical/hierarchicalChartUtils.d.ts

 export type CATEGORY_LABEL_KEY = 'AG-GRID-DEFAULT-LABEL-KEY';
 export declare const CATEGORY_LABEL_KEY: CATEGORY_LABEL_KEY;
-export interface CategoryGroup<T extends object> {
-    [CATEGORY_LABEL_KEY]: string | null;
-    children: Array<CategoryGroup<T> | CategoryItem<T>>;
-}
 export type CategoryItem<T extends object> = {
     [CATEGORY_LABEL_KEY]: string | null;
+    children?: Array<CategoryItem<T>>;
 } & T;
-export declare function createCategoryHierarchy<T extends object>(data: T[], categoryKeys: Array<keyof T>): Array<CategoryGroup<T> | CategoryItem<T>>;
-export declare function createAutoGroupHierarchy<T extends object>(data: T[], getItemLabels: (item: T) => string[] | null): Array<CategoryGroup<T> | CategoryItem<T>>;
+export declare function createCategoryHierarchy<T extends object>(data: T[], categoryKeys: Array<keyof T>): CategoryItem<T>[];
+export declare function createAutoGroupHierarchy<T extends object>(data: T[], getItemLabels: (item: T) => string[] | null): CategoryItem<T>[];

dist/types/src/charts/chartComp/chartProxies/pie/pieChartProxy.d.ts

 import { ChartProxy, ChartProxyParams, UpdateParams } from '../chartProxy';
-export declare class PieChartProxy extends ChartProxy {
+import { AgPolarChartOptions } from 'ag-charts-community';
+export declare class PieChartProxy extends ChartProxy<AgPolarChartOptions, 'pie' | 'donut'> {
     constructor(params: ChartProxyParams);
-    update(params: UpdateParams): void;
+    protected getUpdateOptions(params: UpdateParams, commonChartOptions: AgPolarChartOptions): AgPolarChartOptions;
     private getSeries;
@@ -10,3 +11,2 @@ private getCrossFilterData;
     private getFields;
-    crossFilteringReset(): void;
 }

dist/types/src/charts/chartComp/chartProxies/polar/polarChartProxy.d.ts

 import { ChartProxy, ChartProxyParams, UpdateParams } from '../chartProxy';
-import { AgNightingaleSeriesOptions, AgPolarAxisOptions, AgRadarAreaSeriesOptions, AgRadarLineSeriesOptions, AgRadialBarSeriesOptions, AgRadialColumnSeriesOptions } from 'ag-charts-community';
-type AgPolarSeriesOptions = AgRadarLineSeriesOptions | AgRadarAreaSeriesOptions | AgNightingaleSeriesOptions | AgRadialBarSeriesOptions | AgRadialColumnSeriesOptions;
-export declare class PolarChartProxy extends ChartProxy {
+import { AgPolarAxisOptions, AgPolarChartOptions, AgPolarSeriesOptions } from 'ag-charts-community';
+import { SeriesGroupType } from '@ag-grid-community/core';
+export declare class PolarChartProxy extends ChartProxy<AgPolarChartOptions, 'radar-line' | 'radar-area' | 'nightingale' | 'radial-column' | 'radial-bar'> {
     constructor(params: ChartProxyParams);
     getAxes(_: UpdateParams): AgPolarAxisOptions[];
     getSeries(params: UpdateParams): AgPolarSeriesOptions[];
-    update(params: UpdateParams): void;
+    getSeriesGroupType(): SeriesGroupType | undefined;
+    protected getUpdateOptions(params: UpdateParams, commonChartOptions: AgPolarChartOptions): AgPolarChartOptions;
     private getData;
-    private getDataTransformedData;
-    crossFilteringReset(): void;
+    private getSeriesGroupTypeOptions;
 }
-export {};

dist/types/src/charts/chartComp/chartProxies/specialized/heatmapChartProxy.d.ts

@@ -1,2 +0,2 @@
-import { AgHeatmapSeriesOptions, AgChartThemeOverrides } from 'ag-charts-community';
+import { AgCartesianChartOptions, AgHeatmapSeriesOptions, AgChartThemeOverrides } from 'ag-charts-community';
 import { ChartProxy, ChartProxyParams, UpdateParams } from '../chartProxy';
@@ -6,10 +6,8 @@ export declare const HEATMAP_CATEGORY_KEY = "AG-GRID-DEFAULT-HEATMAP-CATEGORY-KEY";
 export declare const HEATMAP_VALUE_KEY = "AG-GRID-DEFAULT-HEATMAP-VALUE-KEY";
-export declare class HeatmapChartProxy extends ChartProxy {
+export declare class HeatmapChartProxy extends ChartProxy<AgCartesianChartOptions, 'heatmap'> {
     constructor(params: ChartProxyParams);
-    update(params: UpdateParams): void;
+    protected getUpdateOptions(params: UpdateParams, commonChartOptions: AgCartesianChartOptions): AgCartesianChartOptions;
     protected getSeries(params: UpdateParams, xSeriesKey: string, xValueKey: string, yKey: string): AgHeatmapSeriesOptions[];
     protected getData(params: UpdateParams, xSeriesKey: string, xValueKey: string, yKey: string): any[];
-    protected getChartThemeDefaults(): AgChartThemeOverrides | undefined;
-    protected transformData(data: any[], categoryKey: string, categoryAxis?: boolean): any[];
-    crossFilteringReset(): void;
+    protected getSeriesChartThemeDefaults(): AgChartThemeOverrides['heatmap'];
 }

dist/types/src/charts/chartComp/chartProxies/statistical/boxPlotChartProxy.d.ts

 import { ChartProxyParams, UpdateParams } from '../chartProxy';
 import { AgBoxPlotSeriesOptions } from 'ag-charts-community';
 import { StatisticalChartProxy } from "./statisticalChartProxy";
-export declare class BoxPlotChartProxy extends StatisticalChartProxy {
+export declare class BoxPlotChartProxy extends StatisticalChartProxy<'box-plot'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ getSeries(params: UpdateParams): AgBoxPlotSeriesOptions<any>[];

dist/types/src/charts/chartComp/chartProxies/statistical/rangeChartProxy.d.ts

 import { ChartProxyParams, UpdateParams } from '../chartProxy';
 import { AgRangeAreaSeriesOptions } from 'ag-charts-community';
 import { StatisticalChartProxy } from "./statisticalChartProxy";
-export declare class RangeChartProxy extends StatisticalChartProxy {
+export declare class RangeChartProxy extends StatisticalChartProxy<'range-bar' | 'range-area'> {
     constructor(params: ChartProxyParams);
@@ -6,0 +6,0 @@ getSeries(params: UpdateParams): AgRangeAreaSeriesOptions<any>[];

dist/types/src/charts/chartComp/chartProxies/statistical/statisticalChartProxy.d.ts

 import { ChartProxyParams, UpdateParams } from '../chartProxy';
 import { CartesianChartProxy } from "../cartesian/cartesianChartProxy";
-import { AgCartesianAxisOptions } from 'ag-charts-community';
-export declare abstract class StatisticalChartProxy extends CartesianChartProxy {
+import { AgCartesianAxisOptions, AgCartesianChartOptions } from 'ag-charts-community';
+export declare abstract class StatisticalChartProxy<TSeries extends 'box-plot' | 'range-area' | 'range-bar'> extends CartesianChartProxy<TSeries> {
     protected constructor(params: ChartProxyParams);
-    getAxes(params: UpdateParams): AgCartesianAxisOptions[];
+    getAxes(params: UpdateParams, commonChartOptions: AgCartesianChartOptions): AgCartesianAxisOptions[];
     protected computeSeriesStatistics(params: UpdateParams, computeStatsFn: (values: number[]) => any): any[];
     protected groupDataByCategory(categoryKey: string, data: any[]): Map<any, any[]>;
 }

dist/types/src/charts/chartComp/datasource/chartDatasource.d.ts

@@ -1,2 +0,2 @@
-import { BeanStub, CellRange, Column, IAggFunc } from "@ag-grid-community/core";
+import { BeanStub, Column, IAggFunc, PartialCellRange } from "@ag-grid-community/core";
 import { ColState } from "../model/chartDataModel";
@@ -13,3 +13,3 @@ export interface ChartDatasourceParams {
     aggFunc?: string | IAggFunc;
-    referenceCellRange?: CellRange;
+    referenceCellRange?: PartialCellRange;
 }
@@ -21,2 +21,3 @@ interface IData {
     };
+    groupChartData?: any[];
 }
@@ -29,3 +30,3 @@ export declare class ChartDatasource extends BeanStub {
     private sortController;
-    private readonly aggregationStage;
+    private readonly aggregationStage?;
     getData(params: ChartDatasourceParams): IData;
@@ -32,0 +33,0 @@ private extractRowsFromGridRowModel;

dist/types/src/charts/chartComp/gridChartComp.d.ts

@@ -1,2 +0,2 @@
-import { CellRange, ChartModel, ChartToolPanelName, ChartType, Component, IAggFunc, SeriesChartType, UpdateChartParams } from "@ag-grid-community/core";
+import { ChartModel, ChartToolPanelName, ChartType, Component, IAggFunc, SeriesChartType, UpdateChartParams, PartialCellRange } from "@ag-grid-community/core";
 import { AgChartInstance, AgChartThemeOverrides, AgChartThemePalette } from "ag-charts-community";
@@ -6,13 +6,13 @@ import { CrossFilteringContext } from "../chartService";
     chartId: string;
-    pivotChart: boolean;
-    cellRange: CellRange;
+    pivotChart?: boolean;
+    cellRange: PartialCellRange;
     chartType: ChartType;
     chartThemeName?: string;
     insideDialog: boolean;
-    suppressChartRanges: boolean;
-    switchCategorySeries: boolean;
+    suppressChartRanges?: boolean;
+    switchCategorySeries?: boolean;
     aggFunc?: string | IAggFunc;
     chartThemeOverrides?: AgChartThemeOverrides;
     unlinkChart?: boolean;
-    crossFiltering: boolean;
+    crossFiltering?: boolean;
     crossFilteringContext: CrossFilteringContext;
@@ -19,0 +19,0 @@ chartOptionsToRestore?: AgChartThemeOverrides;

dist/types/src/charts/chartComp/menu/data/dragDataPanel.d.ts

@@ -21,3 +21,3 @@ import { AgCheckbox, AgGroupComponent, AgRadioButton, AgSelect, AutoScrollService, Component, DragAndDropService, DraggingEvent, DragSourceType } from "@ag-grid-community/core";
     refreshColumnComps(cols: ColState[]): boolean;
-    protected createGroup(columns: ColState[], valueFormatter: (colState: ColState) => string, selectLabelKey: ChartTranslationKey, dragSourceId: string): void;
+    protected createGroup(columns: ColState[], valueFormatter: (colState: ColState) => string, selectLabelKey: ChartTranslationKey, dragSourceId: string, skipAnimation?: () => boolean): void;
     protected refreshValueSelect(columns: ColState[]): void;
@@ -34,3 +34,3 @@ private createValueSelectParams;
     protected addDragHandle(comp: AgCheckbox, col: ColState): void;
-    protected addChangeListener(component: AgRadioButton | AgCheckbox, columnState: ColState): void;
+    protected addChangeListener(component: AgRadioButton | AgCheckbox, updatedColState: ColState): void;
     protected isInterestedIn(type: DragSourceType): boolean;
@@ -37,0 +37,0 @@ protected onValueChange({ added, updated, removed, selected }: AgPillSelectChangeParams<ColState>): void;

dist/types/src/charts/chartComp/menu/format/axis/cartesianAxisPanel.d.ts

@@ -15,2 +15,4 @@ import { Component } from "@ag-grid-community/core";
     private readonly chartAxisAppliedThemeOverridesProxy;
+    private readonly chartOptionsSeriesProxy;
+    private readonly chartOptionsService;
     private readonly isExpandedOnInit;
@@ -20,5 +22,8 @@ private activePanels;
     private prevRotation;
-    constructor(axisType: 'xAxis' | 'yAxis', { chartController, chartOptionsService, isExpandedOnInit }: FormatPanelOptions);
+    constructor(axisType: 'xAxis' | 'yAxis', { chartController, chartOptionsService, isExpandedOnInit, seriesType }: FormatPanelOptions);
     private init;
     private getAxisTypeSelectParams;
+    private refreshAxisTypeSelect;
+    private getAxisTypeSelectOptions;
+    private isCategoryAxis;
     private getAxisPositionSelectParams;
@@ -25,0 +30,0 @@ private getAxisTimeFormatSelectParams;

dist/types/src/charts/chartComp/menu/format/chart/chartPanel.d.ts

@@ -6,7 +6,14 @@ import { Component } from "@ag-grid-community/core";
     private chartTranslationService;
-    private readonly chartMenuUtils;
+    private chartMenuService;
+    private readonly chartMenuParamsFactory;
     private readonly chartController;
     private readonly isExpandedOnInit;
-    constructor({ chartController, chartMenuParamsFactory: chartMenuUtils, isExpandedOnInit }: FormatPanelOptions);
+    private readonly chartOptionsSeriesProxy;
+    private chartSeriesMenuParamsFactory;
+    private directionSelect?;
+    constructor({ chartController, chartMenuParamsFactory, isExpandedOnInit, chartOptionsService, seriesType }: FormatPanelOptions);
     private init;
+    private refresh;
+    private createDirectionSelect;
+    private updateDirectionSelect;
 }

dist/types/src/charts/chartComp/menu/format/series/seriesPanel.d.ts

@@ -12,7 +12,6 @@ import { Component } from "@ag-grid-community/core";
     private chartOptions;
-    private seriesSelectOptions;
     private activePanels;
     private seriesType;
-    private widgetFuncs;
-    private seriesWidgetMappings;
+    private readonly widgetFuncs;
+    private readonly seriesWidgetMappings;
     constructor({ chartController, chartOptionsService, seriesType, isExpandedOnInit }: FormatPanelOptions);
@@ -38,6 +37,7 @@ private init;
     private initTileSpacingPanel;
+    private initGroupType;
     private addWidget;
-    private getChartSeriesType;
     private getSeriesSelectOptions;
     private updateSeriesType;
+    private getActiveSeriesTypes;
     private translate;
@@ -44,0 +44,0 @@ private destroyActivePanels;

dist/types/src/charts/chartComp/model/chartDataModel.d.ts

@@ -1,3 +0,4 @@
-import { BeanStub, CellRange, ChartType, Column, IAggFunc, SeriesChartType } from "@ag-grid-community/core";
+import { BeanStub, ChartType, Column, IAggFunc, SeriesChartType, PartialCellRange, CellRange, SeriesGroupType } from "@ag-grid-community/core";
 import { ComboChartModel } from "./comboChartModel";
+import { AgCartesianAxisType } from "ag-charts-community";
 export interface ColState {
@@ -12,3 +13,3 @@ column?: Column;
     chartId: string;
-    pivotChart: boolean;
+    pivotChart?: boolean;
     chartType: ChartType;
@@ -18,7 +19,8 @@ chartThemeName: string;
     aggFunc?: string | IAggFunc;
-    cellRange: CellRange;
-    suppressChartRanges: boolean;
+    cellRange: PartialCellRange;
+    suppressChartRanges?: boolean;
     unlinkChart?: boolean;
     crossFiltering?: boolean;
     seriesChartTypes?: SeriesChartType[];
+    seriesGroupType?: SeriesGroupType;
 }
@@ -35,2 +37,3 @@ export declare class ChartDataModel extends BeanStub {
     pivotChart: boolean;
+    categoryAxisType?: AgCartesianAxisType;
     chartType: ChartType;
@@ -40,2 +43,3 @@ chartThemeName: string;
     chartData: any[];
+    groupChartData: any[] | undefined;
     valueColState: ColState[];
@@ -51,7 +55,9 @@ dimensionColState: ColState[];
     private datasource;
-    referenceCellRange: CellRange;
-    suppliedCellRange: CellRange;
+    referenceCellRange: PartialCellRange;
+    suppliedCellRange: PartialCellRange;
     crossFiltering: boolean;
     private grouping;
+    seriesGroupType?: SeriesGroupType;
     constructor(params: ChartModelParams);
+    private setParams;
     private init;
@@ -58,0 +64,0 @@ updateModel(params: ChartModelParams): void;

dist/types/src/charts/chartComp/services/chartColumnService.d.ts

@@ -5,3 +5,5 @@ import { BeanStub, Column } from "@ag-grid-community/core";
     private readonly valueService;
-    private readonly rowRenderer;
+    private rowPositionUtils;
+    private valueColsWithoutSeriesType;
+    private postConstruct;
     getColumn(colId: string): Column | null;
@@ -18,4 +20,5 @@ getAllDisplayedColumns(): Column[];
     };
-    private isNumberCol;
+    private isInferredValueCol;
     private extractLeafData;
+    protected destroy(): void;
 }

dist/types/src/charts/chartComp/services/chartOptionsService.d.ts

 import { AgChartThemeOverrides, BeanStub, ChartType } from "@ag-grid-community/core";
-import { AgChartOptions } from "ag-charts-community";
+import { AgChartOptions, AgCartesianAxesTheme, AgPolarAxesTheme, AgCartesianAxisOptions } from "ag-charts-community";
 import { ChartController } from "../chartController";
-import { AgChartActual } from "../utils/integration";
+import { AgChartActual, AgChartAxisType } from "../utils/integration";
 import { ChartSeriesType } from "../utils/seriesTypeMapper";
@@ -15,2 +15,5 @@ export interface ChartOptionsProxy {
 type ChartAxis = NonNullable<AgChartActual['axes']>[number];
+type AgPolarAxisThemeOverrides = NonNullable<AgPolarAxesTheme[keyof AgPolarAxesTheme]>;
+type AgCartesianAxisThemeOverrides = NonNullable<AgCartesianAxesTheme[keyof AgCartesianAxesTheme]>;
+type AgChartAxisThemeOverrides = AgCartesianAxisThemeOverrides | AgPolarAxisThemeOverrides;
 export declare class ChartOptionsService extends BeanStub {
@@ -29,2 +32,13 @@ private readonly chartController;
     getPersistedChartThemeOverrides(existingChartOptions: AgChartOptions, existingAxes: ChartAxis[] | undefined, existingChartType: ChartType, targetChartType: ChartType): AgChartThemeOverrides;
+    assignPersistedAxisOverrides(params: {
+        existingAxes: ChartAxis[];
+        retainedChartAxisThemeOverrideKeys: {
+            expression: keyof AgChartAxisThemeOverrides | string;
+            targetAxisTypes: AgChartAxisType[];
+        }[];
+        existingChartOptions: AgChartOptions;
+        targetChartOptions: AgChartOptions;
+        existingChartType: ChartType;
+        targetChartType: ChartType;
+    }): void;
     private getRetainedChartThemeOverrideKeys;
@@ -43,2 +57,4 @@ private getRetainedChartAxisThemeOverrideKeys;
     private setCartesianAxisOptions;
+    private updateCartesianAxisOptions;
+    setCartesianCategoryAxisType(axisType: 'xAxis' | 'yAxis', value: AgCartesianAxisOptions['type']): void;
     private getCartesianAxis;
@@ -45,0 +61,0 @@ private getSeriesOption;

dist/types/src/charts/chartComp/services/chartTranslationService.d.ts

@@ -230,4 +230,11 @@ import { BeanStub } from "@ag-grid-community/core";
         avg: string;
+        direction: string;
+        horizontal: string;
+        vertical: string;
+        seriesGroupType: string;
+        groupedSeriesGroupType: string;
+        stackedSeriesGroupType: string;
+        normalizedSeriesGroupType: string;
     };
     translate(toTranslate: ChartTranslationKey): string;
 }

dist/types/src/charts/chartComp/utils/integration.d.ts

@@ -19,8 +19,4 @@ import { _Scene, AgCartesianAxisType, AgChartInstance, AgPolarAxisOptions } from "ag-charts-community";
     }[];
-    scene: {
-        canvas: {
-            element: HTMLCanvasElement;
-        };
-        getDataURL(type?: string): string;
-    };
+    canvasElement: HTMLCanvasElement;
+    getCanvasDataURL(type?: string): string;
     addEventListener(type: 'click', cb: (even: any) => void): void;
@@ -27,0 +23,0 @@ waitForUpdate(): Promise<void>;

dist/types/src/charts/chartComp/utils/seriesTypeMapper.d.ts

@@ -1,18 +0,20 @@
-import { ChartType } from "@ag-grid-community/core";
-export type ChartSeriesType = 'cartesian' | 'column' | 'bar' | 'line' | 'area' | 'scatter' | 'histogram' | 'polar' | 'pie' | 'donut' | 'hierarchy' | 'bubble' | 'radial-column' | 'radial-bar' | 'radar-line' | 'radar-area' | 'nightingale' | 'range-bar' | 'range-area' | 'box-plot' | 'treemap' | 'sunburst' | 'heatmap' | 'waterfall' | 'common';
-export declare const VALID_SERIES_TYPES: ChartSeriesType[];
+import { ChartType, ChartMappings } from "@ag-grid-community/core";
+import { AgChartThemeOverrides } from "ag-charts-community";
+export type ChartSeriesType = typeof ChartMappings.CHART_TYPE_TO_SERIES_TYPE[keyof typeof ChartMappings.CHART_TYPE_TO_SERIES_TYPE] & keyof AgChartThemeOverrides;
+export type ChartThemeOverridesSeriesType = keyof AgChartThemeOverrides & (ChartSeriesType | 'common');
+export declare function isSeriesType(seriesType: ChartSeriesType): boolean;
+export declare function isComboChart(chartType: ChartType): boolean;
 export declare function isEnterpriseChartType(chartType: ChartType): boolean;
-export declare function isHorizontal(chartType: ChartType): boolean;
 export declare function isStacked(chartType: ChartType): boolean;
-export declare function isCartesian(chartType: ChartType): boolean;
-export declare function isPolar(chartType: ChartType): boolean;
-export declare function isRadial(chartType: ChartType): boolean;
-export declare function isHierarchical(chartType: ChartType): boolean;
-export declare function hasGradientLegend(chartType: ChartType): boolean;
+export declare function isCartesian(seriesType: ChartSeriesType): boolean;
+export declare function isPolar(seriesType: ChartSeriesType): boolean;
+export declare function isRadial(seriesType: ChartSeriesType): boolean;
+export declare function isHierarchical(seriesType: ChartSeriesType): boolean;
 export declare function getCanonicalChartType(chartType: ChartType): Exclude<ChartType, 'doughnut'>;
+export declare function getSeriesTypeIfExists(chartType: ChartType): ChartSeriesType | undefined;
 export declare function getSeriesType(chartType: ChartType): ChartSeriesType;
-export type PieChartSeriesType = Extract<ChartSeriesType, 'pie' | 'donut'>;
-export declare function isPieChartSeries(seriesType: ChartSeriesType): seriesType is PieChartSeriesType;
+export declare function isPieChartSeries(seriesType: ChartSeriesType): boolean;
 export declare function getMaxNumCategories(chartType: ChartType): number | undefined;
 export declare function getMaxNumSeries(chartType: ChartType): number | undefined;
 export declare function supportsInvertedCategorySeries(chartType: ChartType): boolean;
+export declare function canSwitchDirection(chartType: ChartType): boolean;

dist/types/src/charts/chartService.d.ts

@@ -1,2 +0,3 @@
-import { BeanStub, ChartDownloadParams, ChartModel, ChartRef, ChartType, CreateCrossFilterChartParams, CreatePivotChartParams, CreateRangeChartParams, GetChartImageDataUrlParams, IChartService, OpenChartToolPanelParams, UpdateChartParams } from "@ag-grid-community/core";
+import { BaseCreateChartParams, BeanStub, ChartDownloadParams, ChartModel, ChartRef, ChartType, CreateCrossFilterChartParams, CreatePivotChartParams, CreateRangeChartParams, GetChartImageDataUrlParams, IAggFunc, IChartService, OpenChartToolPanelParams, PartialCellRange, SeriesChartType, SeriesGroupType, UpdateChartParams } from "@ag-grid-community/core";
+import { AgChartThemeOverrides, AgChartThemePalette } from "ag-charts-community";
 import { GridChartComp } from "./chartComp/gridChartComp";
@@ -6,5 +7,17 @@ export interface CrossFilteringContext {
 }
+export interface CommonCreateChartParams extends BaseCreateChartParams {
+    cellRange: PartialCellRange;
+    pivotChart?: boolean;
+    suppressChartRanges?: boolean;
+    switchCategorySeries?: boolean;
+    aggFunc?: string | IAggFunc;
+    crossFiltering?: boolean;
+    chartOptionsToRestore?: AgChartThemeOverrides;
+    chartPaletteToRestore?: AgChartThemePalette;
+    seriesChartTypes?: SeriesChartType[];
+    seriesGroupType?: SeriesGroupType;
+}
 export declare class ChartService extends BeanStub implements IChartService {
-    private rangeService;
     private columnModel;
+    private rangeService?;
     static CHARTS_VERSION: string;
@@ -32,3 +45,4 @@ private activeCharts;
     private generateId;
+    private createCellRange;
     private destroyAllActiveCharts;
 }

dist/types/src/version.d.ts

@@ -1,1 +0,1 @@
-export declare const VERSION = "31.2.1";
+export declare const VERSION = "31.3.0";

package.json

 {
   "name": "@ag-grid-enterprise/charts",
-  "version": "31.2.1",
+  "version": "31.3.0",
   "description": "Advanced Data Grid / Data Table supporting Javascript / Typescript / React / Angular / Vue",
@@ -15,6 +15,6 @@ "main": "./dist/package/main.cjs.js",
   "dependencies": {
-    "@ag-grid-community/core": "31.2.1",
-    "@ag-grid-enterprise/core": "31.2.1",
-    "@ag-grid-enterprise/range-selection": "31.2.1",
-    "ag-charts-community": "9.2.0"
+    "@ag-grid-community/core": "31.3.0",
+    "@ag-grid-enterprise/core": "31.3.0",
+    "@ag-grid-enterprise/range-selection": "31.3.0",
+    "ag-charts-community": "9.3.0"
   },
@@ -21,0 +21,0 @@ "devDependencies": {

No alert changes

Worsened metrics

Total package byte prevSize

1891064

decreased by-0.14%

Number of package files

154

decreased by-1.28%

Lines of code

35289

decreased by-0.5%

Dependency changes

• + Added@ag-grid-community/core@31.3.0(transitive)

• + Added@ag-grid-enterprise/core@31.3.0(transitive)

• + Added@ag-grid-enterprise/range-selection@31.3.0(transitive)

• + Addedag-charts-community@9.3.0(transitive)

• - Removed@ag-grid-community/core@31.2.1(transitive)

• - Removed@ag-grid-enterprise/core@31.2.1(transitive)

• - Removed@ag-grid-enterprise/range-selection@31.2.1(transitive)

• - Removedag-charts-community@9.2.0(transitive)

• Updated@ag-grid-community/core@31.3.0

• Updated@ag-grid-enterprise/core@31.3.0

• Updated@ag-grid-enterprise/range-selection@31.3.0

• Updatedag-charts-community@9.3.0