@genesislcap/grid-pro 15.64.0 → 15.64.1-FUI-2629.6

package/dist/esm/datasource/server-side.datasource.js

@@ -10,6 +10,7 @@ import { filterDataserverResult } from './dataserver-result.filter';
 import { getFilterByFieldType, getServerSideFilterParamsByFieldType, } from './server-side.grid-definitions';
 import { DataserverServerSideDatasource } from './server-side.resource-dataserver';
 import { ReqRepServerSideDatasource } from './server-side.resource-reqrep';
+import { getIndexLeadingFields } from './sort-index.utils';
 const criteriaDelimiter = ';';
 const withoutColumnDefs = null;
 /**
@@ -650,8 +651,11 @@ let GridProServerSideDatasource = class GridProServerSideDatasource extends Life
     getAgColumnDefs(fieldsMetadata) {
         return __awaiter(this, void 0, void 0, function* () {
             const colDefsFromGenesisData = this.generateColumnDefsFromMetadata(fieldsMetadata, getServerSideFilterParamsByFieldType, getFilterByFieldType);
+            const sortableFields = this.isRequestServer
+                ? new Set([].concat(...this.indexes.values()))
+                : getIndexLeadingFields(this.indexes);
             colDefsFromGenesisData.forEach((colDef) => {
-                colDef.sortable = [].concat(...this.indexes.values()).includes(colDef.field);
+                colDef.sortable = sortableFields.has(colDef.field);
                 if (this.datasource.criteriaOnlyRequest) {
                     colDef.filter = this.datasource.availableCriteriaFields.includes(colDef.field)
                         ? colDef.filter

package/dist/esm/datasource/server-side.resource-base.js

@@ -168,16 +168,6 @@ export class BaseServerSideDatasource {
             this.setResourceParam('REVERSE', params.reverse);
         }
     }
-    getOrderByAndToBeSortedColIds(map, searchValue) {
-        for (const [key, value] of map.entries()) {
-            const searchIndex = value.findIndex((x) => x === searchValue);
-            if (searchIndex !== -1) {
-                const copy = [...value];
-                const toBeSorted = copy.splice(searchIndex, 1);
-                return { orderBy: key, toBeSorted };
-            }
-        }
-    }
     buildCriteriaMatchFromFilters() {
         this.setResourceParam('CRITERIA_MATCH', this.originalCriteriaMatch);
         let criteriaMatch = this.getResourceParam('CRITERIA_MATCH');

package/dist/esm/datasource/server-side.resource-dataserver.js

@@ -1,9 +1,10 @@
 import { __awaiter } from "tslib";
 import { dataserverPagingStatus, describeDataserverPagingStop, MessageType, logger, } from '@genesislcap/foundation-comms';
 import { DOM } from '@microsoft/fast-element';
-import { getAvailableIndexes, getAvailableIndexFields } from '../utils';
+import { getAvailableIndexes } from '../utils';
 import { cachedRowKeyResolver, filterDataserverResult } from './dataserver-result.filter';
 import { BaseServerSideDatasource } from './server-side.resource-base';
+import { findIndexLedBy, getIndexLeadingFields } from './sort-index.utils';
 /**
  * The DATASERVER IServerSideDatasource implementation, used for SSRM (Server-Side Row Model) in the grid.
  * @beta
@@ -366,13 +367,13 @@ export class DataserverServerSideDatasource extends BaseServerSideDatasource {
                 else if (toBeAppliedSortModel.length > 0) {
                     const coldIdBeingSorted = toBeAppliedSortModel[0].colId; // Not allowing multiple sorts by user
                     const sortTypeBeingApplied = toBeAppliedSortModel[0].sort;
-                    const orderByAndToBeSortedColIds = this.getOrderByAndToBeSortedColIds(this.resourceIndexes, coldIdBeingSorted);
-                    if (!orderByAndToBeSortedColIds) {
-                        const availableIndexes = getAvailableIndexes(this.resourceIndexes);
-                        const availableIndexFields = getAvailableIndexFields(this.resourceIndexes);
-                        logger.warn(`The FIELD/column (${coldIdBeingSorted}) being sorted is not part of an INDEX, required for the [orderBy] operation - ignoring this sort and loading unsorted data. See https://learn.genesis.global/docs/database/data-types/index-entities/`);
-                        logger.debug('Available indexes:', availableIndexes);
-                        logger.debug('Columns that can be sorted with the available indexes:', availableIndexFields);
+                    const orderBy = findIndexLedBy(this.resourceIndexes, coldIdBeingSorted);
+                    if (!orderBy) {
+                        logger.warn(`The FIELD/column (${coldIdBeingSorted}) being sorted does not lead a named INDEX, required for the [orderBy] operation - ignoring this sort and loading unsorted data. See https://learn.genesis.global/docs/database/data-types/index-entities/`);
+                        logger.debug('Available indexes:', getAvailableIndexes(this.resourceIndexes));
+                        logger.debug('Columns that can be sorted with the available indexes:', [
+                            ...getIndexLeadingFields(this.resourceIndexes),
+                        ]);
                         // Ignore the un-sortable sort instead of failing - failing killed the entire
                         // first load when a restored workspace carried a sort on a non-indexed column.
                         const sortModelChanged = JSON.stringify(toBeAppliedSortModel) !== JSON.stringify(this.currentSortModel);
@@ -396,7 +397,7 @@ export class DataserverServerSideDatasource extends BaseServerSideDatasource {
                     }
                     else if (JSON.stringify(toBeAppliedSortModel) !== JSON.stringify(this.currentSortModel)) {
                         this.currentSortModel = toBeAppliedSortModel;
-                        this.resourceParams.ORDER_BY = orderByAndToBeSortedColIds.orderBy;
+                        this.resourceParams.ORDER_BY = orderBy;
                         this.resourceParams.REVERSE = sortTypeBeingApplied === 'desc' ? true : false;
                         yield this.refreshDatasource(params);
                         return true;

package/dist/esm/datasource/sort-index.utils.js

@@ -0,0 +1,31 @@
+/**
+ * Finds the index a DATASERVER can ORDER_BY to sort rows by `field`.
+ * @remarks ORDER_BY on an index orders rows by its fields in turn, so only an index that `field`
+ * leads orders by it; a trailing field is only ordered within groups of the fields before it. An
+ * index with no NAME cannot be named in ORDER_BY.
+ * @param indexes - The resource's indexes, keyed by name
+ * @param field - The field to sort by
+ * @returns The name of the first named index `field` leads, or undefined when it leads none
+ * @internal
+ */
+export function findIndexLedBy(indexes, field) {
+    for (const [indexName, fields] of indexes) {
+        if (indexName && fields[0] === field) {
+            return indexName;
+        }
+    }
+    return undefined;
+}
+/**
+ * The fields a DATASERVER can sort by: those that lead a named index (see `findIndexLedBy`).
+ * @internal
+ */
+export function getIndexLeadingFields(indexes) {
+    const leadingFields = new Set();
+    indexes.forEach((fields, indexName) => {
+        if (indexName && fields.length) {
+            leadingFields.add(fields[0]);
+        }
+    });
+    return leadingFields;
+}

