@genesislcap/grid-pro 14.318.0 → 14.320.0

package/README.md

@@ -105,32 +105,149 @@ The `<grid-pro>` element supports the following attributes and properties:
 
 |Name|Type|Default|Description|
 |----|----|-------|-----------|
-| `:rowData` | `any[]` | - | **Manual data**: Array of row data for scenarios where you set data manually without using datasource components. |
-| `:gridComponents` | `{[componentName: string]: any}` | - | **Custom components**: Object containing custom AG Grid components (cell renderers, editors, filters). |
-| `:eventsAndCallbacks` | `GridProEventsAndCallbacks` | - | **AG Grid events**: Object containing AG Grid event handlers and callbacks. |
-| `:gridFontFace` | `string` | `defaultAgGridFontFace` | **Font configuration**: Font face configuration for AG Grid themes. |
-| `auto-cell-renderer-by-type` | `boolean` | `false` | **Genesis-specific**: Enable automatic cell renderer selection by data type. |
-| `only-template-col-defs` | `boolean` | `false` | **Genesis-specific**: Use only template-defined column definitions, ignore metadata. |
-| `grid-autosizing` | `boolean` | `false` | **Important**: Controls automatic column sizing on interaction. Disables manual column widths and local storage persistence of widths. |
 | `add-index` | `number` | `0` | Index position for new rows when using `applyTransaction` or `applyTransactionAsync`. |
 | `async-add` | `boolean` | `false` | Use `applyTransactionAsync` for add transactions (better performance for large datasets). |
 | `async-remove` | `boolean` | `false` | Use `applyTransactionAsync` for remove transactions (better performance for large datasets). |
 | `async-update` | `boolean` | `true` | Use `applyTransactionAsync` for update transactions (enabled by default for performance). |
+| `auto-cell-renderer-by-type` | `boolean` | `false` | **Genesis-specific**: Enable automatic cell renderer selection by data type. |
+| `column-component-name` | `string` | `grid-pro-column` | **Internal**: Name of the column component to use. |
 | `enable-cell-flashing` | `boolean` | `false` | Enable cell flashing animations when cell values change. |
 | `enable-row-flashing` | `boolean` | `false` | Enable row flashing animations for add transactions. |
 | `enabled-row-flashing` | `boolean` | `false` | **@deprecated** - Use `enable-row-flashing` instead. |
-| `persist-column-state-key` | `string` | - | **Key for persisting column state** in local browser or KV storage. Essential for maintaining user preferences. |
-| `persist-filter-model-key` | `string` | - | **Key for persisting filter model** in local browser or KV storage. Maintains filter state across sessions. |
+| `grid-autosizing` | `boolean` | `false` | **Important**: Controls automatic column sizing on interaction. Disables manual column widths and local storage persistence of widths. |
 | `header-case-type` | `GridProCaseType` | `CONSTANT_CASE` | Transform header names: `camelCase`, `capitalCase`, `dotCase`, `headerCase`, `noCase`, `paramCase`, `pascalCase`, `pathCase`, `sentenceCase`, `snakeCase`. |
-| `column-component-name` | `string` | `grid-pro-column` | **Internal**: Name of the column component to use. |
 | `header-height` | `number` | - | Custom header height in pixels. Overrides theme defaults. |
-| `row-height` | `number` | - | Custom row height in pixels. Overrides theme defaults. |
-| `theme` | `string` | `alpine` | AG Grid theme name. Available: `alpine`, `alpine-dark`, `balham`, `balham-dark`, `material`. |
+| `only-template-col-defs` | `boolean` | `false` | **Genesis-specific**: Use only template-defined column definitions, ignore metadata. |
 | `pagination` | `boolean` | `false` | **Enables pagination**. Basic pagination works with AG Grid Community edition. **Enterprise features** like custom pagination components require AG Grid Enterprise. Works with both client-side and server-side datasources. |
 | `pagination-page-size` | `number` | `25` | Number of rows per page when pagination is enabled. |
+| `persist-column-state-key` | `string` | - | **Key for persisting column state** in local browser or KV storage. Essential for maintaining user preferences. |
+| `persist-filter-model-key` | `string` | - | **Key for persisting filter model** in local browser or KV storage. Maintains filter state across sessions. |
+| `row-height` | `number` | - | Custom row height in pixels. Overrides theme defaults. |
+| `theme` | `string` | `alpine` | AG Grid theme name. Available: `alpine`, `alpine-dark`, `balham`, `balham-dark`, `material`. |
 | `with-status-bar` | `boolean` | `false` | **Enterprise Feature**: Enables status bar at bottom of grid. **Requires AG Grid Enterprise module**. |
