ag-grid-community - npm Package Compare versions

Comparing version 27.0.1 to 27.1.0

dist/lib/columns/columnApi.d.ts

 import { ColDef, ColGroupDef } from "../entities/colDef";
 import { IHeaderColumn } from "../entities/iHeaderColumn";
-import { ColumnState } from "./columnModel";
+import { ColumnState, ApplyColumnStateParams } from "./columnModel";
 import { ProvidedColumnGroup } from "../entities/providedColumnGroup";
@@ -103,2 +103,3 @@ import { ColumnGroup } from "../entities/columnGroup";
     getSecondaryPivotColumn(pivotKeys: string[], valueColKey: string | Column): Column | null;
+    /** Set the value columns. */
     setValueColumns(colKeys: (string | Column)[]): void;
@@ -191,9 +192,1 @@ /** Get value columns. */
 }
-export interface ApplyColumnStateParams {
-    /** The state from `getColumnState` */
-    state?: ColumnState[];
-    /** Whether column order should be applied */
-    applyOrder?: boolean;
-    /** State to apply to columns where state is missing for those columns */
-    defaultState?: ColumnState;
-}

dist/lib/columns/columnModel.d.ts

@@ -10,3 +10,2 @@ import { ColumnGroup } from '../entities/columnGroup';
 import { RowNode } from '../entities/rowNode';
-import { ApplyColumnStateParams } from './columnApi';
 export interface ColumnResizeSet {
@@ -17,5 +16,3 @@ columns: Column[];
 }
-export interface ColumnState {
-    /** ID of the column */
-    colId?: string;
+export interface ColumnStateParams {
     /** True if the column is hidden */
@@ -44,2 +41,14 @@ hide?: boolean | null;
 }
+export interface ColumnState extends ColumnStateParams {
+    /** ID of the column */
+    colId: string;
+}
+export interface ApplyColumnStateParams {
+    /** The state from `getColumnState` */
+    state?: ColumnState[];
+    /** Whether column order should be applied */
+    applyOrder?: boolean;
+    /** State to apply to columns where state is missing for those columns */
+    defaultState?: ColumnStateParams;
+}
 export declare class ColumnModel extends BeanStub {
@@ -120,4 +129,6 @@ private expressionService;
     onAutoGroupColumnDefChanged(): void;
+    onDefaultColDefChanged(): void;
     getColDefVersion(): number;
     setColumnDefs(columnDefs: (ColDef | ColGroupDef)[], source?: ColumnEventType): void;
+    private createColumnsFromColumnDefs;
     private dispatchNewColumnsLoaded;
@@ -124,0 +135,0 @@ private dispatchEverythingChanged;

dist/lib/components/componentUtil.d.ts

@@ -17,3 +17,3 @@ import { GridOptions } from '../entities/gridOptions';
     static getEventCallbacks(): string[];
-    static copyAttributesToGridOptions(gridOptions: GridOptions, component: any, skipEventDeprecationCheck?: boolean): GridOptions;
+    static copyAttributesToGridOptions(gridOptions: GridOptions | undefined, component: any, skipEventDeprecationCheck?: boolean): GridOptions;
     static getCallbackForEvent(eventName: string): string;
@@ -20,0 +20,0 @@ static processOnChange(changes: any, gridOptions: GridOptions, api: GridApi, columnApi: ColumnApi): void;

dist/lib/components/framework/userComponentFactory.d.ts

@@ -28,2 +28,4 @@ import { BeanStub } from "../../context/beanStub";
     type: ComponentType;
+    popupFromSelector?: boolean;
+    popupPositionFromSelector?: string;
     newAgStackInstance: () => AgPromise<any>;
@@ -30,0 +32,0 @@ }

dist/lib/entities/colDef.d.ts

@@ -622,2 +622,6 @@ import { ColumnApi } from "../columns/columnApi";
     params?: any;
+    /** Equivalent of setting `colDef.cellEditorPopup` */
+    popup?: boolean;
+    /** Equivalent of setting `colDef.cellEditorPopupPosition` */
+    popupPosition?: string;
 }

dist/lib/entities/rowNode.d.ts

@@ -195,2 +195,3 @@ import { AgEvent } from "../events";
     setId(id?: string): void;
+    getGroupKeys(excludeSelf?: boolean): string[];
     isPixelInRange(pixel: number): boolean;
@@ -197,0 +198,0 @@ setFirstChild(firstChild: boolean): void;

