docs(ui5-menu): make focus event public (#8407)

unazko · web-flow · commit d5e5944191ef · 2024-03-08T09:56:28.000+02:00
diff --git a/packages/main/src/Menu.ts b/packages/main/src/Menu.ts
@@ -56,6 +56,11 @@ type MenuItemClickEventDetail = {
 type MenuBeforeOpenEventDetail = { item?: MenuItem };
 type MenuBeforeCloseEventDetail = { escPressed: boolean };
 
+type MenuItemFocusEventDetail = {
+	ref: HTMLElement,
+	item: MenuItem,
+};
+
 type OpenerStandardListItem = StandardListItem & { associatedItem: MenuItem };
 
 /**
@@ -184,6 +189,32 @@ type OpenerStandardListItem = StandardListItem & { associatedItem: MenuItem };
  * @since 1.10.0
  */
 @event("after-close")
+
+/**
+ * Fired when a menu item receives focus.
+ *
+ * @public
+ * @param { HTMLElement } ref The currently focused element representing a <code>ui5-menu-item</code>.
+ * @param { HTMLElement } item The <code>ui5-menu-item</code> represented by the focused element.
+ * @since 1.23.1
+ */
+@event<MenuItemFocusEventDetail>("item-focus", {
+	detail: {
+		/**
+		 * @public
+		 */
+		ref: {
+			type: HTMLElement,
+		},
+		/**
+		 * @public
+		 */
+		item: {
+			type: HTMLElement,
+		},
+	},
+})
+
 class Menu extends UI5Element {
 	/**
 	 * Defines the header text of the menu (displayed on mobile).
@@ -539,7 +570,7 @@ class Menu extends UI5Element {
 			: (target.getRootNode() as ShadowRoot).host as MenuListItem;
 		const item = menuListItem.associatedItem as MenuItem;
 		const mainMenu = this._findMainMenu(item);
-		mainMenu?.fireEvent("item-focus", { ref: menuListItem, item });
+		mainMenu?.fireEvent<MenuItemFocusEventDetail>("item-focus", { ref: menuListItem, item });
 	}
 
 	_startOpenTimeout(item: MenuItem, opener: OpenerStandardListItem) {
@@ -712,4 +743,5 @@ export type {
 	MenuItemClickEventDetail,
 	MenuBeforeCloseEventDetail,
 	MenuBeforeOpenEventDetail,
+	MenuItemFocusEventDetail,
 };
