@featherk/composables 0.13.2 → 0.13.3

package/docs/menu/usePopupMenu.md

@@ -11,7 +11,7 @@ Composable for accessible Kendo UI for Vue `Popup` + `Menu` action menus. It man
 1. Add static `aria-haspopup="menu"` and baseline `aria-expanded="false"` to the trigger element in your template. The composable never sets `aria-haspopup` and never removes `aria-expanded`; the consumer owns both as the closed-state baseline.
 2. Create parent-owned refs for `isOpen`, `triggerRef`, `menuRef`, and an optional keyboard focus target.
 3. Call `usePopupMenu(...)` with `requestShow`, `requestHide`, and an explicit `triggerMode: "button"` (or `"row"`).
-4. Route Kendo Menu `@select` through `handleMenuSelect(event, onAction)` so your business action runs while the active menu context is still available, before the composable closes the popup.
+4. Route Kendo Menu `@select` through `handleMenuSelect(event, onAction)` so the composable closes the popup before running your business action synchronously.
 5. Bind trigger button `@click` and `@keydown` to the composable handlers.
 6. Bind Popup `@close` and Menu `@keydown.escape` so keyboard and mouse close paths restore focus correctly.
 
@@ -70,7 +70,7 @@ const menu = usePopupMenu({
   requestHide: () => (isOpen.value = false),
 });
 
-// Step 4: act while the active context is available; usePopupMenu closes afterward
+// Step 4: usePopupMenu closes before running the business action synchronously
 const onSelect = (event: KendoMenuSelectEvent) => {
   menu.handleMenuSelect(event, (selected) => {
     // Keep application-specific actions in the consuming component.
@@ -89,7 +89,7 @@ For a virtualized Kendo Grid, use `focusTargetContainerSelector` to restore keyb
 3. Create trigger and menu refs as component refs (`ComponentPublicInstance`) for Kendo wrappers.
 4. Call `usePopupMenu(...)` with an explicit `triggerMode: "button"` and map `requestShow`/`requestHide` to row-specific emits.
 5. Provide `focusTargetContainerSelector` so keyboard close restores focus to the current virtualized row.
-6. Route menu selection through `handleMenuSelect(event, onAction)` so row action logic can use its active state before the popup closes.
+6. Route menu selection through `handleMenuSelect(event, onAction)` so the popup closes before row action logic runs synchronously.
 
 ```ts
 <script setup lang="ts">
@@ -124,7 +124,7 @@ const menu = usePopupMenu({
   focusTargetContainerSelector: ".k-table-row[data-grid-row-index]",
 });
 
-// Step 6: run row-specific business action before usePopupMenu closes
+// Step 6: usePopupMenu closes before running the row-specific business action
 const onSelect = (event: KendoMenuSelectEvent) => {
   menu.handleMenuSelect(event, (selected) => {
     // Row-specific action logic remains here.
@@ -417,7 +417,7 @@ Whenever `anchor` is configured, `usePopupMenu` automatically flips the popup to
 - Trigger replacement and virtualization are handled by re-resolving the ref. The previous trigger is demoted to `aria-expanded="false"`, not stripped of attributes, so a shared instance can move between many rows (e.g. a grid) without losing each row's `aria-haspopup` baseline. Set `manageMenuTriggerAria` to `false` when the consumer owns `aria-expanded` too.
 - 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 runs the optional business callback while the active state is still available, then records modality and closes the popup.
+- Menu selection records modality and requests close before running the optional business callback synchronously. Registry-backed consumers must snapshot business context before calling `handleMenuSelect`; `useActionCellMenu` does this internally.
 - `Escape` on the trigger or inside the menu uses the keyboard close path.
 - Keyboard-driven closes focus `resolveFocusTarget()` or `focusTargetRef`, then fall back to the trigger.
 - Mouse selection closes restore focus to the trigger.

package/docs/menu/usePopupMenuGridOrchestration.md

@@ -340,17 +340,19 @@ const handleGridKeydown = (event: KeyboardEvent) => {
 };
 
 const handleRowMenuSelect = (event: KendoMenuSelectEvent) => {
+  const record = activeRowRecord.value;
   rowMenu.handleMenuSelect(event, (selection) => {
-    if (selection.item && activeRowRecord.value) {
-      console.log(selection.item.id, activeRowRecord.value);
+    if (selection.item && record) {
+      console.log(selection.item.id, record);
     }
   });
 };
 
 const handleButtonMenuSelect = (event: KendoMenuSelectEvent) => {
+  const record = activeButtonRecord.value;
   buttonMenu.handleMenuSelect(event, (selection) => {
-    if (selection.item && activeButtonRecord.value) {
-      console.log(selection.item.id, activeButtonRecord.value);
+    if (selection.item && record) {
+      console.log(selection.item.id, record);
     }
   });
 };

package/package.json

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