dist/lib/entities/sideBar.d.ts

 export interface ToolPanelDef {
     /** The unique ID for this panel. Used in the API and elsewhere to refer to the panel. */
     id: string;
-    /** The key used for [localisation](/localisation/) for displaying the label. The label is displayed in the tab button. */
+    /** The key used for localisation for displaying the label. The label is displayed in the tab button. */
     labelKey: string;
@@ -14,3 +14,3 @@ /** The default label if `labelKey` is missing or does not map to valid text through localisation. */
     width?: number;
-    /** The [key of the icon](/custom-icons/) to be used as a graphical aid beside the label in the side bar. */
+    /** The key of the icon to be used as a graphical aid beside the label in the side bar. */
     iconKey: string;
@@ -20,3 +20,3 @@ /**
      * The provided panels use components `agColumnsToolPanel` and `agFiltersToolPanel`.
-     * To provide your own custom panel component, you reference it by name here.
+     * To provide your own custom panel component, you reference it here.
      */
@@ -23,0 +23,0 @@ toolPanel?: any;

dist/lib/eventKeys.d.ts

@@ -68,2 +68,3 @@ export declare class Events {
     static EVENT_CELL_VALUE_CHANGED: string;
+    static EVENT_CELL_EDIT_REQUEST: string;
     static EVENT_ROW_VALUE_CHANGED: string;
@@ -70,0 +71,0 @@ static EVENT_CELL_FOCUSED: string;

dist/lib/events.d.ts

@@ -379,2 +379,7 @@ import { RowNode } from './entities/rowNode';
 }
+export interface CellEditRequestEvent extends CellEvent {
+    oldValue: any;
+    newValue: any;
+    source: string | undefined;
+}
 export interface AsyncTransactionsFlushed extends AgGridEvent {
@@ -381,0 +386,0 @@ /**

dist/lib/filter/floating/floatingFilter.d.ts

@@ -57,3 +57,15 @@ import { IComponent } from '../../interfaces/iComponent';
 export interface IFloatingFilter {
+    /**
+     * Gets called every time the parent filter changes.
+     * Your floating filter would typically refresh its UI to reflect the new filter state.
+     * The provided parentModel is what the parent filter returns from its getModel() method.
+     * The event is the FilterChangedEvent that the grid fires.
+     */
     onParentModelChanged(parentModel: any, filterChangedEvent?: FilterChangedEvent | null): void;
+    /**
+     * A hook to perform any necessary operation just after the GUI for this component has been rendered on the screen.
+     * If a parent popup is closed and reopened (e.g. for filters), this method is called each time the component is shown.
+     * This is useful for any logic that requires attachment before executing, such as putting focus on a particular DOM element.
+     */
+    afterGuiAttached?(): void;
 }
@@ -60,0 +72,0 @@ export interface IFloatingFilterComp<P = any> extends IFloatingFilter, IComponent<IFloatingFilterParams<P>> {

dist/lib/filter/floating/provided/textInputFloatingFilter.d.ts

@@ -14,2 +14,3 @@ import { IFloatingFilterParams } from '../floatingFilter';
     private postConstruct;
+    private resetTemplate;
     protected getDefaultDebounceMs(): number;
@@ -16,0 +17,0 @@ onParentModelChanged(model: ProvidedFilterModel, event: FilterChangedEvent): void;

dist/lib/gridApi.d.ts

@@ -25,3 +25,3 @@ import { ColumnApi } from "./columns/columnApi";
 import { ChartRef, GetChartToolbarItems, GetContextMenuItems, GetMainMenuItems, GetRowNodeIdFunc, GetServerSideGroupKey, GetServerSideStoreParamsParams, IsApplyServerSideTransaction, IsRowMaster, IsRowSelectable, IsServerSideGroup, IsServerSideGroupOpenByDefaultParams, NavigateToNextCellParams, NavigateToNextHeaderParams, PaginationNumberFormatterParams, PostProcessPopupParams, ProcessRowParams, ServerSideStoreParams, TabToNextCellParams, TabToNextHeaderParams, RowClassParams, RowHeightParams } from "./entities/gridOptions";
-import { ChartType } from "./interfaces/iChartOptions";
+import { ChartType, CrossFilterChartType, SeriesChartType } from "./interfaces/iChartOptions";
 import { IToolPanel } from "./interfaces/iToolPanel";
@@ -93,4 +93,8 @@ import { RowNodeTransaction } from "./interfaces/rowNodeTransaction";
     aggFunc?: string | IAggFunc;
+    /** The series chart type configurations used in combination charts */
+    seriesChartTypes?: SeriesChartType[];
 }
 export interface CreateCrossFilterChartParams extends CreateChartParams {
+    /** The type of cross-filter chart to create. */
+    chartType: CrossFilterChartType;
     /** The range of cells to be charted. If no rows / rowIndexes are specified all rows will be included. */
@@ -237,2 +241,4 @@ cellRange: ChartParamsCellRange;
     setAutoGroupColumnDef(colDef: ColDef, source?: ColumnEventType): void;
+    /** Call to set new Default Column Definition. */
+    setDefaultColDef(colDef: ColDef, source?: ColumnEventType): void;
     expireValueCache(): void;
@@ -613,5 +619,5 @@ /**
     /** Navigates the grid focus to the next cell, as if tabbing. */
-    tabToNextCell(): boolean;
+    tabToNextCell(event?: KeyboardEvent): boolean;
     /** Navigates the grid focus to the previous cell, as if shift-tabbing. */
-    tabToPreviousCell(): boolean;
+    tabToPreviousCell(event?: KeyboardEvent): boolean;
     /** Returns the list of active cell renderer instances. */
@@ -618,0 +624,0 @@ getCellRendererInstances(params?: GetCellRendererInstancesParams): ICellRenderer[];

dist/lib/gridBodyComp/navigationService.d.ts

@@ -37,3 +37,3 @@ import { CellPosition } from "../entities/cellPosition";
     onTabKeyDown(previous: CellCtrl | RowCtrl, keyboardEvent: KeyboardEvent): void;
-    tabToNextCell(backwards: boolean): boolean;
+    tabToNextCell(backwards: boolean, event?: KeyboardEvent): boolean;
     private tabToNextCellCommon;
@@ -40,0 +40,0 @@ private moveToNextEditingCell;

dist/lib/gridBodyComp/rowDragFeature.d.ts

@@ -33,2 +33,4 @@ import { DraggingEvent, DragSourceType, DropTarget } from "../dragAndDrop/dragAndDropService";
     private rangeService;
+    private columnApi;
+    private gridApi;
     private clientSideRowModel;
@@ -35,0 +37,0 @@ private eContainer;

dist/lib/gridOptionsWrapper.d.ts

 import { RowNode } from './entities/rowNode';
-import { ChartRef, FillOperationParams, GetChartToolbarItems, GetContextMenuItems, GetMainMenuItems, GetRowNodeIdFunc, GetServerSideStoreParamsParams, GridOptions, IsApplyServerSideTransaction, IsGroupOpenByDefaultParams, IsRowMaster, IsRowSelectable, IsServerSideGroupOpenByDefaultParams, NavigateToNextCellParams, NavigateToNextHeaderParams, PaginationNumberFormatterParams, PostProcessPopupParams, ProcessDataFromClipboardParams, ServerSideStoreParams, TabToNextCellParams, TabToNextHeaderParams } from './entities/gridOptions';
+import { ChartRef, FillOperationParams, GetChartToolbarItems, GetContextMenuItems, GetMainMenuItems, GetServerSideStoreParamsParams, GridOptions, IsApplyServerSideTransaction, IsGroupOpenByDefaultParams, IsRowMaster, IsRowSelectable, IsServerSideGroupOpenByDefaultParams, NavigateToNextCellParams, NavigateToNextHeaderParams, PaginationNumberFormatterParams, PostProcessPopupParams, ProcessDataFromClipboardParams, ServerSideStoreParams, TabToNextCellParams, TabToNextHeaderParams, GetRowIdFunc } from './entities/gridOptions';
 import { GridApi } from './gridApi';
@@ -191,2 +191,3 @@ import { ColDef, ColGroupDef, IAggFunc, SuppressKeyboardEventParams } from './entities/colDef';
     getColumnApi(): ColumnApi | undefined | null;
+    isReadOnlyEdit(): boolean;
     isImmutableData(): boolean;
@@ -231,2 +232,3 @@ isEnsureDomOrder(): boolean;
     isSuppressColumnVirtualisation(): boolean;
+    isSuppressRowVirtualisation(): boolean;
     isSuppressContextMenu(): boolean;
@@ -298,3 +300,3 @@ isAllowContextMenuWithControlKey(): boolean;
     getMainMenuItemsFunc(): GetMainMenuItems | undefined;
-    getRowNodeIdFunc(): GetRowNodeIdFunc | undefined;
+    getRowIdFunc(): GetRowIdFunc | undefined;
     getNavigateToNextHeaderFunc(): ((params: NavigateToNextHeaderParams) => (HeaderPosition | null)) | undefined;
@@ -329,3 +331,3 @@ getTabToNextHeaderFunc(): ((params: TabToNextHeaderParams) => (HeaderPosition | null)) | undefined;
     getChartThemes(): string[];
-    getClipboardDeliminator(): string;
+    getClipboardDelimiter(): string;
     setProperty(key: string, value: any, force?: boolean): void;
@@ -358,3 +360,5 @@ addEventListener(key: string, listener: Function): void;
     globalEventHandler(eventName: string, event?: any): void;
+    private setRowHeightVariable;
     getRowHeightAsNumber(): number;
+    isGetRowHeightFunction(): boolean;
     getRowHeightForNode(rowNode: RowNode, allowEstimate?: boolean, defaultRowHeight?: number): {
@@ -361,0 +365,0 @@ height: number;

dist/lib/interfaces/iAfterGuiAttachedParams.d.ts

 export declare type ContainerType = 'columnMenu' | 'contextMenu' | 'toolPanel' | 'floatingFilter';
 export interface IAfterGuiAttachedParams {
+    /** Where this component is attached to. */
     container?: ContainerType;
+    /**
+     * Call this to hide the popup.
+     * i.e useful if your component has an action button and you want to hide the popup after it is pressed.
+     */
     hidePopup?: () => void;
+    /** Set to `true` to not have the component focus its default item. */
     suppressFocus?: boolean;
 }

dist/lib/interfaces/iAgChartOptions.d.ts

@@ -5,32 +5,75 @@ export declare type FontStyle = 'normal' | 'italic' | 'oblique';
 export interface AgChartThemePalette {
+    /** The array of fills to be used. */
     fills: string[];
+    /** The array of strokes to be used. */
     strokes: string[];
 }
 export interface AgChartThemeOptions {
+    /** The palette to use. If specified, this replaces the palette from the base theme. */
     palette?: AgChartThemePalette;
+    /** Configuration from this object is merged over the defaults specified in the base theme. */
     overrides?: AgChartThemeOverrides;
 }
+/** This object is used to define the configuration for a custom chart theme. */
 export interface AgChartTheme extends AgChartThemeOptions {
+    /**
+     * The name of the theme to base your theme on. Your custom theme will inherit all of the configuration from
+     * the base theme, allowing you to override just the settings you wish to change using the `overrides` config (see
+     * below).
+     */
     baseTheme?: AgChartThemeName;
 }
 export interface AgChartThemeOverrides {
-    cartesian?: AgCartesianChartOptions<AgCartesianAxesTheme, AgCartesianSeriesTheme>;
-    column?: AgCartesianChartOptions<AgCartesianAxesTheme, AgBarSeriesOptions>;
-    bar?: AgCartesianChartOptions<AgCartesianAxesTheme, AgBarSeriesOptions>;
-    line?: AgCartesianChartOptions<AgCartesianAxesTheme, AgLineSeriesOptions>;
-    area?: AgCartesianChartOptions<AgCartesianAxesTheme, AgAreaSeriesOptions>;
-    scatter?: AgCartesianChartOptions<AgCartesianAxesTheme, AgScatterSeriesOptions>;
-    histogram?: AgCartesianChartOptions<AgCartesianAxesTheme, AgHistogramSeriesOptions>;
-    polar?: AgPolarChartOptions<AgPolarSeriesTheme>;
-    pie?: AgPolarChartOptions<AgPieSeriesOptions>;
-    hierarchy?: AgHierarchyChartOptions<AgHierarchySeriesTheme>;
-    treemap?: AgHierarchyChartOptions<AgHierarchySeriesOptions>;
+    /** Specifies defaults for all cartesian charts (used for bar, column, histogram, line, scatter and area series) */
+    cartesian?: AgCartesianThemeOptions<AgCartesianSeriesTheme>;
+    /** Specifies defaults for column charts. */
+    column?: AgCartesianThemeOptions<AgBarSeriesOptions>;
+    /** Specifies defaults for bar charts. */
+    bar?: AgCartesianThemeOptions<AgBarSeriesOptions>;
+    /** Specifies defaults for line charts. */
+    line?: AgCartesianThemeOptions<AgLineSeriesOptions>;
+    /** Specifies defaults for area charts. */
+    area?: AgCartesianThemeOptions<AgAreaSeriesOptions>;
+    /** Specifies defaults for scatter/bubble charts. */
+    scatter?: AgCartesianThemeOptions<AgScatterSeriesOptions>;
+    /** Specifies defaults for histogram charts. */
+    histogram?: AgCartesianThemeOptions<AgHistogramSeriesOptions>;
+    /** Specifies defaults for all polar charts (used for pie series) */
+    polar?: AgPolarThemeOptions<AgPolarSeriesTheme>;
+    /** Specifies defaults for pie/doughnut charts. */
+    pie?: AgPolarThemeOptions<AgPieSeriesOptions>;
+    /** Specifies defaults for all hierarchy charts (used for treemap series) */
+    hierarchy?: AgHierarchyThemeOptions<AgHierarchySeriesTheme>;
+    /** Specifies defaults for all treemap charts. */
+    treemap?: AgHierarchyThemeOptions<AgHierarchySeriesOptions>;
+    /** Specifies defaults for all chart types. Be careful to only use properties that apply to all chart types here. For example, don't specify `navigator` configuration here as navigators are only available in cartesian charts. */
     common?: any;
 }
+/** This is the configuration shared by all types of axis. */
 export interface AgCartesianAxisThemeOptions<T> {
-    top?: Omit<T, 'top' | 'type'>;
-    right?: Omit<T, 'right' | 'type'>;
-    bottom?: Omit<T, 'bottom' | 'type'>;
-    left?: Omit<T, 'left' | 'type'>;
+    /** An object with axis theme overrides for the `top` positioned axes. Same configs apply here as one level above. For example, to rotate labels by 45 degrees in 'top' positioned axes one can use `top: { label: { rotation: 45 } } }`. */
+    top?: Omit<T, 'position' | 'type'>;
+    /** An object with axis theme overrides for the `right` positioned axes. Same configs apply here as one level above. */
+    right?: Omit<T, 'position' | 'type'>;
+    /** An object with axis theme overrides for the `bottom` positioned axes. Same configs apply here as one level above. */
+    bottom?: Omit<T, 'position' | 'type'>;
+    /** An object with axis theme overrides for the `left` positioned axes. Same configs apply here as one level above. */
+    left?: Omit<T, 'position' | 'type'>;
 }
+export interface AgCartesianThemeOptions<S = AgCartesianSeriesTheme> extends AgBaseChartOptions {
+    /** Axis configurations. */
+    axes?: AgCartesianAxesTheme;
+    /** Series configurations. */
+    series?: S;
+    /** Configuration for the chart navigator. */
+    navigator?: AgNavigatorOptions;
+}
+export interface AgPolarThemeOptions<S = AgPolarSeriesTheme> extends AgBaseChartOptions {
+    /** Series configurations. */
+    series?: S;
+}
+export interface AgHierarchyThemeOptions<S = AgHierarchySeriesTheme> extends AgBaseChartOptions {
+    /** Series configurations. */
+    series?: S;
+}
 export interface AgNumberAxisThemeOptions extends Omit<AgNumberAxisOptions, 'type'>, AgCartesianAxisThemeOptions<AgNumberAxisOptions> {
@@ -47,6 +90,11 @@ }
 export interface AgCartesianAxesTheme {
+    /** This extends the common axis configuration with options specific to number axes. */
     number?: AgNumberAxisThemeOptions;
+    /** This extends the common axis configuration with options specific to number axes. */
     log?: AgLogAxisThemeOptions;
+    /** This extends the common axis configuration with options specific to category axes. */
     category?: AgCategoryAxisThemeOptions;
+    /** This extends the common axis configuration with options specific to grouped category axes. Currently there are no additional options beyond the common configuration. */
     groupedCategory?: AgGroupedCategoryAxisThemeOptions;
+    /** This extends the common axis configuration with options specific to time axes. */
     time?: AgTimeAxisThemeOptions;
@@ -69,55 +117,96 @@ }
 export interface AgChartPaddingOptions {
+    /** The number of pixels of padding at the top of the chart area. */
     top?: number;
+    /** The number of pixels of padding at the right of the chart area. */
     right?: number;
+    /** The number of pixels of padding at the bottom of the chart area. */
     bottom?: number;
+    /** The number of pixels of padding at the left of the chart area. */
     left?: number;
 }
 export interface AgChartLabelOptions {
+    /** Whether or not the labels should be shown. */
     enabled?: boolean;
+    /** The font style to use for the labels. */
     fontStyle?: FontStyle;
+    /** The font weight to use for the labels. */
     fontWeight?: FontWeight;
+    /** The font size in pixels to use for the labels. */
     fontSize?: number;
+    /** The font family to use for the labels. */
     fontFamily?: string;
+    /** The colour to use for the labels. */
     color?: string;
 }
 export interface AgDropShadowOptions {
+    /** Whether or not the shadow is visible. */
     enabled?: boolean;
+    /** The colour of the shadow. */
     color?: string;
+    /** The horizontal offset in pixels for the shadow. */
     xOffset?: number;
+    /** The vertical offset in pixels for the shadow. */
     yOffset?: number;
+    /** The radius of the shadow's blur, given in pixels. */
     blur?: number;
 }
 export interface AgChartCaptionOptions {
+    /** Whether or not the title should be shown. */
     enabled?: boolean;
     padding?: AgChartPaddingOptions;
+    /** The text to show in the title. */
     text?: string;
+    /** The font style to use for the title. */
     fontStyle?: FontStyle;
+    /** The font weight to use for the title. */
     fontWeight?: FontWeight;
+    /** The font size in pixels to use for the title. */
     fontSize?: number;
+    /** The font family to use for the title. */
     fontFamily?: string;
+    /** The colour to use for the title. */
     color?: string;
 }
 export interface AgNavigatorMaskOptions {
+    /** The fill colour used by the mask. */
     fill?: string;
+    /** The stroke colour used by the mask. */
     stroke?: string;
+    /** The stroke width used by the mask. */
     strokeWidth?: number;
+    /** The opacity of the mask's fill in the `[0, 1]` interval, where `0` is effectively no masking. */
     fillOpacity?: number;
 }
 export interface AgNavigatorHandleOptions {
+    /** The fill colour used by the handle. */
     fill?: string;
+    /** The stroke colour used by the handle. */
     stroke?: string;
+    /** The stroke width used by the handle. */
     strokeWidth?: number;
+    /** The width of the handle. */
     width?: number;
+    /** The height of the handle. */
     height?: number;
+    /** The distance between the handle's grip lines. */
     gripLineGap?: number;
+    /** The length of the handle's grip lines. */
     gripLineLength?: number;
 }
 export interface AgNavigatorOptions {
+    /** Whether or not to show the navigator. */
     enabled?: boolean;
+    /** The height of the navigator. */
     height?: number;
+    /** The distance between the navigator and the bottom axis. */
     margin?: number;
+    /** The start of the visible range in the `[0, 1]` interval. */
     min?: number;
+    /** The end of the visible range in the `[0, 1]` interval. */
     max?: number;
+    /** Configuration for the navigator's visible range mask. */
     mask?: AgNavigatorMaskOptions;
+    /** Configuration for the navigator's left handle. */
     minHandle?: AgNavigatorHandleOptions;
+    /** Configuration for the navigator's right handle. */
     maxHandle?: AgNavigatorHandleOptions;
@@ -127,51 +216,93 @@ }
 export interface AgChartLegendMarkerOptions {
+    /** The size in pixels of the markers in the legend. */
     size?: number;
+    /** If set, overrides the marker shape from the series and the legend will show the specified marker shape instead. If not set, will use a marker shape matching the shape from the series, or fall back to `'square'` if there is none. */
     shape?: string | (new () => any);
+    /** The padding in pixels between a legend marker and the corresponding label. */
     padding?: number;
+    /** The width in pixels of the stroke for markers in the legend. */
     strokeWidth?: number;
 }
 export interface AgChartLegendLabelOptions {
+    /** The colour of the text. */
     color?: string;
+    /** The font style to use for the legend. */
     fontStyle?: FontStyle;
+    /** The font weight to use for the legend. */
     fontWeight?: FontWeight;
+    /** The font size in pixels to use for the legend. */
     fontSize?: number;
+    /** The font family to use for the legend. */
     fontFamily?: string;
+    /** Function used to render legend labels. Where `id` is a series ID, `itemId` is component ID within a series, such as a field name or an item index. */
+    formatter?: (id: string, itemId: any, value: string) => string;
 }
 export interface AgChartLegendItemOptions {
+    /** Configuration for the legend markers. */
     marker?: AgChartLegendMarkerOptions;
+    /** Configuration for the legend labels. */
     label?: AgChartLegendLabelOptions;
+    /** The horizontal spacing in pixels to use between legend items. */
     paddingX?: number;
+    /** The vertical spacing in pixels to use between legend items. */
     paddingY?: number;
 }
 export interface AgChartLegendOptions {
+    /** Whether or not to show the legend. */
     enabled?: boolean;
+    /** Where the legend should show in relation to the chart. */
     position?: AgChartLegendPosition;
+    /** The spacing in pixels to use outside the legend. */
     spacing?: number;
+    /** Configuration for the legend items that consist of a marker and a label. */
     item?: AgChartLegendItemOptions;
 }
 export interface AgChartTooltipOptions {
+    /** Set to false to disable tooltips for all series in the chart. */
     enabled?: boolean;
+    /** A class name to be added to the tooltip element of the chart. */
     class?: string;
+    /** If true, for series with markers the tooltip will be shown to the closest marker. */
     tracking?: boolean;
+    /** The time interval (in milliseconds) after which the tooltip is shown. */
     delay?: number;
 }
+export interface AgChartBackground {
+    /** Whether or not the background should be visible. */
+    visible?: boolean;
+    /** Colour of the chart background. */
+    fill?: string;
+}
+export interface AgBaseChartListeners {
+    /** The listener to call when a node (marker, column, bar, tile or a pie slice) in any series is clicked. In case a chart has multiple series, the chart's `seriesNodeClick` event can be used to listen to `nodeClick` events of all the series at once. */
+    seriesNodeClick: (type: 'seriesNodeClick', series: any, datum: any, xKey: string, yKey: string) => any;
+    /** Generic listeners. */
+    [key: string]: Function;
+}
+/** Configuration common to all charts.  */
 export interface AgBaseChartOptions {
+    /** The data to render the chart from. If this is not specified, it must be set on individual series instead. */
+    data?: any[];
+    /** The element to place the rendered chart into.<br/><strong>Important:</strong> make sure to read the `autoSize` config description for information on how the container element affects the chart size (by default). */
     container?: HTMLElement | null;
-    data?: any[];
+    /** The width of the chart in pixels. Has no effect if `autoSize` is set to `true`. */
     width?: number;
+    /** The height of the chart in pixels. Has no effect if `autoSize` is set to `true`. */
     height?: number;
+    /** By default, the chart will resize automatically to fill the container element. Set this to `false` to disable this behaviour. If either the `width` or `height` are set, auto-sizing will be disabled unless this is explicitly set to `true`.<br/><strong>Important:</strong> if this config is set to `true`, make sure to give the chart's `container` element an explicit size, otherwise you will run into a chicken and egg situation where the container expects to size itself according to the content and the chart expects to size itself according to the container. */
     autoSize?: boolean;
+    /** Configuration for the padding shown around the chart. */
     padding?: AgChartPaddingOptions;
-    background?: {
-        visible?: boolean;
-        fill?: string;
-    };
+    /** Configuration for the background shown behind the chart. */
+    background?: AgChartBackground;
+    /** Configuration for the title shown at the top of the chart. */
     title?: AgChartCaptionOptions;
+    /** Configuration for the subtitle shown beneath the chart title. Note: a subtitle will only be shown if a title is also present. */
     subtitle?: AgChartCaptionOptions;
+    /** Global configuration that applies to all tooltips in the chart. */
     tooltip?: AgChartTooltipOptions;
-    navigator?: AgNavigatorOptions;
+    /** Configuration for the chart legend. */
     legend?: AgChartLegendOptions;
-    listeners?: {
-        [key: string]: Function;
-    };
+    /** A map of event names to event listeners. */
+    listeners?: AgBaseChartListeners;
     theme?: string | AgChartTheme;
@@ -181,12 +312,20 @@ }
     keys?: string[];
+    /** If set to a non-zero value, the axis will have the specified thickness regardless of label size. */
+    thickness?: number;
 }
 export declare type AgCartesianAxisPosition = 'top' | 'right' | 'bottom' | 'left';
 export interface AgAxisLineOptions {
+    /** The width in pixels of the axis line. */
     width?: number;
+    /** The colour of the axis line. */
     color?: string;
 }
 export interface AgAxisTickOptions {
+    /** The width in pixels of the axis ticks (and corresponding grid line). */
     width?: number;
+    /** The length in pixels of the axis ticks. */
     size?: number;
+    /** The colour of the axis ticks. */
     color?: string;
+    /** A hint of how many ticks to use across an axis. The axis is not guaranteed to use exactly this number of ticks, but will try to use a number of ticks that is close to the number given.<br/><br/>If the axis is a `time` axis, the following intervals from the `agCharts.time` namespace can be used: `millisecond, second, minute, hour, day, sunday, monday, tuesday, wednesday, thursday, friday, saturday, month, year, utcMinute, utcHour, utcDay, utcMonth, utcYear`. And derived intervals can be created by using the `every` method on the default ones. For example, `agCharts.time.month.every(2)` will return a derived interval that will make the axis place ticks for every other month.<br/><br/> */
     count?: any;
@@ -201,23 +340,41 @@ }
 export interface AgAxisLabelOptions {
+    /** The font style to use for the labels. */
     fontStyle?: FontStyle;
+    /** The font weight to use for the labels. */
     fontWeight?: FontWeight;
+    /** The font size in pixels to use for the labels. */
     fontSize?: number;
+    /** The font family to use for the labels */
     fontFamily?: string;
+    /** Padding in pixels between the axis label and the tick. */
     padding?: number;
+    /** The colour to use for the labels */
     color?: string;
+    /** The rotation of the axis labels in degrees. Note: for integrated charts the default is 335 degrees, unless the axis shows grouped or default categories (indexes). The first row of labels in a grouped category axis is rotated perpendicular to the axis line. */
     rotation?: number;
+    /** Format string used when rendering labels for time axes. For more information on the structure of the string, <a href=\"../axes/#time-label-format-string\">click here</a> */
     format?: string;
+    /** Function used to render axis labels. If `value` is a number, `fractionDigits` will also be provided, which indicates the number of fractional digits used in the step between ticks; for example, a tick step of `0.0005` would have `fractionDigits` set to `4` */
     formatter?: (params: AgAxisLabelFormatterParams) => string;
 }
 export interface AgAxisGridStyle {
+    /** The colour of the grid line. */
     stroke?: string;
+    /** Defines how the gridlines are rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
 }
 export declare type AgCartesianAxisType = 'category' | 'groupedCategory' | 'number' | 'log' | 'time';
+/** Configuration for axes in cartesian charts. */
 export interface AgBaseCartesianAxisOptions extends AgBaseAxisOptions {
+    /** The position on the chart where the axis should be rendered. */
     position?: AgCartesianAxisPosition;
+    /** Configuration for the title shown next to the axis. */
     title?: AgChartCaptionOptions;
+    /** Configuration for the axis line. */
     line?: AgAxisLineOptions;
+    /** Configuration for the axis ticks. */
     tick?: AgAxisTickOptions;
+    /** Configuration for the axis labels, shown next to the ticks. */
     label?: AgAxisLabelOptions;
+    /** Configuration of the lines used to form the grid in the chart area. */
     gridStyle?: AgAxisGridStyle[];
@@ -227,4 +384,7 @@ }
     type: 'number';
+    /** If 'true', the range will be rounded up to ensure nice equal spacing between the ticks. */
     nice?: boolean;
+    /** User override for the automatically determined min value (based on series data). */
     min?: number;
+    /** User override for the automatically determined max value (based on series data). */
     max?: number;
@@ -234,5 +394,9 @@ }
     type: 'log';
+    /** If 'true', the range will be rounded up to ensure nice equal spacing between the ticks. */
     nice?: boolean;
+    /** User override for the automatically determined min value (based on series data). */
     min?: number;
+    /** User override for the automatically determined max value (based on series data). */
     max?: number;
+    /** The base of the logarithm used. */
     base?: number;
@@ -250,37 +414,70 @@ }
     type: 'time';
+    /** If 'true', the range will be rounded up to ensure nice equal spacing between the ticks. */
     nice?: boolean;
 }
 export declare type AgCartesianAxisOptions = AgNumberAxisOptions | AgLogAxisOptions | AgCategoryAxisOptions | AgGroupedCategoryAxisOptions | AgTimeAxisOptions;
