@genesislcap/grid-pro 15.75.0 → 15.76.1-alpha-aff9783af4.0

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/dist/react.cjs

@@ -124,6 +124,11 @@ const StringEditor = React.forwardRef(function StringEditor(props, ref) {
   return React.createElement(customElements.getName(StringEditorWC) ?? '%%prefix%%-string-editor', { ...rest, ref }, children);
 });
 
+const GridProColumn = React.forwardRef(function GridProColumn(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(GridProColumnWC) ?? 'grid-pro-column', { ...rest, ref }, children);
+});
+
 const ActionRenderer = React.forwardRef(function ActionRenderer(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(ActionRendererWC) ?? '%%prefix%%-grid-pro-action-renderer', { ...rest, ref }, children);
@@ -164,11 +169,6 @@ const AgTextRenderer = React.forwardRef(function AgTextRenderer(props, ref) {
   return React.createElement(customElements.getName(AgTextRendererWC) ?? '%%prefix%%-grid-text-renderer', { ...rest, ref }, children);
 });
 
-const GridProColumn = React.forwardRef(function GridProColumn(props, ref) {
-  const { children, ...rest } = props;
-  return React.createElement(customElements.getName(GridProColumnWC) ?? 'grid-pro-column', { ...rest, ref }, children);
-});
-
 const ColumnSelection = React.forwardRef(function ColumnSelection(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(ColumnSelectionWC) ?? '%%prefix%%-column-selection', { ...rest, ref }, children);
@@ -596,6 +596,7 @@ module.exports = {
   NumberEditor,
   SelectEditor,
   StringEditor,
+  GridProColumn,
   ActionRenderer,
   ActionsMenuRenderer,
   BooleanRenderer,
@@ -604,7 +605,6 @@ module.exports = {
   StatusPillRenderer,
   AgTextFieldRenderer,
   AgTextRenderer,
-  GridProColumn,
   ColumnSelection,
   GridProClientSideDatasource,
   GridProInfiniteDatasource,

package/dist/react.mjs

@@ -122,6 +122,11 @@ export const StringEditor = React.forwardRef(function StringEditor(props, ref) {
   return React.createElement(customElements.getName(StringEditorWC) ?? '%%prefix%%-string-editor', { ...rest, ref }, children);
 });
 
+export const GridProColumn = React.forwardRef(function GridProColumn(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(GridProColumnWC) ?? 'grid-pro-column', { ...rest, ref }, children);
+});
+
 export const ActionRenderer = React.forwardRef(function ActionRenderer(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(ActionRendererWC) ?? '%%prefix%%-grid-pro-action-renderer', { ...rest, ref }, children);
@@ -162,11 +167,6 @@ export const AgTextRenderer = React.forwardRef(function AgTextRenderer(props, re
   return React.createElement(customElements.getName(AgTextRendererWC) ?? '%%prefix%%-grid-text-renderer', { ...rest, ref }, children);
 });
 
-export const GridProColumn = React.forwardRef(function GridProColumn(props, ref) {
-  const { children, ...rest } = props;
-  return React.createElement(customElements.getName(GridProColumnWC) ?? 'grid-pro-column', { ...rest, ref }, children);
-});
-
 export const ColumnSelection = React.forwardRef(function ColumnSelection(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(ColumnSelectionWC) ?? '%%prefix%%-column-selection', { ...rest, ref }, children);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/grid-pro",
   "description": "Genesis Foundation AG Grid",
-  "version": "15.75.0",
+  "version": "15.76.1-alpha-aff9783af4.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.1-alpha-aff9783af4.0",
+    "@genesislcap/genx": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/ts-builder": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/uvu-playwright-builder": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/vite-builder": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/webpack-builder": "15.76.1-alpha-aff9783af4.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.1-alpha-aff9783af4.0",
+    "@genesislcap/foundation-criteria": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/foundation-logger": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/foundation-ui": "15.76.1-alpha-aff9783af4.0",
+    "@genesislcap/foundation-utils": "15.76.1-alpha-aff9783af4.0",
     "@microsoft/fast-colors": "5.3.1",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",