@versini/ui-menu 6.1.1 → 6.2.0

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
-  @versini/ui-menu v6.1.1
+  @versini/ui-menu v6.2.0
   © 2026 gizmette.com
 */
 
@@ -43,6 +43,34 @@ function getNextEnabledIndex(items, currentIndex, direction) {
     }
     /* v8 ignore start - all items disabled edge case */ return currentIndex;
 /* v8 ignore stop */ }
+const TYPEAHEAD_TIMEOUT_MS = 500;
+function getTypeaheadMatchIndex(items, searchString, startIndex) {
+    const count = items.length;
+    const normalized = searchString.toLowerCase();
+    // When the same single character is repeated (e.g. "aaa"), cycle
+    // through items starting with that character instead of trying to
+    // match the full repeated string.
+    const isRepeatedChar = normalized.length > 1 && [
+        ...normalized
+    ].every((c)=>c === normalized[0]);
+    const matchStr = isRepeatedChar ? normalized[0] : normalized;
+    // For a single character (including repeated single-char), start
+    // searching from the item *after* the current one so we always
+    // advance to the next match.  For multi-character strings, start
+    // from the current item so the user can refine the match in-place.
+    const offset = normalized.length === 1 || isRepeatedChar ? 1 : 0;
+    for(let i = 0; i < count; i++){
+        const index = (startIndex + offset + i) % count;
+        if (items[index].disabled) {
+            continue;
+        }
+        const text = /* v8 ignore next -- textContent is always a string in DOM */ (items[index].element.textContent ?? "").trim().toLowerCase();
+        if (text.startsWith(matchStr)) {
+            return index;
+        }
+    }
+    return -1;
+}
 /* v8 ignore start - Home/End handlers with disabled item edge cases */ function getFirstEnabledIndex(items) {
     for(let i = 0; i < items.length; i++){
         if (!items[i].disabled) {
@@ -60,6 +88,27 @@ function getLastEnabledIndex(items) {
     return -1;
 }
 /* v8 ignore stop */ function useMenuKeyboard({ menuRef, isOpen, activeIndex, setActiveIndex, getItems, onClose, isSubMenu = false, onOpenSubMenu, onCloseToParent }) {
+    const searchBufferRef = useRef("");
+    const searchTimeoutRef = useRef(undefined);
+    // Clear the typeahead buffer when the menu closes.
+    useEffect(()=>{
+        if (!isOpen) {
+            searchBufferRef.current = "";
+            if (searchTimeoutRef.current) {
+                clearTimeout(searchTimeoutRef.current);
+            }
+        }
+    }, [
+        isOpen
+    ]);
+    // Clean up timeout on unmount.
+    useEffect(()=>{
+        return ()=>{
+            if (searchTimeoutRef.current) {
+                clearTimeout(searchTimeoutRef.current);
+            }
+        };
+    }, []);
     /* v8 ignore start - focusItem bounds guard */ const focusItem = useCallback((index)=>{
         const items = getItems();
         if (index >= 0 && index < items.length) {
@@ -77,7 +126,7 @@ function getLastEnabledIndex(items) {
             /* v8 ignore start - items always exist when menu is open */ if (items.length === 0) {
                 return;
             }
-            /* v8 ignore stop */ /* v8 ignore start - switch default branch (unmatched keys) */ switch(event.key){
+            /* v8 ignore stop */ /* v8 ignore start - switch internal branch */ switch(event.key){
                 /* v8 ignore stop */ case "ArrowDown":
                     {
                         event.preventDefault();
@@ -150,6 +199,28 @@ function getLastEnabledIndex(items) {
                         onClose();
                         break;
                     }
+                /* v8 ignore stop */ default:
+                    {
+                        // Typeahead: printable single characters (ignore modifier-only
+                        // or functional keys such as Shift, Control, Alt, Meta, etc.).
+                        if (event.key.length === 1 && !event.ctrlKey && !event.metaKey) {
+                            event.preventDefault();
+                            // Reset the debounce timer.
+                            if (searchTimeoutRef.current) {
+                                clearTimeout(searchTimeoutRef.current);
+                            }
+                            searchBufferRef.current += event.key;
+                            const matchIndex = getTypeaheadMatchIndex(items, searchBufferRef.current, /* v8 ignore next */ activeIndex >= 0 ? activeIndex : 0);
+                            if (matchIndex >= 0) {
+                                setActiveIndex(matchIndex);
+                                focusItem(matchIndex);
+                            }
+                            searchTimeoutRef.current = setTimeout(()=>{
+                                searchBufferRef.current = "";
+                            }, TYPEAHEAD_TIMEOUT_MS);
+                        }
+                        break;
+                    }
             }
         };
         const menuElement = menuRef.current;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/ui-menu",
-	"version": "6.1.1",
+	"version": "6.2.0",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -49,5 +49,5 @@
 	"sideEffects": [
 		"**/*.css"
 	],
-	"gitHead": "84d5ac4ea694792080c881a50b4fd5c4ce3750c0"
+	"gitHead": "97a8939e0f65fe7c37b265d10a8956f6b6df42d9"
 }