@genesislcap/grid-pro 14.48.0 → 14.49.1

package/dist/custom-elements.json

@@ -263,6 +263,26 @@
       "kind": "javascript-module",
       "path": "src/grid-pro.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "convertToKebabCase",
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "The value to convert to Kebab case."
+            }
+          ],
+          "description": "Convert string values from 'camelCase' to 'kebab-case'",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "privacy": "public"
+        },
         {
           "kind": "class",
           "description": "The Grid Pro element.",
@@ -429,15 +449,18 @@
             {
               "kind": "field",
               "name": "agAttributes",
-              "privacy": "protected",
               "type": {
-                "text": "object"
+                "text": "Record<string, string>"
               },
+              "privacy": "protected",
               "default": "{}"
             },
             {
               "kind": "field",
               "name": "agPropertiesMap",
+              "type": {
+                "text": "Record<string, string>"
+              },
               "privacy": "protected"
             },
             {
@@ -493,7 +516,7 @@
             },
             {
               "kind": "method",
-              "name": "serialiseStoreTableConfig",
+              "name": "saveColumnState",
               "privacy": "private",
               "return": {
                 "type": {
@@ -503,7 +526,18 @@
             },
             {
               "kind": "method",
-              "name": "rehydrateTableConfig",
+              "name": "getSavedColumnState",
+              "return": {
+                "type": {
+                  "text": "ColumnState[]"
+                }
+              },
+              "description": "Gets the saved grid ColumnState[] from local storage",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "restoreColumnState",
               "privacy": "private",
               "return": {
                 "type": {
@@ -519,6 +553,14 @@
               },
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "gridProGenesisDatasource",
+              "type": {
+                "text": "GridProGenesisDatasource"
+              },
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "enableFlashingRows",
@@ -530,10 +572,13 @@
               "parameters": [
                 {
                   "name": "columnDefs",
-                  "default": "[]",
                   "type": {
                     "text": "ColDef[]"
                   }
+                },
+                {
+                  "name": "deferredColumnDefs",
+                  "default": "false"
                 }
               ]
             },
@@ -711,6 +756,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "convertToKebabCase",
+          "declaration": {
+            "name": "convertToKebabCase",
+            "module": "src/grid-pro.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "GridPro",
@@ -3259,6 +3312,14 @@
               },
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "rowDataMapper",
+              "type": {
+                "text": "Function"
+              },
+              "description": "Allows grid data updates to be processed via and external function before applying in grid"
+            },
             {
               "kind": "field",
               "name": "dataSub",
@@ -3405,6 +3466,11 @@
               "description": "Restarts the datasource, uses `deinit` and `init` in sequence.",
               "privacy": "public"
             },
+            {
+              "kind": "method",
+              "name": "refreshRows",
+              "description": "Force the grid to redispatch the current rows"
+            },
             {
               "kind": "method",
               "name": "clearRowData",
@@ -3498,6 +3564,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "mapTransaction",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "transaction",
+                  "type": {
+                    "text": "RowDataTransaction"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "handleStreamInserts",
@@ -3771,11 +3850,68 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/array.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "mergeAndDedupColDefWithColumnState",
+          "return": {
+            "type": {
+              "text": "ColDef[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "colDefs",
+              "type": {
+                "text": "ColDef[]"
+              }
+            },
+            {
+              "name": "columnStates",
+              "type": {
+                "text": "ColumnState[]"
+              }
+            },
+            {
+              "name": "arr1Field",
+              "default": "'field'"
+            },
+            {
+              "name": "arr2Field",
+              "default": "'colId'"
+            }
+          ],
+          "description": "Merges two arrays, one of `ColDef` and one of `ColumnState`, and deduplicates them.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "mergeAndDedupColDefWithColumnState",
+          "declaration": {
+            "name": "mergeAndDedupColDefWithColumnState",
+            "module": "src/utils/array.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./array"
+          }
+        },
         {
           "kind": "js",
           "name": "*",

package/dist/dts/grid-pro-genesis-datasource/grid-pro-genesis-datasource.d.ts

@@ -46,11 +46,7 @@ declare const GridProGenesisDatasource_base: (new (...args: any[]) => {
     readonly classList: DOMTokenList;
     className: string;
     readonly clientHeight: number;
-    readonly clientLeft: number; /**
-     * Initializes the datasource.
-     * @public
-     * @remarks This method is called automatically when the element is connected to the DOM.
-     */
+    readonly clientLeft: number;
     readonly clientTop: number;
     readonly clientWidth: number;
     id: string;
@@ -360,6 +356,10 @@ export declare class GridProGenesisDatasource extends GridProGenesisDatasource_b
      */
     rowIdAttr: any;
     restartOnReconnection: boolean;
+    /**
+     * Allows grid data updates to be processed via and external function before applying in grid
+     */
+    rowDataMapper: Function;
     private dataSub;
     private updateSub;
     private connectionSub;
@@ -398,6 +398,10 @@ export declare class GridProGenesisDatasource extends GridProGenesisDatasource_b
      * @public
      */
     restart(): void;
+    /**
+     * Force the grid to redispatch the current rows
+     */
+    refreshRows(): void;
     /**
      * Sends a DATA_LOGOFF when the resource is an active stream
      * @remarks Will only happen for streaming DATASERER resources.
@@ -412,6 +416,7 @@ export declare class GridProGenesisDatasource extends GridProGenesisDatasource_b
     private handleStreamResult;
     private applyRequestServerData;
     private applyDataserverData;
+    private mapTransaction;
     private handleStreamInserts;
     private handleStreamDeletes;
     private handleStreamUpdates;

package/dist/dts/grid-pro-genesis-datasource/grid-pro-genesis-datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-pro-genesis-datasource.d.ts","sourceRoot":"","sources":["../../../src/grid-pro-genesis-datasource/grid-pro-genesis-datasource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,WAAW,EAAsB,MAAM,yBAAyB,CAAC;AAClF,OAAO,EACL,OAAO,EAEP,UAAU,EAYX,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;;;;;;wCA6D7D;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAuEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA5HL;;;;GAIG;AACH,qBAGa,wBAAyB,SAAQ,6BAAiC;IACpE,OAAO,EAAG,OAAO,CAAC;IACf,UAAU,EAAG,UAAU,CAAC;IAExB,mBAAmB,EAAE,WAAW,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAalD,MAAM,EAAE,MAAM,CAAC;IACgC,UAAU,UAAS;IACvC,OAAO,EAAE,MAAM,CAAmC;IAClD,OAAO,EAAE,MAAM,CAAoC;IAC3C,eAAe,EAAE,MAAM,CACf;IACI,UAAU,UAAS;IACvC,OAAO,EAAE,MAAM,CAAC;IACrC,OAAO,EAAE,GAAG,CAAC;IACa,YAAY,EAAE,MAAM,CAAC;IAC3D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK3B,OAAO,UAAS;IAE3C;;;;;OAKG;IAC4B,SAAS,MAAC;IAEwB,qBAAqB,UAAS;IAE/F,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,aAAa,CAAe;IAEpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,6BAA6B,CAAQ;IAC7C,OAAO,CAAC,mBAAmB,CAAS;IAEpC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,MAAM,CAAwE;IAEtF,iBAAiB;IAuBjB,oBAAoB;IASX,SAAS,IAAI,IAAI;IAO1B,OAAO,KAAK,MAAM,GAEjB;IAGD,OAAO,KAAK,KAAK,GAIhB;IAED;;;;OAIG;IACG,IAAI;IAyCV;;;OAGG;IACH,MAAM;IAIN;;;;OAIG;IACH,KAAK;IA6BL;;;OAGG;IACH,OAAO;IAKP;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;YAUP,gBAAgB;IAiD9B,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,sBAAsB;IA0C9B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,aAAa;IAMd,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK9C,YAAY,CAAC,SAAS,EAAE,MAAM;CAItC"}
+{"version":3,"file":"grid-pro-genesis-datasource.d.ts","sourceRoot":"","sources":["../../../src/grid-pro-genesis-datasource/grid-pro-genesis-datasource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,WAAW,EAAsB,MAAM,yBAAyB,CAAC;AAClF,OAAO,EACL,OAAO,EAEP,UAAU,EAYX,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;;;;;;wCA6D7D;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAjDL;;;;GAIG;AACH,qBAGa,wBAAyB,SAAQ,6BAAiC;IACpE,OAAO,EAAG,OAAO,CAAC;IACf,UAAU,EAAG,UAAU,CAAC;IAExB,mBAAmB,EAAE,WAAW,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAalD,MAAM,EAAE,MAAM,CAAC;IACgC,UAAU,UAAS;IACvC,OAAO,EAAE,MAAM,CAAmC;IAClD,OAAO,EAAE,MAAM,CAAoC;IAC3C,eAAe,EAAE,MAAM,CACf;IACI,UAAU,UAAS;IACvC,OAAO,EAAE,MAAM,CAAC;IACrC,OAAO,EAAE,GAAG,CAAC;IACa,YAAY,EAAE,MAAM,CAAC;IAC3D,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK3B,OAAO,UAAS;IAE3C;;;;;OAKG;IAC4B,SAAS,MAAC;IAEwB,qBAAqB,UAAS;IAE/F;;OAEG;IACS,aAAa,EAAE,QAAQ,CAAC;IAEpC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,aAAa,CAAe;IAEpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,6BAA6B,CAAQ;IAC7C,OAAO,CAAC,mBAAmB,CAAS;IAEpC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,MAAM,CAAwE;IAEtF,iBAAiB;IAuBjB,oBAAoB;IASX,SAAS,IAAI,IAAI;IAO1B,OAAO,KAAK,MAAM,GAEjB;IAGD,OAAO,KAAK,KAAK,GAIhB;IAED;;;;OAIG;IACG,IAAI;IAyCV;;;OAGG;IACH,MAAM;IAIN;;;;OAIG;IACH,KAAK;IA6BL;;;OAGG;IACH,OAAO;IAKP;;OAEG;IACH,WAAW;IAIX;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;YAYP,gBAAgB;IAiD9B,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,sBAAsB;IA2C9B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,eAAe;IA6CvB,OAAO,CAAC,aAAa;IAMd,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK9C,YAAY,CAAC,SAAS,EAAE,MAAM;CAItC"}

package/dist/dts/grid-pro.d.ts

@@ -1,6 +1,14 @@
-import { Grid, ColumnApi, GridApi, GridOptions, ColDef } from '@ag-grid-community/core';
+import { Grid, ColumnApi, GridApi, GridOptions, ColDef, ColumnState } from '@ag-grid-community/core';
 import { FoundationElement } from '@microsoft/fast-foundation';
+import { GridProGenesisDatasource } from './grid-pro-genesis-datasource';
 import { GridComponents } from './grid-pro.types';
+/**
+ * Convert string values from 'camelCase' to 'kebab-case'
+ * @param value - The value to convert to Kebab case.
+ * @returns The Kebab case result.
+ * @public
+ */
+export declare const convertToKebabCase: (value: string) => string;
 declare const GridPro_base: (new (...args: any[]) => {
     "__#1@#_container": import("@genesislcap/foundation-utils").FoundationLayoutContainer | import("@genesislcap/foundation-utils").LayoutCacheContainer | import("@genesislcap/foundation-utils").DOMContainer;
     cloneNode(deep?: boolean): Node;
@@ -246,6 +254,10 @@ declare const GridPro_base: (new (...args: any[]) => {
     ondragleave: (this: GlobalEventHandlers, ev: DragEvent) => any;
     ondragover: (this: GlobalEventHandlers, ev: DragEvent) => any;
     ondragstart: (this: GlobalEventHandlers, ev: DragEvent) => any;
+    /**
+     * Grid Pro default configuration.
+     * @public
+     */
     ondrop: (this: GlobalEventHandlers, ev: DragEvent) => any;
     ondurationchange: (this: GlobalEventHandlers, ev: Event) => any;
     onemptied: (this: GlobalEventHandlers, ev: Event) => any;
@@ -363,8 +375,8 @@ export declare class GridPro extends GridPro_base {
     gridComponents: {
         [componentName: string]: any;
     };
-    protected agAttributes: any;
-    protected agPropertiesMap: any;
+    protected agAttributes: Record<string, string>;
+    protected agPropertiesMap: Record<string, string>;
     protected agGridOptions: GridOptions;
     protected initialised: boolean;
     private rehydrationAttempted;
@@ -384,15 +396,23 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     private removeConfigWidthsToAutosize;
-    private serialiseStoreTableConfig;
-    private rehydrateTableConfig;
+    private saveColumnState;
+    /**
+     * Gets the saved grid ColumnState[] from local storage
+     * @remarks This is used to restore the grid state when the grid is rehydrated
+     * @privateRemarks Not using `columnApi.get|setColumnState()` for these flows as it doesn't work setting new columnDefs vs different ordering.
+     * @public
+     */
+    getSavedColumnState(): ColumnState[];
+    private restoreColumnState;
     /**
      * @public
      */
     get gridOptions(): GridOptions;
+    get gridProGenesisDatasource(): GridProGenesisDatasource;
     set gridOptions(options: GridOptions);
     private enableFlashingRows;
-    applyTemplateDefinitions(columnDefs?: ColDef[]): ColDef<any>[];
+    applyTemplateDefinitions(columnDefs: ColDef[], deferredColumnDefs?: boolean): ColDef<any>[];
     get observedAttributes(): string[];
     agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
     globalEventListener(eventType: any, event: any): void;

package/dist/dts/grid-pro.d.ts.map

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

package/dist/dts/utils/array.d.ts

@@ -0,0 +1,9 @@
+import { ColDef, ColumnState } from '@ag-grid-community/core';
+/**
+ * Merges two arrays, one of `ColDef` and one of `ColumnState`, and deduplicates them.
+ * @remarks ColDef uses `field` and ColumnState uses `colId` to identify columns.
+ * @privateRemarks For restoring saved `ColumnState` but also keep custom renderers and other `ColDef` properties.
+ * @public
+ */
+export declare function mergeAndDedupColDefWithColumnState(colDefs: ColDef[], columnStates: ColumnState[], arr1Field?: string, arr2Field?: string): ColDef[];
+//# sourceMappingURL=array.d.ts.map

package/dist/dts/utils/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/utils/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,WAAW,EAAE,EAC3B,SAAS,SAAU,EACnB,SAAS,SAAU,GAClB,MAAM,EAAE,CAuBV"}

package/dist/dts/utils/index.d.ts

@@ -1,2 +1,3 @@
+export * from './array';
 export * from './logger';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/esm/grid-pro-genesis-datasource/grid-pro-genesis-datasource.js

@@ -164,6 +164,12 @@ let GridProGenesisDatasource = class GridProGenesisDatasource extends LifecycleM
         this.deinit();
         this.init();
     }
+    /**
+     * Force the grid to redispatch the current rows
+     */
+    refreshRows() {
+        this.updateRowData(Array.from(this.rows.values()));
+    }
     /**
      * Sends a DATA_LOGOFF when the resource is an active stream
      * @remarks Will only happen for streaming DATASERER resources.
@@ -186,7 +192,8 @@ let GridProGenesisDatasource = class GridProGenesisDatasource extends LifecycleM
         if (agColumnDefs) {
             this.agGrid.gridApi.setColumnDefs(agColumnDefs);
         }
-        this.agGrid.gridApi.setRowData(rowData);
+        const data = this.rowDataMapper ? this.rowDataMapper(rowData) : rowData;
+        this.agGrid.gridApi.setRowData(data);
         this.requiresFullRowDataAndColDefs = false;
     }
     loadResourceData(withFullInit = true) {
@@ -295,7 +302,7 @@ let GridProGenesisDatasource = class GridProGenesisDatasource extends LifecycleM
         this.handleStreamInserts(rowsToInsert);
         this.handleStreamDeletes(rowsToDelete);
         this.handleStreamUpdates(rowsToUpdate);
-        this.agGrid.gridApi.applyTransaction(this.agTransaction);
+        this.agGrid.gridApi.applyTransaction(this.mapTransaction(this.agTransaction));
     }
     applyDataserverData(dataServerResult) {
         var _a;
@@ -311,7 +318,13 @@ let GridProGenesisDatasource = class GridProGenesisDatasource extends LifecycleM
         this.handleStreamInserts(dataServerResult.inserts);
         this.handleStreamDeletes(dataServerResult.deletes);
         this.handleStreamUpdates(dataServerResult.updates);
-        this.agGrid.gridApi.applyTransaction(this.agTransaction);
+        this.agGrid.gridApi.applyTransaction(this.mapTransaction(this.agTransaction));
+    }
+    mapTransaction(transaction) {
+        if (!this.rowDataMapper) {
+            return transaction;
+        }
+        return Object.assign(Object.assign({}, transaction), { add: this.rowDataMapper(transaction.add, this.rows), update: this.rowDataMapper(transaction.update, this.rows), remove: this.rowDataMapper(transaction.remove, this.rows) });
     }
     handleStreamInserts(insertedRows) {
         insertedRows === null || insertedRows === void 0 ? void 0 : insertedRows.forEach((insertData) => {
@@ -371,7 +384,7 @@ let GridProGenesisDatasource = class GridProGenesisDatasource extends LifecycleM
             }
             return Object.assign(Object.assign({ field: field.name }, cellConfigs), templateColDef);
         });
-        const colDefsMergedWithTemplateDefs = this.agGrid.applyTemplateDefinitions(colDefsFromGenesisData);
+        const colDefsMergedWithTemplateDefs = this.agGrid.applyTemplateDefinitions(colDefsFromGenesisData, true);
         return colDefsMergedWithTemplateDefs;
     }
     buildCriteria() {
@@ -437,6 +450,9 @@ __decorate([
 __decorate([
     attr({ mode: 'boolean', attribute: 'restart-on-reconnection' })
 ], GridProGenesisDatasource.prototype, "restartOnReconnection", void 0);
+__decorate([
+    observable
+], GridProGenesisDatasource.prototype, "rowDataMapper", void 0);
 GridProGenesisDatasource = __decorate([
     customElement({
         name: 'grid-pro-genesis-datasource',

package/dist/esm/grid-pro.js

@@ -16,12 +16,19 @@ import { DEBOUNCED_RESIZE_TIME } from './grid-pro.definitions';
 import { foundationGridProStyles as styles } from './grid-pro.styles';
 import { gridProTemplate as template } from './grid-pro.template';
 import { AgGridTheme, GridProRendererTypes, agThemeFontsId, agThemeTokenMapClassname, } from './grid-pro.types';
+import { mergeAndDedupColDefWithColumnState } from './utils';
 GridProGenesisDatasource;
 GridProGenesisDatasourceNext;
 GridProCell;
 GridColumn;
 ModuleRegistry.registerModules([CsvExportModule, ClientSideRowModelModule]);
-const hypenateAndLowercase = (property) => property.replace('/([a-z])([A-Z])/g', '$1-$2').toLowerCase();
+/**
+ * Convert string values from 'camelCase' to 'kebab-case'
+ * @param value - The value to convert to Kebab case.
+ * @returns The Kebab case result.
+ * @public
+ */
+export const convertToKebabCase = (value) => value.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
 /**
  * The Grid Pro element.
  * @remarks Grid Pro is a Web Component wrapper around the AG Grid Community library.
@@ -62,7 +69,7 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
         this.agAttributes = {};
         this.agPropertiesMap = ComponentUtil.ALL_PROPERTIES.reduce((map, property) => {
             map[property.toLowerCase()] = property;
-            map[hypenateAndLowercase(property)] = property;
+            map[convertToKebabCase(property)] = property;
             return map;
         }, {});
     }
@@ -134,28 +141,45 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
     removeConfigWidthsToAutosize(colState) {
         return colState.map((col) => (Object.assign(Object.assign({}, col), { width: null })));
     }
-    serialiseStoreTableConfig() {
+    saveColumnState() {
         if (this.rehydrationAttempted && this.statePersistanceEnabled()) {
             const existingOptions = JSON.parse(this.session.getLocalStorageItem('gridOptions') || '{}');
-            let colState = this.agGridOptions.columnApi.getColumnState();
+            let colState = this.columnApi.getColumnState();
             colState = this.gridAutosizingEnabled
                 ? this.removeConfigWidthsToAutosize(colState)
                 : colState;
+            if (colState.length === 0)
+                return;
             existingOptions[this.persistColumnStateKey] = JSON.stringify(colState);
             this.session.setLocalStorageItem('gridOptions', JSON.stringify(existingOptions));
         }
     }
-    rehydrateTableConfig() {
-        this.rehydrationAttempted = true;
-        if (this.statePersistanceEnabled() && this.session.getLocalStorageItem('gridOptions')) {
-            const allGridOptions = JSON.parse(this.session.getLocalStorageItem('gridOptions'));
+    /**
+     * Gets the saved grid ColumnState[] from local storage
+     * @remarks This is used to restore the grid state when the grid is rehydrated
+     * @privateRemarks Not using `columnApi.get|setColumnState()` for these flows as it doesn't work setting new columnDefs vs different ordering.
+     * @public
+     */
+    getSavedColumnState() {
+        const localStorageGridOptions = this.session.getLocalStorageItem('gridOptions');
+        if (this.statePersistanceEnabled() && localStorageGridOptions) {
+            const allGridOptions = JSON.parse(localStorageGridOptions);
             if (this.persistColumnStateKey in allGridOptions) {
-                this.agGridOptions.columnApi.applyColumnState({
-                    state: JSON.parse(allGridOptions[this.persistColumnStateKey]),
-                    applyOrder: true,
-                });
+                return JSON.parse(allGridOptions[this.persistColumnStateKey]);
             }
         }
+        return [];
+    }
+    restoreColumnState() {
+        var _a;
+        this.rehydrationAttempted = true;
+        const colState = this.getSavedColumnState();
+        if (colState && colState.length > 0) {
+            (_a = this.columnApi) === null || _a === void 0 ? void 0 : _a.applyColumnState({
+                state: colState,
+                applyOrder: true,
+            });
+        }
     }
     /**
      * @public
@@ -163,13 +187,15 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
     get gridOptions() {
         return this.agGridOptions;
     }
+    get gridProGenesisDatasource() {
+        return this.querySelector('grid-pro-genesis-datasource');
+    }
     set gridOptions(options) {
         const globalEventListener = this.globalEventListener.bind(this);
         const gridOnChangeCallback = () => {
-            this.serialiseStoreTableConfig.bind(this)();
+            this.saveColumnState.bind(this)();
             this.debouncedColumnAutosize.bind(this)();
         };
-        const rehydrateTableConfig = this.rehydrateTableConfig.bind(this);
         Array.from(this.attributes).forEach((attribute) => {
             const attrName = this.agPropertiesMap[attribute.name];
             if (!attrName)
@@ -181,7 +207,7 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
                 filter: true,
                 resizable: true,
                 sortable: true,
-            }, columnDefs: this.applyTemplateDefinitions(columnDefs), components: this.combineAllGridComponents(components), suppressDragLeaveHidesColumns: true }, this.eventsAndCallbacks), { onGridReady: (params) => {
+            }, components: this.combineAllGridComponents(components), suppressDragLeaveHidesColumns: true }, this.eventsAndCallbacks), { onGridReady: (params) => {
                 var _a, _b;
                 this.gridApi = (_a = options.api) !== null && _a !== void 0 ? _a : params.api;
                 this.columnApi = (_b = options.columnApi) !== null && _b !== void 0 ? _b : params.columnApi;
@@ -192,11 +218,14 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
                     params,
                     gridId: this.id,
                 });
-                rehydrateTableConfig();
+                this.restoreColumnState.bind(this)();
                 this.debouncedColumnAutosize.bind(this)();
             }, onFirstDataRendered: () => {
-                this.enableFlashingRows.bind(this);
+                this.enableFlashingRows.bind(this)();
             }, onColumnPinned: gridOnChangeCallback, onColumnResized: gridOnChangeCallback, onColumnMoved: gridOnChangeCallback, onDisplayedColumnsChanged: gridOnChangeCallback, onFilterChanged: gridOnChangeCallback, onGridSizeChanged: gridOnChangeCallback, onSortChanged: gridOnChangeCallback }), rest);
+        if (!this.gridProGenesisDatasource) {
+            derivedOptions.columnDefs = this.applyTemplateDefinitions(columnDefs);
+        }
         this.agGridOptions = Object.assign(Object.assign({}, this.agGridOptions), ComponentUtil.copyAttributesToGridOptions(derivedOptions, this.agAttributes));
         const gridParams = {
             globalEventListener: globalEventListener,
@@ -226,40 +255,49 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
             });
         }
     }
-    applyTemplateDefinitions(columnDefs = []) {
+    applyTemplateDefinitions(columnDefs, deferredColumnDefs = false) {
+        const columnDefinitions = columnDefs || [];
         const agColumnNodes = this.querySelectorAll(this.columnComponentName);
         const overrides = Array.from(agColumnNodes).map((x) => { var _a; return (_a = x.definition) === null || _a === void 0 ? void 0 : _a.field; });
-        if (agColumnNodes.length === 0)
-            return columnDefs;
-        const mergedColumnDefs = [
-            ...(columnDefs ? columnDefs.filter((g) => !overrides.includes(g.field)) : []),
-            ...Array.from(agColumnNodes).map((x) => {
-                var _a;
-                if (this.enableCellFlashing && x.definition.enableCellChangeFlash === undefined) {
-                    x.definition.enableCellChangeFlash = true;
-                }
-                // Applies the default valueformatter for given data type, if unspecified in user colDefs
-                // Skip if autoCellRendererByType is disabled
-                if (!this.autoCellRendererByType || x.definition.valueFormatter) {
+        let colDefsToReturn = [];
+        if (agColumnNodes.length === 0) {
+            colDefsToReturn = columnDefinitions;
+        }
+        else {
+            colDefsToReturn = [
+                ...columnDefinitions.filter((g) => !overrides.includes(g.field)),
+                ...Array.from(agColumnNodes).map((x) => {
+                    var _a;
+                    if (this.enableCellFlashing && x.definition.enableCellChangeFlash === undefined) {
+                        x.definition.enableCellChangeFlash = true;
+                    }
+                    // Applies the default valueformatter for given data type, if unspecified in user colDefs
+                    // Skip if autoCellRendererByType is disabled
+                    if (!this.autoCellRendererByType || x.definition.valueFormatter) {
+                        return x.definition;
+                    }
+                    const typeValueFormatter = (_a = columnDefinitions.find((colDef) => x.definition.field === colDef.field)) === null || _a === void 0 ? void 0 : _a.valueFormatter;
+                    if (typeValueFormatter) {
+                        x.definition.valueFormatter = typeValueFormatter;
+                    }
                     return x.definition;
-                }
-                const typeValueFormatter = (_a = columnDefs === null || columnDefs === void 0 ? void 0 : columnDefs.find((colDef) => x.definition.field === colDef.field)) === null || _a === void 0 ? void 0 : _a.valueFormatter;
-                if (typeValueFormatter) {
-                    x.definition.valueFormatter = typeValueFormatter;
-                }
-                return x.definition;
-            }),
-        ];
-        return mergedColumnDefs;
+                }),
+            ];
+        }
+        if (this.gridProGenesisDatasource && deferredColumnDefs) {
+            const savedColumnState = this.getSavedColumnState();
+            return mergeAndDedupColDefWithColumnState(colDefsToReturn, savedColumnState);
+        }
+        return colDefsToReturn;
     }
     get observedAttributes() {
-        // allow properties to be supplied either lowercased or hyphenated
+        // allow properties to be supplied either lowercased or kebab-cased
         // this allows the user to either supply (for example) enableSorting or enabled-sorting
         // properties lowercased
         const lowerCasedPropertyNames = ComponentUtil.ALL_PROPERTIES.map((property) => property.toLowerCase());
-        // properties hyphenated
-        const hyphenatedPropertyNames = ComponentUtil.ALL_PROPERTIES.map((property) => hypenateAndLowercase(property));
-        return lowerCasedPropertyNames.concat(hyphenatedPropertyNames);
+        // properties kebab-cased
+        const kebabCasePropertyNames = ComponentUtil.ALL_PROPERTIES.map((property) => convertToKebabCase(property));
+        return lowerCasedPropertyNames.concat(kebabCasePropertyNames);
     }
     agAttributeChangedCallback(attName, oldValue, newValue) {
         if (oldValue === newValue) {