@genesislcap/foundation-ui 15.58.0 → 15.58.1-FUI-2629.4

package/dist/custom-elements.json

@@ -1493,6 +1493,37 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/_config/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./styles"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./tokens"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./values"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/accordion-item/accordion-item.styles.ts",
@@ -1887,37 +1918,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/_config/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./styles"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./tokens"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./values"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/actions-menu/actions-menu.styles.ts",
@@ -2065,7 +2065,7 @@
               "kind": "field",
               "name": "actions",
               "type": {
-                "text": "ActionMenuItem[]"
+                "text": "ActionMenuItems"
               }
             },
             {
@@ -2114,6 +2114,14 @@
               },
               "default": "'Actions'"
             },
+            {
+              "kind": "field",
+              "name": "iconName",
+              "type": {
+                "text": "string"
+              },
+              "description": "When set, the opener renders this icon instead of the `name` text (e.g. `ellipsis`\nfor an icon-only \"kebab\" opener)."
+            },
             {
               "kind": "field",
               "name": "open",
@@ -2166,11 +2174,29 @@
                 "text": "HTMLElement"
               }
             },
+            {
+              "kind": "field",
+              "name": "positionTracker",
+              "type": {
+                "text": "AnchoredPopoverPositionTracker | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "updateMenuPosition",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "startTrackingPosition",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "stopTrackingPosition",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "definitionChanged",
@@ -2199,6 +2225,37 @@
               "kind": "method",
               "name": "toggleActionsMenuVisibility"
             },
+            {
+              "kind": "method",
+              "name": "onPopoverToggle",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Syncs `open` when the native `popover=\"auto\"` light-dismiss (outside click / Escape) closes\nthe vertical menu without going through `toggleActionsMenuVisibility()`."
+            },
+            {
+              "kind": "method",
+              "name": "onIconOpenerKeydown",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Opens the icon-only opener from the keyboard, as a native button would."
+            },
             {
               "kind": "method",
               "name": "onActionMenuItemClick",
@@ -2211,6 +2268,32 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "isActionDisabled",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "action",
+                  "type": {
+                    "text": "ActionMenuItem"
+                  }
+                }
+              ],
+              "description": "Resolves an action's `isDisabled` flag or row-data function for the current row."
+            },
+            {
+              "kind": "field",
+              "name": "resolvedActions",
+              "type": {
+                "text": "ActionMenuItem[]"
+              },
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "allActions",
@@ -2393,6 +2476,14 @@
               "default": "'Actions'",
               "fieldName": "name"
             },
