@genesislcap/grid-pro 15.75.0 → 15.76.0

package/dist/custom-elements.json

@@ -5791,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",
@@ -5930,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",
@@ -5969,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": [
@@ -5995,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"
+          }
         }
       ]
     },

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.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../../src/context-menu/context-menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA2L9D;;;;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"}
+{"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/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);
+};

package/dist/esm/context-menu/context-menu.js

@@ -1,48 +1,31 @@
+import { agMenuStyles } from '@genesislcap/foundation-ui';
 import { css, DOM } from '@microsoft/fast-element';
 import { logger } from '../utils/logger';
 /**
- * Same surface as the vertical actions menu: AG Grid's context-menu variables, with design-system
- * tokens when those variables are not set. The menu is drawn in the top layer, outside the themed
- * grid element, so the values are copied from the cell that was clicked.
+ * Same surface as the vertical actions menu (foundation-ui's `agMenuStyles`): AG Grid's menu
+ * variables, with design-system tokens when those variables are not set. The menu is drawn in the
+ * top layer, outside the themed grid element, so the values are copied from the cell that was
+ * clicked.
  */
 const contextMenuStyles = css `
   :host {
     display: block;
   }
 
+  ${agMenuStyles(':host > .grid-context-menu, .grid-context-menu-item > .grid-context-menu', '.grid-context-menu > .grid-context-menu-item')}
+
   :host > .grid-context-menu,
   .grid-context-menu-item > .grid-context-menu {
     display: flex;
     flex-direction: column;
-    box-sizing: border-box;
     margin: 0;
-    padding: var(--ag-spacing, 4px) 0;
     max-width: 368px;
     min-width: 64px;
-    background-color: var(--ag-menu-background-color, var(--fill-color));
-    border: var(
-      --ag-menu-border,
-      calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest, transparent)
-    );
-    border-radius: var(--ag-border-radius, calc(var(--control-corner-radius, 2) * 1px));
-    box-shadow: var(--ag-menu-shadow, var(--ag-popup-shadow, 0 2px 8px rgb(0 0 0 / 30%)));
-    color: var(--ag-menu-text-color, var(--neutral-foreground-rest));
-    font-family: var(--ag-font-family, var(--body-font));
   }
 
   .grid-context-menu > .grid-context-menu-item {
     display: flex;
-    box-sizing: border-box;
     align-items: center;
-    height: calc(var(--ag-icon-size, 16px) + (var(--ag-spacing, 4px) + 2px) * 2);
-    margin: 0;
-    background: transparent;
-    border: none;
-    border-radius: 0;
-    color: inherit;
-    font-family: inherit;
-    font-size: var(--ag-font-size, var(--type-ramp-base-font-size));
-    font-weight: 500;
     user-select: none;
   }
 
@@ -55,23 +38,8 @@ const contextMenuStyles = css `
     opacity: 50%;
   }
 
-  .grid-context-menu > .grid-context-menu-item:hover,
-  .grid-context-menu > .grid-context-menu-item:focus {
-    background: var(--ag-row-hover-color, var(--neutral-fill-stealth-hover));
-    border: none;
-  }
-
-  .grid-context-menu > .grid-context-menu-item[disabled] {
-    background: transparent;
-    cursor: default;
-    opacity: 50%;
-  }
-
   .grid-context-menu > .grid-context-menu-item::part(content) {
     flex: 1;
-    margin-inline: 0;
-    padding-inline: calc(var(--ag-spacing, 4px) * 2) calc(var(--ag-spacing, 4px) * 4);
-    line-height: var(--ag-icon-size, 16px);
   }
 
   /* A plain item in a menu with checkboxes lines its text up with theirs. */

package/dist/grid-pro.api.json

@@ -760,7 +760,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/grid-pro!ActionsMenuRenderer#refresh:member(1)",
-              "docComment": "",
+              "docComment": "/**\n * Hands the latest row data to the menu, so per-row actions and disabled states stay current.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -14373,7 +14373,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 `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, or a function of the row data returning that array (for row-scoped eligibility/permission filtering).\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",
@@ -14381,12 +14381,8 @@
             },
             {
               "kind": "Reference",
-              "text": "ActionMenuItem",
-              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
-            },
-            {
-              "kind": "Content",
-              "text": "[]"
+              "text": "ActionMenuItems",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItems:type"
             },
             {
               "kind": "Content",
@@ -14433,8 +14429,8 @@
           ],
           "fileUrlPath": "src/cell-renderers/actions-menu.renderer.ts",
           "returnTypeTokenRange": {
-            "startIndex": 12,
-            "endIndex": 13
+            "startIndex": 11,
+            "endIndex": 12
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -14443,39 +14439,39 @@
               "parameterName": "actions",
               "parameterTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 2
               },
               "isOptional": false
             },
             {
               "parameterName": "overrideDef",
               "parameterTypeTokenRange": {
-                "startIndex": 4,
-                "endIndex": 5
+                "startIndex": 3,
+                "endIndex": 4
               },
               "isOptional": true
             },
             {
               "parameterName": "customActionsOpenerName",
               "parameterTypeTokenRange": {
-                "startIndex": 6,
-                "endIndex": 7
+                "startIndex": 5,
+                "endIndex": 6
               },
               "isOptional": true
             },
             {
               "parameterName": "isVertical",
               "parameterTypeTokenRange": {
-                "startIndex": 8,
-                "endIndex": 9
+                "startIndex": 7,
+                "endIndex": 8
               },
               "isOptional": true
             },
             {
               "parameterName": "buttonAppearance",
               "parameterTypeTokenRange": {
-                "startIndex": 10,
-                "endIndex": 11
+                "startIndex": 9,
+                "endIndex": 10
               },
               "isOptional": true
             }
