@genesislcap/foundation-ui 15.71.0 → 15.72.0-FUI-2629.7

package/dist/esm/actions-menu/ag-menu.styles.js

@@ -0,0 +1,60 @@
+import { css } from '@microsoft/fast-element';
+/**
+ * Styles a menu to match AG Grid's own menu (ag-menu / ag-menu-list / ag-menu-option), so a menu
+ * drawn over a grid looks like the grid's. AG Grid's `--ag-*` variables apply where they are set;
+ * elsewhere the design system's tokens do, with fallbacks for when neither is in scope.
+ *
+ * @remarks Shared by the vertical actions menu and grid-pro's right-click menu. Each adds its own
+ * layout (display, sizing) around these rules.
+ *
+ * @param menuSelector - Selects the menu surface. May be a selector list.
+ * @param itemSelector - Selects a menu item. Must be a single selector, as states are appended to it.
+ * @returns The menu surface and item styles.
+ * @public
+ */
+export const agMenuStyles = (menuSelector, itemSelector) => css `
+  ${menuSelector} {
+    box-sizing: border-box;
+    padding: var(--ag-spacing, 4px) 0;
+    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));
+  }
+
+  ${itemSelector} {
+    box-sizing: border-box;
+    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;
+  }
+
+  ${itemSelector}:hover, ${itemSelector}:focus {
+    background: var(--ag-row-hover-color, var(--neutral-fill-stealth-hover));
+    border: none;
+  }
+
+  ${itemSelector}[disabled] {
+    background: transparent;
+    cursor: default;
+    opacity: 50%;
+  }
+
+  /* AG's trailing shortcut and popup-pointer cells add 2 more spacings on the right. */
+  ${itemSelector}::part(content) {
+    margin-inline: 0;
+    padding-inline: calc(var(--ag-spacing, 4px) * 2) calc(var(--ag-spacing, 4px) * 4);
+    line-height: var(--ag-icon-size, 16px);
+  }
+`;

package/dist/esm/actions-menu/index.js

@@ -1,3 +1,4 @@
 export * from './actions-menu.styles';
 export * from './actions-menu.template';
 export * from './actions-menu';
+export * from './ag-menu.styles';

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",
@@ -1278,6 +1640,64 @@
           ],
           "name": "AffixMixin"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ui!agMenuStyles:function(1)",
+          "docComment": "/**\n * Styles a menu to match AG Grid's own menu (ag-menu / ag-menu-list / ag-menu-option), so a menu drawn over a grid looks like the grid's. AG Grid's `--ag-*` variables apply where they are set; elsewhere the design system's tokens do, with fallbacks for when neither is in scope.\n *\n * @remarks\n *\n * Shared by the vertical actions menu and grid-pro's right-click menu. Each adds its own layout (display, sizing) around these rules.\n *\n * @param menuSelector - Selects the menu surface. May be a selector list.\n *\n * @param itemSelector - Selects a menu item. Must be a single selector, as states are appended to it.\n *\n * @returns The menu surface and item styles.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "agMenuStyles: (menuSelector: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ", itemSelector: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "ElementStyles",
+              "canonicalReference": "@microsoft/fast-element!ElementStyles:class"
+            }
+          ],
+          "fileUrlPath": "src/actions-menu/ag-menu.styles.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "menuSelector",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "itemSelector",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "agMenuStyles"
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/foundation-ui!AiCriteriaSearch:class",
@@ -54125,7 +54545,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 +54947,7 @@
             },
             {
               "kind": "Content",
-              "text": ", any>"
+              "text": ">"
             }
           ],
           "fileUrlPath": "src/actions-menu/actions-menu.template.ts",
@@ -66682,7 +67102,7 @@
             },
             {
               "kind": "Content",
-              "text": ", any>"
+              "text": ">"
             }
           ],
           "fileUrlPath": "src/actions-menu/actions-menu.template.ts",