+            {
+              "name": "icon-name",
+              "type": {
+                "text": "string"
+              },
+              "description": "When set, the opener renders this icon instead of the `name` text (e.g. `ellipsis`\nfor an icon-only \"kebab\" opener).",
+              "fieldName": "iconName"
+            },
             {
               "name": "open",
               "type": {
@@ -59561,6 +59652,14 @@
             "package": "./options-datasource-utils"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./popover-position"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -59694,6 +59793,89 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/popover-position.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "findScrollableAncestors",
+          "return": {
+            "type": {
+              "text": "(HTMLElement | Document)[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ],
+          "description": "Walks up from `element`, crossing shadow-root boundaries via `.host`, collecting every\nscrollable ancestor (including the anchor's own document).",
+          "privacy": "public"
+        },
+        {
+          "kind": "class",
+          "description": "Keeps a Popover-API element anchored to its trigger while any of the trigger's scrollable\nancestors scroll, and reports back when the trigger has been removed from the DOM (e.g. AG\nGrid row virtualization recycling the row that owns it).",
+          "name": "AnchoredPopoverPositionTracker",
+          "members": [
+            {
+              "kind": "field",
+              "name": "ancestors",
+              "type": {
+                "text": "(HTMLElement | Document)[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "handleScroll",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "start",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "stop",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "findScrollableAncestors",
+          "declaration": {
+            "name": "findScrollableAncestors",
+            "module": "src/utils/popover-position.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AnchoredPopoverPositionTracker",
+          "declaration": {
+            "name": "AnchoredPopoverPositionTracker",
+            "module": "src/utils/popover-position.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/tooltip.ts",

package/dist/dts/actions-menu/actions-menu.d.ts

@@ -1,4 +1,6 @@
+import type { IconStyle } from '@fortawesome/fontawesome-svg-core';
 import { FoundationElement } from '@microsoft/fast-foundation';
+import type { FaSize } from '../icon';
 /**
  * The Action Menu Item component.
  * @remarks Used within the Action Menu component.
@@ -7,20 +9,37 @@ import { FoundationElement } from '@microsoft/fast-foundation';
 export type ActionMenuItem = {
     name: string | ((rowData: any) => string);
     callback: (rowData: any) => void | any;
-    isDisabled?: (rowData: any) => boolean;
+    /** A fixed flag, or a function of the row data (the grid row from the cell params). */
+    isDisabled?: boolean | ((rowData: any) => boolean);
     color?: string;
+    icon?: {
+        variant?: IconStyle;
+        name: string;
+        size?: FaSize;
+    };
 };
+/**
+ * The actions shown by the Actions Menu: a fixed array, or a function of the row data returning
+ * one (for row-scoped eligibility/permission filtering).
+ * @public
+ */
+export type ActionMenuItems = ActionMenuItem[] | ((rowData: any) => ActionMenuItem[]);
 /**
  * @tagname %%prefix%%-actions-menu
  */
 export declare class ActionsMenu extends FoundationElement {
-    actions: ActionMenuItem[];
+    actions: ActionMenuItems;
     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;
@@ -28,12 +47,25 @@ export declare class ActionsMenu extends FoundationElement {
     singleOption: ActionMenuItem;
     actionsMenu: HTMLElement;
     actionsOpener: HTMLElement;
+    private positionTracker?;
     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` flag or row-data function for the current row. */
+    isActionDisabled(action: ActionMenuItem): boolean;
+    get resolvedActions(): ActionMenuItem[];
     get allActions(): ActionMenuItem[];
     get rowData(): any;
     getLabel(name: string | ((rowData: any) => string)): string;

package/dist/dts/actions-menu/actions-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-menu.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,GAAG,CAAC;IACvC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IACe,UAAU,EAAE,OAAO,CAAS;IACpB,iBAAiB,EAAE,OAAO,CAAQ;IACjC,iBAAiB,EAAE,OAAO,CAAQ;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,GAAG,CAAC;IACtB,IAAI,SAAa;IACuB,IAAI,EAAE,OAAO,CAAS;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACwB,YAAY,EAAE,OAAO,CAAS;IACpB,oBAAoB,EAAE,OAAO,CACtF;IACI,YAAY,EAAE,cAAc,CAAC;IAEzC,WAAW,EAAG,WAAW,CAAC;IAC1B,aAAa,EAAG,WAAW,CAAC;IAE5B,oBAAoB,IAAI,IAAI;IAO5B,OAAO,CAAC,kBAAkB;IAQ1B,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG;IAyBxD,SAAS,CAAC,WAAW;IAWrB,2BAA2B;IAI3B,qBAAqB,CAAC,QAAQ,EAAE,CAAC,OAAO,KAAA,KAAK,IAAI,GAAG,GAAG;IAKvD,IAAI,UAAU,IAAI,cAAc,EAAE,CASjC;IAED,IAAI,OAAO,QAKV;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IAQlD,WAAW,CAAC,MAAM,EAAE,MAAM;CAsB3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,2TAIhC,CAAC"}
+{"version":3,"file":"actions-menu.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAStC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,GAAG,CAAC;IACvC,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,SAAS,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,cAAc,EAAE,CAAC,CAAC;AAEtF;;GAEG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;IACpC,OAAO,EAAE,eAAe,CAAC;IACgB,UAAU,EAAE,OAAO,CAAS;IACpB,iBAAiB,EAAE,OAAO,CAAQ;IACjC,iBAAiB,EAAE,OAAO,CAAQ;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,GAAG,CAAC;IACtB,IAAI,SAAa;IACvB;;;OAGG;IAC+B,QAAQ,EAAE,MAAM,CAAC;IACL,IAAI,EAAE,OAAO,CAAS;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACwB,YAAY,EAAE,OAAO,CAAS;IACpB,oBAAoB,EAAE,OAAO,CACtF;IACI,YAAY,EAAE,cAAc,CAAC;IAEzC,WAAW,EAAG,WAAW,CAAC;IAC1B,aAAa,EAAG,WAAW,CAAC;IAE5B,OAAO,CAAC,eAAe,CAAC,CAAiC;IAEzD,oBAAoB,IAAI,IAAI;IAQ5B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,oBAAoB;IAK5B,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG;IA0CxD,SAAS,CAAC,WAAW;IAerB,2BAA2B;IAI3B;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,KAAK;IAO5B,8EAA8E;IAC9E,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAMlD,qBAAqB,CAAC,QAAQ,EAAE,CAAC,OAAO,KAAA,KAAK,IAAI,GAAG,GAAG;IAKvD,uFAAuF;IACvF,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAKjD,IAAI,eAAe,IAAI,cAAc,EAAE,CAGtC;IAED,IAAI,UAAU,IAAI,cAAc,EAAE,CAWjC;IAED,IAAI,OAAO,QAKV;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IAQlD,WAAW,CAAC,MAAM,EAAE,MAAM;CAyB3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,2TAIhC,CAAC"}

package/dist/dts/actions-menu/actions-menu.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-menu.styles.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,qBAAqB,GAChC,SAAS,wBAAwB,EACjC,YAAY,2BAA2B,KACtC,aA4FF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,SAAS,wBAAwB,EACjC,YAAY,2BAA2B,KACtC,aAEF,CAAC"}
+{"version":3,"file":"actions-menu.styles.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,qBAAqB,GAChC,SAAS,wBAAwB,EACjC,YAAY,2BAA2B,KACtC,aAiKF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,SAAS,wBAAwB,EACjC,YAAY,2BAA2B,KACtC,aAEF,CAAC"}

package/dist/dts/actions-menu/actions-menu.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-menu.template.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,mCAoD1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,mCAclD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,YAAY,CAAC,WAAW,CAOnE,CAAC"}
+{"version":3,"file":"actions-menu.template.d.ts","sourceRoot":"","sources":["../../../src/actions-menu/actions-menu.template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwClD,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,mCAiE1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,mCAclD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,YAAY,CAAC,WAAW,CAOnE,CAAC"}

package/dist/dts/filter-bar/filter-bar.utils.d.ts

@@ -1,2 +1,2 @@
-export declare const mapType: (TYPE: string) => "boolean" | "number" | "date" | "text" | "enum";
+export declare const mapType: (TYPE: string) => "boolean" | "number" | "text" | "date" | "enum";
 //# sourceMappingURL=filter-bar.utils.d.ts.map

package/dist/dts/utils/index.d.ts

@@ -3,5 +3,6 @@ export * from './dom';
 export * from './event-types';
 export * from './logger';
 export * from './options-datasource-utils';
+export * from './popover-position';
 export * from './tooltip';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/dist/dts/utils/popover-position.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Walks up from `element`, crossing shadow-root boundaries via `.host`, collecting every
+ * scrollable ancestor (including the anchor's own document).
+ * @remarks Native `scroll` events are not `composed`, so they don't cross shadow-DOM boundaries
+ * the way `click`/`keydown` do — a listener on `document` never sees a shadow-DOM-nested
+ * viewport's own scroll. Callers must listen on each returned ancestor directly.
+ * @public
+ */
+export declare function findScrollableAncestors(element: HTMLElement): (HTMLElement | Document)[];
+/**
+ * Keeps a Popover-API element anchored to its trigger while any of the trigger's scrollable
+ * ancestors scroll, and reports back when the trigger has been removed from the DOM (e.g. AG
+ * Grid row virtualization recycling the row that owns it).
+ * @public
+ */
+export declare class AnchoredPopoverPositionTracker {
+    private readonly anchor;
+    private readonly onReposition;
+    private readonly onAnchorDetached;
+    private ancestors;
+    private readonly handleScroll;
+    constructor(anchor: HTMLElement, onReposition: () => void, onAnchorDetached: () => void);
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=popover-position.d.ts.map

package/dist/dts/utils/popover-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-position.d.ts","sourceRoot":"","sources":["../../../src/utils/popover-position.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,EAAE,CA8BxF;AAED;;;;;GAKG;AACH,qBAAa,8BAA8B;IAYvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAbnC,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAM3B;gBAGiB,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,IAAI,EACxB,gBAAgB,EAAE,MAAM,IAAI;IAG/C,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;CAMb"}

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

@@ -2,6 +2,7 @@ import { __decorate } from "tslib";
 import { attr, observable } from '@microsoft/fast-element';
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { classNames } from '@microsoft/fast-web-utilities';
+import { AnchoredPopoverPositionTracker } from '../utils';
 import { foundationActionsMenuStyles as styles } from './actions-menu.styles';
 import { singleOptionTemplate, menuTemplate, foundationActionsMenuTemplate as template, } from './actions-menu.template';
 /**
@@ -20,6 +21,7 @@ export class ActionsMenu extends FoundationElement {
     }
     disconnectedCallback() {
         var _a;
+        this.stopTrackingPosition();
         if ((_a = this.actionsMenu) === null || _a === void 0 ? void 0 : _a.matches(':popover-open')) {
             this.actionsMenu.hidePopover();
         }
@@ -28,13 +30,25 @@ export class ActionsMenu extends FoundationElement {
     updateMenuPosition() {
         const rect = this.actionsOpener.getBoundingClientRect();
         this.actionsMenu.style.position = 'fixed';
-        this.actionsMenu.style.top = `${rect.top}px`;
+        // The vertical menu drops down below its opener; the horizontal one overlays it.
+        this.actionsMenu.style.top = `${this.isVertical ? rect.bottom : rect.top}px`;
         this.actionsMenu.style.left = 'auto';
         this.actionsMenu.style.right = `${window.innerWidth - rect.right}px`;
     }
+    startTrackingPosition() {
+        this.positionTracker = new AnchoredPopoverPositionTracker(this.actionsOpener, () => this.updateMenuPosition(), () => (this.open = false));
+        this.positionTracker.start();
+    }
+    stopTrackingPosition() {
+        var _a;
+        (_a = this.positionTracker) === null || _a === void 0 ? void 0 : _a.stop();
+        this.positionTracker = undefined;
+    }
     definitionChanged(oldValue, newValue) {
         var _a;
-        this.actions = (_a = newValue === null || newValue === void 0 ? void 0 : newValue.actions) !== null && _a !== void 0 ? _a : [];
+        if (!newValue)
+            return;
+        this.actions = (_a = newValue.actions) !== null && _a !== void 0 ? _a : [];
         delete this.definition.actions;
         if (newValue.buttonText) {
             this.name = newValue.buttonText;
@@ -44,6 +58,18 @@ export class ActionsMenu extends FoundationElement {
             this.isVertical = newValue.isVertical;
             delete this.definition.isVertical;
         }
+        if (newValue.iconName) {
+            this.iconName = newValue.iconName;
+            delete this.definition.iconName;
+        }
+        if (newValue.addDefaultActions !== undefined) {
+            this.addDefaultActions = newValue.addDefaultActions;
+            delete this.definition.addDefaultActions;
+        }
+        if (newValue.hideDisabled !== undefined) {
+            this.hideDisabled = newValue.hideDisabled;
+            delete this.definition.hideDisabled;
+        }
         if (newValue.buttonAppearance) {
             this.buttonAppearance = newValue.buttonAppearance;
             delete this.definition.buttonAppearance;
@@ -59,28 +85,59 @@ export class ActionsMenu extends FoundationElement {
         if (this.open) {
             this.updateMenuPosition();
             this.actionsMenu.showPopover();
+            this.startTrackingPosition();
         }
-        else if ((_a = this.actionsMenu) === null || _a === void 0 ? void 0 : _a.matches(':popover-open')) {
-            this.actionsMenu.hidePopover();
+        else {
+            this.stopTrackingPosition();
+            if ((_a = this.actionsMenu) === null || _a === void 0 ? void 0 : _a.matches(':popover-open')) {
+                this.actionsMenu.hidePopover();
+            }
         }
     }
     toggleActionsMenuVisibility() {
         this.open = !this.open;
     }
+    /**
+     * Syncs `open` when the native `popover="auto"` light-dismiss (outside click / Escape) closes
+     * the vertical menu without going through `toggleActionsMenuVisibility()`.
+     */
+    onPopoverToggle(event) {
+        const newState = event.newState;
+        if (newState) {
+            this.open = newState === 'open';
+        }
+    }
+    /** Opens the icon-only opener from the keyboard, as a native button would. */
+    onIconOpenerKeydown(event) {
+        if (event.key !== 'Enter' && event.key !== ' ')
+            return true;
+        this.toggleActionsMenuVisibility();
+        return false;
+    }
     onActionMenuItemClick(callback) {
         if (this.autoCloseOnAction)
             this.open = false;
         callback(this.rowData);
     }
+    /** Resolves an action's `isDisabled` flag or row-data function for the current row. */
+    isActionDisabled(action) {
+        const { isDisabled } = action;
+        return typeof isDisabled === 'function' ? !!isDisabled(this.rowData) : !!isDisabled;
+    }
+    get resolvedActions() {
+        const actions = typeof this.actions === 'function' ? this.actions(this.rowData) : this.actions;
+        return actions !== null && actions !== void 0 ? actions : [];
+    }
     get allActions() {
-        var _a;
         const defaultActions = [
             {
                 name: '✖',
                 callback: () => (this.open = false),
             },
         ];
-        return this.addDefaultActions ? [...((_a = this.actions) !== null && _a !== void 0 ? _a : []), ...defaultActions] : this.actions;
+        return this.addDefaultActions
+            ? [...this.resolvedActions, ...defaultActions]
+            : this.resolvedActions;
     }
     get rowData() {
         if (!this.definition)
@@ -95,15 +152,17 @@ export class ActionsMenu extends FoundationElement {
         return name;
     }
     getTemplate(prefix) {
+        const enabledRows = this.resolvedActions.filter((action) => !this.isActionDisabled(action));
+        // The vertical menu hides its opener entirely rather than open onto nothing actionable.
+        const hasVisibleActions = this.hideDisabled
+            ? enabledRows.length > 0
+            : this.resolvedActions.length > 0;
+        if (this.isVertical && !hasVisibleActions) {
+            return;
+        }
         if (!this.hideMenuSingleOption) {
             return menuTemplate(prefix);
         }
-        const enabledRows = this.actions.filter((action) => {
-            if (!action.isDisabled) {
-                return true;
-            }
-            return !action.isDisabled(this.rowData);
-        });
         this.singleOption = null;
         if (enabledRows.length === 0) {
             return;
@@ -136,6 +195,9 @@ __decorate([
 __decorate([
     attr
 ], ActionsMenu.prototype, "name", void 0);
+__decorate([
+    attr({ attribute: 'icon-name' })
+], ActionsMenu.prototype, "iconName", void 0);
 __decorate([
     attr({ attribute: 'open', mode: 'boolean' })
 ], ActionsMenu.prototype, "open", void 0);