+export interface AgSeriesHighlightMarkerStyle {
+    /** The fill colour of a marker when tapped or hovered over. Use `undefined` for no highlight. */
+    fill?: string;
+    /** The stroke colour of a marker when tapped or hovered over. Use `undefined` for no highlight. */
+    stroke?: string;
+    /** The stroke width of a marker when tapped or hovered over. Use `undefined` for no highlight. */
+    strokeWidth?: number;
+}
+export interface AgSeriesHighlightSeriesStyle {
+    enabled?: boolean;
+    /** The opacity of the whole series (area line, area fill, labels and markers, if any) when another chart series or another stack level in the same area series is highlighted by hovering a data point or a legend item. Use `undefined` or `1` for no dimming. */
+    dimOpacity?: number;
+    /** The stroke width of the area line when one of the markers is tapped or hovered over, or when a tooltip is shown for a data point, even when series markers are disabled. Use `undefined` for no highlight. */
+    strokeWidth?: number;
+}
+export interface AgSeriesHighlightStyle {
+    /**
+     * The fill colour of a marker when tapped or hovered over. Use `undefined` for no highlight.
+     *
+     * @deprecated Use item.fill instead.
+     */
+    fill?: string;
+    /**
+     * The stroke colour of a marker when tapped or hovered over. Use `undefined` for no highlight.
+     *
+     * @deprecated Use item.stroke instead.
+     */
+    stroke?: string;
+    /**
+     * The stroke width of a marker when tapped or hovered over. Use `undefined` for no highlight.
+     *
+     * @deprecated Use item.strokeWidth instead.
+     */
+    strokeWidth?: number;
+    /** Highlight style used for an individual marker when tapped or hovered over. */
+    item?: AgSeriesHighlightMarkerStyle;
+    /** Highlight style used for whole series when one of its markers is tapped or hovered over. */
+    series?: AgSeriesHighlightSeriesStyle;
+}
+export interface AgBaseSeriesListeners {
+    /** The listener to call when a node (marker, column, bar, tile or a pie slice) in the series is clicked. */
+    nodeClick: (params: {
+        type: 'nodeClick';
+        series: any;
+        datum: any;
+        xKey: string;
+        yKey: string;
+    }) => any;
+}
 export interface AgBaseSeriesOptions {
+    /** The data to use when rendering the series. If this is not supplied, data must be set on the chart instead. */
     data?: any[];
+    /** Whether or not to display the series. */
     visible?: boolean;
+    /** Whether or not to include the series in the legend. */
     showInLegend?: boolean;
+    /** The cursor to use for hovered area markers. This config is identical to the CSS `cursor` property. */
     cursor?: string;
-    listeners?: {
-        [key in string]: Function;
+    /** A map of event names to event listeners. */
+    listeners?: AgBaseSeriesListeners | {
+        [key: string]: Function;
     };
-    highlightStyle?: {
-        /**
-         * @deprecated Use item.fill instead.
-         */
-        fill?: string;
-        /**
-         * @deprecated Use item.stroke instead.
-         */
-        stroke?: string;
-        /**
-         * @deprecated Use item.strokeWidth instead.
-         */
-        strokeWidth?: number;
-        item?: {
-            fill?: string;
-            stroke?: string;
-            strokeWidth?: number;
-        };
-        series?: {
-            enabled?: boolean;
-            dimOpacity?: number;
-            strokeWidth?: number;
-        };
-    };
+    /** Configuration for series markers and series line highlighting when a marker / data point or a legend item is hovered over. */
+    highlightStyle?: AgSeriesHighlightStyle;
 }
@@ -319,10 +516,19 @@ export interface AgTooltipRendererResult {
 export interface AgSeriesMarker {
+    /** Whether or not to show markers. */
     enabled?: boolean;
+    /** The shape to use for the markers. You can also supply a custom marker by providing a `Marker` subclass. */
     shape?: string | (new () => any);
+    /** The size in pixels of the markers. */
     size?: number;
+    /** For series where the size of the marker is determined by the data, this determines the largest size a marker can be in pixels. */
     maxSize?: number;
+    /** The colour to use for marker fills. If this is not specified, the markers will take their fill from the series. */
     fill?: string;
+    /** The colour to use for marker strokes. If this is not specified, the markers will take their stroke from the series. */
     stroke?: string;
+    /** The width in pixels of the marker stroke. If this is not specified, the markers will take their stroke width from the series. */
     strokeWidth?: number;
+    /**  */
     fillOpacity?: number;
+    /**  */
     strokeOpacity?: number;
@@ -348,10 +554,13 @@ }
 }
-export declare type AgCartesianSeriesMarkerFormatter = (params: AgCartesianSeriesMarkerFormatterParams) => (AgCartesianSeriesMarkerFormat | undefined);
+export declare type AgCartesianSeriesMarkerFormatter = (params: AgCartesianSeriesMarkerFormatterParams) => AgCartesianSeriesMarkerFormat | undefined;
 export interface AgCartesianSeriesMarker extends AgSeriesMarker {
+    /** Function used to return formatting for individual markers, based on the supplied information. If the current marker is highlighted, the `highlighted` property will be set to `true`; make sure to check this if you want to differentiate between the highlighted and un-highlighted states. */
     formatter?: AgCartesianSeriesMarkerFormatter;
 }
 export interface AgSeriesTooltip {
+    /** Whether or not to show tooltips when the series are hovered over. */
     enabled?: boolean;
 }
 export interface AgLineSeriesLabelOptions extends AgChartLabelOptions {
+    /** Function used to turn 'yKey' values into text to be displayed by a label. Be default the values are simply stringified. */
     formatter?: (params: {
@@ -362,47 +571,37 @@ value: any;
 export interface AgLineSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgCartesianSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
     format?: string;
 }
+/** Configuration for line series. */
 export interface AgLineSeriesOptions extends AgBaseSeriesOptions {
     type?: 'line';
     marker?: AgCartesianSeriesMarker;
+    /** The key to use to retrieve x-values from the data. */
     xKey?: string;
+    /** The key to use to retrieve y-values from the data. */
     yKey?: string;
+    /** A human-readable description of the x-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     xName?: string;
+    /** A human-readable description of the y-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     yName?: string;
+    /** The title to use for the series. Defaults to `yName` if it exists, or `yKey` if not. */
     title?: string;
+    /** The colour of the stroke for the lines. */
     stroke?: string;
+    /** The width in pixels of the stroke for the lines. */
     strokeWidth?: number;
+    /** The opacity of the stroke for the lines. */
     strokeOpacity?: number;
+    /** Defines how the line stroke is rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
+    /** The initial offset of the dashed line in pixels. */
     lineDashOffset?: number;
+    /** Configuration for the labels shown on top of data points. */
     label?: AgLineSeriesLabelOptions;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgLineSeriesTooltip;
 }
-export interface AgOHLCTooltipRendererParams extends AgSeriesTooltipRendererParams {
-    dateKey?: string;
-    dateName?: string;
-    openKey?: string;
-    openName?: string;
-    highKey?: string;
-    highName?: string;
-    lowKey?: string;
-    lowName?: string;
-    closeKey?: string;
-    closeName?: string;
-}
-export interface AgOHLCSeriesTooltip extends AgSeriesTooltip {
-    renderer?: (params: AgOHLCTooltipRendererParams) => string | AgTooltipRendererResult;
-}
-export interface AgOHLCSeriesOptions extends AgBaseSeriesOptions {
-    type?: 'ohlc';
-    dateKey?: string;
-    openKey?: string;
-    highKey?: string;
-    lowKey?: string;
-    closeKey?: string;
-    labelKey?: string;
-    tooltip?: AgOHLCSeriesTooltip;
-}
 export interface AgScatterSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgScatterSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
@@ -412,35 +611,39 @@ }
 }
+/** Configuration for scatter/bubble series. */
 export interface AgScatterSeriesOptions extends AgBaseSeriesOptions {
+    /** Configuration for the treemap series.  */
     type?: 'scatter';
+    /** Configuration for the markers used in the series.  */
     marker?: AgCartesianSeriesMarker;
+    /** Configuration for the labels shown on top of data points.  */
     label?: AgScatterSeriesLabelOptions;
+    /** The key to use to retrieve x-values from the data.  */
     xKey?: string;
+    /** The key to use to retrieve y-values from the data.  */
     yKey?: string;
+    /** A human-readable description of the x-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.  */
     xName?: string;
+    /** A human-readable description of the y-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.  */
     yName?: string;
+    /** The key to use to retrieve size values from the data, used to control the size of the markers in bubble charts.  */
     sizeKey?: string;
+    /** A human-readable description of the size values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.  */
     sizeName?: string;
+    /** The key to use to retrieve values from the data to use as labels for the markers.  */
     labelKey?: string;
+    /** A human-readable description of the label values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.  */
     labelName?: string;
+    /** The title to use for the series. Defaults to `yName` if it exists, or `yKey` if not.  */
     title?: string;
-    /**
-     * @deprecated Use {@link marker.fill} instead.
-     */
+    /** @deprecated Use {@link marker.fill} instead. */
     fill?: string;
-    /**
-     * @deprecated Use {@link marker.stroke} instead.
-     */
+    /** @deprecated Use {@link marker.stroke} instead. */
     stroke?: string;
-    /**
-     * @deprecated Use {@link marker.strokeWidth} instead.
-     */
+    /** @deprecated Use {@link marker.strokeWidth} instead. */
     strokeWidth?: number;
-    /**
-     * @deprecated Use {@link marker.fillOpacity} instead.
-     */
+    /** @deprecated Use {@link marker.fillOpacity} instead. */
     fillOpacity?: number;
-    /**
-     * @deprecated Use {@link marker.strokeOpacity} instead.
-     */
+    /** @deprecated Use {@link marker.strokeOpacity} instead. */
     strokeOpacity?: number;
+    /** Series-specific tooltip configuration.  */
     tooltip?: AgScatterSeriesTooltip;
@@ -453,2 +656,3 @@ }
 export interface AgAreaSeriesLabelOptions extends AgChartLabelOptions {
+    /** Function used to turn 'yKey' values into text to be displayed by a label. Be default the values are simply stringified. */
     formatter?: (params: {
@@ -458,19 +662,59 @@ value: any;
 }
+/** Configuration for area series. */
 export interface AgAreaSeriesOptions extends AgBaseSeriesOptions {
     type?: 'area';
+    /** Configuration for the markers used in the series. */
     marker?: AgCartesianSeriesMarker;
+    /** The number to normalise the area stacks to. For example, if `normalizedTo` is set to `100`, the stacks will all be scaled proportionally so that their total height is always 100. */
     normalizedTo?: number;
+    /** The key to use to retrieve x-values from the data. */
     xKey?: string;
+    /**
+     * The keys to use to retrieve y-values from the data.
+     *
+     * @deprecated use yKey and multiple series instead
+     */
     yKeys?: string[];
+    /** The key to use to retrieve y-values from the data. */
+    yKey?: string;
+    /** A human-readable description of the x-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     xName?: string;
+    /**
+     * Human-readable descriptions of the y-values. If supplied, a corresponding `yName` will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.
+     *
+     * @deprecated use yName and multiple series instead
+     */
     yNames?: string[];
+    yName?: string;
+    /**
+     * The colours to cycle through for the fills of the areas.
+     *
+     * @deprecated use fill and multiple series instead
+     */
     fills?: string[];
+    /** The colour to use for the fill of the area. */
+    fill?: string;
+    /**
+     * The colours to cycle through for the strokes of the areas.
+     *
+     * @deprecated use stroke and multiple series instead
+     */
     strokes?: string[];
+    /** The colours to use for the stroke of the areas. */
+    stroke?: string;
+    /** The width in pixels of the stroke for the areas. */
     strokeWidth?: number;
+    /** The opacity of the fill for the area. */
     fillOpacity?: number;
+    /** The opacity of the stroke for the areas. */
     strokeOpacity?: number;
+    /** Defines how the area strokes are rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
+    /** The initial offset of the dashed line in pixels. */
     lineDashOffset?: number;
+    /** Configuration for the shadow used behind the chart series. */
     shadow?: AgDropShadowOptions;
+    /** Configuration for the labels shown on top of data points. */
     label?: AgAreaSeriesLabelOptions;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgAreaSeriesTooltip;
@@ -480,5 +724,7 @@ stacked?: boolean;
 export interface AgBarSeriesLabelOptions extends AgChartLabelOptions {
+    /** Function used to turn 'yKey' values into text to be displayed by a label. Be default the values are simply stringified. */
     formatter?: (params: {
         value: number;
     }) => string;
+    /** Where to render series labels relative to the segments. */
     placement?: 'inside' | 'outside';
@@ -501,11 +747,32 @@ }
 export interface AgBarSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgCartesianSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
 }
+/** Configuration for bar/column series. */
 export interface AgBarSeriesOptions extends AgBaseSeriesOptions {
     type?: 'bar' | 'column';
+    /** Whether to show different y-values as separate bars (grouped) or not (stacked). */
     grouped?: boolean;
+    stacked?: boolean;
+    /** The number to normalise the bar stacks to. Has no effect when `grouped` is `true`. For example, if `normalizedTo` is set to `100`, the bar stacks will all be scaled proportionally so that each of their totals is 100. */
     normalizedTo?: number;
+    /** The key to use to retrieve x-values from the data. */
     xKey?: string;
+    /** The keys to use to retrieve y-values from the data. */
+    yKey?: string;
+    /**
+     * The keys to use to retrieve y-values from the data.
+     *
+     * @deprecated use yKey and multiple series instead
+     */
     yKeys?: string[] | string[][];
+    /** A human-readable description of the x-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     xName?: string;
+    /** Human-readable description of the y-values. If supplied, a corresponding `yName` will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
+    yName?: string;
+    /**
+     * Human-readable descriptions of the y-values. If supplied, a corresponding `yName` will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters.
+     *
+     * @deprecated use yName and multiple series instead
+     */
     yNames?: string[] | {
@@ -515,15 +782,39 @@ [key in string]: string;
     flipXY?: boolean;
+    /**
+     * The colours to cycle through for the fills of the bars.
+     *
+     * @deprecated use fill and multiple series instead
+     */
     fills?: string[];
+    /** The colour to use for the fill of the area. */
+    fill?: string;
+    /**
+     * The colours to cycle through for the strokes of the bars.
+     *
+     * @deprecated use stroke and multiple series instead
+     */
     strokes?: string[];
+    /** The colours to use for the stroke of the bars. */
+    stroke?: string;
+    /** The width in pixels of the stroke for the bars. */
     strokeWidth?: number;
+    /** The opacity of the fill for the bars. */
     fillOpacity?: number;
+    /** The opacity of the stroke for the bars. */
     strokeOpacity?: number;
+    /** Defines how the bar/column strokes are rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
+    /** The initial offset of the dashed line in pixels. */
     lineDashOffset?: number;
+    /** Configuration for the shadow used behind the chart series. */
     shadow?: AgDropShadowOptions;
+    /** Configuration for the labels shown on bars. */
     label?: AgBarSeriesLabelOptions;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgBarSeriesTooltip;
+    /** Function used to return formatting for individual bars/columns, based on the given parameters. If the current bar/column is highlighted, the `highlighted` property will be set to `true`; make sure to check this if you want to differentiate between the highlighted and un-highlighted states. */
     formatter?: (params: AgBarSeriesFormatterParams) => AgBarSeriesFormat;
 }
 export interface AgHistogramSeriesLabelOptions extends AgChartLabelOptions {
+    /** Function used to turn 'yKey' values into text to be displayed by a label. Be default the values are simply stringified. */
     formatter?: (params: {
@@ -534,27 +825,49 @@ value: number;
 export interface AgHistogramSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgCartesianSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
 }
+/** Configuration for histogram series. */
 export interface AgHistogramSeriesOptions extends AgBaseSeriesOptions {
     type?: 'histogram';
+    /** The colour of the fill for the histogram bars. */
     fill?: string;
+    /** The colour of the stroke for the histogram bars. */
     stroke?: string;
+    /** The opacity of the fill for the histogram bars. */
     fillOpacity?: number;
+    /** The opacity of the stroke for the histogram bars. */
     strokeOpacity?: number;
+    /** The width in pixels of the stroke for the histogram bars. */
     strokeWidth?: number;
+    /** Defines how the column strokes are rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
+    /** The initial offset of the dashed line in pixels. */
     lineDashOffset?: number;
+    /** The key to use to retrieve x-values from the data. */
     xKey?: string;
+    /** A human-readable description of the x-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     xName?: string;
+    /** The key to use to retrieve y-values from the data. */
     yKey?: string;
+    /** A human-readable description of the y-values. If supplied, this will be shown in the default tooltip and passed to the tooltip renderer as one of the parameters. */
     yName?: string;
+    /** For variable width bins, if true the histogram will represent the aggregated `yKey` values using the area of the bar. Otherwise, the height of the var represents the value as per a normal bar chart. This is useful for keeping an undistorted curve displayed when using variable-width bins. */
     areaPlot?: boolean;
+    /** Set the bins explicitly. The bins need not be of equal width. Clashes with the `binCount` setting. */
     bins?: [number, number][];
+    /** The number of bins to try to split the x axis into. Clashes with the `bins` setting. */
     binCount?: number;
+    /** Dictates how the bins are aggregated. If set to 'sum', the value shown for the bins will be the total of the yKey values. If set to 'mean', it will display the average yKey value of the bin. */
     aggregation?: 'count' | 'sum' | 'mean';
+    /** Configuration for the shadow used behind the chart series. */
     shadow?: AgDropShadowOptions;
+    /** Configuration for the labels shown on bars. */
     label?: AgHistogramSeriesLabelOptions;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgHistogramSeriesTooltip;
 }
 export interface AgPieSeriesLabelOptions extends AgChartLabelOptions {
+    /** Distance in pixels between the callout line and the label text. */
     offset?: number;
+    /** Minimum angle in degrees required for a segment to show a label. */
     minAngle?: number;
@@ -577,2 +890,3 @@ }
 export interface AgPieSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgPieSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
@@ -583,28 +897,54 @@ }
 }
+export interface AgPieSeriesCalloutOptions {
+    /** The colours to cycle through for the strokes of the callouts. */
+    colors?: string[];
+    /** The length in pixels of the callout lines. */
+    length?: number;
+    /** The width in pixels of the stroke for callout lines. */
+    strokeWidth?: number;
+}
+/** Configuration for pie/doughnut series. */
 export interface AgPieSeriesOptions extends AgBaseSeriesOptions {
     type?: 'pie';
+    /** Configuration for the series title. */
     title?: AgPieTitleOptions;
+    /** Configuration for the labels used for the segments. */
     label?: AgPieSeriesLabelOptions;
-    callout?: {
-        colors?: string[];
-        length?: number;
-        strokeWidth?: number;
-    };
+    /** Configuration for the callouts used with the labels for the segments. */
+    callout?: AgPieSeriesCalloutOptions;
+    /** The key to use to retrieve angle values from the data. */
     angleKey?: string;
+    /** A human-readable description of the angle values. If supplied, this will be passed to the tooltip renderer as one of the parameters. */
     angleName?: string;
+    /** The key to use to retrieve radius values from the data. */
     radiusKey?: string;
+    /** A human-readable description of the radius values. If supplied, this will be passed to the tooltip renderer as one of the parameters. */
     radiusName?: string;
+    /** The key to use to retrieve label values from the data. */
     labelKey?: string;
+    /** A human-readable description of the label values. If supplied, this will be passed to the tooltip renderer as one of the parameters. */
     labelName?: string;
+    /** The colours to cycle through for the fills of the segments. */
     fills?: string[];
+    /** The colours to cycle through for the strokes of the segments. */
     strokes?: string[];
+    /** The opacity of the fill for the segments. */
     fillOpacity?: number;
+    /** The opacity of the stroke for the segments. */
     strokeOpacity?: number;
+    /** The width in pixels of the stroke for the segments. */
     strokeWidth?: number;
+    /** Defines how the pie sector strokes are rendered. Every number in the array specifies the length in pixels of alternating dashes and gaps. For example, `[6, 3]` means dashes with a length of `6` pixels with gaps between of `3` pixels. */
     lineDash?: number[];
+    /** The initial offset of the dashed line in pixels. */
     lineDashOffset?: number;
+    /** The rotation of the pie series in degrees. */
     rotation?: number;
+    /** The offset in pixels of the outer radius of the series. Used to construct doughnut charts. */
     outerRadiusOffset?: number;
+    /** The offset in pixels of the inner radius of the series. Used to construct doughnut charts. If this is not given, or a value of zero is given, a pie chart will be rendered. */
     innerRadiusOffset?: number;
+    /** Configuration for the shadow used behind the chart series. */
     shadow?: AgDropShadowOptions;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgPieSeriesTooltip;
@@ -618,2 +958,3 @@ formatter?: (params: AgPieSeriesFormatterParams) => AgPieSeriesFormat;
 export interface AgTreemapSeriesLabelOptions extends AgChartLabelOptions {
+    /** The amount of the tile's vertical space to reserve for the label. */
     padding?: number;
@@ -639,41 +980,64 @@ }
 export interface AgTreemapSeriesTooltip extends AgSeriesTooltip {
+    /** Function used to create the content for tooltips. */
     renderer?: (params: AgTreemapSeriesTooltipRendererParams) => string | AgTooltipRendererResult;
 }
+export interface AgTreemapSeriesLabelsOptions {
+    /** The label configuration for the large leaf tiles. */
+    large?: AgChartLabelOptions;
+    /** The label configuration for the medium-sized leaf tiles. */
+    medium?: AgChartLabelOptions;
+    /** The label configuration for the small leaf tiles. */
+    small?: AgChartLabelOptions;
+    /** The configuration for the labels showing the value of the 'colorKey'. */
+    color?: AgChartLabelOptions;
+}
+/** Configuration for the treemap series. */
 export interface AgTreemapSeriesOptions extends AgBaseSeriesOptions {
     type?: 'treemap';
+    /** The label configuration for the top-level tiles. */
     title?: AgTreemapSeriesLabelOptions;
+    /** The label configuration for the children of the top-level parent tiles. */
     subtitle?: AgTreemapSeriesLabelOptions;
-    labels?: {
-        large?: AgChartLabelOptions;
-        medium?: AgChartLabelOptions;
-        small?: AgChartLabelOptions;
-        value?: AgChartLabelOptions;
-    };
+    /** Configuration for the tile labels. */
+    labels?: AgTreemapSeriesLabelsOptions;
+    /** The name of the node key containing the label. */
     labelKey?: string;
+    /** The name of the node key containing the size value. */
     sizeKey?: string;
+    /** The name of the node key containing the color value. This value (along with `colorDomain` and `colorRange` configs) will be used to determine the tile color. */
     colorKey?: string;
+    /** The domain the 'colorKey' values belong to. The domain can contain more than two stops, for example `[-5, 0, -5]`. In that case the 'colorRange' should also use a matching number of colors. */
     colorDomain?: number[];
+    /** The color range to interpolate the numeric `colorDomain` into. For example, if the `colorDomain` is `[-5, 5]` and `colorRange` is `['red', 'green']`, a `colorKey` value of `-5` will be assigned the 'red' color, `5` - 'green' color and `0` a blend of 'red' and 'green'. */
     colorRange?: string[];
+    /** Whether or not to assign colors to non-leaf nodes based on 'colorKey'. */
     colorParents?: boolean;
+    /** Series-specific tooltip configuration. */
     tooltip?: AgTreemapSeriesTooltip;
+    /** The amount of padding in pixels inside of each treemap tile. Increasing `nodePadding` will reserve more space for parent labels. */
     nodePadding?: number;
+    /** Whether or not to use gradients for treemap tiles. */
     gradient?: boolean;
 }
-export declare type AgCartesianSeriesOptions = AgLineSeriesOptions | AgScatterSeriesOptions | AgAreaSeriesOptions | AgBarSeriesOptions | AgHistogramSeriesOptions | AgOHLCSeriesOptions;
+export declare type AgCartesianSeriesOptions = AgLineSeriesOptions | AgScatterSeriesOptions | AgAreaSeriesOptions | AgBarSeriesOptions | AgHistogramSeriesOptions;
 export declare type AgPolarSeriesOptions = AgPieSeriesOptions;
 export declare type AgHierarchySeriesOptions = AgTreemapSeriesOptions;
-export interface AgCartesianChartOptions<TAxisOptions = AgCartesianAxisOptions[], TSeriesOptions = AgCartesianSeriesOptions[]> extends AgBaseChartOptions {
-    type?: 'cartesian' | 'groupedCategory' | 'line' | 'bar' | 'column' | 'area' | 'scatter' | 'ohlc' | 'histogram';
-    axes?: TAxisOptions;
-    series?: TSeriesOptions;
+export interface AgCartesianChartOptions extends AgBaseChartOptions {
+    type?: 'cartesian' | 'groupedCategory' | 'line' | 'bar' | 'column' | 'area' | 'scatter' | 'histogram';
+    /** Axis configurations. */
+    axes?: AgCartesianAxisOptions[];
+    /** Series configurations. */
+    series?: AgCartesianSeriesOptions[];
+    /** Configuration for the chart navigator. */
+    navigator?: AgNavigatorOptions;
 }
-export interface AgPolarChartOptions<TSeriesOptions = AgPolarSeriesOptions[]> extends AgBaseChartOptions {
+export interface AgPolarChartOptions extends AgBaseChartOptions {
     type?: 'polar' | 'pie';
-    series?: TSeriesOptions;
+    series?: AgPolarSeriesOptions[];
 }
-export interface AgHierarchyChartOptions<TSeriesOptions = AgHierarchySeriesOptions[]> extends AgBaseChartOptions {
+export interface AgHierarchyChartOptions extends AgBaseChartOptions {
     type?: 'hierarchy' | 'treemap';
     data?: any;
-    series?: TSeriesOptions;
+    series?: AgHierarchySeriesOptions[];
 }
 export declare type AgChartOptions = AgCartesianChartOptions | AgPolarChartOptions | AgHierarchyChartOptions;

dist/lib/interfaces/iCellEditor.d.ts

@@ -42,2 +42,8 @@ import { Column } from "../entities/column";
     focusOut?(): void;
+    /**
+     * A hook to perform any necessary operation just after the GUI for this component has been rendered on the screen.
+     * This method is called each time the edit component is activated.
+     * This is useful for any logic that requires attachment before executing, such as putting focus on a particular DOM element.
+     */
+    afterGuiAttached?(): void;
 }
@@ -47,5 +53,7 @@ export interface ICellEditorParams {
     value: any;
+    /** @deprecated Use `eventKey`. */
+    key: string | null;
     /** Key value of key that started the edit, eg 'Enter' or 'Delete' - non-printable
      *  characters appear here */
-    key: string | null;
+    eventKey: string | null;
     /** The string that started the edit, eg 'a' if letter 'a' was pressed, or 'A' if
@@ -52,0 +60,0 @@ *  shift + letter 'a' only printable characters appear here */

dist/lib/interfaces/iChartOptions.d.ts

@@ -1,2 +0,8 @@
-export declare type ChartType = 'column' | 'groupedColumn' | 'stackedColumn' | 'normalizedColumn' | 'bar' | 'groupedBar' | 'stackedBar' | 'normalizedBar' | 'line' | 'scatter' | 'bubble' | 'pie' | 'doughnut' | 'area' | 'stackedArea' | 'normalizedArea' | 'histogram';
+export declare type ChartType = 'column' | 'groupedColumn' | 'stackedColumn' | 'normalizedColumn' | 'bar' | 'groupedBar' | 'stackedBar' | 'normalizedBar' | 'line' | 'scatter' | 'bubble' | 'pie' | 'doughnut' | 'area' | 'stackedArea' | 'normalizedArea' | 'histogram' | 'columnLineCombo' | 'areaColumnCombo' | 'customCombo';
+export declare type CrossFilterChartType = 'column' | 'bar' | 'line' | 'scatter' | 'bubble' | 'pie' | 'doughnut' | 'area';
 export declare type ChartMenuOptions = 'chartSettings' | 'chartData' | 'chartFormat' | 'chartLink' | 'chartUnlink' | 'chartDownload';
+export interface SeriesChartType {
+    colId: string;
+    chartType: ChartType;
+    secondaryAxis?: boolean;
+}

dist/lib/interfaces/IChartService.d.ts

@@ -1,2 +0,2 @@
-import { ChartType } from "./iChartOptions";
+import { ChartType, SeriesChartType } from "./iChartOptions";
 import { ChartRef } from "../entities/gridOptions";
@@ -19,2 +19,3 @@ import { CreateCrossFilterChartParams, CreatePivotChartParams, CreateRangeChartParams } from "../gridApi";
 export interface ChartModel {
+    version?: string;
     modelType: ChartModelType;
@@ -29,2 +30,3 @@ chartId: string;
     unlinkChart?: boolean;
+    seriesChartTypes?: SeriesChartType[];
 }
@@ -31,0 +33,0 @@ export interface IChartService {

dist/lib/interfaces/iComponent.d.ts

 import { AgPromise } from '../utils';
-import { IAfterGuiAttachedParams } from './iAfterGuiAttachedParams';
 /** This is for User Components only, do not implement this for internal components. */
@@ -9,13 +8,4 @@ export interface IComponent<T> {
     destroy?(): void;
-    /** A hook to perform any necessary operation just after the GUI for this component has been rendered
-     on the screen.
-     If a parent popup is closed and reopened (e.g. for filters), this method is called each time the component is shown.
-     This is useful for any
-     logic that requires attachment before executing, such as putting focus on a particular DOM
-     element. The params has one callback method 'hidePopup', which you can call at any later
-     point to hide the popup - good if you have an 'Apply' button and you want to hide the popup
-     after it is pressed. */
-    afterGuiAttached?(params?: IAfterGuiAttachedParams): void;
     /** The init(params) method is called on the component once. */
     init?(params: T): AgPromise<void> | void;
 }

dist/lib/interfaces/iFilter.d.ts

@@ -10,2 +10,3 @@ import { Column } from '../entities/column';
 import { ColumnApi } from '../columns/columnApi';
+import { IAfterGuiAttachedParams } from './iAfterGuiAttachedParams';
 export declare type IFilterType = string | {
@@ -76,2 +77,8 @@ new (): IFilterComp;
     getModelAsString?(model: any): string;
+    /**
+     * A hook to perform any necessary operation just after the GUI for this component has been rendered on the screen.
+     * If a parent popup is closed and reopened (e.g. for filters), this method is called each time the component is shown.
+     * This is useful for any logic that requires attachment before executing, such as putting focus on a particular DOM element.
+     */
+    afterGuiAttached?(params?: IAfterGuiAttachedParams): void;
 }
@@ -78,0 +85,0 @@ export interface ProvidedFilterModel {

dist/lib/interfaces/iImmutableService.d.ts

@@ -1,6 +0,4 @@
-import { RowDataTransaction } from "./rowDataTransaction";
 export interface IImmutableService {
-    createTransactionForRowData(data: any[]): ([RowDataTransaction, {
-        [id: string]: number;
-    } | null]) | undefined;
+    setRowData(data: any[]): void;
+    isActive(): boolean;
 }

dist/lib/main.d.ts

 export { ColumnFactory } from "./columns/columnFactory";
-export { ColumnModel, ColumnState } from "./columns/columnModel";
+export { ColumnModel, ColumnState, ColumnStateParams, ApplyColumnStateParams } from "./columns/columnModel";
 export { ColumnKeyCreator } from "./columns/columnKeyCreator";
@@ -186,3 +186,3 @@ export { ColumnUtils } from "./columns/columnUtils";
 export { IAggFunc, IAggFuncParams, ColGroupDef, ColDef, AbstractColDef, ValueSetterParams, ValueParserParams, ValueFormatterParams, ValueFormatterFunc, ValueParserFunc, ValueGetterFunc, ValueSetterFunc, HeaderValueGetterFunc, HeaderValueGetterParams, ColSpanParams, RowSpanParams, SuppressKeyboardEventParams, SuppressHeaderKeyboardEventParams, ValueGetterParams, NewValueParams, CellClassParams, CellClassFunc, CellStyleFunc, CellStyle, CellClassRules, CellEditorSelectorFunc, CellEditorSelectorResult, CellRendererSelectorFunc, CellRendererSelectorResult, GetQuickFilterTextParams, ColumnFunctionCallbackParams, CheckboxSelectionCallbackParams, CheckboxSelectionCallback, RowDragCallback, RowDragCallbackParams, DndSourceCallback, DndSourceCallbackParams, DndSourceOnRowDragParams, EditableCallbackParams, EditableCallback, SuppressPasteCallback, SuppressPasteCallbackParams, SuppressNavigableCallback, SuppressNavigableCallbackParams, HeaderCheckboxSelectionCallbackParams, HeaderCheckboxSelectionCallback, ColumnsMenuParams, HeaderClassParams, HeaderClass, ToolPanelClassParams, ToolPanelClass, KeyCreatorParams, IsColumnFunc, IsColumnFuncParams } from "./entities/colDef";
-export { GridOptions, IsServerSideGroupOpenByDefaultParams, IsGroupOpenByDefaultParams, IsApplyServerSideTransactionParams, IsApplyServerSideTransaction, GetContextMenuItemsParams, GetContextMenuItems, GetChartToolbarItemsParams, GetDataPath, IsRowMaster, IsRowSelectable, MenuItemDef, GetMainMenuItemsParams, GetMainMenuItems, GetRowNodeIdFunc, ProcessRowParams, NavigateToNextHeaderParams, TabToNextHeaderParams, NavigateToNextCellParams, TabToNextCellParams, PostProcessPopupParams, ProcessDataFromClipboardParams, ChartRef, RowClassRules, RowStyle, RowClassParams, RowHeightParams, SendToClipboardParams, ServerSideStoreType, ServerSideStoreParams, GetServerSideStoreParamsParams, PaginationNumberFormatterParams, GetServerSideGroupKey, IsServerSideGroup, GetChartToolbarItems, FillOperationParams, RowGroupingDisplayType, TreeDataDisplayType, LoadingCellRendererSelectorFunc, LoadingCellRendererSelectorResult } from "./entities/gridOptions";
+export { GridOptions, IsServerSideGroupOpenByDefaultParams, IsGroupOpenByDefaultParams, IsApplyServerSideTransactionParams, IsApplyServerSideTransaction, GetContextMenuItemsParams, GetContextMenuItems, GetChartToolbarItemsParams, GetDataPath, IsRowMaster, IsRowSelectable, MenuItemLeafDef, MenuItemDef, GetMainMenuItemsParams, GetMainMenuItems, GetRowNodeIdFunc, GetRowIdFunc, GetRowIdParams, ProcessRowParams, NavigateToNextHeaderParams, TabToNextHeaderParams, NavigateToNextCellParams, TabToNextCellParams, PostProcessPopupParams, ProcessDataFromClipboardParams, ChartRef, RowClassRules, RowStyle, RowClassParams, RowHeightParams, SendToClipboardParams, ServerSideStoreType, ServerSideStoreParams, GetServerSideStoreParamsParams, PaginationNumberFormatterParams, GetServerSideGroupKey, IsServerSideGroup, GetChartToolbarItems, FillOperationParams, RowGroupingDisplayType, TreeDataDisplayType, LoadingCellRendererSelectorFunc, LoadingCellRendererSelectorResult } from "./entities/gridOptions";
 export * from "./propertyKeys";
@@ -189,0 +189,0 @@ export { IProvidedColumn } from "./entities/iProvidedColumn";

dist/lib/misc/simpleHttpRequest.d.ts

@@ -5,2 +5,5 @@ import { AgPromise } from "../utils";
 }
+/**
+ * @deprecated
+ */
 export declare function simpleHttpRequest(params: SimpleHttpRequestParams): AgPromise<any>;

dist/lib/rendering/cell/cellCtrl.d.ts

@@ -18,6 +18,3 @@ import { Beans } from "./../beans";
     setUserStyles(styles: any): void;
-    setAriaSelected(selected: boolean | undefined): void;
-    setAriaExpanded(expanded: boolean): void;
     getFocusableElement(): HTMLElement;
-    setAriaColIndex(index: number): void;
     setTabIndex(tabIndex: number): void;
@@ -77,3 +74,3 @@ setRole(role: string): void;
     refreshShouldDestroy(): boolean;
-    startEditing(key?: string | null, charPress?: string | null, cellStartedEdit?: boolean): void;
+    startEditing(key?: string | null, charPress?: string | null, cellStartedEdit?: boolean, event?: KeyboardEvent | MouseEvent | null): void;
     private setEditing;
@@ -84,2 +81,3 @@ stopRowOrCellEdit(cancel?: boolean): void;
     private saveNewValue;
+    private dispatchEventForSaveValueReadOnly;
     stopEditing(cancel?: boolean): void;
@@ -139,3 +137,3 @@ private dispatchEditingStoppedEvent;
     isEditing(): boolean;
-    startRowOrCellEdit(key?: string | null, charPress?: string | null): void;
+    startRowOrCellEdit(key?: string | null, charPress?: string | null, event?: KeyboardEvent | MouseEvent | null): void;
     getRowCtrl(): RowCtrl;
@@ -142,0 +140,0 @@ getRowPosition(): RowPosition;

dist/lib/rendering/cell/cellRangeFeature.d.ts

@@ -7,2 +7,3 @@ import { Beans } from "../beans";
     private cellCtrl;
+    private eGui;
     private rangeCount;
@@ -12,3 +13,3 @@ private hasChartRange;
     constructor(beans: Beans, ctrl: CellCtrl);
-    setComp(cellComp: ICellComp): void;
+    setComp(cellComp: ICellComp, eGui: HTMLElement): void;
     onRangeSelectionChanged(): void;
@@ -15,0 +16,0 @@ private updateRangeBorders;

dist/lib/rendering/cellEditors/popupSelectCellEditor.d.ts

 import { SelectCellEditor } from "./selectCellEditor";
 export declare class PopupSelectCellEditor extends SelectCellEditor {
+    constructor();
     isPopup(): boolean;
 }

dist/lib/rendering/cellEditors/popupTextCellEditor.d.ts

 import { TextCellEditor } from "./textCellEditor";
 export declare class PopupTextCellEditor extends TextCellEditor {
+    constructor();
     isPopup(): boolean;
 }

dist/lib/rendering/dateComponent.d.ts

 import { IComponent } from "../interfaces/iComponent";
 import { IDateFilterParams } from "../filter/provided/date/dateFilter";
+import { IAfterGuiAttachedParams } from "../interfaces/iAfterGuiAttachedParams";
 export interface IDate {
-    /** Returns the current date represented by this editor */
+    /** Returns the current date represented by this component */
     getDate(): Date | null;
@@ -10,4 +11,12 @@ /** Sets the date represented by this component */
     setDisabled?(disabled: boolean): void;
+    /** [optional method] sets the current input placeholder */
     setInputPlaceholder?(placeholder: string): void;
+    /** [optional method] sets the current input aria label */
     setInputAriaLabel?(placeholder: string): void;
+    /**
+     * A hook to perform any necessary operation just after the GUI for this component has been rendered on the screen.
+     * If a parent popup is closed and reopened (e.g. for filters), this method is called each time the component is shown.
+     * This is useful for any logic that requires attachment before executing, such as putting focus on a particular DOM element.
+     */
+    afterGuiAttached?(params?: IAfterGuiAttachedParams): void;
 }
@@ -14,0 +23,0 @@ export interface IDateParams {

dist/lib/rendering/row/rowCtrl.d.ts

@@ -25,12 +25,8 @@ import { UserCompDetails } from "../../components/framework/userComponentFactory";
     getFullWidthCellRenderer(): ICellRenderer | null | undefined;
-    setAriaExpanded(on: boolean): void;
-    setAriaSelected(selected: boolean | undefined): void;
     setTop(top: string): void;
     setTransform(transform: string): void;
     setRowIndex(rowIndex: string): void;
-    setAriaRowIndex(rowIndex: number): void;
     setRowId(rowId: string): void;
     setRowBusinessKey(businessKey: string): void;
     setTabIndex(tabIndex: number): void;
-    setAriaLabel(label: string | undefined): void;
     setUserStyles(styles: any): void;
@@ -126,6 +122,7 @@ setRole(role: string): void;
     private onModelUpdated;
+    private refreshFirstAndLastRowStyles;
     stopEditing(cancel?: boolean): void;
     setInlineEditingCss(editing: boolean): void;
     private setEditingRow;
-    startRowEditing(key?: string | null, charPress?: string | null, sourceRenderedCell?: CellCtrl | null): void;
+    startRowEditing(key?: string | null, charPress?: string | null, sourceRenderedCell?: CellCtrl | null, event?: KeyboardEvent | null): void;
     getAllCellCtrls(): CellCtrl[];
@@ -132,0 +129,0 @@ private postProcessClassesFromGridOptions;

dist/lib/rendering/rowRenderer.d.ts

@@ -77,2 +77,4 @@ import { RowCtrl } from "./row/rowCtrl";
     getEditingCells(): CellPosition[];
+    private mapRowNodes;
+    private isRowInMap;
     private getCellCtrls;
@@ -90,2 +92,3 @@ protected destroy(): void;
     private redrawFullWidthEmbeddedRows;
+    getFullWidthRowCtrls(rowNodes?: RowNode[]): RowCtrl[];
     refreshFullWidthRows(rowNodesToRefresh?: RowNode[]): void;
@@ -92,0 +95,0 @@ private createOrUpdateRowCtrl;

dist/lib/widgets/agMenuItemComponent.d.ts

 import { AgEvent } from '../events';
 import { IPopupComponent } from '../interfaces/iPopupComponent';
 import { Component } from './component';
-import { MenuItemDef } from '../entities/gridOptions';
+import { MenuItemLeafDef, MenuItemDef } from '../entities/gridOptions';
 import { ITooltipParams } from '../rendering/tooltipComponent';
-interface MenuItemComponentParams extends MenuItemDef {
+import { IComponent } from '../interfaces/iComponent';
+interface MenuItemComponentParams extends MenuItemLeafDef {
     isCompact?: boolean;
     isAnotherSubMenuOpen: () => boolean;
+    subMenu?: (MenuItemDef | string)[] | IComponent<any>;
 }
@@ -10,0 +12,0 @@ export interface MenuItemSelectedEvent extends AgEvent {

main.d.ts

@@ -1,2 +0,2 @@
-// Type definitions for ag-grid-community v27.0.1
+// Type definitions for ag-grid-community v27.1.0
 // Project: http://www.ag-grid.com/
@@ -3,0 +3,0 @@ // Definitions by: Niall Crosby <https://github.com/ag-grid/>

package.json

 {
   "name": "ag-grid-community",
-  "version": "27.0.1",
+  "version": "27.1.0",
   "description": "Advanced Data Grid / Data Table supporting Javascript / Typescript / React / Angular / Vue",
   "main": "./dist/ag-grid-community.cjs.js",
   "scripts": {
-    "build": "npx gulp && npm run rollup && npm run hash",
-    "rollup": "node build.js",
+    "build": "npx gulp build && npx gulp && npm run rollup && npm run hash",
+    "rollup": "mkdir -p dist && node build.js",
     "hash": "sh ../../scripts/hashDirectory.sh > .hash"
@@ -53,7 +53,7 @@ },
   "devDependencies": {
-    "@ag-grid-community/all-modules": "~27.0.1",
-    "@ag-grid-community/core": "~27.0.1",
-    "@ag-grid-community/client-side-row-model": "~27.0.0",
-    "@ag-grid-community/csv-export": "~27.0.0",
-    "@ag-grid-community/infinite-row-model": "~27.0.0",
+    "@ag-grid-community/all-modules": "~27.1.0",
+    "@ag-grid-community/core": "~27.1.0",
+    "@ag-grid-community/client-side-row-model": "~27.1.0",
+    "@ag-grid-community/csv-export": "~27.1.0",
+    "@ag-grid-community/infinite-row-model": "~27.1.0",
     "@types/node": "12.20.20",
@@ -76,2 +76,2 @@ "gulp": "4.0.2",
   }
-}
+}

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

32727659

increased by0.42%

Lines of code

279680

increased by0.46%

No dependency changes