@genesislcap/foundation-ui 15.64.0 → 15.64.1-FUI-2629.6

package/dist/esm/ai-criteria-search/validation/operator-map.js

@@ -8,6 +8,7 @@ const OPERATOR_TO_SERIALISER = {
     contains: Serialisers.containsIgnoreCase,
     equals: Serialisers.EQ,
     startsWith: Serialisers.startsWith,
+    // Deprecated: GSF 8.14+ rejects FIELD.endsWith, and validateGroups refuses it.
     endsWith: Serialisers.endsWith,
     greaterThan: Serialisers.GT,
     lessThan: Serialisers.LT,
@@ -26,11 +27,16 @@ const OPERATOR_TO_SERIALISER = {
     dateTimeIsLessEqual: Serialisers.dateTimeIsLessEqual,
 };
 function clauseToExpression(clause) {
-    var _a, _b;
-    const serialiser = (_a = OPERATOR_TO_SERIALISER[clause.operator]) !== null && _a !== void 0 ? _a : Serialisers.containsIgnoreCase;
+    var _a;
+    const serialiser = OPERATOR_TO_SERIALISER[clause.operator];
+    if (!serialiser) {
+        // An operator outside CriteriaOperator (a restored or hand-written IR that skipped
+        // validateGroups). Falling back to another operator would quietly match different rows.
+        throw new Error(`Unknown criteria operator '${clause.operator}'`);
+    }
     return new ExpressionBuilder()
         .withField(clause.field)
-        .withValue((_b = clause.value) !== null && _b !== void 0 ? _b : null)
+        .withValue((_a = clause.value) !== null && _a !== void 0 ? _a : null)
         .withSerialiser(serialiser)
         .withGroup('default')
         .build();
@@ -70,7 +76,6 @@ export const STRING_OPERATORS = [
     'contains',
     'equals',
     'startsWith',
-    'endsWith',
     'notEqual',
 ];
 export const NUMERIC_OPERATORS = [

package/dist/esm/utils/popover-position.js

@@ -0,0 +1,50 @@
+/**
+ * Keeps a Popover-API element anchored to its trigger, and reports back when the trigger has been
+ * removed from the DOM (e.g. AG Grid row virtualization recycling the row that owns it).
+ * @remarks Checks the trigger once per animation frame while started, and repositions only when
+ * the trigger or the viewport moved. Events alone miss moves: native `scroll` events don't cross
+ * shadow-DOM boundaries, and a grid re-sort moves a row by `transform`, which fires nothing on the
+ * rows that didn't change. Callers start it when the popover opens and stop it when it closes.
+ * @internal
+ */
+export class AnchoredPopoverPositionTracker {
+    constructor(anchor, onReposition, onAnchorDetached) {
+        this.anchor = anchor;
+        this.onReposition = onReposition;
+        this.onAnchorDetached = onAnchorDetached;
+        this.check = () => {
+            if (!this.anchor.isConnected) {
+                this.stop();
+                this.onAnchorDetached();
+                return;
+            }
+            const { top, right, bottom } = this.anchor.getBoundingClientRect();
+            const position = `${top},${right},${bottom},${this.view.innerWidth},${this.view.innerHeight}`;
+            // The first check only records where the caller already positioned the popover.
+            if (this.lastPosition !== undefined && position !== this.lastPosition) {
+                this.onReposition();
+                // onReposition may have stopped the tracker; don't schedule past that.
+                if (!this.view)
+                    return;
+            }
+            this.lastPosition = position;
+            this.frame = this.view.requestAnimationFrame(this.check);
+        };
+    }
+    start() {
+        this.stop();
+        this.view = this.anchor.ownerDocument.defaultView;
+        if (!this.view)
+            return;
+        this.check();
+    }
+    stop() {
+        var _a;
+        if (this.frame !== undefined) {
+            (_a = this.view) === null || _a === void 0 ? void 0 : _a.cancelAnimationFrame(this.frame);
+        }
+        this.frame = undefined;
+        this.lastPosition = undefined;
+        this.view = undefined;
+    }
+}

package/dist/foundation-ui.api.json

@@ -279,7 +279,25 @@
             },
             {
               "kind": "Content",
-              "text": "{\n    name: string | ((rowData: any) => string);\n    callback: (rowData: any) => void | any;\n    isDisabled?: (rowData: any) => boolean;\n    color?: string;\n}"
+              "text": "{\n    name: string | ((rowData: any) => string);\n    callback: (rowData: any) => void | any;\n    isDisabled?: (rowData: any) => boolean;\n    color?: string;\n    icon?: {\n        variant?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "IconStyle",
+              "canonicalReference": "@fortawesome/fontawesome-common-types!IconStyle:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n        name: string;\n        size?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "FaSize",
+              "canonicalReference": "@genesislcap/foundation-ui!FaSize:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n    };\n}"
             },
             {
               "kind": "Content",
@@ -291,7 +309,78 @@
           "name": "ActionMenuItem",
           "typeTokenRange": {
             "startIndex": 1,
-            "endIndex": 2
+            "endIndex": 6
+          }
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItems:type",
+          "docComment": "/**\n * The actions a grid column's Actions Menu shows: a fixed array, or a resolver per row.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ActionMenuItems = "
+            },
+            {
+              "kind": "Reference",
+              "text": "ActionMenuItem",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[] | "
+            },
+            {
+              "kind": "Reference",
+              "text": "ActionMenuItemsResolver",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItemsResolver:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/actions-menu/actions-menu.ts",
+          "releaseTag": "Public",
+          "name": "ActionMenuItems",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItemsResolver:type",
+          "docComment": "/**\n * A function of the row data returning the actions for that row (for row-scoped eligibility/permission filtering).\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ActionMenuItemsResolver = "
+            },
+            {
+              "kind": "Content",
+              "text": "(rowData: any) => "
+            },
+            {
+              "kind": "Reference",
+              "text": "ActionMenuItem",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/actions-menu/actions-menu.ts",
+          "releaseTag": "Public",
+          "name": "ActionMenuItemsResolver",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
           }
         },
         {
@@ -416,6 +505,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#actionsResolver:member",
+              "docComment": "/**\n * Resolves the actions per row instead of `actions`, from the row data in `definition`.\n *\n * @remarks\n *\n * Set from a function passed as the cell params' `actions`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "actionsResolver?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ActionMenuItemsResolver",
+                  "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItemsResolver:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "actionsResolver",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#addDefaultActions:member",
@@ -810,6 +930,36 @@
               "isAbstract": false,
               "name": "getTemplate"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#hasVisibleActions:member",
+              "docComment": "/**\n * Whether the row has an action to show: an enabled one, or any when disabled ones show.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get hasVisibleActions(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "hasVisibleActions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#hideDisabled:member",
@@ -870,6 +1020,85 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#iconName:member",
+              "docComment": "/**\n * When set, the opener renders this icon instead of the `name` text (e.g. `ellipsis` for an icon-only \"kebab\" opener).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "iconName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "iconName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#isActionDisabled:member(1)",
+              "docComment": "/**\n * Resolves an action's `isDisabled` for the current row.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isActionDisabled(action: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ActionMenuItem",
+                  "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "action",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isActionDisabled"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#isVertical:member",
@@ -978,6 +1207,104 @@
               "isAbstract": false,
               "name": "onActionMenuItemClick"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#onIconOpenerKeydown:member(1)",
+              "docComment": "/**\n * Opens the icon-only opener from the keyboard, as a native button would.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onIconOpenerKeydown(event: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "KeyboardEvent",
+                  "canonicalReference": "!KeyboardEvent:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "event",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "onIconOpenerKeydown"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#onPopoverToggle:member(1)",
+              "docComment": "/**\n * Syncs `open` when the native `popover=\"auto\"` light-dismiss (outside click / Escape) closes the vertical menu without going through `toggleActionsMenuVisibility()`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onPopoverToggle(event: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Event",
+                  "canonicalReference": "!Event:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "event",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "onPopoverToggle"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#open:member",
@@ -1039,6 +1366,41 @@
               "isAbstract": false,
               "name": "openChanged"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#resolvedActions:member",
+              "docComment": "/**\n * The actions for the current row: from `actionsResolver` when set, else `actions`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get resolvedActions(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ActionMenuItem",
+                  "canonicalReference": "@genesislcap/foundation-ui!ActionMenuItem:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "resolvedActions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-ui!ActionsMenu#rowData:member",
@@ -54125,7 +54487,7 @@
             },
             {
               "kind": "Content",
-              "text": "\"boolean\" | \"number\" | \"date\" | \"text\" | \"enum\""
+              "text": "\"boolean\" | \"number\" | \"text\" | \"date\" | \"enum\""
             }
           ],
           "fileUrlPath": "src/filter-bar/filter-bar.utils.ts",