package/dist/esm/grid-pro.js

@@ -19,6 +19,7 @@ import { errorHandlerDialogStyles } from './datasource/error-handler.dialog';
 import { GridProGenesisDatasource, gridProGenesisDatasourceEventNames, } from './grid-pro-genesis-datasource';
 import { datasourceEventNames, } from './grid-pro-genesis-datasource/datasource-events.types';
 import { AG_PROPERTIES, copyAttributesToGridOptions, DEBOUNCED_RESIZE_TIME, defaultGridProConfig, foundationGridProShadowOptions, gridProErrorNames, gridProEventNames, } from './grid-pro.definitions';
+import { enrichColumnDefsFromMetadata, getMetadataSetFilterValues, isSetFilter, } from './grid-pro.metadata-enrichment';
 import { agDragGhostShadowDomStyles, rowMatchAlertStyles } from './grid-pro.styles';
 import { gridProTemplate as template } from './grid-pro.template';
 import { DEFAULT_STATUS_BAR_CONFIG, EDITED_COLUMN_FIELD, ERROR_COLUMN_FIELD, GRID_READY_EVENT, GridOptionsConfig, GridProRendererTypes, GridProStatusBarTypes, } from './grid-pro.types';
@@ -622,16 +623,18 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
      */
     processSchemaUpdate(_a) {
         return __awaiter(this, arguments, void 0, function* ({ schema }) {
+            this.applyCommunityFilterFallbacks(schema);
             // Only auto-generate columns from the datasource schema when the consumer has NOT already
             // supplied their own column defs (e.g. via `gridOptions`/`deferredGridOptions.columnDefs` or
             // `grid-pro-column` templates). Overwriting here would discard user-provided definitions —
             // including `ColGroupDef` group structure and custom header names — and replace them with flat
-            // metadata columns. This mirrors the legacy `GridProLegacy` behaviour.
+            // metadata columns. This mirrors the legacy `GridProLegacy` behaviour. They are enriched
+            // instead, with what the server decides and the consumer left unset.
             const preSetColumnDefs = this.gridApi.getColumnDefs();
             if (preSetColumnDefs && preSetColumnDefs.length > 0) {
+                this.enrichPresetColumnDefs(schema);
                 return;
             }
-            this.applyCommunityFilterFallbacks(schema);
             // Merge with template definitions
             const mergedColumnDefs = yield this.mergeAllColumnDefsAndStates(schema, true);
             this.gridApi.setGridOption('columnDefs', mergedColumnDefs);
@@ -643,6 +646,36 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
             this.restoreCachedFilterConfig();
         });
     }
