@iyulab/components 1.7.2 → 1.8.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.8.1] - 2026-07-24
+
+### Fixed
+- **u-field 합성 폼 컨트롤이 접근성 트리에서 이름 없이 노출되던 문제 수정** (WCAG 1.3.1·4.1.2 — U-Platform T8-1 Playwright E2E 실측, ISSUE-20260723-uinput-label-a11y). 라벨은 `u-field` 의 별도 섀도 스코프에 렌더되어 `label[for]` 로 컨트롤과 연결될 수 없었고, 섀도 경계 탓에 cross-root `aria-labelledby` 도 현 브라우저에서 신뢰성 있게 배송되지 않는다. 이제 각 컴포넌트가 자신의 접근 이름 호스트에 라벨을 `aria-label`(설명은 `aria-description`)로 미러링한다 — `u-input`/`u-textarea`(네이티브 컨트롤), `u-rating`/`u-radio`(`role=radiogroup`), `u-select`(`role=combobox` + `aria-expanded`/`aria-haspopup`/`aria-controls`), `u-slider`(`role=slider` + `aria-valuenow`/`valuemin`/`valuemax`/`valuetext`). 아울러 `u-option` 이 사용 맥락에 맞는 자식 역할·상태를 노출한다 — radiogroup(`marker='radio'`) 안에서는 `role=radio` + `aria-checked`, listbox(`u-select`/`u-input` combobox) 에서는 `role=option` + `aria-selected`(+ `aria-disabled`) — 이름만 있고 비어 보이던 radiogroup/combobox 위젯이 자식까지 정합하게 읽힌다. `u-rating` 심볼(`role=radio`)도 커밋 값 기준 `aria-checked` 를 노출한다. `getByLabel`/`getByRole({name})` 로케이터와 스크린리더가 컨트롤을 이름으로 인식한다.
+- **React 래퍼 `.d.ts` 타이핑 2건 수정** (React 19 + TS strict 컴파일 차단 — U-CMMS 실측, ISSUE-20260722-react-wrapper-typing). (1) `React.HTMLAttributes` 의 이벤트 핸들러(`onChange` 등)와 래퍼의 CustomEvent 시그니처가 교집합되어 어떤 핸들러도 대입 불가였던 것을, HTMLAttributes 쪽 동명 이벤트 키를 `Omit` 해 CustomEvent 시그니처만 남기도록 교정. (2) `Partial<Element>` 의 DOM `children: HTMLCollection` 이 JSX children 을 가려 `<UButton>text</UButton>` 이 TS2747 로 실패하던 것을, `Omit<Partial<Element>, keyof HTMLAttributes>` 로 DOM 전용 키를 제거하고 React 친화 타입(`children: ReactNode`)이 HTMLAttributes 에서 공급되도록 교정. 소비자의 `as unknown as ComponentType` 우회 제거 가능.
+
+## [1.8.0] - 2026-07-22
+
+### Fixed
+- **`u-icon` 아이콘 리졸브가 재렌더·재마운트마다 다시 fetch되던 스톰 수정** — `IconRegistry.resolve()`가 리졸버 결과를 캐시하지 않아, SSE 스트리밍처럼 같은 아이콘이 반복 재마운트되는 UI에서 단일 아이콘에 수백 회 fetch가 발생했다(미존재 아이콘은 404 스톰으로 콘솔 오염 + dev 서버 부하 — SMI.AIMS 실측, ISSUE-components-20260722-iconregistry-resolver-no-cache). 이제 레지스트리가 (lib, name) 단위 캐싱과 동시 요청 in-flight dedupe를 소유해, 커스텀 리졸버를 포함한 모든 라이브러리에서 아이콘당 세션 1회만 리졸브된다. `u-icon`의 `src` 경로·무-lib 기본(baseUrl) 경로도 신설 `IconRegistry.resolveUrl(url)`을 경유해 동일하게 캐시된다.
+- 내장 CDN 리졸버(tabler/heroicons/lucide/bootstrap)가 네트워크 오류를 `undefined`로 삼키던 것을 throw 전파로 교정 — 일시 장애가 세션 내 not-found로 오인·고착되지 않고 다음 조회에서 재시도된다.
+
+### Changed
+- **`IconResolver` 계약 명확화 (동작 변경)** — 리졸버의 `undefined` 반환은 이제 **not-found 확정**을 뜻하며 네거티브 캐시되어 세션 내 재호출되지 않는다(탈출구: `IconCache.clear()`). **일시 오류(네트워크 장애 등)에는 `undefined` 대신 `throw`를 사용할 것** — throw는 캐시되지 않아 다음 조회 시 재시도된다. 일시 실패에 `undefined`를 반환하던 커스텀 리졸버는 throw로 전환해야 재시도 동작을 유지한다.
+- `IconRegistry.unregister(lib)`가 해당 라이브러리의 캐시 항목을 함께 비운다 — 내장 CDN 라이브러리를 로컬 리졸버로 교체(`unregister` → `register`, 폐쇄망 대응)할 때 이전 리졸버의 stale 결과가 남지 않는다.
+
+### Added
+- `IconRegistry.resolveUrl(url)` — URL 직접 리졸브(캐시 + dedupe). 예약 네임스페이스 `url`로 `IconCache`에 저장되며 소비앱의 prewarm 용도로도 사용 가능.
+- `IconCache.clear(lib)` — 특정 라이브러리 항목만 클리어(전체 클리어는 기존대로 인자 없이).
+- `IconCache.set()`이 `undefined`(네거티브 항목) 저장을 허용.
+
+### Documentation
+- `docs/icons.md`·skills 레퍼런스에 리졸버 계약(성공/not-found/일시 오류)·캐싱 동작·내장 라이브러리 오버라이드 절차(`unregister`→`register`) 문서화. CDN 버전 표기 드리프트 교정(lucide 0.577.0, bootstrap 1.13.1).
+
 ## [1.7.2] - 2026-07-19
 
 ### Fixed

package/dist/components/icon/UIcon.js

