@genesislcap/grid-pro 15.71.0 → 15.72.0-FUI-2629.7

package/dist/custom-elements.json

@@ -2205,6 +2205,38 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "contextMenuItems",
+              "type": {
+                "text": "GridProContextMenuItems | undefined"
+              },
+              "description": "Opts the grid into its own right-click menu, built from these items for each cell. It needs no\nAG Grid Enterprise module, and replaces AG Grid's context menu while set. Assign\ndefaultGridContextMenuItems for a CSV Export menu, or return an empty list to show the\nbrowser's menu for that cell.\n\nUnset, right-click is left alone: AG Grid's menu when its `ContextMenu` module is registered,\notherwise the browser's.",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "contextMenuItemsChanged"
+            },
+            {
+              "kind": "field",
+              "name": "closeContextMenu",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "description": "Removes the open right-click menu, if there is one."
+            },
+            {
+              "kind": "field",
+              "name": "gridCreatedWithMenuSuppressed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the AG grid instance was created with its own context menu suppressed."
+            },
             {
               "kind": "field",
               "name": "enableColumnSelection",
@@ -2368,6 +2400,13 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "boundContextMenuListener",
+              "privacy": "private",
+              "readonly": true,
+              "description": "`globalListener` runs on a timeout, which is too late to cancel the browser menu.\nThis one runs inside the right-click event."
+            },
             {
               "kind": "field",
               "name": "_filterConfig",
@@ -3489,6 +3528,14 @@
             "package": "./column-filters"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./context-menu"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -5744,7 +5791,8 @@
                     "text": "ICellRendererParams"
                   }
                 }
-              ]
+              ],
+              "description": "Hands the latest row data to the menu, so per-row actions and disabled states stay current."
             },
             {
               "kind": "field",
@@ -5883,9 +5931,9 @@
             {
               "name": "actions",
               "type": {
-                "text": "ActionMenuItem[]"
+                "text": "ActionMenuItems"
               },
-              "description": "Array of `ActionMenuItem` to be displayed in the menu."
+              "description": "Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data\nreturning that array (for row-scoped eligibility/permission filtering)."
             },
             {
               "name": "overrideDef",
@@ -5922,6 +5970,58 @@
           ],
           "description": "Helper function to get ColDef https://www.ag-grid.com/javascript-data-grid/column-properties/ for Actions Menu Renderer.\nWill take the parameter values for a base ColDef and merge them with the overrideDef (if specified).",
           "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getVerticalDropdownMenuDef",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "actions",
+              "type": {
+                "text": "ActionMenuItems"
+              },
+              "description": "Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data\nreturning that array (for row-scoped eligibility/permission filtering)."
+            },
+            {
+              "name": "overrideDef",
+              "default": "{}",
+              "type": {
+                "text": "ColDef & { suppressHeaderMenuButton?: boolean }"
+              },
+              "description": "Optional override for the ColDef. Will override any of the default values. Default is an empty object."
+            },
+            {
+              "name": "iconName",
+              "default": "'ellipsis'",
+              "type": {
+                "text": "string"
+              },
+              "description": "Optional icon name for the opener. Default is `'ellipsis'` (horizontal dots); pass `'ellipsis-vertical'` for vertical ones."
+            },
+            {
+              "name": "buttonAppearance",
+              "optional": true,
+              "type": {
+                "text": "string"
+              },
+              "description": "Optional appearance for the button that opens the menu."
+            },
+            {
+              "name": "hideDisabled",
+              "default": "false",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Optional flag to hide disabled actions instead of greying them out. Default is false.\nWhen every action for a row is hidden, the opener hides too."
+            }
+          ],
+          "description": "Helper function to get ColDef https://www.ag-grid.com/javascript-data-grid/column-properties/ for a\nvertical Actions Menu behind an icon-only \"kebab\" opener, for a pinned column of per-row actions.\nWill take the parameter values for a base ColDef and merge them with the overrideDef (if specified).",
+          "privacy": "public"
         }
       ],
       "exports": [
@@ -5948,6 +6048,14 @@
             "name": "getActionsMenuDef",
             "module": "src/cell-renderers/actions-menu.renderer.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "getVerticalDropdownMenuDef",
+          "declaration": {
+            "name": "getVerticalDropdownMenuDef",
+            "module": "src/cell-renderers/actions-menu.renderer.ts"
+          }
         }
       ]
     },