+    /**
+     * Fills the consumer's column defs with the sortability, filter and set-filter values the
+     * schema knows and they left unset.
+     * @remarks Reads `getGridOption('columnDefs')` - the defs as given - rather than
+     * `getColumnDefs()`, which merges in `defaultColDef`, so an unset `sortable` would already read
+     * as the datasource default.
+     * @internal
+     */
+    enrichPresetColumnDefs(schema) {
+        const columnDefs = this.gridApi.getGridOption('columnDefs');
+        if (!(columnDefs === null || columnDefs === void 0 ? void 0 : columnDefs.length)) {
+            return;
+        }
+        // Client-side filters work on the rows, so the consumer's defaultColDef filter still serves.
+        const enrichedColumnDefs = enrichColumnDefsFromMetadata(columnDefs, schema, {
+            fillUnsetFilters: !this.isClientSideRowModel,
+        });
+        if (enrichedColumnDefs === columnDefs) {
+            return;
+        }
+        // New defs reset the column order (no maintainColumnOrder), undoing the restored state, and a
+        // changed filter type drops that column's filter model.
+        const columnState = this.gridApi.getColumnState();
+        const filterModel = JSON.stringify(this.gridApi.getFilterModel());
+        this.gridApi.setGridOption('columnDefs', enrichedColumnDefs);
+        this.gridApi.applyColumnState({ state: columnState, applyOrder: true });
+        if (JSON.stringify(this.gridApi.getFilterModel()) !== filterModel) {
+            this.restoreCachedFilterConfig();
+        }
+    }
     /**
      * Downgrades enterprise filters in metadata-generated colDefs when their modules are not
      * registered — from v35 AG Grid throws on unregistered filters instead of falling back.
@@ -1372,7 +1405,7 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
             const templateColumnDefs = Array.from(this.querySelectorAll(this.columnComponentName))
                 .map((templateColumn) => templateColumn.definition)
                 .map((columnDef) => {
-                var _a, _b, _c, _d, _e, _f;
+                var _a;
                 // enable cell flashing for each column if unspecified on column level but enabled on grid level
                 if (this.enableCellFlashing && columnDef.enableCellChangeFlash === undefined) {
                     columnDef.enableCellChangeFlash = true;
@@ -1383,20 +1416,16 @@ export class GridPro extends LifecycleMixin(FoundationElement) {
                  * respect that choice and don't inject metadata values. This allows consumers to
                  * opt out of metadata values and let AG Grid extract values from row data instead.
                  */