@@ -13,8 +13,9 @@ var UIcon = class UIcon extends UElement {
 		this.styles = [super.styles, styles];
 	}
 	render() {
-		if (this.src) return until(fetch(this.src).then((r) => r.text()).then((html) => {
-			return html ? unsafeHTML(this.sanitize(html)) : nothing;
+		if (this.src) return until(IconRegistry.resolveUrl(this.src).then((html) => {
+			const sanitized = this.sanitize(html);
+			return sanitized ? unsafeHTML(sanitized) : nothing;
 		}), nothing);
 		if (this.name) return until(this.resolve(this.name).then((html) => {
 			return html ? unsafeHTML(html) : nothing;
@@ -24,12 +25,9 @@ var UIcon = class UIcon extends UElement {
 	async resolve(name) {
 		let html = void 0;
 		if (this.lib) html = await IconRegistry.resolve(this.lib, name);
-		else try {
+		else {
 			const url = `${getDefaultBaseUrl().replace(/\/$/, "")}/${name}.svg`;
-			const response = await fetch(url);
-			if (response.ok) html = await response.text();
-		} catch (error) {
-			console.error(error);
+			html = await IconRegistry.resolveUrl(url);
 		}
 		return this.sanitize(html);
 	}

package/dist/components/input/UInput.js

@@ -148,6 +148,8 @@ var UInput = class UInput extends UFormControlElement {
 
           <input part="input"
             type=${this.type === "password" && this.showPassword ? "text" : this.type}
+            aria-label=${ifDefined(this.label)}
+            aria-description=${ifDefined(this.description)}
             name=${ifDefined(this.name)}
             ?required=${this.required}
             ?disabled=${this.disabled}

package/dist/components/option/UOption.d.ts

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { UElement } from '../UElement.js';
 export type OptionMarker = 'radio' | 'check';
 /**
@@ -31,6 +32,7 @@ export declare class UOption extends UElement {
     /** 옵션 고유값 */
     value: string;
     connectedCallback(): void;
+    protected updated(changed: PropertyValues): void;
     render(): import('lit-html').TemplateResult<1>;
     private renderMarker;
     /** 라벨(기본 slot)의 텍스트 노드만 추출한다 — 엘리먼트 자식(예: 설명용 `<p>`)은 제외. */

package/dist/components/option/UOption.js

@@ -21,6 +21,15 @@ var UOption = class UOption extends UElement {
 		this.setAttribute("role", "option");
 		this.setAttribute("tabindex", this.disabled ? "-1" : "0");
 	}
+	updated(changed) {
+		super.updated(changed);
+		const isRadio = this.marker === "radio";
+		this.setAttribute("role", isRadio ? "radio" : "option");
+		this.removeAttribute(isRadio ? "aria-selected" : "aria-checked");
+		this.setAttribute(isRadio ? "aria-checked" : "aria-selected", String(this.selected));
+		this.setAttribute("aria-disabled", String(this.disabled));
+		this.setAttribute("tabindex", this.disabled ? "-1" : "0");
+	}
 	render() {
 		return html`
       ${this.renderMarker()}

package/dist/components/radio/URadio.js

@@ -7,6 +7,7 @@ import { UOption } from "../option/UOption.js";
 import { styles } from "./URadio.styles.js";
 import { html } from "lit";
 import { customElement, property, state } from "lit/decorators.js";
+import { ifDefined } from "lit/directives/if-defined.js";
 //#region src/components/radio/URadio.ts
 var URadio = class URadio extends UFormControlElement {
 	constructor(..._args) {
@@ -91,7 +92,10 @@ var URadio = class URadio extends UFormControlElement {
         .description=${this.description}
         .validationMessage=${this.validationMessage}
       >
-        <div class="container" part="container">
+        <div class="container" part="container"
+          role="radiogroup"
+          aria-label=${ifDefined(this.label)}
+          aria-description=${ifDefined(this.description)}>
           <slot @slotchange=${this.handleSlotChange}></slot>
         </div>
       </u-field>

package/dist/components/rating/URating.js

@@ -7,6 +7,7 @@ import "../field/UField.js";
 import { styles } from "./URating.styles.js";
 import { html } from "lit";
 import { customElement, property, state } from "lit/decorators.js";
+import { ifDefined } from "lit/directives/if-defined.js";
 //#region src/components/rating/URating.ts
 var URating = class URating extends UFormControlElement {
 	constructor(..._args) {
@@ -110,13 +111,17 @@ var URating = class URating extends UFormControlElement {
         .description=${this.description}
         .validationMessage=${this.validationMessage}
       >
-        <div class="symbols" part="container" role="radiogroup">
+        <div class="symbols" part="container" role="radiogroup"
+          aria-label=${ifDefined(this.label)}
+          aria-description=${ifDefined(this.description)}>
           ${Array.from({ length: this.max }, (_, i) => {
 			const score = i + 1;
 			const fill = Math.max(0, Math.min(1, value - score + 1));
 			return html`
               <span class="symbol" part="symbol"
                 role="radio"
+                aria-checked=${score === Math.round(this.value || 0) ? "true" : "false"}
+                aria-disabled=${this.interactive ? "false" : "true"}
                 tabindex=${this.interactive ? "0" : "-1"}
                 data-score=${score}
                 @pointermove=${this.handleSymbolPointerMove}

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

@@ -48,6 +48,10 @@ export declare class USelect extends UFormControlElement<string | string[]> {
     containerEl?: HTMLElement;
     popoverEl?: UPopover;
     private options;
+    /** aria-expanded 배선용 팝오버 열림 상태 */
+    private open;
+    /** combobox → listbox 연결용 고유 id (aria-controls) */
+    private readonly listboxId;
     protected shouldValidate(changed: PropertyValues): boolean;
     private get valueAsString();
     private get valueAsArray();

package/dist/components/select/USelect.js

@@ -10,6 +10,7 @@ import { UPopover } from "../popover/UPopover.js";
 import { styles } from "./USelect.styles.js";
 import { html } from "lit";
 import { customElement, property, query, state } from "lit/decorators.js";
+import { ifDefined } from "lit/directives/if-defined.js";
 //#region src/components/select/USelect.ts
 var USelect = class USelect extends UFormControlElement {
 	constructor(..._args) {
@@ -20,6 +21,8 @@ var USelect = class USelect extends UFormControlElement {
 		this.clearable = false;
 		this.loading = false;
 		this.options = [];
+		this.open = false;
+		this.listboxId = `u-select-listbox-${Math.random().toString(36).slice(2, 8)}`;
 		this.handleSlotChange = (e) => {
 			this.cleanup(this.options);
 			const slot = e.target;
@@ -158,7 +161,13 @@ var USelect = class USelect extends UFormControlElement {
           ${this.valueAsArray.length} / ${this.maxCount}
         </span>
 
-        <div class="container" part="container" tabindex=${this.disabled ? "-1" : "0"}>
+        <div class="container" part="container" tabindex=${this.disabled ? "-1" : "0"}
+          role="combobox"
+          aria-label=${ifDefined(this.label)}
+          aria-description=${ifDefined(this.description)}
+          aria-haspopup="listbox"
+          aria-expanded=${this.open}
+          aria-controls=${this.listboxId}>
           <slot name="prefix"></slot>
           <slot name="display">${this.renderContent()}</slot>
           <slot name="suffix"></slot>
@@ -181,11 +190,14 @@ var USelect = class USelect extends UFormControlElement {
       </u-field>
 
       <u-popover part="popover"
+        id=${this.listboxId}
         role="listbox"
         scrollable
         autofocus
         for=".container"
         trigger="click"
+        @show=${() => this.open = true}
+        @hide=${() => this.open = false}
         strategy="fixed"
         placement="bottom-start"
         offset="1"
@@ -322,6 +334,7 @@ __decorate([property({ converter: { fromAttribute: (value) => {
 __decorate([query(".container", true), __decorateMetadata("design:type", typeof HTMLElement === "undefined" ? Object : HTMLElement)], USelect.prototype, "containerEl", void 0);
 __decorate([query("u-popover", true), __decorateMetadata("design:type", typeof UPopover === "undefined" ? Object : UPopover)], USelect.prototype, "popoverEl", void 0);
 __decorate([state(), __decorateMetadata("design:type", Array)], USelect.prototype, "options", void 0);
+__decorate([state(), __decorateMetadata("design:type", Boolean)], USelect.prototype, "open", void 0);
 USelect = __decorate([customElement("u-select")], USelect);
 //#endregion
 export { USelect };

package/dist/components/slider/USlider.js

@@ -7,6 +7,7 @@ import "../field/UField.js";
 import { styles } from "./USlider.styles.js";
 import { html } from "lit";
 import { customElement, property, query, state } from "lit/decorators.js";
+import { ifDefined } from "lit/directives/if-defined.js";
 //#region src/components/slider/USlider.ts
 var USlider = class USlider extends UFormControlElement {
 	constructor(..._args) {
@@ -217,6 +218,13 @@ var USlider = class USlider extends UFormControlElement {
 		return html`
       <div class="thumb" part=${isEnd ? "thumb-end" : "thumb"}
         role="slider"
+        aria-label=${ifDefined(this.label)}
+        aria-valuenow=${val}
+        aria-valuemin=${this.min}
+        aria-valuemax=${this.max}
+        aria-valuetext=${this.formatValue(val)}
+        aria-orientation="horizontal"
+        aria-disabled=${this.disabled ? "true" : "false"}
         ?hidden=${isEnd && !this.range}
         style="left: ${pct}%"
         tabindex=${this.disabled || isEnd && !this.range ? -1 : 0}

package/dist/components/textarea/UTextarea.js

@@ -56,6 +56,8 @@ var UTextarea = class UTextarea extends UFormControlElement {
         <div class="container" part="container">
           <textarea part="textarea"
             scrollable
+            aria-label=${ifDefined(this.label)}
+            aria-description=${ifDefined(this.description)}
             ?required=${this.required}
             ?disabled=${this.disabled}
             ?readonly=${this.readonly}

package/dist/react/UAlert.d.ts

@@ -4,7 +4,9 @@ import { type ShowEventDetail } from '../events/ShowEvent';
 import { type HideEventDetail } from '../events/HideEvent';
 
 export declare const UAlert: React.ForwardRefExoticComponent<
-  Partial<UAlertElement> & React.HTMLAttributes<UAlertElement> & {
+  Omit<Partial<UAlertElement>, keyof React.HTMLAttributes<UAlertElement>>
+    & Omit<React.HTMLAttributes<UAlertElement>, 'onShow' | 'onHide'>
+    & {
   onShow?: (event: CustomEvent<ShowEventDetail>) => void;
   onHide?: (event: CustomEvent<HideEventDetail>) => void;
   }

package/dist/react/UAvatar.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UAvatar as UAvatarElement } from '../components/avatar/UAvatar';
 
 export declare const UAvatar: React.ForwardRefExoticComponent<
-  Partial<UAvatarElement> & React.HTMLAttributes<UAvatarElement> & {
+  Omit<Partial<UAvatarElement>, keyof React.HTMLAttributes<UAvatarElement>>
+    & Omit<React.HTMLAttributes<UAvatarElement>, never>
+    & {
   }
 >;
 

package/dist/react/UBadge.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UBadge as UBadgeElement } from '../components/badge/UBadge';
 
 export declare const UBadge: React.ForwardRefExoticComponent<
-  Partial<UBadgeElement> & React.HTMLAttributes<UBadgeElement> & {
+  Omit<Partial<UBadgeElement>, keyof React.HTMLAttributes<UBadgeElement>>
+    & Omit<React.HTMLAttributes<UBadgeElement>, never>
+    & {
   }
 >;
 

package/dist/react/UBreadcrumb.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UBreadcrumb as UBreadcrumbElement } from '../components/breadcrumb/UBreadcrumb';
 
 export declare const UBreadcrumb: React.ForwardRefExoticComponent<
-  Partial<UBreadcrumbElement> & React.HTMLAttributes<UBreadcrumbElement> & {
+  Omit<Partial<UBreadcrumbElement>, keyof React.HTMLAttributes<UBreadcrumbElement>>
+    & Omit<React.HTMLAttributes<UBreadcrumbElement>, never>
+    & {
   }
 >;
 

package/dist/react/UBreadcrumbItem.d.ts

@@ -3,7 +3,9 @@ import { UBreadcrumbItem as UBreadcrumbItemElement } from '../components/breadcr
 import { type NavigateEventDetail } from '../events/NavigateEvent';
 
 export declare const UBreadcrumbItem: React.ForwardRefExoticComponent<
-  Partial<UBreadcrumbItemElement> & React.HTMLAttributes<UBreadcrumbItemElement> & {
+  Omit<Partial<UBreadcrumbItemElement>, keyof React.HTMLAttributes<UBreadcrumbItemElement>>
+    & Omit<React.HTMLAttributes<UBreadcrumbItemElement>, 'onNavigate'>
+    & {
   onNavigate?: (event: CustomEvent<NavigateEventDetail>) => void;
   }
 >;

package/dist/react/UButton.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UButton as UButtonElement } from '../components/button/UButton';
 
 export declare const UButton: React.ForwardRefExoticComponent<
-  Partial<UButtonElement> & React.HTMLAttributes<UButtonElement> & {
+  Omit<Partial<UButtonElement>, keyof React.HTMLAttributes<UButtonElement>>
+    & Omit<React.HTMLAttributes<UButtonElement>, never>
+    & {
   }
 >;
 

package/dist/react/UButtonGroup.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UButtonGroup as UButtonGroupElement } from '../components/button-group/UButtonGroup';
 
 export declare const UButtonGroup: React.ForwardRefExoticComponent<
-  Partial<UButtonGroupElement> & React.HTMLAttributes<UButtonGroupElement> & {
+  Omit<Partial<UButtonGroupElement>, keyof React.HTMLAttributes<UButtonGroupElement>>
+    & Omit<React.HTMLAttributes<UButtonGroupElement>, never>
+    & {
   }
 >;
 

package/dist/react/UCard.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UCard as UCardElement } from '../components/card/UCard';
 
 export declare const UCard: React.ForwardRefExoticComponent<
-  Partial<UCardElement> & React.HTMLAttributes<UCardElement> & {
+  Omit<Partial<UCardElement>, keyof React.HTMLAttributes<UCardElement>>
+    & Omit<React.HTMLAttributes<UCardElement>, never>
+    & {
   }
 >;
 

package/dist/react/UCarousel.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UCarousel as UCarouselElement } from '../components/carousel/UCarousel';
 
 export declare const UCarousel: React.ForwardRefExoticComponent<
-  Partial<UCarouselElement> & React.HTMLAttributes<UCarouselElement> & {
+  Omit<Partial<UCarouselElement>, keyof React.HTMLAttributes<UCarouselElement>>
+    & Omit<React.HTMLAttributes<UCarouselElement>, never>
+    & {
   }
 >;
 

package/dist/react/UCheckbox.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UCheckbox as UCheckboxElement } from '../components/checkbox/UCheckbox';
 
 export declare const UCheckbox: React.ForwardRefExoticComponent<
-  Partial<UCheckboxElement> & React.HTMLAttributes<UCheckboxElement> & {
+  Omit<Partial<UCheckboxElement>, keyof React.HTMLAttributes<UCheckboxElement>>
+    & Omit<React.HTMLAttributes<UCheckboxElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UChip.d.ts

@@ -4,7 +4,9 @@ import { type PickEventDetail } from '../events/PickEvent';
 import { type RemoveEventDetail } from '../events/RemoveEvent';
 
 export declare const UChip: React.ForwardRefExoticComponent<
-  Partial<UChipElement> & React.HTMLAttributes<UChipElement> & {
+  Omit<Partial<UChipElement>, keyof React.HTMLAttributes<UChipElement>>
+    & Omit<React.HTMLAttributes<UChipElement>, 'onPick' | 'onRemove'>
+    & {
   onPick?: (event: CustomEvent<PickEventDetail>) => void;
   onRemove?: (event: CustomEvent<RemoveEventDetail>) => void;
   }

package/dist/react/UCopyButton.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UCopyButton as UCopyButtonElement } from '../components/copy-button/UCopyButton';
 
 export declare const UCopyButton: React.ForwardRefExoticComponent<
-  Partial<UCopyButtonElement> & React.HTMLAttributes<UCopyButtonElement> & {
+  Omit<Partial<UCopyButtonElement>, keyof React.HTMLAttributes<UCopyButtonElement>>
+    & Omit<React.HTMLAttributes<UCopyButtonElement>, 'onCopy'>
+    & {
   onCopy?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UDialog.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UDialog as UDialogElement } from '../components/dialog/UDialog';
 
 export declare const UDialog: React.ForwardRefExoticComponent<
-  Partial<UDialogElement> & React.HTMLAttributes<UDialogElement> & {
+  Omit<Partial<UDialogElement>, keyof React.HTMLAttributes<UDialogElement>>
+    & Omit<React.HTMLAttributes<UDialogElement>, never>
+    & {
   }
 >;
 

package/dist/react/UDivider.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UDivider as UDividerElement } from '../components/divider/UDivider';
 
 export declare const UDivider: React.ForwardRefExoticComponent<
-  Partial<UDividerElement> & React.HTMLAttributes<UDividerElement> & {
+  Omit<Partial<UDividerElement>, keyof React.HTMLAttributes<UDividerElement>>
+    & Omit<React.HTMLAttributes<UDividerElement>, never>
+    & {
   }
 >;
 

package/dist/react/UDrawer.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UDrawer as UDrawerElement } from '../components/drawer/UDrawer';
 
 export declare const UDrawer: React.ForwardRefExoticComponent<
-  Partial<UDrawerElement> & React.HTMLAttributes<UDrawerElement> & {
+  Omit<Partial<UDrawerElement>, keyof React.HTMLAttributes<UDrawerElement>>
+    & Omit<React.HTMLAttributes<UDrawerElement>, never>
+    & {
   }
 >;
 

package/dist/react/UField.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UField as UFieldElement } from '../components/field/UField';
 
 export declare const UField: React.ForwardRefExoticComponent<
-  Partial<UFieldElement> & React.HTMLAttributes<UFieldElement> & {
+  Omit<Partial<UFieldElement>, keyof React.HTMLAttributes<UFieldElement>>
+    & Omit<React.HTMLAttributes<UFieldElement>, never>
+    & {
   }
 >;
 

package/dist/react/UForm.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UForm as UFormElement } from '../components/form/UForm';
 
 export declare const UForm: React.ForwardRefExoticComponent<
-  Partial<UFormElement> & React.HTMLAttributes<UFormElement> & {
+  Omit<Partial<UFormElement>, keyof React.HTMLAttributes<UFormElement>>
+    & Omit<React.HTMLAttributes<UFormElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UIcon.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UIcon as UIconElement } from '../components/icon/UIcon';
 
 export declare const UIcon: React.ForwardRefExoticComponent<
-  Partial<UIconElement> & React.HTMLAttributes<UIconElement> & {
+  Omit<Partial<UIconElement>, keyof React.HTMLAttributes<UIconElement>>
+    & Omit<React.HTMLAttributes<UIconElement>, never>
+    & {
   }
 >;
 

package/dist/react/UIconButton.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UIconButton as UIconButtonElement } from '../components/icon-button/UIconButton';
 
 export declare const UIconButton: React.ForwardRefExoticComponent<
-  Partial<UIconButtonElement> & React.HTMLAttributes<UIconButtonElement> & {
+  Omit<Partial<UIconButtonElement>, keyof React.HTMLAttributes<UIconButtonElement>>
+    & Omit<React.HTMLAttributes<UIconButtonElement>, never>
+    & {
   }
 >;
 

package/dist/react/UInput.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UInput as UInputElement } from '../components/input/UInput';
 
 export declare const UInput: React.ForwardRefExoticComponent<
-  Partial<UInputElement> & React.HTMLAttributes<UInputElement> & {
+  Omit<Partial<UInputElement>, keyof React.HTMLAttributes<UInputElement>>
+    & Omit<React.HTMLAttributes<UInputElement>, 'onInput' | 'onChange'>
+    & {
   onInput?: (event: CustomEvent) => void;
   onChange?: (event: CustomEvent) => void;
   }

package/dist/react/UMenu.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UMenu as UMenuElement } from '../components/menu/UMenu';
 
 export declare const UMenu: React.ForwardRefExoticComponent<
-  Partial<UMenuElement> & React.HTMLAttributes<UMenuElement> & {
+  Omit<Partial<UMenuElement>, keyof React.HTMLAttributes<UMenuElement>>
+    & Omit<React.HTMLAttributes<UMenuElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UMenuItem.d.ts

@@ -3,7 +3,9 @@ import { UMenuItem as UMenuItemElement } from '../components/menu-item/UMenuItem
 import { type PickEventDetail } from '../events/PickEvent';
 
 export declare const UMenuItem: React.ForwardRefExoticComponent<
-  Partial<UMenuItemElement> & React.HTMLAttributes<UMenuItemElement> & {
+  Omit<Partial<UMenuItemElement>, keyof React.HTMLAttributes<UMenuItemElement>>
+    & Omit<React.HTMLAttributes<UMenuItemElement>, 'onPick'>
+    & {
   onPick?: (event: CustomEvent<PickEventDetail>) => void;
   }
 >;

package/dist/react/UOption.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UOption as UOptionElement } from '../components/option/UOption';
 
 export declare const UOption: React.ForwardRefExoticComponent<
-  Partial<UOptionElement> & React.HTMLAttributes<UOptionElement> & {
+  Omit<Partial<UOptionElement>, keyof React.HTMLAttributes<UOptionElement>>
+    & Omit<React.HTMLAttributes<UOptionElement>, never>
+    & {
   }
 >;
 

package/dist/react/UPanel.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UPanel as UPanelElement } from '../components/panel/UPanel';
 
 export declare const UPanel: React.ForwardRefExoticComponent<
-  Partial<UPanelElement> & React.HTMLAttributes<UPanelElement> & {
+  Omit<Partial<UPanelElement>, keyof React.HTMLAttributes<UPanelElement>>
+    & Omit<React.HTMLAttributes<UPanelElement>, never>
+    & {
   }
 >;
 

package/dist/react/UPopover.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UPopover as UPopoverElement } from '../components/popover/UPopover';
 
 export declare const UPopover: React.ForwardRefExoticComponent<
-  Partial<UPopoverElement> & React.HTMLAttributes<UPopoverElement> & {
+  Omit<Partial<UPopoverElement>, keyof React.HTMLAttributes<UPopoverElement>>
+    & Omit<React.HTMLAttributes<UPopoverElement>, 'onShow' | 'onHide'>
+    & {
   onShow?: (event: CustomEvent) => void;
   onHide?: (event: CustomEvent) => void;
   }

package/dist/react/UProgressBar.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UProgressBar as UProgressBarElement } from '../components/progress-bar/UProgressBar';
 
 export declare const UProgressBar: React.ForwardRefExoticComponent<
-  Partial<UProgressBarElement> & React.HTMLAttributes<UProgressBarElement> & {
+  Omit<Partial<UProgressBarElement>, keyof React.HTMLAttributes<UProgressBarElement>>
+    & Omit<React.HTMLAttributes<UProgressBarElement>, never>
+    & {
   }
 >;
 

package/dist/react/UProgressRing.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UProgressRing as UProgressRingElement } from '../components/progress-ring/UProgressRing';
 
 export declare const UProgressRing: React.ForwardRefExoticComponent<
-  Partial<UProgressRingElement> & React.HTMLAttributes<UProgressRingElement> & {
+  Omit<Partial<UProgressRingElement>, keyof React.HTMLAttributes<UProgressRingElement>>
+    & Omit<React.HTMLAttributes<UProgressRingElement>, never>
+    & {
   }
 >;
 

package/dist/react/URadio.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { URadio as URadioElement } from '../components/radio/URadio';
 
 export declare const URadio: React.ForwardRefExoticComponent<
-  Partial<URadioElement> & React.HTMLAttributes<URadioElement> & {
+  Omit<Partial<URadioElement>, keyof React.HTMLAttributes<URadioElement>>
+    & Omit<React.HTMLAttributes<URadioElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/URating.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { URating as URatingElement } from '../components/rating/URating';
 
 export declare const URating: React.ForwardRefExoticComponent<
-  Partial<URatingElement> & React.HTMLAttributes<URatingElement> & {
+  Omit<Partial<URatingElement>, keyof React.HTMLAttributes<URatingElement>>
+    & Omit<React.HTMLAttributes<URatingElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/USelect.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { USelect as USelectElement } from '../components/select/USelect';
 
 export declare const USelect: React.ForwardRefExoticComponent<
-  Partial<USelectElement> & React.HTMLAttributes<USelectElement> & {
+  Omit<Partial<USelectElement>, keyof React.HTMLAttributes<USelectElement>>
+    & Omit<React.HTMLAttributes<USelectElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/USkeleton.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { USkeleton as USkeletonElement } from '../components/skeleton/USkeleton';
 
 export declare const USkeleton: React.ForwardRefExoticComponent<
-  Partial<USkeletonElement> & React.HTMLAttributes<USkeletonElement> & {
+  Omit<Partial<USkeletonElement>, keyof React.HTMLAttributes<USkeletonElement>>
+    & Omit<React.HTMLAttributes<USkeletonElement>, never>
+    & {
   }
 >;
 

package/dist/react/USlider.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { USlider as USliderElement } from '../components/slider/USlider';
 
 export declare const USlider: React.ForwardRefExoticComponent<
-  Partial<USliderElement> & React.HTMLAttributes<USliderElement> & {
+  Omit<Partial<USliderElement>, keyof React.HTMLAttributes<USliderElement>>
+    & Omit<React.HTMLAttributes<USliderElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/USpinner.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { USpinner as USpinnerElement } from '../components/spinner/USpinner';
 
 export declare const USpinner: React.ForwardRefExoticComponent<
-  Partial<USpinnerElement> & React.HTMLAttributes<USpinnerElement> & {
+  Omit<Partial<USpinnerElement>, keyof React.HTMLAttributes<USpinnerElement>>
+    & Omit<React.HTMLAttributes<USpinnerElement>, never>
+    & {
   }
 >;
 

package/dist/react/USplitPanel.d.ts

@@ -3,7 +3,9 @@ import { USplitPanel as USplitPanelElement } from '../components/split-panel/USp
 import { type ShiftEventDetail } from '../events/ShiftEvent';
 
 export declare const USplitPanel: React.ForwardRefExoticComponent<
-  Partial<USplitPanelElement> & React.HTMLAttributes<USplitPanelElement> & {
+  Omit<Partial<USplitPanelElement>, keyof React.HTMLAttributes<USplitPanelElement>>
+    & Omit<React.HTMLAttributes<USplitPanelElement>, 'onShiftStart' | 'onShift' | 'onShiftEnd'>
+    & {
   onShiftStart?: (event: CustomEvent<ShiftEventDetail>) => void;
   onShift?: (event: CustomEvent<ShiftEventDetail>) => void;
   onShiftEnd?: (event: CustomEvent<ShiftEventDetail>) => void;

package/dist/react/USwitch.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { USwitch as USwitchElement } from '../components/switch/USwitch';
 
 export declare const USwitch: React.ForwardRefExoticComponent<
-  Partial<USwitchElement> & React.HTMLAttributes<USwitchElement> & {
+  Omit<Partial<USwitchElement>, keyof React.HTMLAttributes<USwitchElement>>
+    & Omit<React.HTMLAttributes<USwitchElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UTab.d.ts

@@ -3,7 +3,9 @@ import { UTab as UTabElement } from '../components/tab/UTab';
 import { type RemoveEventDetail } from '../events/RemoveEvent';
 
 export declare const UTab: React.ForwardRefExoticComponent<
-  Partial<UTabElement> & React.HTMLAttributes<UTabElement> & {
+  Omit<Partial<UTabElement>, keyof React.HTMLAttributes<UTabElement>>
+    & Omit<React.HTMLAttributes<UTabElement>, 'onRemove'>
+    & {
   onRemove?: (event: CustomEvent<RemoveEventDetail>) => void;
   }
 >;

package/dist/react/UTabPanel.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UTabPanel as UTabPanelElement } from '../components/tab-panel/UTabPanel';
 
 export declare const UTabPanel: React.ForwardRefExoticComponent<
-  Partial<UTabPanelElement> & React.HTMLAttributes<UTabPanelElement> & {
+  Omit<Partial<UTabPanelElement>, keyof React.HTMLAttributes<UTabPanelElement>>
+    & Omit<React.HTMLAttributes<UTabPanelElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UTag.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UTag as UTagElement } from '../components/tag/UTag';
 
 export declare const UTag: React.ForwardRefExoticComponent<
-  Partial<UTagElement> & React.HTMLAttributes<UTagElement> & {
+  Omit<Partial<UTagElement>, keyof React.HTMLAttributes<UTagElement>>
+    & Omit<React.HTMLAttributes<UTagElement>, never>
+    & {
   }
 >;
 

package/dist/react/UTextarea.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UTextarea as UTextareaElement } from '../components/textarea/UTextarea';
 
 export declare const UTextarea: React.ForwardRefExoticComponent<
-  Partial<UTextareaElement> & React.HTMLAttributes<UTextareaElement> & {
+  Omit<Partial<UTextareaElement>, keyof React.HTMLAttributes<UTextareaElement>>
+    & Omit<React.HTMLAttributes<UTextareaElement>, 'onInput' | 'onChange'>
+    & {
   onInput?: (event: CustomEvent) => void;
   onChange?: (event: CustomEvent) => void;
   }

package/dist/react/UTooltip.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UTooltip as UTooltipElement } from '../components/tooltip/UTooltip';
 
 export declare const UTooltip: React.ForwardRefExoticComponent<
-  Partial<UTooltipElement> & React.HTMLAttributes<UTooltipElement> & {
+  Omit<Partial<UTooltipElement>, keyof React.HTMLAttributes<UTooltipElement>>
+    & Omit<React.HTMLAttributes<UTooltipElement>, 'onShow' | 'onHide'>
+    & {
   onShow?: (event: CustomEvent) => void;
   onHide?: (event: CustomEvent) => void;
   }

package/dist/react/UTree.d.ts

@@ -2,7 +2,9 @@ import React from 'react';
 import { UTree as UTreeElement } from '../components/tree/UTree';
 
 export declare const UTree: React.ForwardRefExoticComponent<
-  Partial<UTreeElement> & React.HTMLAttributes<UTreeElement> & {
+  Omit<Partial<UTreeElement>, keyof React.HTMLAttributes<UTreeElement>>
+    & Omit<React.HTMLAttributes<UTreeElement>, 'onChange'>
+    & {
   onChange?: (event: CustomEvent) => void;
   }
 >;

package/dist/react/UTreeItem.d.ts

@@ -6,7 +6,9 @@ import { type PickEventDetail } from '../events/PickEvent';
 import { type CheckEventDetail } from '../events/CheckEvent';
 
 export declare const UTreeItem: React.ForwardRefExoticComponent<
-  Partial<UTreeItemElement> & React.HTMLAttributes<UTreeItemElement> & {
+  Omit<Partial<UTreeItemElement>, keyof React.HTMLAttributes<UTreeItemElement>>
+    & Omit<React.HTMLAttributes<UTreeItemElement>, 'onExpand' | 'onCollapse' | 'onPick' | 'onCheck'>
+    & {
   onExpand?: (event: CustomEvent<ExpandEventDetail>) => void;
   onCollapse?: (event: CustomEvent<CollapseEventDetail>) => void;
   onPick?: (event: CustomEvent<PickEventDetail>) => void;

package/dist/utilities/icons.d.ts

@@ -10,11 +10,18 @@ declare function getDefaultBaseUrl(): string;
 declare function setDefaultBaseUrl(url: string): void;
 /**
  * `name`으로 아이콘 리소스를 가져오는 함수입니다.
+ *
+ * 반환 계약 — 레지스트리가 결과를 (lib, name) 단위로 캐시하므로 리졸버는 순수 조회만 담당합니다:
+ * - `string` 반환: 성공 — 세션 동안 캐시되어 재호출되지 않습니다.
+ * - `undefined` 반환: **not-found 확정** — 네거티브 캐시되어 재호출되지 않습니다.
+ *   (탈출구: `IconCache.clear()`)
+ * - `throw`: **일시 오류**(네트워크 장애 등) — 캐시되지 않아 다음 조회 시 재시도됩니다.
  */
 type IconResolver = (name: string) => string | undefined | Promise<string | undefined>;
 /**
  * 아이콘 리소스 캐시입니다.
  * lib + name 조합으로 SVG 리소스를 저장/조회합니다.
+ * `undefined` 값은 "not-found 확정"의 네거티브 캐시 항목을 의미합니다.
  */
 declare class IconCache {
     private static cache;
@@ -22,7 +29,7 @@ declare class IconCache {
     private constructor();
     private static makeKey;
     /**
-     * 지정된 lib, name 조합의 리소스가 존재하는지 확인합니다.
+     * 지정된 lib, name 조합의 리소스(네거티브 항목 포함)가 존재하는지 확인합니다.
      */
     static has(lib: string, name: string): boolean;
     /**
@@ -31,12 +38,15 @@ declare class IconCache {
     static get(lib: string, name: string): string | undefined;
     /**
      * 지정된 lib, name 조합의 리소스를 저장합니다.
+     * `undefined`를 저장하면 not-found 확정(네거티브 캐시)으로 기록됩니다.
      */
-    static set(lib: string, name: string, resource: string): void;
+    static set(lib: string, name: string, resource: string | undefined): void;
     /**
-     * 전체 캐시를 비웁니다.
+     * 캐시를 비웁니다.
+     *
+     * @param lib - 지정하면 해당 라이브러리의 항목만, 생략하면 전체를 비웁니다.
      */
-    static clear(): void;
+    static clear(lib?: string): void;
 }
 /**
  * 아이콘 레지스트리입니다.
@@ -44,6 +54,8 @@ declare class IconCache {
  */
 declare class IconRegistry {
     private static libs;
+    /** 동일 (lib, name)의 동시 리졸브를 하나의 요청으로 합치는 in-flight 맵입니다. */
+    private static pending;
     /** 클래스 생성 방지 */
     private constructor();
     /**
@@ -57,11 +69,33 @@ declare class IconRegistry {
     static register(lib: string, resolver: IconResolver): void;
     /**
      * 지정된 아이콘 라이브러리를 등록 해제합니다.
+     * 해당 라이브러리의 캐시 항목도 함께 비웁니다 —
+     * `unregister` 후 다른 리졸버를 재등록할 때 이전 결과가 남지 않도록 하기 위함입니다.
      */
     static unregister(lib: string): void;
     /**
      * 지정된 아이콘 라이브러리의 svg 아이콘 소스를 가져옵니다.
+     *
+     * 리졸브 결과는 (lib, name) 단위로 캐시됩니다 — 스트리밍 재렌더처럼 같은 아이콘이
+     * 반복 재마운트되는 시나리오에서도 리졸버는 이름당 한 번만 호출됩니다.
+     * 동시 요청은 in-flight Promise를 공유하고, `IconResolver` 계약에 따라
+     * `undefined`(not-found 확정)는 네거티브 캐시, `throw`(일시 오류)는 캐시하지 않습니다.
      */
     static resolve(lib: string, name: string): Promise<string | undefined>;
+    /**
+     * URL에서 직접 svg 아이콘 소스를 가져옵니다.
+     * `u-icon`의 `src` 경로와 무-lib 기본(baseUrl) 경로가 사용하는 저수준 진입점입니다.
+     *
+     * 결과는 예약 네임스페이스 `url`로 `IconCache`에 캐시되어 같은 URL은 세션당
+     * 한 번만 fetch됩니다. HTTP 실패(404 등)는 not-found로 네거티브 캐시되고,
+     * 네트워크 오류는 캐시하지 않아 다음 조회 시 재시도됩니다.
+     */
+    static resolveUrl(url: string): Promise<string | undefined>;
+    /**
+     * 캐시 기록 + in-flight dedupe + 실패 시멘틱을 공유하는 리졸브 코어입니다.
+     * catch를 task 내부에 두어, in-flight를 공유한 모든 호출자가 rejection 대신
+     * undefined를 받도록 한다 (렌더 경로로 rejection이 전파되면 안 됨).
+     */
+    private static resolveCached;
 }
 export { getDefaultBaseUrl, setDefaultBaseUrl, IconCache, IconRegistry, };

package/dist/utilities/icons.js

@@ -63,6 +63,7 @@ var InternalIconBundle = new Map(Object.entries(/* #__PURE__ */ Object.assign({
 /**
 * 아이콘 리소스 캐시입니다.
 * lib + name 조합으로 SVG 리소스를 저장/조회합니다.
+* `undefined` 값은 "not-found 확정"의 네거티브 캐시 항목을 의미합니다.
 */
 var IconCache = class {
 	static {
@@ -74,7 +75,7 @@ var IconCache = class {
 		return `${lib}:${name}`;
 	}
 	/**
-	* 지정된 lib, name 조합의 리소스가 존재하는지 확인합니다.
+	* 지정된 lib, name 조합의 리소스(네거티브 항목 포함)가 존재하는지 확인합니다.
 	*/
 	static has(lib, name) {
 		return this.cache.has(this.makeKey(lib, name));
@@ -87,15 +88,23 @@ var IconCache = class {
 	}
 	/**
 	* 지정된 lib, name 조합의 리소스를 저장합니다.
+	* `undefined`를 저장하면 not-found 확정(네거티브 캐시)으로 기록됩니다.
 	*/
 	static set(lib, name, resource) {
 		this.cache.set(this.makeKey(lib, name), resource);
 	}
 	/**
-	* 전체 캐시를 비웁니다.
+	* 캐시를 비웁니다.
+	*
+	* @param lib - 지정하면 해당 라이브러리의 항목만, 생략하면 전체를 비웁니다.
 	*/
-	static clear() {
-		this.cache.clear();
+	static clear(lib) {
+		if (lib === void 0) {
+			this.cache.clear();
+			return;
+		}
+		const prefix = `${lib}:`;
+		for (const key of this.cache.keys()) if (key.startsWith(prefix)) this.cache.delete(key);
 	}
 };
 /**
@@ -106,6 +115,9 @@ var IconRegistry = class {
 	static {
 		this.libs = /* @__PURE__ */ new Map();
 	}
+	static {
+		this.pending = /* @__PURE__ */ new Map();
+	}
 	/** 클래스 생성 방지 */
 	constructor() {}
 	/**
@@ -123,75 +135,95 @@ var IconRegistry = class {
 	}
 	/**
 	* 지정된 아이콘 라이브러리를 등록 해제합니다.
+	* 해당 라이브러리의 캐시 항목도 함께 비웁니다 —
+	* `unregister` 후 다른 리졸버를 재등록할 때 이전 결과가 남지 않도록 하기 위함입니다.
 	*/
 	static unregister(lib) {
 		this.libs.delete(lib);
+		IconCache.clear(lib);
 	}
 	/**
 	* 지정된 아이콘 라이브러리의 svg 아이콘 소스를 가져옵니다.
+	*
+	* 리졸브 결과는 (lib, name) 단위로 캐시됩니다 — 스트리밍 재렌더처럼 같은 아이콘이
+	* 반복 재마운트되는 시나리오에서도 리졸버는 이름당 한 번만 호출됩니다.
+	* 동시 요청은 in-flight Promise를 공유하고, `IconResolver` 계약에 따라
+	* `undefined`(not-found 확정)는 네거티브 캐시, `throw`(일시 오류)는 캐시하지 않습니다.
 	*/
 	static async resolve(lib, name) {
+		if (IconCache.has(lib, name)) return IconCache.get(lib, name);
 		const resolver = this.libs.get(lib);
 		if (!resolver) return void 0;
-		return (await resolver(name))?.trim();
+		return this.resolveCached(lib, name, () => resolver(name));
+	}
+	/**
+	* URL에서 직접 svg 아이콘 소스를 가져옵니다.
+	* `u-icon`의 `src` 경로와 무-lib 기본(baseUrl) 경로가 사용하는 저수준 진입점입니다.
+	*
+	* 결과는 예약 네임스페이스 `url`로 `IconCache`에 캐시되어 같은 URL은 세션당
+	* 한 번만 fetch됩니다. HTTP 실패(404 등)는 not-found로 네거티브 캐시되고,
+	* 네트워크 오류는 캐시하지 않아 다음 조회 시 재시도됩니다.
+	*/
+	static async resolveUrl(url) {
+		if (IconCache.has("url", url)) return IconCache.get("url", url);
+		return this.resolveCached("url", url, async () => {
+			const response = await fetch(url);
+			if (!response.ok) return void 0;
+			return await response.text();
+		});
+	}
+	/**
+	* 캐시 기록 + in-flight dedupe + 실패 시멘틱을 공유하는 리졸브 코어입니다.
+	* catch를 task 내부에 두어, in-flight를 공유한 모든 호출자가 rejection 대신
+	* undefined를 받도록 한다 (렌더 경로로 rejection이 전파되면 안 됨).
+	*/
+	static resolveCached(lib, name, fn) {
+		const key = `${lib}:${name}`;
+		const inflight = this.pending.get(key);
+		if (inflight) return inflight;
+		const task = (async () => {
+			try {
+				const svg = (await fn())?.trim();
+				IconCache.set(lib, name, svg);
+				return svg;
+			} catch (error) {
+				console.error(`[IconRegistry] '${key}' 아이콘 리졸브 실패 (재시도 가능):`, error);
+				return;
+			}
+		})();
+		this.pending.set(key, task);
+		task.finally(() => this.pending.delete(key));
+		return task;
 	}
 };
 IconRegistry.register("internal", (name) => {
 	return InternalIconBundle.get(name);
 });
 IconRegistry.register("tabler", async (name) => {
-	if (IconCache.has("tabler", name)) return IconCache.get("tabler", name);
-	try {
-		const [iconName, style = "outline"] = name.split(":");
-		const url = `https://cdn.jsdelivr.net/npm/@tabler/icons@3.40.0/icons/${style}/${iconName}.svg`;
-		const response = await fetch(url);
-		if (!response.ok) return void 0;
-		const svg = await response.text();
-		IconCache.set("tabler", name, svg);
-		return svg;
-	} catch {
-		return;
-	}
+	const [iconName, style = "outline"] = name.split(":");
+	const url = `https://cdn.jsdelivr.net/npm/@tabler/icons@3.40.0/icons/${style}/${iconName}.svg`;
+	const response = await fetch(url);
+	if (!response.ok) return void 0;
+	return await response.text();
 });
 IconRegistry.register("heroicons", async (name) => {
-	if (IconCache.has("heroicons", name)) return IconCache.get("heroicons", name);
-	try {
-		const [iconName, style = "outline", size = "24"] = name.split(":");
-		const url = `https://cdn.jsdelivr.net/npm/heroicons@2.2.0/${size}/${style}/${iconName}.svg`;
-		const response = await fetch(url);
-		if (!response.ok) return void 0;
-		const svg = await response.text();
-		IconCache.set("heroicons", name, svg);
-		return svg;
-	} catch {
-		return;
-	}
+	const [iconName, style = "outline", size = "24"] = name.split(":");
+	const url = `https://cdn.jsdelivr.net/npm/heroicons@2.2.0/${size}/${style}/${iconName}.svg`;
+	const response = await fetch(url);
+	if (!response.ok) return void 0;
+	return await response.text();
 });
 IconRegistry.register("lucide", async (name) => {
-	if (IconCache.has("lucide", name)) return IconCache.get("lucide", name);
-	try {
-		const url = `https://cdn.jsdelivr.net/npm/lucide-static@0.577.0/icons/${name}.svg`;
-		const response = await fetch(url);
-		if (!response.ok) return void 0;
-		const svg = await response.text();
-		IconCache.set("lucide", name, svg);
-		return svg;
-	} catch {
-		return;
-	}
+	const url = `https://cdn.jsdelivr.net/npm/lucide-static@0.577.0/icons/${name}.svg`;
+	const response = await fetch(url);
+	if (!response.ok) return void 0;
+	return await response.text();
 });
 IconRegistry.register("bootstrap", async (name) => {
-	if (IconCache.has("bootstrap", name)) return IconCache.get("bootstrap", name);
-	try {
-		const url = `https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/icons/${name}.svg`;
-		const response = await fetch(url);
-		if (!response.ok) return void 0;
-		const svg = await response.text();
-		IconCache.set("bootstrap", name, svg);
-		return svg;
-	} catch {
-		return;
-	}
+	const url = `https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/icons/${name}.svg`;
+	const response = await fetch(url);
+	if (!response.ok) return void 0;
+	return await response.text();
 });
 //#endregion
 export { IconCache, IconRegistry, getDefaultBaseUrl, setDefaultBaseUrl };

package/package.json

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

package/plugins/vite-plugin-react-wrapper.js

@@ -190,10 +190,21 @@ export const ${className} = createComponent({
             return `  ${e.reactName}?: (event: ${type}) => void;`;
         }).join('\n') + '\n'
         : '';
+    // 래퍼 이벤트 prop(onChange 등)은 React.HTMLAttributes 의 동명 핸들러와 교집합되면
+    // 어떤 시그니처도 대입 불가가 된다. HTMLAttributes 쪽에서 해당 키를 제거해 CustomEvent
+    // 시그니처만 남긴다. 이벤트가 없으면 Omit<…, never> 로 HTMLAttributes 원형 유지.
+    const eventKeyUnion = events.length > 0
+        ? events.map(e => `'${e.reactName}'`).join(' | ')
+        : 'never';
+    // Partial<Element> 은 DOM 프로퍼티(children: HTMLCollection 등)를 포함해 React 의 JSX
+    // children/이벤트/className 등과 충돌한다. keyof React.HTMLAttributes 를 제거해 컴포넌트
+    // 고유 prop만 남기고, React 친화 타입(children: ReactNode 포함)은 HTMLAttributes 가 제공한다.
     const dts = `${dtsImports.join('\n')}
 
 export declare const ${className}: React.ForwardRefExoticComponent<
-  Partial<${className}Element> & React.HTMLAttributes<${className}Element> & {
+  Omit<Partial<${className}Element>, keyof React.HTMLAttributes<${className}Element>>
+    & Omit<React.HTMLAttributes<${className}Element>, ${eventKeyUnion}>
+    & {
 ${eventTypes}  }
 >;
 

package/skills/iyulab-components/references/utilities/icons.md

@@ -24,14 +24,20 @@ IconRegistry.register('my-icons', async (name: string) => {
 });
 ```
 
+Resolver contract — the registry owns caching, so a resolver is a pure lookup:
+return `string` = success (cached) · return `undefined` = definitive not-found (negative-cached, not retried) · `throw` = transient error (not cached, retried on next lookup).
+
+`register()` ignores an already-registered `lib` name. To override a built-in library (e.g. air-gapped local bundle), call `unregister(lib)` first — this also evicts that library's cache.
+
 ## API
 
 | Method | Description |
 |--------|-------------|
-| `IconRegistry.register(lib, resolver)` | Register an icon library |
-| `IconRegistry.unregister(lib)` | Remove a library |
+| `IconRegistry.register(lib, resolver)` | Register an icon library (ignored if `lib` already registered) |
+| `IconRegistry.unregister(lib)` | Remove a library + evict its cached entries |
 | `IconRegistry.has(lib)` | Check if a library is registered |
-| `IconRegistry.resolve(lib, name)` | `Promise<string \| undefined>` — resolve SVG source |
+| `IconRegistry.resolve(lib, name)` | `Promise<string \| undefined>` — resolve SVG source (cached + in-flight dedupe) |
+| `IconRegistry.resolveUrl(url)` | `Promise<string \| undefined>` — fetch SVG by URL, cached under the reserved `url` namespace (used by `u-icon` `src`/base-URL paths) |
 
 ## Built-in Libraries
 
@@ -40,14 +46,15 @@ IconRegistry.register('my-icons', async (name: string) => {
 | `internal` | (bundled) | — |
 | `tabler` | `name` / `name:filled` | 3.40.0 |
 | `heroicons` | `name` / `name:solid` | 2.2.0 |
-| `lucide` | `name` | 0.503.0 |
-| `bootstrap` | `name` / `name:filled` | 1.11.3 |
+| `lucide` | `name` | 0.577.0 |
+| `bootstrap` | `name` / `name:filled` | 1.13.1 |
 
 ## Caching
 
-Resolved SVGs are cached by `lib:name` key. The cache persists for the lifetime of the page.
+Resolved SVGs are cached by `lib:name` key (owned by `IconRegistry.resolve()` — resolvers are called once per name per session, concurrent lookups share one in-flight request). Not-found results are negative-cached; transient errors (`throw`) are retried. The cache persists for the lifetime of the page.
 
 ```ts
 // Internal cache is managed automatically; manual access is rarely needed.
-// IconCache.clear(); // clears all cached entries
+// IconCache.clear();        // clears all cached entries
+// IconCache.clear('tabler'); // clears one library's entries
 ```