@@ -10371,6 +10479,104 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/context-menu/context-menu.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "defaultGridContextMenuItems",
+          "return": {
+            "type": {
+              "text": "GridProContextMenuItem[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "CellContextMenuEvent"
+              }
+            }
+          ],
+          "description": "A CSV Export item, using AG Grid's community CSV export. Assign it to `contextMenuItems` as the\nwhole menu, or spread its result into a menu of your own. Empty when the grid sets\n`suppressCsvExport`.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "defaultGridContextMenuItems",
+          "declaration": {
+            "name": "defaultGridContextMenuItems",
+            "module": "src/context-menu/context-menu.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/context-menu/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "defaultGridContextMenuItems",
+          "declaration": {
+            "name": "defaultGridContextMenuItems",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GridProContextMenuEntry",
+          "declaration": {
+            "name": "GridProContextMenuEntry",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GridProContextMenuItem",
+          "declaration": {
+            "name": "GridProContextMenuItem",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./context-menu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GridProContextMenuItems",
+          "declaration": {
+            "name": "GridProContextMenuItems",
+            "module": "./context-menu"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/datasource/base.datasource.ts",

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

@@ -1,5 +1,5 @@
 import type { ColDef, ICellRendererComp, ICellRendererParams } from '@ag-grid-community/core';
-import { ActionMenuItem } from '@genesislcap/foundation-ui';
+import type { ActionMenuItems } from '@genesislcap/foundation-ui';
 import { FoundationElement } from '@microsoft/fast-foundation';
 /**
  * The Actions Menu Renderer element.
@@ -11,6 +11,7 @@ export declare class ActionsMenuRenderer extends FoundationElement implements IC
     params: ICellRendererParams;
     init(params: ICellRendererParams): void;
     getGui(): HTMLElement;
+    /** Hands the latest row data to the menu, so per-row actions and disabled states stay current. */
     refresh(params: ICellRendererParams): boolean;
 }
 /**
@@ -30,7 +31,8 @@ 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 `ActionMenuItem` to be displayed in the menu.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data
+ * returning that array (for row-scoped eligibility/permission filtering).
  * @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).
@@ -60,5 +62,39 @@ export declare const foundationGridProActionsMenuRenderer: (overrideDefinition?:
  * ```
  * @public
  */
-export declare const getActionsMenuDef: (actions: ActionMenuItem[], overrideDef?: ColDef, customActionsOpenerName?: string, isVertical?: boolean, buttonAppearance?: string) => ColDef;
+export declare const getActionsMenuDef: (actions: ActionMenuItems, overrideDef?: ColDef, customActionsOpenerName?: string, isVertical?: boolean, buttonAppearance?: string) => ColDef;
+/**
+ * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for a
+ * vertical Actions Menu behind an icon-only "kebab" opener, for a pinned column of per-row actions.
+ * Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).
+ * @remarks The opener hides itself on rows with no actions, so it never opens an empty menu. The
+ * column has a `colId` but no `field`: AG Grid only refreshes a cell with a field when its value
+ * changes, and this column has no value, so a row update would leave stale actions. Having no value,
+ * the column is also not sortable, filterable, resizable or flashed, and shows no header menu
+ * button — pass any of these in `overrideDef` to turn them back on.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data
+ * returning that array (for row-scoped eligibility/permission filtering).
+ * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.
+ * @param iconName - Optional icon name for the opener. Default is `'ellipsis'` (horizontal dots); pass `'ellipsis-vertical'` for vertical ones.
+ * @param buttonAppearance - Optional appearance for the button that opens the menu.
+ * @param hideDisabled - Optional flag to hide disabled actions instead of greying them out. Default is false.
+ * When every action for a row is hidden, the opener hides too.
+ * @returns Merged ColDef (base ColDef created from the parameters + overrideDef) for Actions Menu Renderer.
+ * @example
+ * ```ts
+ * public exampleMoreColumnDef: ColDef = getVerticalDropdownMenuDef(
+ *   (rowData) => [
+ *     { name: 'Ping Trader', icon: { name: 'paper-plane' }, callback: (rowData) => pingTrader(rowData) },
+ *     { name: 'Assign', icon: { name: 'user' }, callback: (rowData) => assign(rowData) },
+ *   ],
+ *   { headerName: '', pinned: 'right' },
+ * );
+ * ```
+ * @public
+ */
+export declare const getVerticalDropdownMenuDef: (actions: ActionMenuItems, overrideDef?: ColDef & {
+    suppressHeaderMenuButton?: boolean;
+}, iconName?: string, buttonAppearance?: string, hideDisabled?: boolean) => ColDef & {
+    suppressHeaderMenuButton?: boolean;
+};
 //# sourceMappingURL=actions-menu.renderer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions-menu.renderer.d.ts","sourceRoot":"","sources":["../../../src/cell-renderers/actions-menu.renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,iBAAkB,YAAW,iBAAiB;IAClE,MAAM,EAAE,mBAAmB,CAAC;IAExC,IAAI,CAAC,MAAM,EAAE,mBAAmB;IAKhC,MAAM,IAAI,WAAW;IAIrB,OAAO,CAAC,MAAM,EAAE,mBAAmB;CAG3C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC;;;;;;8BAQ/C,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,cAAc,EAAE,EACzB,cAAa,MAAW,EACxB,0BAAyB,MAAY,EACrC,aAAY,OAAe,EAC3B,mBAAmB,MAAM,KACxB,MAqBF,CAAC"}
+{"version":3,"file":"actions-menu.renderer.d.ts","sourceRoot":"","sources":["../../../src/cell-renderers/actions-menu.renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,iBAAkB,YAAW,iBAAiB;IAClE,MAAM,EAAE,mBAAmB,CAAC;IAExC,IAAI,CAAC,MAAM,EAAE,mBAAmB;IAKhC,MAAM,IAAI,WAAW;IAI5B,kGAAkG;IAC3F,OAAO,CAAC,MAAM,EAAE,mBAAmB;CAI3C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC;;;;;;8BAQ/C,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,eAAe,EACxB,cAAa,MAAW,EACxB,0BAAyB,MAAY,EACrC,aAAY,OAAe,EAC3B,mBAAmB,MAAM,KACxB,MAqBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,eAAe,EACxB,cAAa,MAAM,GAAG;IAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAO,EACjE,WAAU,MAAmB,EAC7B,mBAAmB,MAAM,EACzB,eAAc,OAAe,KAC5B,MAAM,GAAG;IAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;CA2B/C,CAAC"}

package/dist/dts/context-menu/context-menu.d.ts

@@ -0,0 +1,69 @@
+import type { CellContextMenuEvent } from 'ag-grid-community';
+/**
+ * One entry in grid-pro's right-click menu.
+ *
+ * @public
+ */
+export interface GridProContextMenuItem {
+    name: string;
+    /** Drawn to the right of the name, for example a key combination. */
+    shortcut?: string;
+    /** Shown on hover, including while the item is disabled — say why it cannot be chosen. */
+    tooltip?: string;
+    disabled?: boolean;
+    /** Set to `true` or `false` to make the item a checkbox; leave unset for a plain item. */
+    checked?: boolean;
+    action?: () => void;
+    subMenu?: GridProContextMenuEntry[];
+}
+/**
+ * An item, or `'separator'` for a dividing line between groups of items.
+ *
+ * @public
+ */
+export type GridProContextMenuEntry = GridProContextMenuItem | 'separator';
+/**
+ * Builds the right-click menu for one cell. Return an empty list to show the browser's menu.
+ *
+ * @public
+ */
+export type GridProContextMenuItems = (event: CellContextMenuEvent) => GridProContextMenuEntry[];
+/**
+ * A CSV Export item, using AG Grid's community CSV export. Assign it to `contextMenuItems` as the
+ * whole menu, or spread its result into a menu of your own. Empty when the grid sets
+ * `suppressCsvExport`.
+ *
+ * @public
+ */
+export declare function defaultGridContextMenuItems(event: CellContextMenuEvent): GridProContextMenuItem[];
+/**
+ * Where and how {@link openGridContextMenu} draws the menu.
+ *
+ * @internal
+ */
+export interface GridContextMenuOptions {
+    /** Design-system prefix: the menu is built from `${prefix}-menu` and `${prefix}-menu-item`. */
+    prefix: string;
+    /** Viewport coordinates of the pointer. */
+    x: number;
+    y: number;
+    items: readonly GridProContextMenuEntry[];
+    /**
+     * Node the menu is attached to. Use one inside the grid's own tree, so a grid in a modal dialog
+     * does not render its menu inert. Defaults to `document.body`.
+     */
+    container?: Node;
+    /** Element the theme variables are read from, and focus returns to on keyboard close. */
+    themeSource?: Element | null;
+}
+/**
+ * Opens a design-system menu at the pointer and returns a function that removes it, or
+ * `undefined` when the design system has not registered the menu components.
+ *
+ * A pointer press outside, a scroll outside, a window resize, Escape or Tab closes it. Choosing an item runs its
+ * action and closes it; an item with a submenu opens the submenu instead.
+ *
+ * @internal
+ */
+export declare function openGridContextMenu(options: GridContextMenuOptions): (() => void) | undefined;
+//# sourceMappingURL=context-menu.d.ts.map

package/dist/dts/context-menu/context-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../../src/context-menu/context-menu.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA6J9D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,uBAAuB,EAAE,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,EAAE,CAUjG;AAmBD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA4E7F"}

package/dist/dts/context-menu/index.d.ts

@@ -0,0 +1,2 @@
+export { defaultGridContextMenuItems, type GridProContextMenuEntry, type GridProContextMenuItem, type GridProContextMenuItems, } from './context-menu';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/context-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC"}

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

@@ -1,7 +1,8 @@
 import { ViewTemplate } from '@microsoft/fast-element';
 import { FoundationElement } from '@microsoft/fast-foundation';
-import type { ColDef, ColumnState, GridApi, GridOptions, GridParams, IStatusPanelComp } from 'ag-grid-community';
+import type { CellContextMenuEvent, ColDef, ColumnState, GridApi, GridOptions, GridParams, IStatusPanelComp } from 'ag-grid-community';
 import { type GridProColumnDragBridge } from './column-selection/grid-pro-column-drag-bridge';
+import { type GridProContextMenuItems } from './context-menu/context-menu';
 import { GridProBaseDatasource } from './datasource/base.datasource';
 import type { GridComponents, GridProCaseType, GridProErrorEvent, GridProErrorItem, GridProEventsAndCallbacks } from './grid-pro.types';
 import { GridOptionsConfig, GridProStatusBarConfig, GridProStatusBarLabelConfig } from './grid-pro.types';
@@ -503,6 +504,23 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     get statusBar(): GridProStatusBar | undefined;
+    /**
+     * Opts the grid into its own right-click menu, built from these items for each cell. It needs no
+     * AG Grid Enterprise module, and replaces AG Grid's context menu while set. Assign
+     * {@link defaultGridContextMenuItems} for a CSV Export menu, or return an empty list to show the
+     * browser's menu for that cell.
+     *
+     * Unset, right-click is left alone: AG Grid's menu when its `ContextMenu` module is registered,
+     * otherwise the browser's.
+     *
+     * @public
+     */
+    contextMenuItems?: GridProContextMenuItems;
+    contextMenuItemsChanged(): void;
+    /** Removes the open right-click menu, if there is one. */
+    private closeContextMenu?;
+    /** Whether the AG grid instance was created with its own context menu suppressed. */
+    private gridCreatedWithMenuSuppressed;
     /**
      * Shows a Columns side panel on the trailing edge of the grid.
      * @public
@@ -536,6 +554,11 @@ export declare class GridPro extends GridPro_base {
     private luminanceSubscription?;
     private visibilityObserverCleanup?;
     private readonly boundGlobalEventListener;
+    /**
+     * `globalListener` runs on a timeout, which is too late to cancel the browser menu.
+     * This one runs inside the right-click event.
+     */
+    private readonly boundContextMenuListener;
     private _filterConfig;
     getfilterModel(): Promise<{
         [key: string]: any;
@@ -878,7 +901,7 @@ export declare class GridPro extends GridPro_base {
         onCellValueChanged?: ((event: import("@ag-grid-community/core").NewValueParams<any>) => void) | ((event: import("ag-grid-community").NewValueParams<any, any, any>) => void);
         onCellClicked?: ((event: import("@ag-grid-community/core").CellClickedEvent<any, any>) => void) | ((event: import("ag-grid-community").CellClickedEvent<any, any, any>) => void);
         onCellDoubleClicked?: ((event: import("@ag-grid-community/core").CellDoubleClickedEvent<any, any>) => void) | ((event: import("ag-grid-community").CellDoubleClickedEvent<any, any, any>) => void);
-        onCellContextMenu?: ((event: import("@ag-grid-community/core").CellContextMenuEvent<any, any>) => void) | ((event: import("ag-grid-community").CellContextMenuEvent<any, any, any>) => void);
+        onCellContextMenu?: ((event: import("@ag-grid-community/core").CellContextMenuEvent<any, any>) => void) | ((event: CellContextMenuEvent<any, any, any>) => void);
         getQuickFilterText?: ((params: import("@ag-grid-community/core").GetQuickFilterTextParams<any, any>) => string) | import("ag-grid-community").GetQuickFilterText<any, any, any>;
         filterValueGetter?: string | import("@ag-grid-community/core").ValueGetterFunc<any> | import("ag-grid-community").ValueGetterFunc<any, any, any>;
         floatingFilter?: boolean;
@@ -1019,6 +1042,20 @@ export declare class GridPro extends GridPro_base {
     protected setupStatusBar(gridOptions: GridOptions): void;
     get observedAttributes(): string[];
     agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
+    /**
+     * AG Grid draws its own menu when `ContextMenu` is registered, so it is suppressed while
+     * `contextMenuItems` is set and the app's own `suppressContextMenu` restored when it is cleared.
+     * The suppression goes to AG Grid only, never into `agGridOptions`: that object is what the
+     * `gridOptions` getter returns, and an app re-applying it would otherwise adopt the setting.
+     * @internal
+     */
+    private syncContextMenuSuppression;
+    /**
+     * Opens the grid's right-click menu for a cell. Called from the synchronous grid listener so
+     * `preventDefault` still cancels the browser menu.
+     * @internal
+     */
+    private showContextMenu;
     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/index.d.ts

@@ -4,6 +4,7 @@ export * from './cell-editors';
 export * from './column';
 export * from './column-selection';
 export * from './column-filters';
+export * from './context-menu';
 export * from './datasource';
 export * from './external';
 export * from './grid-components';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

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

@@ -18,8 +18,10 @@ export class ActionsMenuRenderer extends FoundationElement {
     getGui() {
         return this;
     }
+    /** Hands the latest row data to the menu, so per-row actions and disabled states stay current. */
     refresh(params) {
-        return false;
+        this.params = params;
+        return true;
     }
 }
 __decorate([
@@ -44,7 +46,8 @@ 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 `ActionMenuItem` to be displayed in the menu.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data
+ * returning that array (for row-scoped eligibility/permission filtering).
  * @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).
@@ -95,3 +98,59 @@ export const getActionsMenuDef = (actions, overrideDef = {}, customActionsOpener
     };
     return Object.assign(Object.assign({}, actionsMenuDef), overrideDef);
 };
+/**
+ * Helper function to get ColDef {@link https://www.ag-grid.com/javascript-data-grid/column-properties/} for a
+ * vertical Actions Menu behind an icon-only "kebab" opener, for a pinned column of per-row actions.
+ * Will take the parameter values for a base ColDef and merge them with the overrideDef (if specified).
+ * @remarks The opener hides itself on rows with no actions, so it never opens an empty menu. The
+ * column has a `colId` but no `field`: AG Grid only refreshes a cell with a field when its value
+ * changes, and this column has no value, so a row update would leave stale actions. Having no value,
+ * the column is also not sortable, filterable, resizable or flashed, and shows no header menu
+ * button — pass any of these in `overrideDef` to turn them back on.
+ * @param actions - Array of `ActionMenuItem` to be displayed in the menu, or a function of the row data
+ * returning that array (for row-scoped eligibility/permission filtering).
+ * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.
+ * @param iconName - Optional icon name for the opener. Default is `'ellipsis'` (horizontal dots); pass `'ellipsis-vertical'` for vertical ones.
+ * @param buttonAppearance - Optional appearance for the button that opens the menu.
+ * @param hideDisabled - Optional flag to hide disabled actions instead of greying them out. Default is false.
+ * When every action for a row is hidden, the opener hides too.
+ * @returns Merged ColDef (base ColDef created from the parameters + overrideDef) for Actions Menu Renderer.
+ * @example
+ * ```ts
+ * public exampleMoreColumnDef: ColDef = getVerticalDropdownMenuDef(
+ *   (rowData) => [
+ *     { name: 'Ping Trader', icon: { name: 'paper-plane' }, callback: (rowData) => pingTrader(rowData) },
+ *     { name: 'Assign', icon: { name: 'user' }, callback: (rowData) => assign(rowData) },
+ *   ],
+ *   { headerName: '', pinned: 'right' },
+ * );
+ * ```
+ * @public
+ */
+export const getVerticalDropdownMenuDef = (actions, overrideDef = {}, iconName = 'ellipsis', buttonAppearance, hideDisabled = false) => {
+    // `suppressHeaderMenuButton` is AG Grid v31+; the v29 `ColDef` used across grid-pro's public helpers lacks it.
+    const verticalDropdownMenuDef = {
+        cellRenderer: GridProRendererTypes.actionsMenu,
+        cellRendererParams: {
+            actions,
+            addDefaultActions: false,
+            buttonAppearance,
+            hideDisabled,
+            iconName,
+            isVertical: true,
+        },
+        cellStyle: { border: 'none', overflow: 'visible' },
+        colId: overrideDef.headerName
+            ? convertToKebabCase(overrideDef.headerName)
+            : 'vertical-dropdown-menu',
+        // A column with no value can't be usefully sorted, filtered or flashed; and with no field it is
+        // force-refreshed on every row update, so cell flashing would flash it on every tick.
+        enableCellChangeFlash: false,
+        filter: false,
+        resizable: false,
+        sortable: false,
+        suppressHeaderMenuButton: true,
+        width: 40,
+    };
+    return Object.assign(Object.assign({}, verticalDropdownMenuDef), overrideDef);
+};