-                if (columnDef.filter === 'agSetColumnFilter' ||
-                    columnDef.filter === GridProFilterTypes.enumFilter) {
+                if (isSetFilter(columnDef.filter)) {
                     const hasExplicitValues = columnDef.filterParams != null && 'values' in columnDef.filterParams;
                     if (!hasExplicitValues) {
-                        const metadataFilterParams = (_a = columnDefinitionsFromMetadata.find((colDef) => colDef.field === columnDef.field)) === null || _a === void 0 ? void 0 : _a.filterParams;
-                        // Metadata enum values are flat ({ values }) on the server-side datasource path, but
-                        // nested inside a multi-filter's set sub-filter on the client-side datasource path.
-                        const metadataValues = (_b = metadataFilterParams === null || metadataFilterParams === void 0 ? void 0 : metadataFilterParams.values) !== null && _b !== void 0 ? _b : (_e = (_d = (_c = metadataFilterParams === null || metadataFilterParams === void 0 ? void 0 : metadataFilterParams.filters) === null || _c === void 0 ? void 0 : _c.find((subFilter) => subFilter.filter === 'agSetColumnFilter')) === null || _d === void 0 ? void 0 : _d.filterParams) === null || _e === void 0 ? void 0 : _e.values;
+                        const metadataValues = getMetadataSetFilterValues(columnDefinitionsFromMetadata.find((colDef) => colDef.field === columnDef.field));
                         if (metadataValues) {
                             columnDef.filterParams = Object.assign(Object.assign({}, columnDef.filterParams), { values: metadataValues });
                         }
                     }
                     if (columnDef.filter === GridProFilterTypes.enumFilter) {
-                        (_f = columnDef.floatingFilterComponent) !== null && _f !== void 0 ? _f : (columnDef.floatingFilterComponent = GridProFilterTypes.enumFloatingFilter);
+                        (_a = columnDef.floatingFilterComponent) !== null && _a !== void 0 ? _a : (columnDef.floatingFilterComponent = GridProFilterTypes.enumFloatingFilter);
                     }
                 }
                 if (columnDef.editable) {

package/dist/esm/grid-pro.metadata-enrichment.js

@@ -0,0 +1,75 @@
+import { GridProFilterTypes } from './column-filters';
+/**
+ * Whether a column filter lists set values that metadata can supply.
+ * @internal
+ */
+export const isSetFilter = (filter) => filter === 'agSetColumnFilter' || filter === GridProFilterTypes.enumFilter;
+/**
+ * The enum values datasource metadata gives a column's set filter.
+ * @remarks Flat (`{ values }`) on the server-side and infinite datasources, but nested in a multi
+ * filter's set sub-filter on the client-side datasource - an enum filter once
+ * `applyCommunityFilterFallbacks` has swapped out an unregistered set filter.
+ * @internal
+ */
+export function getMetadataSetFilterValues(metadataColDef) {
+    var _a, _b, _c, _d;
+    const filterParams = metadataColDef === null || metadataColDef === void 0 ? void 0 : metadataColDef.filterParams;
+    return ((_a = filterParams === null || filterParams === void 0 ? void 0 : filterParams.values) !== null && _a !== void 0 ? _a : (_d = (_c = (_b = filterParams === null || filterParams === void 0 ? void 0 : filterParams.filters) === null || _b === void 0 ? void 0 : _b.find((subFilter) => isSetFilter(subFilter.filter))) === null || _c === void 0 ? void 0 : _c.filterParams) === null || _d === void 0 ? void 0 : _d.values);
+}
+function enrichColumnDef(colDef, metadataColDef, { fillUnsetFilters }) {
+    var _a, _b;
+    const enriched = Object.assign({}, colDef);
+    let changed = false;
+    if (enriched.sortable === undefined && metadataColDef.sortable !== undefined) {
+        enriched.sortable = metadataColDef.sortable;
+        changed = true;
+    }
+    if (fillUnsetFilters &&
+        (enriched.filter === undefined || enriched.filter === true) &&
+        metadataColDef.filter !== undefined) {
+        enriched.filter = metadataColDef.filter;
+        if (metadataColDef.filterParams || enriched.filterParams) {
+            enriched.filterParams = Object.assign(Object.assign({}, metadataColDef.filterParams), enriched.filterParams);
+        }
+        if (metadataColDef.floatingFilterComponent) {
+            (_a = enriched.floatingFilterComponent) !== null && _a !== void 0 ? _a : (enriched.floatingFilterComponent = metadataColDef.floatingFilterComponent);
+        }
+        changed = true;
+    }
+    else if (isSetFilter(enriched.filter) && !('values' in ((_b = enriched.filterParams) !== null && _b !== void 0 ? _b : {}))) {
+        const values = getMetadataSetFilterValues(metadataColDef);
+        if (values) {
+            enriched.filterParams = Object.assign(Object.assign({}, enriched.filterParams), { values });
+            changed = true;
+        }
+    }
+    return changed ? enriched : colDef;
+}
+/**
+ * Fills what consumer-authored column defs leave unset from the datasource's metadata column defs.
+ * @remarks Only what the server decides is filled in: whether the column sorts (a DATASERVER can
+ * only order by an index), the filter its field type and transport support (when `filter` is
+ * unset or `true`, and `fillUnsetFilters` is set), and the enum values a set filter lists.
+ * Formatting, rendering and headers stay the consumer's. A column is matched on `field`, and only
+ * when its `colId` is unset or the same: the datasources send the column id as the server field
+ * in ORDER_BY and CRITERIA_MATCH.
+ * @returns The enriched column defs, or `columnDefs` itself when nothing was filled in
+ * @internal
+ */
+export function enrichColumnDefsFromMetadata(columnDefs, metadataColDefs, options) {
+    const metadataByField = new Map(metadataColDefs.map((colDef) => [colDef.field, colDef]));
+    const enrich = (def) => {
+        if ('children' in def) {
+            const children = def.children.map(enrich);
+            return children.every((child, index) => child === def.children[index])
+                ? def
+                : Object.assign(Object.assign({}, def), { children });
+        }
+        const metadataColDef = def.field && (def.colId == null || def.colId === def.field)
+            ? metadataByField.get(def.field)
+            : undefined;
+        return metadataColDef ? enrichColumnDef(def, metadataColDef, options) : def;
+    };
+    const enriched = columnDefs.map(enrich);
+    return enriched.every((def, index) => def === columnDefs[index]) ? columnDefs : enriched;
+}

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",
@@ -14322,7 +14322,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",
@@ -14330,12 +14330,8 @@
             },
             {
               "kind": "Reference",
-              "text": "ActionMenuItem",
-              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
-            },
-            {
-              "kind": "Content",
-              "text": "[]"
+              "text": "ActionMenuItems",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItems:type"
             },
             {
               "kind": "Content",
@@ -14382,8 +14378,8 @@
           ],
           "fileUrlPath": "src/cell-renderers/actions-menu.renderer.ts",
           "returnTypeTokenRange": {
-            "startIndex": 12,
-            "endIndex": 13
+            "startIndex": 11,
+            "endIndex": 12
           },
           "releaseTag": "Public",
           "overloadIndex": 1,
@@ -14392,39 +14388,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
             }
