@iyulab/components 1.34.0 → 1.35.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.35.0] - 2026-08-28
+
+### Added
+
+- **`USelect` fires a `search` event on every search-input change when
+  `searchable`.** The search text was already computed internally to drive
+  the built-in local option filtering, but never surfaced — a consumer
+  binding `USelect` to a large server-paginated dataset had no way to hook
+  into it and had to rebuild the search UI from scratch to do remote
+  search. `search` (`detail: { query: string }`, non-cancelable) fires
+  alongside the existing local filtering, so a consumer can subscribe and
+  drive remote search without losing the built-in search input. Mapped
+  through to the React wrapper as `onSearch`.
+
 ## [1.34.0] - 2026-08-28
 
 ### Added

package/dist/components/select/USelect.d.ts

@@ -24,6 +24,9 @@ export type SelectVariant = 'outlined' | 'filled' | 'underlined' | 'borderless';
  *
  * @event change - 사용자 상호작용(옵션 클릭·칩 제거·지우기)으로 선택 값이 변경될 때 발생.
  *   네이티브 select와 동일하게 프로그램적 value 세팅·옵션 등록으로는 발화하지 않는다.
+ * @event search - `searchable`일 때 검색 입력이 바뀔 때마다 발생(`detail: { query: string }`).
+ *   로컬 필터링(이미 렌더된 `u-option`의 `hidden` 토글)과 별개로 발행되므로, 서버/원격 검색이
+ *   필요한 소비자는 이 이벤트를 구독해 자체적으로 옵션을 갱신할 수 있다.
  */
 export declare class USelect extends UFormControlElement<string | string[]> {
     static styles: import('lit').CSSResultGroup[];

package/dist/components/select/USelect.js

@@ -86,6 +86,10 @@ var USelect = class USelect extends UFormControlElement {
 				const value = option.value.toLowerCase();
 				option.hidden = !label.includes(query) && !value.includes(query);
 			}
+			this.fire("search", {
+				detail: { query },
+				cancelable: false
+			});
 		};
 		this.handleSearchKeydown = (e) => {
 			const options = this.options.filter((o) => !o.hidden && !o.disabled);

package/dist/react/USelect.d.ts

@@ -3,10 +3,11 @@ import { USelect as USelectElement } from '../components/select/USelect';
 
 export declare const USelect: React.ForwardRefExoticComponent<
   Omit<Partial<USelectElement>, keyof React.HTMLAttributes<USelectElement>>
-    & Omit<React.HTMLAttributes<USelectElement>, 'onChange'>
+    & Omit<React.HTMLAttributes<USelectElement>, 'onChange' | 'onSearch'>
     & React.RefAttributes<USelectElement>
     & {
   onChange?: (event: CustomEvent) => void;
+  onSearch?: (event: CustomEvent<{ query: string }>) => void;
   }
 >;
 

package/dist/react/USelect.js

@@ -8,5 +8,6 @@ export const USelect = createComponent({
   elementClass: USelectElement,
   events: {
     onChange: 'change',
+    onSearch: 'search',
   },
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "keywords": [
     "iyulab",
     "components",

package/skills/iyulab-components/references/components/select.md

@@ -59,6 +59,7 @@ Dropdown select with single or multiple selection, search, and clear support. Fo
 | Event | Description |
 |-------|-------------|
 | `change` | Fires when selection changes |
+| `search` | Fires on every search input change when `searchable` (`detail: { query: string }`). Fires alongside the built-in local filtering — subscribe to it to drive remote/server-side search instead of (or in addition to) the local filter |
 
 ## Methods