@getflip/swirl-ai 0.456.3 → 0.457.0

package/dist/agent/components/swirl-option-list.md

@@ -34,7 +34,7 @@ _None._
 
 ## Methods
 
-_None._
+- `focusItemWithValue()` – 
 
 ## Related components
 

package/dist/custom-elements.manifest.json

@@ -36866,6 +36866,35 @@
                 "text": "string[] | undefined"
               },
               "default": "[]"
+            },
+            {
+              "kind": "method",
+              "name": "focusItemWithValue",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string",
+                    "references": [
+                      {
+                        "name": "Promise",
+                        "package": "global:"
+                      }
+                    ]
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
             }
           ],
           "events": [

package/dist/types/components/swirl-option-list/swirl-option-list.d.ts

@@ -43,6 +43,7 @@ export declare class SwirlOptionList implements SwirlFormInput<string[]> {
     watchDisabled(): void;
     watchMultiSelect(): void;
     watchValue(): void;
+    focusItemWithValue(value: string): Promise<void>;
     private onClick;
     private onKeyDown;
     private observeSlotChanges;

package/dist/types/components/swirl-select/swirl-select.d.ts

@@ -29,6 +29,8 @@ export declare class SwirlSelect implements SwirlFormInput<string[]> {
     private optionList;
     private searchInput;
     private swirlPopover;
+    private typeaheadBuffer;
+    private typeaheadTimeout;
     componentWillLoad(): void;
     disconnectedCallback(): void;
     onWindowFocusIn(event: FocusEvent): void;
@@ -41,6 +43,39 @@ export declare class SwirlSelect implements SwirlFormInput<string[]> {
     private onOpen;
     private onClose;
     private onKeyDown;
+    /**
+     * Returns true for printable single-character keys that should trigger
+     * typeahead, excluding Space (used for selection) and keys combined with
+     * modifiers. Ignores events from the search input.
+     */
+    private isTypeaheadKey;
+    /**
+     * Manages the typeahead buffer and delegates to either cycling (repeated
+     * same character) or prefix matching (different characters). Resets the
+     * buffer if transitioning out of cycling mode. The buffer auto-clears
+     * after 500ms of inactivity.
+     */
+    private handleTypeahead;
+    /**
+     * Cycles focus/selection through options that start with the given
+     * character, wrapping around to the first match after the last one.
+     */
+    private cycleTypeahead;
+    /**
+     * Finds the first enabled option whose label starts with the given prefix
+     * (case-insensitive) and focuses/selects it. Returns whether a match was
+     * found, so the caller can fall back to a single-character retry.
+     */
+    private prefixMatchTypeahead;
+    /**
+     * Returns the value of the currently focused option (when open) or the
+     * last selected value (when closed), used as the starting point for cycling.
+     */
+    private getTypeaheadAnchorValue;
+    /**
+     * Applies a typeahead match by focusing the option in the open list.
+     */
+    private applyTypeaheadMatch;
     private onSearchInput;
     private getValueLabel;
     render(): any;

package/dist/types/components.d.ts

@@ -3272,6 +3272,7 @@ export namespace Components {
          */
         "assistiveTextItemMoving"?: string;
         "disabled"?: boolean;
+        "focusItemWithValue": (value: string) => Promise<void>;
         "label"?: string;
         "multiSelect"?: boolean;
         "optionListId"?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getflip/swirl-ai",
-  "version": "0.456.3",
+  "version": "0.457.0",
   "description": "Swirl Design System AI package with artifacts for AI agents",
   "author": "Flip GmbH",
   "repository": "https://github.com/getflip/swirl",
@@ -46,7 +46,7 @@
     "zod": "3.24.0"
   },
   "devDependencies": {
-    "@getflip/swirl-components": "0.456.3",
+    "@getflip/swirl-components": "0.457.0",
     "@types/node": "25.3.0",
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",