@@ -15678,6 +15674,114 @@
           ],
           "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.\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": ", 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"
+            }
+          ],
+          "fileUrlPath": "src/cell-renderers/actions-menu.renderer.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 11,
+            "endIndex": 12
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "actions",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "overrideDef",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "iconName",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "buttonAppearance",
+              "parameterTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "isOptional": true
+            },
+            {
+              "parameterName": "hideDisabled",
+              "parameterTypeTokenRange": {
+                "startIndex": 9,
+                "endIndex": 10
+              },
+              "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;
 }
 
@@ -3378,7 +3379,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).
@@ -3408,7 +3410,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.
@@ -3572,6 +3574,35 @@ 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.
+ * @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, iconName?: string, buttonAppearance?: string, hideDisabled?: boolean) => ColDef;
+
 /** Context key on `gridOptions.context` for AG column drag integration.
  * @public
  */
@@ -3863,6 +3894,15 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     private processSchemaUpdate;
+    /**
+     * Fills the consumer's column defs with the sortability, filter and set-filter values the
+     * schema knows and they left unset.
+     * @remarks Reads `getGridOption('columnDefs')` - the defs as given - rather than
+     * `getColumnDefs()`, which merges in `defaultColDef`, so an unset `sortable` would already read
+     * as the datasource default.
+     * @internal
+     */
+    private enrichPresetColumnDefs;
     /**
      * Downgrades enterprise filters in metadata-generated colDefs when their modules are not
      * registered — from v35 AG Grid throws on unregistered filters instead of falling back.