+| `:customErrorHandlerTemplate` | `(prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate` | - | **Custom error handling**: Function that returns a custom template for displaying datasource errors. If not provided, uses the default error dialog. |
+| `:eventsAndCallbacks` | `GridProEventsAndCallbacks` | - | **AG Grid events**: Object containing AG Grid event handlers and callbacks. |
+| `:gridComponents` | `{[componentName: string]: any}` | - | **Custom components**: Object containing custom AG Grid components (cell renderers, editors, filters). |
+| `:gridFontFace` | `string` | `defaultAgGridFontFace` | **Font configuration**: Font face configuration for AG Grid themes. |
+| `:rowData` | `any[]` | - | **Manual data**: Array of row data for scenarios where you set data manually without using datasource components. |
 | `:statusBarConfig` | `GridProStatusBarConfig` | `DEFAULT_STATUS_BAR_CONFIG` | **Enterprise Feature**: Configuration for status bar components. Must use binding syntax with observable property. |
 
+## Custom Error Handling
+
+**Custom Error Handler Template**: Grid Pro allows you to provide a custom template for displaying datasource errors using the `customErrorHandlerTemplate` attribute. This gives you full control over the error display UI.
+
+### Custom Error Handler Configuration
+
+The `customErrorHandlerTemplate` property accepts a function that receives:
+- `prefix`: Design system prefix (e.g., 'rapid', 'foundation')
+- `gridErrorItems`: Array of error items with `detail` and `type` properties
+
+```typescript
+interface GridProErrorItem<T = any> {
+  detail: T;    // Error details (message, object, etc.)
+  type: string; // Error type ('datasource', etc.)
+}
+```
+
+**Available Utility Functions:**
+
+Grid Pro exports an `extractErrorMessage` utility function that can help extract user-friendly error messages from error details:
+
+```typescript
+import { extractErrorMessage } from '@genesislcap/grid-pro';
+
+// Usage in custom error templates
+const message = extractErrorMessage(error.detail);
+```
+
+This utility handles various error detail formats and provides consistent message extraction.
+
+### Usage Examples
+
+**1. Simple Custom Error Dialog:**
+
+```html
+<grid-pro 
+  :customErrorHandlerTemplate="${() => myCustomErrorTemplate}">
+  <grid-pro-client-side-datasource
+    resource-name="ALL_TRADES">
+  </grid-pro-client-side-datasource>
+</grid-pro>
+```
+
+**Custom Error Template Implementation:**
+
+```typescript
+import { html, when } from '@microsoft/fast-element';
+import { GridProErrorItem } from '@genesislcap/grid-pro';
+
+const customErrorTemplate = (prefix: string, errors: GridProErrorItem<any>[]) => html`
+  ${when(() => errors.length > 0, html`
+    <div class="custom-error-overlay">
+      <${prefix}-card class="error-card">
+        <h3>⚠️ Connection Error</h3>
+        <p>Unable to load data. Please check your connection.</p>
+        <${prefix}-button @click=${(x) => x.querySelector('grid-pro').hideDatasourceError()}>
+          Dismiss
+        </${prefix}-button>
+      </${prefix}-card>
+    </div>
+  `)}
+`;
+```
+
+**2. Advanced Custom Error Handler with Details:**
+
+```html
+<grid-pro 
+  :customErrorHandlerTemplate="${() => advancedErrorHandlerTemplate}">
+  <grid-pro-server-side-datasource
+    resource-name="ALL_POSITIONS">
+  </grid-pro-server-side-datasource>
+</grid-pro>
+```
+
+**Advanced Error Template Implementation:**
+
+```typescript
+import { html, when, repeat } from '@microsoft/fast-element';
+import { extractErrorMessage } from '@genesislcap/grid-pro';
+
+const advancedErrorHandlerTemplate = (prefix: string, errors: GridProErrorItem<any>[]) => html`
+  ${when(() => errors.length > 0, html`
+    <div class="error-overlay">
+      <${prefix}-dialog class="custom-error-dialog" open>
+        <h2 slot="header">Data Loading Failed</h2>
+        <div class="error-content">
+          <p>Failed to load grid data:</p>
+          <ul class="error-list">
+            ${repeat(errors, html`
+              <li>${(error) => extractErrorMessage(error.detail)}</li>
+            `)}
+          </ul>
+        </div>
+        <div slot="footer">
+          <${prefix}-button 
+            appearance="accent" 
+            @click=${(x) => {
+              const grid = x.querySelector('grid-pro');
+              grid.hideDatasourceError();
+              grid.querySelector('grid-pro-server-side-datasource')?.restart();
+            }}>
+            Reload Data
+          </${prefix}-button>
+          <${prefix}-button 
+            appearance="lightweight" 
+            @click=${(x) => x.querySelector('grid-pro').hideDatasourceError()}>
+            Dismiss
+          </${prefix}-button>
+        </div>
+      </${prefix}-dialog>
+    </div>
+  `)}
+`;
+```
+
 #### Status Bar Configuration
 
 **Enterprise License Required**: Status bar functionality requires the AG Grid Enterprise license and the `StatusBarModule` to be registered (see [Enterprise Module Registration](#enterprise-module-registration) above). Status bar components will only be displayed if the Enterprise module is properly licensed and configured.

package/dist/custom-elements.json

@@ -586,6 +586,14 @@
               "default": "false",
               "description": "Enables or disables the grid status bar."
             },
+            {
+              "kind": "field",
+              "name": "customErrorHandlerTemplate",
+              "type": {
+                "text": "(\n    prefix: string,\n    gridErrorItems: GridProErrorItem<any>[],\n  ) => ViewTemplate | undefined"
+              },
+              "description": "Custom error handler dialog template function."
+            },
             {
               "kind": "field",
               "name": "columnState",
@@ -4198,7 +4206,7 @@
               "type": {
                 "text": "ActionMenuItem[]"
               },
-              "description": "Array of {@link @genesislcap/foundation-ui#ActionMenuItem}to be displayed in the menu.\n * "
+              "description": "Array of `ActionMenuItem` to be displayed in the menu."
             },
             {
               "name": "overrideDef",
@@ -9667,7 +9675,7 @@
         {
           "kind": "variable",
           "name": "errorHandlerDialogStyles",
-          "default": "css`\n  .overlay {\n    position: absolute;\n    inset: 0;\n    width: 100%;\n    height: 100%;\n    background-color: var(--datasource-error-background-color, var(--neutral-layer-4));\n    opacity: var(--datasource-error-background-opacity, 0.5);\n    z-index: 1000;\n    pointer-events: auto;\n    border-radius: 2px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n  }\n  .dialog-container {\n    position: absolute;\n    left: 50%;\n    top: 50%;\n    transform: translate(-50%, -50%);\n    z-index: 1001;\n    max-width: 90vw;\n    max-height: 90vh;\n    width: 100%;\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    opacity: 1 !important;\n    filter: none !important;\n    box-sizing: border-box;\n  }\n  .grid-datasource-error-dialog {\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    margin: 0 auto;\n    max-width: 400px;\n    width: 100%;\n    box-sizing: border-box;\n    background: var(--dialog-background, #2d2533);\n    box-shadow: 0 4px 32px 0 rgba(0, 0, 0, 0.45);\n    overflow: visible;\n    min-height: 120px;\n  }\n  .error-details {\n    max-height: 120px;\n    overflow: auto;\n    width: 100%;\n    margin-top: 8px;\n  }\n`"
+          "default": "css`\n  .overlay {\n    position: absolute;\n    inset: 0;\n    width: 100%;\n    height: 100%;\n    background-color: var(--datasource-error-background-color, var(--neutral-layer-4));\n    opacity: var(--datasource-error-background-opacity, 0.5);\n    z-index: 1000;\n    pointer-events: auto;\n    border-radius: 2px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n  }\n  .dialog-container {\n    position: absolute;\n    left: 50%;\n    top: 50%;\n    transform: translate(-50%, -50%);\n    z-index: 1001;\n    max-width: 90vw;\n    max-height: 90vh;\n    width: 100%;\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    opacity: 1 !important;\n    filter: none !important;\n    box-sizing: border-box;\n  }\n  .grid-datasource-error-dialog {\n    display: flex;\n    flex-direction: column;\n    align-items: center;\n    justify-content: center;\n    margin: 0 auto;\n    max-width: 600px;\n    width: 100%;\n    box-sizing: border-box;\n    background: var(--dialog-background, #2d2533);\n    box-shadow: 0 4px 32px 0 rgba(0, 0, 0, 0.45);\n    overflow: visible;\n    min-height: 120px;\n  }\n\n  .grid-datasource-error-dialog div {\n    width: 600px;\n  }\n\n  .grid-datasource-error-dialog [slot='top'] {\n    margin-bottom: 0;\n  }\n\n  .grid-datasource-error-dialog [slot='bottom'] {\n    display: flex;\n    justify-content: flex-end;\n    width: 100%;\n  }\n\n  .error-details {\n    max-height: 120px;\n    overflow: auto;\n    width: 100%;\n    margin-top: 8px;\n  }\n`"
         },
         {
           "kind": "function",
@@ -9682,7 +9690,7 @@
             {
               "name": "gridErrorItems",
               "type": {
-                "text": "any[]"
+                "text": "GridProErrorItem<any>[]"
               }
             }
           ]
@@ -15716,6 +15724,42 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/error.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "extractErrorMessage",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "detail",
+              "type": {
+                "text": "any"
+              },
+              "description": "The error detail, which can be a string, array, or object."
+            }
+          ],
+          "description": "Extracts a user-friendly error message from a given error detail.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "extractErrorMessage",
+          "declaration": {
+            "name": "extractErrorMessage",
+            "module": "src/utils/error.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/index.ts",
@@ -15729,6 +15773,14 @@
             "package": "./array"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./error"
+          }
+        },
         {
           "kind": "js",
           "name": "*",

package/dist/dts/cell-renderers/actions-menu.renderer.d.ts

@@ -30,7 +30,7 @@ export declare const foundationGridProActionsMenuRenderer: (overrideDefinition?:
 /**
  * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for Actions Menu Renderer.
  * Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).
- * @param actions - Array of {@link @genesislcap/foundation-ui#ActionMenuItem} to be displayed in the menu.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu.
  * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.
  * @param customActionsOpenerName - Optional custom name for the button that opens the menu. Default is '⋮'.
  * @param isVertical - Optional flag to display the menu vertically. Default is false (displays the menu horizontally, follow the rowHeight).

package/dist/dts/datasource/error-handler.dialog.d.ts

@@ -1,3 +1,4 @@
+import type { GridProErrorItem } from '../grid-pro.types';
 export declare const errorHandlerDialogStyles: import("@microsoft/fast-element").ElementStyles;
-export declare function getErrorHandlerDialogTemplate(prefix: string, gridErrorItems: any[]): import("@microsoft/fast-element").ViewTemplate<any, any>;
+export declare function getErrorHandlerDialogTemplate(prefix: string, gridErrorItems: GridProErrorItem<any>[]): import("@microsoft/fast-element").ViewTemplate<any, any>;
 //# sourceMappingURL=error-handler.dialog.d.ts.map

package/dist/dts/datasource/error-handler.dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.dialog.d.ts","sourceRoot":"","sources":["../../../src/datasource/error-handler.dialog.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,wBAAwB,iDAoDpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,4DAiDlF"}
+{"version":3,"file":"error-handler.dialog.d.ts","sourceRoot":"","sources":["../../../src/datasource/error-handler.dialog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,eAAO,MAAM,wBAAwB,iDAmEpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,4DAgDxC"}

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

@@ -1,5 +1,6 @@
 import type { ColDef, ColumnApi, GridApi, GridOptions, GridParams } from '@ag-grid-community/core';
 import { ColumnState, Grid } from '@ag-grid-community/core';
+import { ViewTemplate } from '@microsoft/fast-element';
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { GridProBaseDatasource } from './datasource/base.datasource';
 import type { GridComponents, GridProCaseType, GridProErrorEvent, GridProErrorItem, GridProEventsAndCallbacks } from './grid-pro.types';
@@ -504,6 +505,14 @@ export declare class GridPro extends GridPro_base {
      * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
      */
     withStatusBar: boolean;
+    /**
+     * Custom error handler dialog template function.
+     * @remarks
+     * When provided, this function will be used to render custom error dialogs instead of the default error handler.
+     * The function should accept a prefix string and an array of grid error items and return a ViewTemplate.
+     * If not provided, the default error handler dialog template will be used.
+     */
+    customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
     private columnState;
     protected agAttributes: Record<string, string>;
     protected agPropertiesMap: Record<string, string>;
@@ -676,12 +685,12 @@ export declare const foundationGridPro: (overrideDefinition?: import("@microsoft
     shadowOptions: any;
     baseName: string;
     styles: import("@microsoft/fast-element").ElementStyles;
-    template: import("@microsoft/fast-element").ViewTemplate<any, any>;
+    template: ViewTemplate<any, any>;
 }>) => import("@microsoft/fast-foundation").FoundationElementRegistry<{
     shadowOptions: any;
     baseName: string;
     styles: import("@microsoft/fast-element").ElementStyles;
-    template: import("@microsoft/fast-element").ViewTemplate<any, any>;
+    template: ViewTemplate<any, any>;
 }, typeof GridPro>;
 export {};
 //# sourceMappingURL=grid-pro.d.ts.map

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/grid-pro.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-pro.template.d.ts","sourceRoot":"","sources":["../../src/grid-pro.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAqB,+BAYvD,CAAC;AACF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,YAAmC,CAAC"}
+{"version":3,"file":"grid-pro.template.d.ts","sourceRoot":"","sources":["../../src/grid-pro.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAqB,+BAiBvD,CAAC;AACF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,YAAmC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Extracts a user-friendly error message from a given error detail.
+ * @param detail - The error detail, which can be a string, array, or object.
+ * @returns A user-friendly error message.
+ * @public
+ */
+export declare const extractErrorMessage: (detail: any) => string;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,GAAG,KAAG,MAYjD,CAAC"}

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

@@ -1,4 +1,5 @@
 export * from './array';
+export * from './error';
 export * from './logger';
 export * from './map';
 export * from './sanitasations';

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,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/esm/cell-renderers/actions-menu.renderer.js

@@ -44,7 +44,7 @@ export const foundationGridProActionsMenuRenderer = ActionsMenuRenderer.compose(
 /**
  * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for Actions Menu Renderer.
  * Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).
- * @param actions - Array of {@link @genesislcap/foundation-ui#ActionMenuItem} to be displayed in the menu.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu.
  * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.
  * @param customActionsOpenerName - Optional custom name for the button that opens the menu. Default is '⋮'.
  * @param isVertical - Optional flag to display the menu vertically. Default is false (displays the menu horizontally, follow the rowHeight).

package/dist/esm/datasource/error-handler.dialog.js

@@ -1,21 +1,5 @@
 import { css, html, when, repeat } from '@microsoft/fast-element';
-const extractMessage = (detail) => {
-    if (!detail)
-        return '';
-    if (typeof detail === 'string')
-        return detail;
-    if (Array.isArray(detail)) {
-        return detail.map(extractMessage).join(', ');
-    }
-    if (typeof detail === 'object') {
-        if ('message' in detail && typeof detail.message === 'string')
-            return detail.message;
-        if ('TEXT' in detail && typeof detail.TEXT === 'string')
-            return detail.TEXT;
-        return JSON.stringify(detail);
-    }
-    return String(detail);
-};
+import { extractErrorMessage } from '../utils';
 export const errorHandlerDialogStyles = css `
   .overlay {
     position: absolute;
@@ -54,7 +38,7 @@ export const errorHandlerDialogStyles = css `
     align-items: center;
     justify-content: center;
     margin: 0 auto;
-    max-width: 400px;
+    max-width: 600px;
     width: 100%;
     box-sizing: border-box;
     background: var(--dialog-background, #2d2533);
@@ -62,6 +46,21 @@ export const errorHandlerDialogStyles = css `
     overflow: visible;
     min-height: 120px;
   }
+
+  .grid-datasource-error-dialog div {
+    width: 600px;
+  }
+
+  .grid-datasource-error-dialog [slot='top'] {
+    margin-bottom: 0;
+  }
+
+  .grid-datasource-error-dialog [slot='bottom'] {
+    display: flex;
+    justify-content: flex-end;
+    width: 100%;
+  }
+
   .error-details {
     max-height: 120px;
     overflow: auto;
@@ -82,22 +81,20 @@ export function getErrorHandlerDialogTemplate(prefix, gridErrorItems) {
             show-close-icon="false"
             open
           >
-            <h2 slot="top" class="title">Datasource Error</h2>
+            <h2 slot="top" class="title">Grid unavailable</h2>
             <div>
               <p>
-                The Datasource is currently unavailable due to an error.
-              </p>
-              <p>
-                This may be due to a network issue, server maintenance or a Datasource configuration error.
+                This may be due to a network, server, or configuration issue.
               </p>
               <details class="error-details">
-                <summary>Show error details</summary>
-                ${repeat(() => gridErrorItems, html `
-                    <p>
-                      <strong>Error:</strong>
-                      ${(x) => extractMessage(x.detail) || 'Unknown error occurred'}
-                    </p>
-                  `)}
+                <summary>Show details</summary>
+                <ul>
+                  ${repeat(() => gridErrorItems, html `
+                      <li>
+                        ${(x) => extractErrorMessage(x.detail) || 'Unknown error occurred'}
+                      </li>
+                    `)}
+                </ul>
               </details>
             </div>
             <div slot="bottom">

package/dist/esm/grid-pro.js

@@ -904,6 +904,9 @@ __decorate([
 __decorate([
     attr({ mode: 'boolean', attribute: 'with-status-bar' })
 ], GridPro.prototype, "withStatusBar", void 0);
+__decorate([
+    observable
+], GridPro.prototype, "customErrorHandlerTemplate", void 0);
 __decorate([
     GridOptionsConfig
 ], GridPro.prototype, "gridOptionsConfig", void 0);

package/dist/esm/grid-pro.template.js

@@ -12,7 +12,9 @@ export const getGridProTemplate = (prefix = 'foundation') => html `
       <slot name="grid" ${ref('gridSlot')}></slot>
       <slot></slot>
     </span>
-    ${(x) => getErrorHandlerDialogTemplate(prefix, x.gridErrorItems.filter(({ type }) => type === 'datasource'))}
+    ${(x) => x.customErrorHandlerTemplate
+    ? x.customErrorHandlerTemplate(prefix, x.gridErrorItems.filter(({ type }) => type === 'datasource'))
+    : getErrorHandlerDialogTemplate(prefix, x.gridErrorItems.filter(({ type }) => type === 'datasource'))}
   </template>
 `;
 /**

package/dist/esm/utils/error.js

@@ -0,0 +1,23 @@
+/**
+ * Extracts a user-friendly error message from a given error detail.
+ * @param detail - The error detail, which can be a string, array, or object.
+ * @returns A user-friendly error message.
+ * @public
+ */
+export const extractErrorMessage = (detail) => {
+    if (!detail)
+        return '';
+    if (typeof detail === 'string')
+        return detail;
+    if (Array.isArray(detail)) {
+        return detail.map(extractErrorMessage).join(', ');
+    }
+    if (typeof detail === 'object') {
+        if ('message' in detail && typeof detail.message === 'string')
+            return detail.message;
+        if ('TEXT' in detail && typeof detail.TEXT === 'string')
+            return detail.TEXT;
+        return JSON.stringify(detail);
+    }
+    return String(detail);
+};

package/dist/esm/utils/index.js

@@ -1,4 +1,5 @@
 export * from './array';
+export * from './error';
 export * from './logger';
 export * from './map';
 export * from './sanitasations';

package/dist/grid-pro.api.json

@@ -4709,6 +4709,47 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/grid-pro!extractErrorMessage:function(1)",
+          "docComment": "/**\n * Extracts a user-friendly error message from a given error detail.\n *\n * @param detail - The error detail, which can be a string, array, or object.\n *\n * @returns A user-friendly error message.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "extractErrorMessage: (detail: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            }
+          ],
+          "fileUrlPath": "src/utils/error.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "detail",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "extractErrorMessage"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/grid-pro!formatDateExtra:function(1)",
@@ -6582,7 +6623,7 @@
             },
             {
               "kind": "Content",
-              "text": ";\n    template: import(\"@microsoft/fast-element\")."
+              "text": ";\n    template: "
             },
             {
               "kind": "Reference",
@@ -6617,7 +6658,7 @@
             },
             {
               "kind": "Content",
-              "text": ";\n    template: import(\"@microsoft/fast-element\")."
+              "text": ";\n    template: "
             },
             {
               "kind": "Reference",
@@ -8693,7 +8734,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/grid-pro!getActionsMenuDef:function(1)",
-          "docComment": "/**\n * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for Actions Menu Renderer. Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).\n *\n * @param actions - Array of {@link @genesislcap/foundation-ui#ActionMenuItem} to be displayed in the menu.\n *\n * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.\n *\n * @param customActionsOpenerName - Optional custom name for the button that opens the menu. Default is '⋮'.\n *\n * @param isVertical - Optional flag to display the menu vertically. Default is false (displays the menu horizontally, follow the rowHeight).\n *\n * @param buttonAppearance - Optional appearance for the button that opens the menu. Default is 'outline'.\n *\n * @returns Merged ColDef (base ColDef created from the parameters + overrideDef) for Actions Menu Renderer.\n *\n * @example\n * ```ts\n * public exampleActionsMenuDef: ColDef = getActionsMenuDef(\n *  [\n *    {\n *      name: 'View',\n *      callback: (rowData) => logger.debug('VIEWW!!!', rowData),\n *    },\n *      {\n *      name: 'Delete',\n *      callback: (rowData) => logger.debug('DELETE!!!', rowData),\n *    },\n *  ],\n *  {\n *    headerName: 'Instrument Actions',\n *    width: 180,\n *  },\n *  '+',\n *  true,\n *  'primary-gradient'\n * );\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for Actions Menu Renderer. Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).\n *\n * @param actions - Array of `ActionMenuItem` to be displayed in the menu.\n *\n * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.\n *\n * @param customActionsOpenerName - Optional custom name for the button that opens the menu. Default is '⋮'.\n *\n * @param isVertical - Optional flag to display the menu vertically. Default is false (displays the menu horizontally, follow the rowHeight).\n *\n * @param buttonAppearance - Optional appearance for the button that opens the menu. Default is 'outline'.\n *\n * @returns Merged ColDef (base ColDef created from the parameters + overrideDef) for Actions Menu Renderer.\n *\n * @example\n * ```ts\n * public exampleActionsMenuDef: ColDef = getActionsMenuDef(\n *  [\n *    {\n *      name: 'View',\n *      callback: (rowData) => logger.debug('VIEWW!!!', rowData),\n *    },\n *      {\n *      name: 'Delete',\n *      callback: (rowData) => logger.debug('DELETE!!!', rowData),\n *    },\n *  ],\n *  {\n *    headerName: 'Instrument Actions',\n *    width: 180,\n *  },\n *  '+',\n *  true,\n *  'primary-gradient'\n * );\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -10566,6 +10607,50 @@
               "isAbstract": false,
               "name": "connectedCallback"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/grid-pro!GridPro#customErrorHandlerTemplate:member",
+              "docComment": "/**\n * Custom error handler dialog template function.\n *\n * @remarks\n *\n * When provided, this function will be used to render custom error dialogs instead of the default error handler. The function should accept a prefix string and an array of grid error items and return a ViewTemplate. If not provided, the default error handler dialog template will be used.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "customErrorHandlerTemplate?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(prefix: string, gridErrorItems: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "GridProErrorItem",
+                  "canonicalReference": "@genesislcap/grid-pro!GridProErrorItem:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<any>[]) => "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ViewTemplate",
+                  "canonicalReference": "@microsoft/fast-element!ViewTemplate:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "customErrorHandlerTemplate",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/grid-pro!GridPro#disconnectedCallback:member(1)",

package/dist/grid-pro.d.ts

@@ -636,6 +636,14 @@ export declare class ErrorTooltip implements ITooltipComp {
     getGui(): HTMLElement;
 }
 
+/**
+ * Extracts a user-friendly error message from a given error detail.
+ * @param detail - The error detail, which can be a string, array, or object.
+ * @returns A user-friendly error message.
+ * @public
+ */
+export declare const extractErrorMessage: (detail: any) => string;
+
 /**
  * The foreground color swatch.
  * @internal
@@ -1494,7 +1502,7 @@ declare const GenesisGridDatasourceElement_base: new () => {
 /**
  * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for Actions Menu Renderer.
  * Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).
- * @param actions - Array of {@link @genesislcap/foundation-ui#ActionMenuItem} to be displayed in the menu.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu.
  * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.
  * @param customActionsOpenerName - Optional custom name for the button that opens the menu. Default is '⋮'.
  * @param isVertical - Optional flag to display the menu vertically. Default is false (displays the menu horizontally, follow the rowHeight).
@@ -1813,6 +1821,14 @@ export declare class GridPro extends GridPro_base {
      * This requires AG Grid Enterprise module to be available for the status bar to be displayed when enabled.
      */
     withStatusBar: boolean;
+    /**
+     * Custom error handler dialog template function.
+     * @remarks
+     * When provided, this function will be used to render custom error dialogs instead of the default error handler.
+     * The function should accept a prefix string and an array of grid error items and return a ViewTemplate.
+     * If not provided, the default error handler dialog template will be used.
+     */
+    customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
     private columnState;
     protected agAttributes: Record<string, string>;
     protected agPropertiesMap: Record<string, string>;

package/docs/api/grid-pro.extracterrormessage.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [extractErrorMessage](./grid-pro.extracterrormessage.md)
+
+## extractErrorMessage() function
+
+Extracts a user-friendly error message from a given error detail.
+
+**Signature:**
+
+```typescript
+extractErrorMessage: (detail: any) => string
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+detail
+
+
+</td><td>
+
+any
+
+
+</td><td>
+
+The error detail, which can be a string, array, or object.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+string
+
+A user-friendly error message.
+

package/docs/api/grid-pro.foundationgridpro.md

@@ -13,12 +13,12 @@ foundationGridPro: (overrideDefinition?: import("@microsoft/fast-foundation").Ov
     shadowOptions: any;
     baseName: string;
     styles: import("@microsoft/fast-element").ElementStyles;
-    template: import("@microsoft/fast-element").ViewTemplate<any, any>;
+    template: ViewTemplate<any, any>;
 }>) => import("@microsoft/fast-foundation").FoundationElementRegistry<{
     shadowOptions: any;
     baseName: string;
     styles: import("@microsoft/fast-element").ElementStyles;
-    template: import("@microsoft/fast-element").ViewTemplate<any, any>;
+    template: ViewTemplate<any, any>;
 }, typeof GridPro>
 ```
 
@@ -47,7 +47,7 @@ overrideDefinition
 
 </td><td>
 
-import("@microsoft/fast-foundation").OverrideFoundationElementDefinition&lt;{ shadowOptions: any; baseName: string; styles: import("@microsoft/fast-element").ElementStyles; template: import("@microsoft/fast-element").ViewTemplate&lt;any, any&gt;; }&gt;
+import("@microsoft/fast-foundation").OverrideFoundationElementDefinition&lt;{ shadowOptions: any; baseName: string; styles: import("@microsoft/fast-element").ElementStyles; template: ViewTemplate&lt;any, any&gt;; }&gt;
 
 
 </td><td>
@@ -60,7 +60,7 @@ _(Optional)_
 
 **Returns:**
 
-import("@microsoft/fast-foundation").FoundationElementRegistry&lt;{ shadowOptions: any; baseName: string; styles: import("@microsoft/fast-element").ElementStyles; template: import("@microsoft/fast-element").ViewTemplate&lt;any, any&gt;; }, typeof [GridPro](./grid-pro.gridpro.md)<!-- -->&gt;
+import("@microsoft/fast-foundation").FoundationElementRegistry&lt;{ shadowOptions: any; baseName: string; styles: import("@microsoft/fast-element").ElementStyles; template: ViewTemplate&lt;any, any&gt;; }, typeof [GridPro](./grid-pro.gridpro.md)<!-- -->&gt;
 
 ## Remarks
 

package/docs/api/grid-pro.getactionsmenudef.md

@@ -42,7 +42,7 @@ ActionMenuItem\[\]
 
 </td><td>
 
-Array of  to be displayed in the menu.
+Array of `ActionMenuItem` to be displayed in the menu.
 
 
 </td></tr>

package/docs/api/grid-pro.gridpro.customerrorhandlertemplate.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GridPro](./grid-pro.gridpro.md) &gt; [customErrorHandlerTemplate](./grid-pro.gridpro.customerrorhandlertemplate.md)
+
+## GridPro.customErrorHandlerTemplate property
+
+Custom error handler dialog template function.
+
+**Signature:**
+
+```typescript
+customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
+```
+
+## Remarks
+
+When provided, this function will be used to render custom error dialogs instead of the default error handler. The function should accept a prefix string and an array of grid error items and return a ViewTemplate. If not provided, the default error handler dialog template will be used.
+

package/docs/api/grid-pro.gridpro.md

@@ -291,6 +291,25 @@ string
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[customErrorHandlerTemplate?](./grid-pro.gridpro.customerrorhandlertemplate.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(prefix: string, gridErrorItems: [GridProErrorItem](./grid-pro.gridproerroritem.md)<!-- -->&lt;any&gt;\[\]) =&gt; ViewTemplate
+
+
+</td><td>
+
+_(Optional)_ Custom error handler dialog template function.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/grid-pro.md

@@ -461,6 +461,17 @@ Returns a formatted date time value from the Grid Pro cell value.
 Returns a formatted date value from the Grid Pro cell value.
 
 
+</td></tr>
+<tr><td>
+
+[extractErrorMessage(detail)](./grid-pro.extracterrormessage.md)
+
+
+</td><td>
+
+Extracts a user-friendly error message from a given error detail.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api-report.md.api.md

@@ -475,6 +475,9 @@ export class ErrorTooltip implements ITooltipComp {
     init(params: ITooltipParams): void;
 }
 
+// @public
+export const extractErrorMessage: (detail: any) => string;
+
 // Warning: (ae-internal-missing-underscore) The name "foregroundSwatch" should be prefixed with an underscore because the declaration is marked as @internal
 //
 // @internal @deprecated
@@ -953,6 +956,7 @@ export class GridPro extends GridPro_base {
     combineAllGridComponents(gridOptionsComponents: GridComponents): GridComponents;
     // (undocumented)
     connectedCallback(): void;
+    customErrorHandlerTemplate?: (prefix: string, gridErrorItems: GridProErrorItem<any>[]) => ViewTemplate;
     // (undocumented)
     disconnectedCallback(): void;
     enableCellFlashing: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/grid-pro",
   "description": "Genesis Foundation AG Grid",
-  "version": "14.318.0",
+  "version": "14.320.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -38,19 +38,19 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.318.0",
-    "@genesislcap/genx": "14.318.0",
-    "@genesislcap/rollup-builder": "14.318.0",
-    "@genesislcap/ts-builder": "14.318.0",
-    "@genesislcap/uvu-playwright-builder": "14.318.0",
-    "@genesislcap/vite-builder": "14.318.0",
-    "@genesislcap/webpack-builder": "14.318.0"
+    "@genesislcap/foundation-testing": "14.320.0",
+    "@genesislcap/genx": "14.320.0",
+    "@genesislcap/rollup-builder": "14.320.0",
+    "@genesislcap/ts-builder": "14.320.0",
+    "@genesislcap/uvu-playwright-builder": "14.320.0",
+    "@genesislcap/vite-builder": "14.320.0",
+    "@genesislcap/webpack-builder": "14.320.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.318.0",
-    "@genesislcap/foundation-logger": "14.318.0",
-    "@genesislcap/foundation-ui": "14.318.0",
-    "@genesislcap/foundation-utils": "14.318.0",
+    "@genesislcap/foundation-comms": "14.320.0",
+    "@genesislcap/foundation-logger": "14.320.0",
+    "@genesislcap/foundation-ui": "14.320.0",
+    "@genesislcap/foundation-utils": "14.320.0",
     "@microsoft/fast-colors": "5.3.1",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
@@ -75,5 +75,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "1904c1e9cb31ff0011555e5337cba101ced5f721"
+  "gitHead": "957aa7b2e81fa3c2915d5154be42c0500790127f"
 }