@@ -15729,6 +15725,122 @@
           ],
           "name": "getTextRendererTemplate"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/grid-pro!getVerticalDropdownMenuDef:function(1)",
+          "docComment": "/**\n * 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).\n *\n * @remarks\n *\n * 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.\n *\n * @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).\n *\n * @param overrideDef - Optional override for the ColDef. Will override any of the default values. Default is an empty object.\n *\n * @param iconName - Optional icon name for the opener. Default is `'ellipsis'` (horizontal dots); pass `'ellipsis-vertical'` for vertical ones.\n *\n * @param buttonAppearance - Optional appearance for the button that opens the menu.\n *\n * @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.\n *\n * @returns Merged ColDef (base ColDef created from the parameters + overrideDef) for Actions Menu Renderer.\n *\n * @example\n * ```ts\n * public exampleMoreColumnDef: ColDef = getVerticalDropdownMenuDef(\n *   (rowData) => [\n *     { name: 'Ping Trader', icon: { name: 'paper-plane' }, callback: (rowData) => pingTrader(rowData) },\n *     { name: 'Assign', icon: { name: 'user' }, callback: (rowData) => assign(rowData) },\n *   ],\n *   { headerName: '', pinned: 'right' },\n * );\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "getVerticalDropdownMenuDef: (actions: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ActionMenuItems",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItems:type"
+            },
+            {
+              "kind": "Content",
+              "text": ", overrideDef?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ColDef",
+              "canonicalReference": "@ag-grid-community/core!ColDef:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " & {\n    suppressHeaderMenuButton?: boolean;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ", iconName?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", buttonAppearance?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", hideDisabled?: "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "ColDef",
+              "canonicalReference": "@ag-grid-community/core!ColDef:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " & {\n    suppressHeaderMenuButton?: boolean;\n}"
+            }
+          ],
+          "fileUrlPath": "src/cell-renderers/actions-menu.renderer.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 12,
+            "endIndex": 14
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "actions",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "overrideDef",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "iconName",
+              "parameterTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 7
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "buttonAppearance",
+              "parameterTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 9
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "hideDisabled",
+              "parameterTypeTokenRange": {
+                "startIndex": 10,
+                "endIndex": 11
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "getVerticalDropdownMenuDef"
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/grid-pro!GRID_PRO_COLUMN_DRAG_BRIDGE_CONTEXT_KEY:var",

package/dist/grid-pro.d.ts

@@ -1,4 +1,4 @@
-import { ActionMenuItem } from '@genesislcap/foundation-ui';
+import type { ActionMenuItems } from '@genesislcap/foundation-ui';
 import { BehaviorSubject } from 'rxjs';
 import { Binding } from '@microsoft/fast-element';
 import { CaptureType } from '@microsoft/fast-element';
@@ -251,6 +251,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;
 }
 
@@ -3387,7 +3388,8 @@ declare class GenesisInfiniteDatasource implements IDatasource {
 /**
  * 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).
@@ -3417,7 +3419,7 @@ declare class GenesisInfiniteDatasource implements IDatasource {
  * ```
  * @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;
 
 /**
  * Get a Design System prefixed Checkbox template.
@@ -3581,6 +3583,41 @@ export declare const getTextFieldRendererTemplate: (designSystem?: string) => Vi
  */
 export declare const getTextRendererTemplate: (designSystem?: string) => ViewTemplate<AgTextFieldRenderer, any>;
 
+/**
+ * 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;
+};
+
 /** Context key on `gridOptions.context` for AG column drag integration.
  * @public
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/grid-pro",
   "description": "Genesis Foundation AG Grid",
-  "version": "15.75.0",
+  "version": "15.76.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -38,19 +38,19 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.75.0",
-    "@genesislcap/genx": "15.75.0",
-    "@genesislcap/ts-builder": "15.75.0",
-    "@genesislcap/uvu-playwright-builder": "15.75.0",
-    "@genesislcap/vite-builder": "15.75.0",
-    "@genesislcap/webpack-builder": "15.75.0"
+    "@genesislcap/foundation-testing": "15.76.0",
+    "@genesislcap/genx": "15.76.0",
+    "@genesislcap/ts-builder": "15.76.0",
+    "@genesislcap/uvu-playwright-builder": "15.76.0",
+    "@genesislcap/vite-builder": "15.76.0",
+    "@genesislcap/webpack-builder": "15.76.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "15.75.0",
-    "@genesislcap/foundation-criteria": "15.75.0",
-    "@genesislcap/foundation-logger": "15.75.0",
-    "@genesislcap/foundation-ui": "15.75.0",
-    "@genesislcap/foundation-utils": "15.75.0",
+    "@genesislcap/foundation-comms": "15.76.0",
+    "@genesislcap/foundation-criteria": "15.76.0",
+    "@genesislcap/foundation-logger": "15.76.0",
+    "@genesislcap/foundation-ui": "15.76.0",
+    "@genesislcap/foundation-utils": "15.76.0",
     "@microsoft/fast-colors": "5.3.1",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",