@genesislcap/grid-tabulator 14.281.2 → 14.282.0

package/dist/grid-tabulator.api.json

@@ -191,7 +191,15 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function actionFormatter(cell: "
+              "text": "export declare function actionFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -206,6 +214,10 @@
               "text": "ActionFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!ActionFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -221,8 +233,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/action.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -230,20 +242,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": true
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "actionFormatter"
         },
         {
@@ -253,7 +278,15 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function actionsMenuFormatter(cell: "
+              "text": "export declare function actionsMenuFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -268,6 +301,10 @@
               "text": "ActionsMenuFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!ActionsMenuFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -283,8 +320,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/actions-menu.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -292,20 +329,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": true
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "actionsMenuFormatter"
         },
         {
@@ -315,7 +365,15 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function booleanFormatter(cell: "
+              "text": "export declare function booleanFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -330,6 +388,10 @@
               "text": "BooleanFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!BooleanFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -345,8 +407,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/boolean.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -354,20 +416,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": true
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "booleanFormatter"
         },
         {
@@ -706,7 +781,15 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function editableFormatter(cell: "
+              "text": "export declare function editableFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -721,6 +804,10 @@
               "text": "EditableFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!EditableFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -736,8 +823,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/editable.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -745,20 +832,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": true
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "editableFormatter"
         },
         {
@@ -2612,11 +2712,19 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/grid-tabulator!selectFormatter:function(1)",
-          "docComment": "/**\n * Formatter that displays a value from a select list of options Styled to match grid-pro select renderer.\n *\n * @param cell - The cell component provided by Tabulator\n *\n * @param formatterParams - Select formatter parameters\n *\n * @returns Text content for the selected option\n *\n * @public\n */\n",
+          "docComment": "/**\n * Formatter that displays a select component with options. Returns a wrapped div containing the select, similar to boolean.formatter.\n *\n * @param cell - The cell component provided by Tabulator\n *\n * @param formatterParams - Select formatter parameters\n *\n * @returns An empty string, as the component is added directly to the cell element\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function selectFormatter(cell: "
+              "text": "export declare function selectFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -2631,6 +2739,10 @@
               "text": "SelectFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!SelectFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -2646,8 +2758,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/select.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -2655,20 +2767,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": false
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "selectFormatter"
         },
         {
@@ -2734,7 +2859,15 @@
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare function textFormatter(cell: "
+              "text": "export declare function textFormatter<T = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": ">(cell: "
             },
             {
               "kind": "Content",
@@ -2749,6 +2882,10 @@
               "text": "TextFormatterParams",
               "canonicalReference": "@genesislcap/grid-tabulator!TextFormatterParams:interface"
             },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
             {
               "kind": "Content",
               "text": "): "
@@ -2764,8 +2901,8 @@
           ],
           "fileUrlPath": "src/cell-formatters/text.formatter.ts",
           "returnTypeTokenRange": {
-            "startIndex": 5,
-            "endIndex": 6
+            "startIndex": 8,
+            "endIndex": 9
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -2773,20 +2910,33 @@
             {
               "parameterName": "cell",
               "parameterTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": false
             },
             {
               "parameterName": "formatterParams",
               "parameterTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 5,
+                "endIndex": 7
               },
               "isOptional": true
             }
           ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
           "name": "textFormatter"
         },
         {

package/dist/grid-tabulator.d.ts

@@ -34,7 +34,7 @@ import { ViewTemplate } from '@microsoft/fast-element';
  * @returns HTML content for the action button
  * @public
  */
-export declare function actionFormatter(cell: any, formatterParams?: ActionFormatterParams): string;
+export declare function actionFormatter<T = any>(cell: any, formatterParams?: ActionFormatterParams<T>): string;
 
 /**
  * Parameters for the action formatter.
@@ -59,12 +59,12 @@ export declare function actionFormatter(cell: any, formatterParams?: ActionForma
  *
  * @alpha
  */
-export declare interface ActionFormatterParams {
-    actionClick?: (rowData: any) => void;
+export declare interface ActionFormatterParams<T = any> {
+    actionClick?: (rowData: T) => void;
     actionName?: string;
     appearance?: string;
-    dataTestId?: string;
-    isDisabled?: (rowData: any) => boolean;
+    dataTestId?: ((rowData: T) => string) | string;
+    isDisabled?: (rowData: T) => boolean;
     uniqueFieldName?: string;
     prefix?: string;
     actionButtonStyle?: string;
@@ -80,7 +80,7 @@ export declare interface ActionFormatterParams {
  * @returns HTML content for the actions menu
  * @public
  */
-export declare function actionsMenuFormatter(cell: any, formatterParams?: ActionsMenuFormatterParams): string;
+export declare function actionsMenuFormatter<T = any>(cell: any, formatterParams?: ActionsMenuFormatterParams<T>): string;
 
 /**
  * Parameters for the actions menu formatter
@@ -95,18 +95,21 @@ export declare function actionsMenuFormatter(cell: any, formatterParams?: Action
  *
  * `buttonAppearance`: Optional appearance for the button that opens the menu.
  *
+ * `dataTestId`: Data test ID for testing
+ *
  * @alpha
  */
-export declare interface ActionsMenuFormatterParams {
+export declare interface ActionsMenuFormatterParams<T = any> {
     actions?: Array<{
         name: string;
-        callback: (rowData: any) => void;
-        isDisabled?: (rowData: any) => boolean;
+        callback: (rowData: T) => void;
+        isDisabled?: (rowData: T) => boolean;
     }>;
     prefix?: string;
     menuName?: string;
     isVertical?: boolean;
     buttonAppearance?: string;
+    dataTestId?: ((rowData: T) => string) | string;
 }
 
 /**
@@ -118,7 +121,7 @@ export declare interface ActionsMenuFormatterParams {
  * @returns HTML content for the boolean value
  * @public
  */
-export declare function booleanFormatter(cell: any, formatterParams?: BooleanFormatterParams): string;
+export declare function booleanFormatter<T = any>(cell: any, formatterParams?: BooleanFormatterParams<T>): string;
 
 /**
  * Parameters for the boolean formatter
@@ -131,9 +134,9 @@ export declare function booleanFormatter(cell: any, formatterParams?: BooleanFor
  *
  * @alpha
  */
-export declare interface BooleanFormatterParams {
-    isDisabled?: (rowData: any) => boolean;
-    dataTestId?: string;
+export declare interface BooleanFormatterParams<T = any> {
+    isDisabled?: (rowData: T) => boolean;
+    dataTestId?: ((rowData: T) => string) | string;
     prefix?: string;
 }
 
@@ -293,7 +296,7 @@ export declare const defaultGridTabulatorConfig: {
  * @returns HTML content for the editable cell
  * @public
  */
-export declare function editableFormatter(cell: any, formatterParams?: EditableFormatterParams): string;
+export declare function editableFormatter<T = any>(cell: any, formatterParams?: EditableFormatterParams<T>): string;
 
 /**
  * Parameters for the editable formatter
@@ -316,13 +319,13 @@ export declare function editableFormatter(cell: any, formatterParams?: EditableF
  *
  * @alpha
  */
-export declare interface EditableFormatterParams {
+export declare interface EditableFormatterParams<T = any> {
     value?: any;
-    data?: any;
+    data?: T;
     field?: string;
     cssClass?: string;
     nullText?: string;
-    dataTestId?: string;
+    dataTestId?: ((rowData: T) => string) | string;
     icon?: string;
     prefix?: string;
 }
@@ -498,6 +501,16 @@ export declare const foundationGridTabulatorComponents: {
  */
 export declare function getColumnType(metadataType: string): string;
 
+/**
+ * Resolves a dataTestId value that can be either a string or a function
+ *
+ * @param dataTestId - The dataTestId value (string or function)
+ * @param rowData - The row data to pass to the function if dataTestId is a function
+ * @returns The resolved test ID string or undefined if not provided
+ * @alpha
+ */
+export declare function getDataTestId<T = any>(dataTestId: ((rowData: T) => string) | string | undefined, rowData: T): string | undefined;
+
 /**
  * Get the filter type based on the field type.
  * @param type - The field type.
@@ -2373,6 +2386,7 @@ declare interface NumberEditorParams {
  */
 export declare type Options = {
     formatters?: Record<string, Formatter>;
+    columns?: ColumnDefinition[];
 } & Omit<Options_2, 'formatters'>;
 
 /**
@@ -2440,15 +2454,15 @@ declare interface SelectEditorParams {
 }
 
 /**
- * Formatter that displays a value from a select list of options
- * Styled to match grid-pro select renderer.
+ * Formatter that displays a select component with options.
+ * Returns a wrapped div containing the select, similar to boolean.formatter.
  *
  * @param cell - The cell component provided by Tabulator
  * @param formatterParams - Select formatter parameters
- * @returns Text content for the selected option
+ * @returns An empty string, as the component is added directly to the cell element
  * @public
  */
-export declare function selectFormatter(cell: any, formatterParams: SelectFormatterParams): string;
+export declare function selectFormatter<T = any>(cell: any, formatterParams: SelectFormatterParams<T>): string;
 
 /**
  * Parameters for the select formatter
@@ -2461,13 +2475,16 @@ export declare function selectFormatter(cell: any, formatterParams: SelectFormat
  *
  * `prefix`: The prefix to use for element classes, e.g., 'foundation', 'zero', 'rapid'. Defaults to 'foundation' if not specified.
  *
+ * `onChange`: Optional callback when the selection changes
+ *
  * @alpha
  */
-export declare interface SelectFormatterParams {
-    options: SelectOption[];
+export declare interface SelectFormatterParams<T = any> {
+    options: SelectOption<T>[];
     nullText?: string;
-    dataTestId?: string;
+    dataTestId?: ((rowData: T) => string) | string;
     prefix?: string;
+    onChange?: (value: string, rowData: T) => void;
 }
 
 /**
@@ -2477,11 +2494,14 @@ export declare interface SelectFormatterParams {
  *
  * `label`: The text to display
  *
+ * `isDisabled`: Optional function to determine if this option should be disabled for the given row data
+ *
  * @alpha
  */
-declare interface SelectOption {
+declare interface SelectOption<T = any> {
     value: string | number;
     label: string;
+    isDisabled?: (rowData: T) => boolean;
 }
 
 /** @beta
@@ -2559,7 +2579,7 @@ export declare const tabulatorThemeSimpleCSS: ElementStyles;
  * @returns Text content for the cell
  * @public
  */
-export declare function textFormatter(cell: any, formatterParams?: TextFormatterParams): string;
+export declare function textFormatter<T = any>(cell: any, formatterParams?: TextFormatterParams<T>): string;
 
 /**
  * Parameters for the text formatter
@@ -2578,12 +2598,12 @@ export declare function textFormatter(cell: any, formatterParams?: TextFormatter
  *
  * @alpha
  */
-export declare interface TextFormatterParams {
+export declare interface TextFormatterParams<T = any> {
     specialValue?: any;
     specialColor?: string;
     specialFontWeight?: string;
     prefix?: string;
-    dataTestId?: string;
+    dataTestId?: ((rowData: T) => string) | string;
     nullText?: string;
 }
 

package/docs/api/grid-tabulator.actionformatter.md

@@ -9,7 +9,7 @@ Formatter that displays an action button in the cell. Styled to match grid-pro a
 **Signature:**
 
 ```typescript
-export declare function actionFormatter(cell: any, formatterParams?: ActionFormatterParams): string;
+export declare function actionFormatter<T = any>(cell: any, formatterParams?: ActionFormatterParams<T>): string;
 ```
 
 ## Parameters
@@ -17,7 +17,7 @@ export declare function actionFormatter(cell: any, formatterParams?: ActionForma
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  cell | any | The cell component provided by Tabulator |
-|  formatterParams | ActionFormatterParams | _(Optional)_ Action formatter parameters |
+|  formatterParams | ActionFormatterParams&lt;T&gt; | _(Optional)_ Action formatter parameters |
 
 **Returns:**