@@ -54527,7 +54889,7 @@
             },
             {
               "kind": "Content",
-              "text": ", any>"
+              "text": ">"
             }
           ],
           "fileUrlPath": "src/actions-menu/actions-menu.template.ts",
@@ -66682,7 +67044,7 @@
             },
             {
               "kind": "Content",
-              "text": ", any>"
+              "text": ">"
             }
           ],
           "fileUrlPath": "src/actions-menu/actions-menu.template.ts",

package/dist/foundation-ui.d.ts

@@ -312,19 +312,47 @@ export declare type ActionMenuItem = {
     callback: (rowData: any) => void | any;
     isDisabled?: (rowData: any) => boolean;
     color?: string;
+    icon?: {
+        variant?: IconStyle;
+        name: string;
+        size?: FaSize;
+    };
 };
 
+/**
+ * The actions a grid column's Actions Menu shows: a fixed array, or a resolver per row.
+ * @public
+ */
+export declare type ActionMenuItems = ActionMenuItem[] | ActionMenuItemsResolver;
+
+/**
+ * A function of the row data returning the actions for that row (for row-scoped
+ * eligibility/permission filtering).
+ * @public
+ */
+export declare type ActionMenuItemsResolver = (rowData: any) => ActionMenuItem[];
+
 /**
  * @tagname %%prefix%%-actions-menu
  */
 export declare class ActionsMenu extends FoundationElement {
     actions: ActionMenuItem[];
+    /**
+     * Resolves the actions per row instead of `actions`, from the row data in `definition`.
+     * @remarks Set from a function passed as the cell params' `actions`.
+     */
+    actionsResolver?: ActionMenuItemsResolver;
     isVertical: boolean;
     addDefaultActions: boolean;
     autoCloseOnAction: boolean;
     classNames: string;
     definition: any;
     name: string;
+    /**
+     * When set, the opener renders this icon instead of the `name` text (e.g. `ellipsis`
+     * for an icon-only "kebab" opener).
+     */
+    iconName: string;
     open: boolean;
     buttonAppearance: string;
     hideDisabled: boolean;
@@ -332,12 +360,30 @@ export declare class ActionsMenu extends FoundationElement {
     singleOption: ActionMenuItem;
     actionsMenu: HTMLElement;
     actionsOpener: HTMLElement;
+    private positionTracker?;
+    /** Set when the keyboard opens the menu, so focus moves into it as screen readers announce. */
+    private focusMenuOnOpen;
     disconnectedCallback(): void;
     private updateMenuPosition;
+    private startTrackingPosition;
+    private stopTrackingPosition;
     protected definitionChanged(oldValue: any, newValue: any): void;
     protected openChanged(): void;
     toggleActionsMenuVisibility(): void;
+    /**
+     * Syncs `open` when the native `popover="auto"` light-dismiss (outside click / Escape) closes
+     * the vertical menu without going through `toggleActionsMenuVisibility()`.
+     */
+    onPopoverToggle(event: Event): void;
+    /** Opens the icon-only opener from the keyboard, as a native button would. */
+    onIconOpenerKeydown(event: KeyboardEvent): boolean;
     onActionMenuItemClick(callback: (rowData: any) => void | any): void;
+    /** Resolves an action's `isDisabled` for the current row. */
+    isActionDisabled(action: ActionMenuItem): boolean;
+    /** The actions for the current row: from `actionsResolver` when set, else `actions`. */
+    get resolvedActions(): ActionMenuItem[];
+    /** Whether the row has an action to show: an enabled one, or any when disabled ones show. */
+    get hasVisibleActions(): boolean;
     get allActions(): ActionMenuItem[];
     get rowData(): any;
     getLabel(name: string | ((rowData: any) => string)): string;
@@ -5480,7 +5526,7 @@ export declare class Listbox extends Listbox_2 {
 export declare class ListboxOption extends ListboxOption_2 {
 }
 
-export declare const mapType: (TYPE: string) => "boolean" | "number" | "date" | "text" | "enum";
+export declare const mapType: (TYPE: string) => "boolean" | "number" | "text" | "date" | "enum";
 
 export declare const MAX_DAYS = 31;
 
@@ -5515,7 +5561,7 @@ export declare class MenuItem extends MenuItem_2 {
     connectedCallback(): void;
 }
 
-export declare const menuTemplate: (prefix: string) => ViewTemplate<ActionsMenu, any>;
+export declare const menuTemplate: (prefix: string) => ViewTemplate<ActionsMenu>;
 
 export declare type MinutesConfig = Omit<baseConfig, 'minutes'> & {
     type: RecurrenceType.MINUTES;
@@ -6948,7 +6994,7 @@ export declare interface SetStatesEventDetail {
 
 export declare const sharedFieldStyles: ElementStyles;
 
-export declare const singleOptionTemplate: (prefix: string) => ViewTemplate<ActionsMenu, any>;
+export declare const singleOptionTemplate: (prefix: string) => ViewTemplate<ActionsMenu>;
 
 /**
  * @tagname %%prefix%%-skeleton

package/dist/react.cjs

@@ -123,11 +123,6 @@ const AccordionItem = React.forwardRef(function AccordionItem(props, ref) {
   return React.createElement(customElements.getName(AccordionItemWC) ?? '%%prefix%%-accordion-item', { ...rest, ref }, children);
 });
 
-const AiIndicator = React.forwardRef(function AiIndicator(props, ref) {
-  const { children, ...rest } = props;
-  return React.createElement(customElements.getName(AiIndicatorWC) ?? '%%prefix%%-ai-indicator', { ...rest, ref }, children);
-});
-
 const AiCriteriaSearch = React.forwardRef(function AiCriteriaSearch(props, ref) {
   const { onCriteriaChanged, onValidationErrors, children, ...rest } = props;
   const _innerRef = React.useRef(null);
@@ -150,6 +145,11 @@ const AiCriteriaSearch = React.forwardRef(function AiCriteriaSearch(props, ref)
   return React.createElement(customElements.getName(AiCriteriaSearchWC) ?? '%%prefix%%-ai-criteria-search', { ...rest, ref: _mergeRefs(_innerRef, ref) }, children);
 });
 
+const AiIndicator = React.forwardRef(function AiIndicator(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(AiIndicatorWC) ?? '%%prefix%%-ai-indicator', { ...rest, ref }, children);
+});
+
 const Accordion = React.forwardRef(function Accordion(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(AccordionWC) ?? '%%prefix%%-accordion', { ...rest, ref }, children);
@@ -1145,8 +1145,8 @@ const WeeklyRecurrence = React.forwardRef(function WeeklyRecurrence(props, ref)
 module.exports = {
   ActionsMenu,
   AccordionItem,
-  AiIndicator,
   AiCriteriaSearch,
+  AiIndicator,
   Accordion,
   Anchor,
   AnchoredRegion,