@keenmate/web-multiselect 2.0.0-rc07 → 2.0.0-rc08

package/docs/usage.md

@@ -219,6 +219,29 @@ multiselect.beforeDeselectCallback = (option, selectedOptions) => {
   if (option.value === 'item1') return false;
 };
 
+// Keyboard hook — runs on every keydown BEFORE the built-in handling.
+// Return true to mark the key fully handled (you own preventDefault; the
+// component runs none of its own logic for it); return false/undefined to
+// fall through to the defaults. `ctx.controller` mirrors the built-in actions.
+multiselect.keydownCallback = (ctx) => {
+  // Vim-style navigation. Returning true means you own the key — call
+  // preventDefault() so a printable key like 'j' isn't also typed into search.
+  if (ctx.key === 'j') { ctx.event.preventDefault(); ctx.controller.focusNext(); return true; }
+  if (ctx.key === 'k') { ctx.event.preventDefault(); ctx.controller.focusPrevious(); return true; }
+  // Ctrl+A → select all currently-filtered options (selectValue is a no-op if
+  // already selected — so it's a true "select all", not a toggle/invert)
+  if ((ctx.event.ctrlKey || ctx.event.metaKey) && ctx.key === 'a') {
+    ctx.event.preventDefault();
+    ctx.filteredOptions.forEach(o => ctx.controller.selectValue(o.value));
+    return true;
+  }
+  // ctx also exposes: event, key, isOpen, presentation, searchTerm,
+  // focusedIndex, focusedOption, filteredOptions, selectedValues.
+  // controller: focusNext/Previous/First/Last, focusPageUp/Down,
+  // focusNextMatch/PreviousMatch, focusIndex, toggleFocused, toggleValue,
+  // selectValue, deselectValue, open, close, setSearch, clearSearch.
+};
+
 // Event handler properties. Since v2 these are real listeners: each receives
 // the same CustomEvent addEventListener('select', ...) would get, so read the
 // payload off `e.detail` — NOT as a bare argument.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keenmate/web-multiselect",
-  "version": "2.0.0-rc07",
+  "version": "2.0.0-rc08",
   "description": "Lightweight multiselect web component with typeahead search, rich content support, and excellent keyboard navigation",
   "type": "module",
   "main": "./dist/multiselect.umd.js",

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@keenmate/web-multiselect",
-  "version": "2.0.0-rc07",
+  "version": "2.0.0-rc08",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -1028,6 +1028,11 @@
                 "name": "addNewCallback",
                 "description": "Create a new option from the typed text.",
                 "type": "(value: string) => unknown | Promise<unknown>"
+              },
+              {
+                "name": "keydownCallback",
+                "description": "Intercept keydown before built-in handling; return true to suppress the default. Gets the event, current state, and an imperative controller.",
+                "type": "(context: MultiSelectKeydownContext) => boolean | void"
               }
             ],
             "events": [