@keenmate/web-multiselect 2.0.0-rc03 → 2.0.0-rc04

package/README.md

@@ -21,6 +21,34 @@ Reads `--base-*` variables from the page if [`@keenmate/theme-designer`](https:/
 - Custom rendering callbacks for options, badges, and group headers.
 - Form integration via standard hidden inputs (FormData-compatible).
 
+## What's New in v2.0.0-rc04
+
+**Phone search — one-tap clear and a keyboard that gets out of the way** — The
+full-screen search sheet gained the two things it was missing on touch. A clear button
+now sits at the trailing edge of the search field (a distinct Lucide `search-x` glyph,
+so it doesn't read as a second close ✕) to wipe the term in one tap and restore the full
+list. And the soft keyboard, which used to stay pinned open once you focused the field,
+now tucks away on the three natural "done typing" gestures — scrolling the list, tapping
+an option, or pressing Enter/Search — while never dismissing itself mid-type from a
+programmatic scroll-to-match.
+
+**A close button you can make your own** — The full-screen close ✕ is now a themeable
+chip: the new `--ms-fullscreen-close-bg`, `--ms-fullscreen-close-border`, and
+`--ms-fullscreen-close-border-radius` variables turn the bare glyph into a bordered
+button (à la a command-palette close) while the defaults keep it a plain round ✕. Its
+tap target was also fixed — the previously-dead padding around the button in the sheet's
+top-trailing corner (the natural place to reach) now dismisses the sheet, without ever
+stealing taps from the first option row or the search field.
+
+**Right presentation on every device, via core rc07** — This release pins
+`@keenmate/web-components-core` at `1.0.0-rc07` and adopts its reworked
+`resolvePresentation` / `classifyDevice` API. Behavior is unchanged — full-screen on
+phones, floating on tablet and desktop — with one refinement from the new capability
+gate: a narrowed desktop window (fine pointer, hover) now stays `desktop` and keeps its
+floating dropdown at any width, instead of ever flipping to the full-screen sheet.
+
+See `CHANGELOG.md` for the full list.
+
 ## What's New in v2.0.0-rc03
 
 **Full-screen dropdown on phones (`mobile-presentation`).** On a phone, a dropdown
@@ -78,21 +106,6 @@ scrolling behind it. Tapping an option no longer pops the keyboard mid-browse.
 
 See `CHANGELOG.md` for the full list.
 
-## What's New in v2.0.0-rc02
-
-**Form association restored for host frameworks (`el.form`).** Selecting inside a
-`<web-multiselect>` that lives in a `<form>` again delivers changes to frameworks
-that resolve the parent form via `event.target.form` — most notably Phoenix
-LiveView's `phx-change` delegation, which silently dropped changes in rc01.
-`<web-multiselect>` is a form-associated custom element, so it now exposes a real
-`el.form` / `event.target.form` like a native control. (rc01 had hardened its
-internal `ElementInternals` handle to a true `#private` field, which killed the
-`.form` that host-framework wrappers read.) The fix lives upstream in
-[`@keenmate/web-components-core`](https://www.npmjs.com/package/@keenmate/web-components-core)
-1.0.0-rc02 (the `el.form` getter), which this release pins.
-
-See `CHANGELOG.md` for the full list.
-
 ## Demos & docs
 
 - 🚀 [Live demo](https://web-multiselect.keenmate.dev)

package/custom-elements.json

@@ -487,6 +487,15 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "fullscreenSearchClear",
+              "type": {
+                "text": "HTMLButtonElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "fullscreenNav",
@@ -2132,6 +2141,28 @@
               },
               "description": "Sync the fullscreen match navigator (navigate mode only) with the current search\r\nstate: hide it until there's a term, then show \"N of M\" while a match is focused\r\n(or \"M matches\" / \"No matches\"), and disable the prev/next buttons when there's\r\nnothing to step through. No-op when the navigator isn't built (floating panel,\r\nfilter mode, or search disabled)."
             },
+            {
+              "kind": "method",
+              "name": "updateFullscreenSearchClear",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Show the fullscreen search's inline clear (✕) only while the field has text.\r\nNo-op when the button isn't built (floating panel, readonly/hidden search)."
+            },
+            {
+              "kind": "method",
+              "name": "clearFullscreenSearch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Clear the fullscreen search term via the same path a keystroke takes, then\r\nrefocus the field so the user can keep typing. Touch has no keyboard Escape,\r\nso this button is the on-screen way to reset a search."
+            },
             {
               "kind": "method",
               "name": "positionHint",

package/dist/index.d.ts

@@ -777,6 +777,7 @@ export declare class WebMultiSelect<T = any> {
     private presentationMode;
     private fullscreenHeader;
     private fullscreenSearchInput;
+    private fullscreenSearchClear;
     private fullscreenNav;
     private fullscreenNavCount;
     private fullscreenNavPrev;
@@ -1175,6 +1176,17 @@ export declare class WebMultiSelect<T = any> {
      * filter mode, or search disabled).
      */
     private updateFullscreenNav;
+    /**
+     * Show the fullscreen search's inline clear (✕) only while the field has text.
+     * No-op when the button isn't built (floating panel, readonly/hidden search).
+     */
+    private updateFullscreenSearchClear;
+    /**
+     * Clear the fullscreen search term via the same path a keystroke takes, then
+     * refocus the field so the user can keep typing. Touch has no keyboard Escape,
+     * so this button is the on-screen way to reset a search.
+     */
+    private clearFullscreenSearch;
     private positionHint;
     private parseInitialSelection;
     /**