@featherk/composables 0.10.10 → 0.11.1

package/dist/menu/usePopupMenu.d.ts

@@ -1,6 +1,7 @@
 import { type ComponentPublicInstance, type Ref } from "vue";
 /** A template ref that may point to an element or a Vue/Kendo component. */
 export type PopupMenuElementRef = Ref<HTMLElement | ComponentPublicInstance | null>;
+export type PopupMenuTriggerMode = "button" | "row";
 /** Why the popup was closed, including the focus policy for mouse paths. */
 export type PopupMenuCloseReason = "keyboard" | "mouse-selection" | "outside-click" | "trigger-click" | null;
 export type PopupMenuCloseTrigger = Exclude<PopupMenuCloseReason, null>;
@@ -40,11 +41,10 @@ export type UsePopupMenuOptions = {
      * Defaults to `".k-menu-item:not(.k-disabled)"` for Kendo Menu.
      */
     menuItemSelector?: string;
-    /**
-     * Keeps `aria-expanded` on the trigger in sync with `isOpen`.
-     * Applies only to button-like triggers. Defaults to `true`.
-     */
-    manageAriaExpanded?: boolean;
+    /** Keeps menu-trigger ARIA attributes in sync with `isOpen`. Defaults to `true`. */
+    manageMenuTriggerAria?: boolean;
+    /** Allows a table row to own the menu trigger semantics without adding button behavior. */
+    triggerMode?: PopupMenuTriggerMode;
 };
 /** Functions returned by {@link usePopupMenu} for the action menu. */
 export type UsePopupMenuReturn = {

package/docs/menu/usePopupMenu.md

@@ -19,7 +19,7 @@ Composable for accessible Kendo UI for Vue `Popup` + `Menu` action menus. It man
     <button
       ref="triggerRef"
       type="button"
-      aria-haspopup="true"
+      aria-haspopup="menu"
       @click="menu.handleActionButtonClick"
       @keydown="menu.handleActionButtonKeydown"
     >
@@ -141,7 +141,8 @@ const onSelect = (event: KendoMenuSelectEvent) => {
 - `focusTargetRef?: PopupMenuElementRef`: Optional element/component to focus after a keyboard-driven close.
 - `resolveFocusTarget?: () => HTMLElement | null`: Dynamic focus-target resolver. It takes precedence over `focusTargetRef` and is useful for virtualized grid rows.
 - `menuItemSelector?: string`: Selector for the first enabled item. Defaults to `.k-menu-item:not(.k-disabled)`.
-- `manageAriaExpanded?: boolean`: Keeps `aria-expanded` on a button-like trigger in sync with `isOpen`. Defaults to `true`; set to `false` to bind the attribute yourself.
+- `manageMenuTriggerAria?: boolean`: Keeps `aria-haspopup="menu"` and `aria-expanded` in sync with `isOpen` on the resolved `triggerRef` element. Defaults to `true`; while enabled, the composable owns both attributes and removes them when the trigger is replaced or the component unmounts. Set to `false` to own both attributes yourself.
+- `triggerMode?: "button" | "row"`: Selects the trigger semantics. Defaults to `"button"`; use `"row"` only when a `tr.k-table-row` owns the menu trigger. Row mode manages ARIA attributes but does not add `role`, `tabindex`, or keyboard behavior.
 
 `PopupMenuElementRef` accepts a normal `HTMLElement` ref or a Vue/Kendo component ref that exposes `$el`.
 
@@ -172,7 +173,9 @@ export type KendoMenuSelectEvent = {
 ## Behavior
 
 - Pointer click, `Enter`, and `Space` toggle the menu.
-- `aria-expanded` is written to the trigger whenever it is a `<button>`, has `role="button"`, or declares `aria-haspopup`.
+- `aria-haspopup="menu"` and `aria-expanded` are written to every resolved `triggerRef` element, including native buttons and Vue/Kendo component refs resolved through `$el`.
+- A `tr.k-table-row` is managed only with `triggerMode: "row"`; rows are never automatically made keyboard buttons.
+- Trigger replacement and virtualization are handled by re-resolving the ref. Managed attributes are removed from the previous trigger and on unmount. Set `manageMenuTriggerAria` to `false` when the consumer owns the attributes.
 - Opening focuses the first enabled Kendo Menu item after Vue renders it.
 - Outside clicks close the menu, while the trigger is ignored to prevent a close/reopen race.
 - Menu selection records keyboard or mouse modality from the selection event type.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featherk/composables",
-  "version": "0.10.10",
+  "version": "0.11.1",
   "main": "dist/featherk-composables.umd.js",
   "module": "dist/featherk-composables.es.js",
   "types": "dist/index.d.ts",