@iyulab/components 1.5.1 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [1.7.0] - 2026-07-17
+
+### Fixed
+- **폼 컨트롤 `change` 이벤트 의미론을 네이티브 규약으로 교정** — `USelect`/`URadio`/`URating`/`USlider`가 `updated()` 경로에서 무조건 `change`를 발화해, (1) 옵션 slot 등록 시 `value===undefined` 상태의 change가 발화되어 React 등 controlled 래퍼의 state를 오염시키고(옵션 등록 전 세팅한 초기값이 유실·서버 enum 기본값으로 저장되는 무증상 데이터 결함 — yesung 실측), (2) 프로그램적 `value` 세팅이 사용자 이벤트로 위장되어 에코 루프를 만들던 문제 수정. 이제 `change`는 **사용자 상호작용**(옵션 클릭·키보드·칩 제거·지우기·드래그 확정)에서만 발화한다(ISSUE-components-20260717-uselect-value-before-options). `UInput`(blur 발화)·`UMenu`/`UTree`(핸들러 발화)는 원래 규약대로였으며 변경 없음.
+- `USlider`: 문서("드래그 완료 후 발생")와 달리 **드래그 중 매 pointermove마다 change가 연사**되던 결함 수정 — 이제 `pointerup` 시 값이 실제로 바뀐 경우 1회 발화. 단일 select에서 동일 옵션 재선택, 선택된 라디오 재클릭도 네이티브와 동일하게 미발화.
+- `USelect`/`URadio`/`URating`의 `onChangeValue()`가 `updated()` 내부에서 `validate()`→`requestUpdate()`를 호출해 v1.5.1 검증 아키텍처를 위반하고 "scheduled an update after an update completed" Lit 경고를 재유발하던 잔재 제거 — 검증 UI 갱신(`validate()`)은 사용자 상호작용 경로에서만 수행하고, 프로그램적 세팅은 base의 silent `setValidity()`로 internals만 갱신한다.
+- **마크업 `value` attribute 선언이 일반 문자열에서 silently null이 되던 갭 수정** — base가 `type: Object`(JSON.parse)여서 `<u-input value="hello">`·`<u-select value="b">`가 null로 해석됐다. 기본 해석을 raw 문자열로 바꾸고, `u-rating`/`u-slider`는 숫자, `u-select`(multiple)/`u-slider`(range)는 JSON 배열(`value='["a","b"]'`)을 지원한다.
+- `USlider` range 표시 텍스트의 구분자 인코딩 오염(`5 ??10`) → `5 ~ 10`으로 교정. `URating` min/max 주석 모지바케 정리.
+
+### Changed
+- 프로그램적 `value` 세팅은 이제 `change` 발화·`invalid` 플래그 자동 갱신을 하지 않는다(`ElementInternals` validity는 계속 동기화됨). 프로그램적 변경 후 검증 UI 갱신이 필요하면 `validate()`를 명시 호출할 것. `value='"quoted"'` 형태(JSON 문자열)로 attribute를 우회 선언하던 경우 이제 따옴표 포함 raw 문자열로 해석된다.
+
+## [1.6.0] - 2026-07-16
+
+### Added
+- `UCopyButton`(`u-copy-button`): **인라인 텍스트 라벨** 지원 — `label` prop을 지정하면 아이콘 옆에 보이는 텍스트 라벨을 렌더한다(예: `label="결과 복사"`). 지금까지 u-copy-button은 아이콘 전용(기본 슬롯은 툴팁으로 소비)이라 "📋 결과 복사"처럼 라벨이 붙은 복사 버튼을 표현할 수 없어, 소비자가 검증된 클립보드 로직(취소 가능 `copy` ClipboardEvent + copied 상태 + 아이콘 토글)을 재사용하지 못하고 자체 재구현하던 역량 갭을 해소(ISSUE-20260715-ucopybutton-no-inline-label). 비파괴 — `label` 미지정 시 기존 아이콘 전용 형태(및 기본 슬롯=툴팁 의미)를 그대로 유지한다. 라벨 지정 시 내부적으로 `u-button`(아이콘 prefix + 텍스트)으로 렌더하고, 클립보드 로직은 두 형태에서 동일하다. online-tools(NT-U4) dogfooding에서 발견.
+
+### Fixed
+- `u-drawer`/`u-dialog`: **테마 토큰 미정의 시 패널이 투명하게 렌더**되어 모달이 "안 뜬 것처럼" 보이던 결함 수정(ISSUE-20260715-uoverlay-panel-token-no-fallback). backdrop(`--u-overlay-bg-color`)에는 폴백이 있는데 패널 배경/테두리(`--u-panel-bg-color`/`--u-border-color`)에는 폴백이 없어, `Theme.init()`로 토큰을 주입하지 않은 소비자에게 backdrop만 흐려지고 패널은 투명하게 떠 슬롯 콘텐츠가 뒤 페이지와 겹쳐 읽히던 footgun. backdrop과 동일 정책으로 패널 배경에 `Canvas`, 테두리에 `color-mix(in srgb, CanvasText 20%, Canvas)` CSS 시스템 컬러 폴백을 부여 — 토큰 미정의 소비자도 라이트·다크 자동 적응되는 가시 패널을 얻고, 토큰 정의 소비자는 기존과 동일(폴백 미사용). 실 브라우저 렌더 회귀 가드 추가. online-tools(NT-U2) dogfooding에서 발견.
+
 ## [1.5.1] - 2026-07-07
 
 ### Fixed

package/README.md

@@ -60,7 +60,7 @@ npx skills add ./node_modules/@iyulab/components
 
 **Feedback** — `u-alert`, `u-badge`, `u-spinner`, `u-skeleton`, `u-progress-bar`, `u-progress-ring`
 
-**Buttons & Actions** — `u-button`, `u-button-group`, `u-icon-button`, `u-chip`
+**Buttons & Actions** — `u-button`, `u-button-group`, `u-icon-button`, `u-copy-button`, `u-chip`
 
 **Form Controls** — `u-input`, `u-textarea`, `u-select`, `u-checkbox`, `u-radio`, `u-switch`, `u-slider`, `u-rating`, `u-field`, `u-form`, `u-option`
 

package/dist/_virtual/{_@oxc-project_runtime@0.138.0 → _@oxc-project_runtime@0.139.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.138.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.138.0 → _@oxc-project_runtime@0.139.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.138.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/components/UFloatingElement.js

@@ -1,8 +1,8 @@
 import { UElement } from "./UElement.js";
 import { getParentElement, querySelectorAllWithin } from "../utilities/elements.js";
 import { styles } from "./UFloatingElement.styles.js";
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { property, state } from "lit/decorators.js";
 import { arrow, autoPlacement, autoUpdate, computePosition, flip, offset, shift } from "@floating-ui/dom";
 //#region src/components/UFloatingElement.ts

package/dist/components/UFormControlElement.d.ts

@@ -23,7 +23,9 @@ export declare abstract class UFormControlElement<T> extends UElement {
     description?: string;
     /** 폼 제출 시 사용되는 이름 */
     name?: string;
-    /** 폼 제출 시 사용되는 값 */
+    /** 폼 제출 시 사용되는 값. attribute 선언 시 기본은 raw 문자열로 해석한다 —
+     *  (이전의 type: Object는 JSON.parse 실패로 일반 문자열 attribute가 silently null이 되는 갭이 있었다)
+     *  string이 아닌 값 타입을 갖는 컨트롤(URating/USlider/USelect multiple)은 자신의 converter로 override한다. */
     value?: T;
     /**
      * ElementInternals는 폼과의 연동, 유효성 검사 상태 관리 등을 지원하는 네이티브 API입니다.

package/dist/components/UFormControlElement.js

@@ -1,6 +1,6 @@
 import { UElement } from "./UElement.js";
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UFormControlElement.styles.js";
 import { property } from "lit/decorators.js";
 //#region src/components/UFormControlElement.ts
@@ -116,6 +116,6 @@ __decorate([property({ type: Boolean }), __decorateMetadata("design:type", Boole
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], UFormControlElement.prototype, "label", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], UFormControlElement.prototype, "description", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], UFormControlElement.prototype, "name", void 0);
-__decorate([property({ type: Object }), __decorateMetadata("design:type", Object)], UFormControlElement.prototype, "value", void 0);
+__decorate([property(), __decorateMetadata("design:type", Object)], UFormControlElement.prototype, "value", void 0);
 //#endregion
 export { UFormControlElement };

package/dist/components/UOverlayElement.js

@@ -1,6 +1,6 @@
 import { UElement } from "./UElement.js";
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { OverlayManager } from "../utilities/OverlayManager.js";
 import { arrayAttrConverter } from "../utilities/converters.js";
 import { styles } from "./UOverlayElement.styles.js";

package/dist/components/alert/UAlert.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";
 import { styles } from "./UAlert.styles.js";

package/dist/components/avatar/UAvatar.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UAvatar.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/badge/UBadge.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UBadge.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/breadcrumb/UBreadcrumb.js

@@ -1,5 +1,5 @@
 import { UElement } from "../UElement.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import { styles } from "./UBreadcrumb.styles.js";
 import { html } from "lit";

package/dist/components/breadcrumb-item/UBreadcrumbItem.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UBreadcrumbItem.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/button/UButton.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../spinner/USpinner.js";
 import { styles } from "./UButton.styles.js";
 import { html } from "lit";

package/dist/components/button-group/UButtonGroup.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UButton } from "../button/UButton.js";
 import { UIconButton } from "../icon-button/UIconButton.js";
 import { styles } from "./UButtonGroup.styles.js";

package/dist/components/card/UCard.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UCard.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/carousel/UCarousel.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";
 import { styles } from "./UCarousel.styles.js";

package/dist/components/checkbox/UCheckbox.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import { Locale } from "../../utilities/Locale.js";

package/dist/components/chip/UChip.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";
 import "../tooltip/UTooltip.js";

package/dist/components/copy-button/UCopyButton.d.ts

@@ -4,14 +4,19 @@ import { ButtonVariant } from '../button/UButton.js';
 /**
  * 클릭 시 클립보드에 텍스트를 복사하는 버튼입니다. 복사 상태를 표시하기 위해 아이콘이 변경됩니다.
  *
- * @slot - 툴팁에 표시할 콘텐츠
+ * 두 가지 형태를 지원합니다:
+ * - **아이콘 전용**(기본): 아이콘만 표시하고, 기본 슬롯 콘텐츠는 툴팁으로 사용됩니다.
+ * - **아이콘 + 라벨**: `label`을 지정하면 아이콘 옆에 보이는 텍스트 라벨을 렌더합니다
+ *   (예: "결과 복사"). 클립보드 로직은 두 형태에서 동일합니다.
+ *
+ * @slot - (아이콘 전용 형태에서) 툴팁에 표시할 콘텐츠. `label` 지정 시에는 사용되지 않습니다.
  *
  * @event copy - 클립보드에 실제로 쓰기 전에 발생하는 네이티브 ClipboardEvent.
  * `preventDefault()`로 복사를 취소하거나, `clipboardData.setData('text/plain', ...)`로 복사될 값을 바꿀 수 있음
  *
  * @csspart button - 내부 버튼 요소
  * @csspart icon - 아이콘 요소
- * @csspart tooltip - 툴팁 요소
+ * @csspart tooltip - 툴팁 요소 (아이콘 전용 형태)
  */
 export declare class UCopyButton extends UElement {
     static styles: import('lit').CSSResultGroup[];
@@ -31,6 +36,11 @@ export declare class UCopyButton extends UElement {
     delay: number;
     /** 복사할 텍스트를 설정합니다. */
     value?: string;
+    /**
+     * 아이콘 옆에 표시할 인라인 텍스트 라벨. 지정하면 아이콘 전용에서 아이콘+라벨 형태로 전환됩니다.
+     * 미지정(기본)이면 아이콘 전용 형태를 유지합니다.
+     */
+    label?: string;
     render(): import('lit-html').TemplateResult<1>;
     /**
      * 클립보드에 텍스트를 복사하는 메서드입니다.

package/dist/components/copy-button/UCopyButton.js

@@ -1,6 +1,8 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
+import "../button/UButton.js";
+import "../icon/UIcon.js";
 import "../icon-button/UIconButton.js";
 import { styles } from "./UCopyButton.styles.js";
 import { html } from "lit";
@@ -46,6 +48,19 @@ var UCopyButton = class UCopyButton extends UElement {
 		this.styles = [super.styles, styles];
 	}
 	render() {
+		const iconName = this.copied ? "check" : "copy";
+		if (this.label != null && this.label !== "") return html`
+        <u-button part="button"
+          exportparts="icon"
+          ?disabled=${this.disabled}
+          .variant=${this.variant}
+          .rounded=${this.rounded}
+          @click=${this.handleButtonClick}
+        >
+          <u-icon slot="prefix" part="icon" lib="internal" name=${iconName}></u-icon>
+          ${this.label}
+        </u-button>
+      `;
 		return html`
       <u-icon-button part="button"
         exportparts="icon,tooltip"
@@ -55,7 +70,7 @@ var UCopyButton = class UCopyButton extends UElement {
         .tooltipPlacement=${this.tooltipPlacement}
         .tooltipOffset=${this.tooltipOffset}
         lib="internal"
-        name=${this.copied ? "check" : "copy"}
+        name=${iconName}
         @click=${this.handleButtonClick}
       >
         <slot></slot>
@@ -89,6 +104,7 @@ __decorate([property({
 }), __decorateMetadata("design:type", Object)], UCopyButton.prototype, "tooltipOffset", void 0);
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Number)], UCopyButton.prototype, "delay", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], UCopyButton.prototype, "value", void 0);
+__decorate([property({ type: String }), __decorateMetadata("design:type", String)], UCopyButton.prototype, "label", void 0);
 UCopyButton = __decorate([customElement("u-copy-button")], UCopyButton);
 //#endregion
 export { UCopyButton };

package/dist/components/copy-button/UCopyButton.styles.js

@@ -16,6 +16,11 @@ var styles = css`
   :host([copied]) u-icon-button {
     color: var(--u-green-500);
   }
+
+  /* 라벨 형태(아이콘+텍스트): 복사 완료 시 아이콘/텍스트를 성공색으로 강조 */
+  :host([copied]) u-button {
+    color: var(--u-green-500);
+  }
 `;
 //#endregion
 export { styles };

package/dist/components/dialog/UDialog.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UOverlayElement } from "../UOverlayElement.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";

package/dist/components/dialog/UDialog.styles.js

@@ -61,9 +61,15 @@ var styles = css`
     flex-direction: column;
     max-width: 90%;
     max-height: 90%;
-    border: 1px solid var(--u-border-color);
+    /*
+     * 토큰 폴백은 backdrop(--u-overlay-bg-color)과 동일 정책 — 테마 토큰 미정의
+     * 소비자도 패널이 보이도록 CSS 시스템 컬러로 폴백. Canvas/CanvasText는 OS/UA
+     * color-scheme 기준 라이트·다크 자동 적응(라이브러리 주입 테마와 별개).
+     * 테두리는 CanvasText 원색이 과해 옅게 혼합.
+     */
+    border: 1px solid var(--u-border-color, color-mix(in srgb, CanvasText 20%, Canvas));
     border-radius: 6px;
-    background: var(--u-panel-bg-color);
+    background: var(--u-panel-bg-color, Canvas);
     box-shadow: 0 4px 16px rgba(0, 0, 0, 0.15);
     pointer-events: auto;
     opacity: 0;

package/dist/components/divider/UDivider.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UDivider.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/drawer/UDrawer.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UOverlayElement } from "../UOverlayElement.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";

package/dist/components/drawer/UDrawer.styles.js

@@ -30,11 +30,16 @@ var styles = css`
     }
   }
 
-  /* placement별 border */
-  :host([placement="left"]) .panel   { border-right: 1px solid var(--u-border-color); }
-  :host([placement="right"]) .panel  { border-left: 1px solid var(--u-border-color); }
-  :host([placement="top"]) .panel    { border-bottom: 1px solid var(--u-border-color); }
-  :host([placement="bottom"]) .panel { border-top: 1px solid var(--u-border-color); }
+  /*
+   * placement별 border. 토큰 폴백은 backdrop(--u-overlay-bg-color)과 동일 정책 —
+   * 테마 토큰 미정의 소비자도 패널이 보이도록 CSS 시스템 컬러로 폴백한다.
+   * Canvas/CanvasText는 OS/UA color-scheme 기준으로 라이트·다크를 자동 적응
+   * (라이브러리 주입 테마와는 별개). 테두리는 CanvasText 원색이 과해 옅게 혼합.
+   */
+  :host([placement="left"]) .panel   { border-right: 1px solid var(--u-border-color, color-mix(in srgb, CanvasText 20%, Canvas)); }
+  :host([placement="right"]) .panel  { border-left: 1px solid var(--u-border-color, color-mix(in srgb, CanvasText 20%, Canvas)); }
+  :host([placement="top"]) .panel    { border-bottom: 1px solid var(--u-border-color, color-mix(in srgb, CanvasText 20%, Canvas)); }
+  :host([placement="bottom"]) .panel { border-top: 1px solid var(--u-border-color, color-mix(in srgb, CanvasText 20%, Canvas)); }
 
   /* 닫힌 상태 */
   :host([placement="left"]) .panel   { transform: translateX(-100%); }
@@ -51,7 +56,7 @@ var styles = css`
   .panel {
     display: flex;
     flex-direction: column;
-    background: var(--u-panel-bg-color);
+    background: var(--u-panel-bg-color, Canvas);
     box-shadow: 0 4px 16px rgba(0, 0, 0, 0.15);
     pointer-events: auto;
     /*

package/dist/components/field/UField.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UField.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/form/UForm.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { arrayAttrConverter } from "../../utilities/converters.js";
 import { styles } from "./UForm.styles.js";

package/dist/components/icon/UIcon.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { IconRegistry, getDefaultBaseUrl } from "../../utilities/icons.js";
 import { styles } from "./UIcon.styles.js";
 import { nothing } from "lit";

package/dist/components/icon-button/UIconButton.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";
 import "../tooltip/UTooltip.js";

package/dist/components/input/UInput.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";

package/dist/components/menu/UMenu.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UMenuItem } from "../menu-item/UMenuItem.js";
 import { styles } from "./UMenu.styles.js";
 import { html } from "lit";

package/dist/components/menu-item/UMenuItem.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import { UDivider } from "../divider/UDivider.js";
 import "../popover/UPopover.js";

package/dist/components/option/UOption.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import { styles } from "./UOption.styles.js";
 import { html, nothing } from "lit";

package/dist/components/panel/UPanel.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UPanel.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/popover/UPopover.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFloatingElement } from "../UFloatingElement.js";
 import { arrayAttrConverter } from "../../utilities/converters.js";
 import { styles } from "./UPopover.styles.js";

package/dist/components/progress-bar/UProgressBar.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UProgressBar.styles.js";
 import { html } from "lit";
 import { customElement, property, state } from "lit/decorators.js";

package/dist/components/progress-ring/UProgressRing.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UProgressRing.styles.js";
 import { html } from "lit";
 import { customElement, property, state } from "lit/decorators.js";

package/dist/components/radio/URadio.d.ts

@@ -11,7 +11,8 @@ export type RadioOrientation = "vertical" | "horizontal";
  * @csspart field - u-field 요소
  * @csspart container - 옵션들을 감싸는 컨테이너
  *
- * @event change - 선택 값이 변경될 때 발생
+ * @event change - 사용자 상호작용(옵션 클릭·키보드)으로 선택 값이 변경될 때 발생.
+ *   네이티브 라디오와 동일하게 프로그램적 value 세팅·옵션 등록으로는 발화하지 않는다.
  */
 export declare class URadio extends UFormControlElement<string> {
     static styles: import('lit').CSSResultGroup[];
@@ -30,6 +31,11 @@ export declare class URadio extends UFormControlElement<string> {
     private setup;
     private cleanup;
     private onChangeValue;
+    /** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+     *  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+     *  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+     *  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+    private emitChange;
     private handleSlotChange;
     private handleOptionClick;
     private handleOptionKeyDown;

package/dist/components/radio/URadio.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import "../field/UField.js";
@@ -25,7 +25,9 @@ var URadio = class URadio extends UFormControlElement {
 			if (this.readonly || this.disabled) return;
 			const option = e.currentTarget;
 			if (option.disabled) return;
+			if (option.value === this.value) return;
 			this.value = option.value;
+			this.emitChange();
 		};
 		this.handleOptionKeyDown = (e) => {
 			if (this.readonly || this.disabled) return;
@@ -125,6 +127,12 @@ var URadio = class URadio extends UFormControlElement {
 			option.selected = option.value === this.value;
 		});
 		this.internals?.setFormValue(this.value || "");
+	}
+	/** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+	*  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+	*  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+	*  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+	emitChange() {
 		if (!this.novalidate) this.validate();
 		this.dispatchEvent(new Event("change", {
 			bubbles: true,

package/dist/components/rating/URating.d.ts

@@ -14,16 +14,19 @@ import { UFormControlElement } from '../UFormControlElement.js';
  * @cssprop --rating-symbol-color - 활성화된 심볼 색상
  * @cssprop --rating-symbol-off-color - 비활성화된 심볼 색상
  *
- * @event change - 레이팅 값 변경 시 발생
+ * @event change - 사용자 상호작용(심볼 클릭·키보드)으로 레이팅 값이 변경될 때 발생.
+ *   프로그램적 value 세팅으로는 발화하지 않는다.
  */
 export declare class URating extends UFormControlElement<number> {
     static styles: import('lit').CSSResultGroup[];
-    /** 理쒖냼 媛?*/
+    /** 최소 값 */
     min: number;
-    /** 理쒕? 媛?*/
+    /** 최대 값 */
     max: number;
     /** 정밀도 (0.5 등) */
     precision: number;
+    /** 레이팅 값. attribute 선언 시 숫자로 해석한다. */
+    value?: number;
     private buffer;
     private symbol;
     private symbolOff;
@@ -35,6 +38,11 @@ export declare class URating extends UFormControlElement<number> {
     private isStepMismatch;
     reset(): void;
     private onChangeValue;
+    /** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+     *  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+     *  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+     *  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+    private emitChange;
     private handleSlotChange;
     private handleSymbolPointerMove;
     private handleSymbolPointerLeave;

package/dist/components/rating/URating.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import { Locale } from "../../utilities/Locale.js";
@@ -37,7 +37,10 @@ var URating = class URating extends UFormControlElement {
 			if (this.disabled || this.readonly) return;
 			const score = Number(e.currentTarget.dataset.score);
 			const val = this.precision < 1 ? this.calibrate(e, score) : score;
-			this.value = this.value === val ? 0 : val;
+			const next = this.value === val ? 0 : val;
+			if (next === this.value) return;
+			this.value = next;
+			this.emitChange();
 		};
 		this.handleSymbolKeydown = (e) => {
 			if (this.disabled || this.readonly) return;
@@ -68,7 +71,11 @@ var URating = class URating extends UFormControlElement {
 				case "Enter": {
 					e.preventDefault();
 					const score = Number(e.currentTarget.dataset.score);
-					this.value = this.value === score ? 0 : score;
+					const next = this.value === score ? 0 : score;
+					if (next !== this.value) {
+						this.value = next;
+						this.emitChange();
+					}
 					return;
 				}
 				default: return;
@@ -166,6 +173,12 @@ var URating = class URating extends UFormControlElement {
 	onChangeValue() {
 		this.buffer = -1;
 		this.internals?.setFormValue(this.value?.toString() || "");
+	}
+	/** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+	*  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+	*  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+	*  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+	emitChange() {
 		if (!this.novalidate) this.validate();
 		this.dispatchEvent(new Event("change", {
 			bubbles: true,
@@ -183,6 +196,7 @@ var URating = class URating extends UFormControlElement {
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Object)], URating.prototype, "min", void 0);
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Object)], URating.prototype, "max", void 0);
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Object)], URating.prototype, "precision", void 0);
+__decorate([property({ type: Number }), __decorateMetadata("design:type", Number)], URating.prototype, "value", void 0);
 __decorate([state(), __decorateMetadata("design:type", Object)], URating.prototype, "buffer", void 0);
 __decorate([state(), __decorateMetadata("design:type", Object)], URating.prototype, "symbol", void 0);
 __decorate([state(), __decorateMetadata("design:type", Object)], URating.prototype, "symbolOff", void 0);

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

@@ -22,7 +22,8 @@ export type SelectVariant = 'outlined' | 'filled' | 'underlined' | 'borderless';
  * @cssprop --select-popover-min-height - 팝오버의 최소 높이 (기본값: 0px)
  * @cssprop --select-popover-max-height - 팝오버의 최대 높이 (기본값: 50vh)
  *
- * @event change - 선택 값이 변경될 때 발생
+ * @event change - 사용자 상호작용(옵션 클릭·칩 제거·지우기)으로 선택 값이 변경될 때 발생.
+ *   네이티브 select와 동일하게 프로그램적 value 세팅·옵션 등록으로는 발화하지 않는다.
  */
 export declare class USelect extends UFormControlElement<string | string[]> {
     static styles: import('lit').CSSResultGroup[];
@@ -42,6 +43,8 @@ export declare class USelect extends UFormControlElement<string | string[]> {
     maxCount?: number;
     /** placeholder 텍스트 */
     placeholder?: string;
+    /** 폼 제출 시 사용되는 값. attribute로는 단일 값 문자열 또는 JSON 배열(`value='["a","b"]'`)을 지원한다. */
+    value?: string | string[];
     containerEl?: HTMLElement;
     popoverEl?: UPopover;
     private options;
@@ -58,6 +61,11 @@ export declare class USelect extends UFormControlElement<string | string[]> {
     private setup;
     private cleanup;
     private onChangeValue;
+    /** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+     *  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+     *  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+     *  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+    private emitChange;
     private handleSlotChange;
     private handleOptionClick;
     private handleOptionKeydown;

package/dist/components/select/USelect.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";
@@ -36,8 +36,11 @@ var USelect = class USelect extends UFormControlElement {
 					if (this.maxCount != null && values.length >= this.maxCount) return;
 					this.value = [...values, option.value];
 				}
+				this.emitChange();
 			} else {
+				const changed = option.value !== this.value;
 				this.value = option.value;
+				if (changed) this.emitChange();
 				this.popoverEl?.hide();
 			}
 		};
@@ -104,12 +107,14 @@ var USelect = class USelect extends UFormControlElement {
 			e.preventDefault();
 			e.stopPropagation();
 			this.reset();
+			this.emitChange();
 			this.containerEl?.click();
 		};
 		this.handleChipRemove = (e) => {
 			const value = e.currentTarget.dataset.value;
 			if (!value) return;
 			this.value = this.valueAsArray.filter((v) => v !== value);
+			this.emitChange();
 		};
 	}
 	static {
@@ -263,6 +268,12 @@ var USelect = class USelect extends UFormControlElement {
 		for (const option of this.options) if (this.multiple) option.selected = values.includes(option.value);
 		else option.selected = option.value === this.value;
 		this.internals?.setFormValue(this.valueAsString);
+	}
+	/** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
+	*  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.
+	*  UI 재렌더를 동반한 validate()도 이 경로에서만 수행한다(v1.5.1 검증 아키텍처 —
+	*  updated() 경로는 base의 silent setValidity()만 수행해 Lit 중복 업데이트를 피한다). */
+	emitChange() {
 		if (!this.novalidate) this.validate();
 		this.dispatchEvent(new Event("change", {
 			bubbles: true,
@@ -299,6 +310,15 @@ __decorate([property({
 	attribute: "max-count"
 }), __decorateMetadata("design:type", Number)], USelect.prototype, "maxCount", void 0);
 __decorate([property({ type: String }), __decorateMetadata("design:type", String)], USelect.prototype, "placeholder", void 0);
+__decorate([property({ converter: { fromAttribute: (value) => {
+	if (value == null) return void 0;
+	if (value.trim().startsWith("[")) try {
+		return JSON.parse(value);
+	} catch {
+		return value;
+	}
+	return value;
+} } }), __decorateMetadata("design:type", Object)], USelect.prototype, "value", void 0);
 __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);

package/dist/components/skeleton/USkeleton.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./USkeleton.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/slider/USlider.d.ts

@@ -32,7 +32,8 @@ export type SliderFormatter = (value: number) => string;
  * @cssprop --slider-mark-color - 마크 색상
  * @cssprop --slider-mark-border-color - 마크 테두리 색상
  *
- * @event change - 드래그 완료 후 값이 확정됐을 때 발생
+ * @event change - 사용자 상호작용으로 값이 확정됐을 때 발생 — 드래그는 완료(pointerup) 시,
+ *   키보드는 조작마다. 프로그램적 value 세팅으로는 발화하지 않는다.
  */
 export declare class USlider extends UFormControlElement<number | number[]> {
     static styles: import('lit').CSSResultGroup[];
@@ -54,6 +55,8 @@ export declare class USlider extends UFormControlElement<number | number[]> {
     max: number;
     /** 값 변경 단위 */
     step: number;
+    /** 슬라이더 값. attribute로는 숫자 또는 range용 JSON 배열(`value='[10,20]'`)을 지원한다. */
+    value?: number | number[];
     private dragging;
     private trackEl;
     private containerEl?;
@@ -72,6 +75,9 @@ export declare class USlider extends UFormControlElement<number | number[]> {
     protected setValidity(): void;
     reset(): void;
     private onChangeValue;
+    /** 사용자 상호작용으로 값이 확정된 경로에서만 호출한다 — 프로그램적 value 세팅은
+     *  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다. */
+    private emitChange;
     private renderThumb;
     private formatDisplay;
     private formatValue;

package/dist/components/slider/USlider.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../tooltip/UTooltip.js";
 import { Locale } from "../../utilities/Locale.js";
@@ -26,6 +26,7 @@ var USlider = class USlider extends UFormControlElement {
 				const pct = Math.max(0, Math.min(rect.width, ev.clientX - rect.left)) / rect.width * 100;
 				return this.percentToVal(pct);
 			};
+			const before = JSON.stringify(this.value);
 			const val = getPointerValue(e);
 			if (this.range) {
 				const closer = Math.abs(val - this.minVal) <= Math.abs(val - this.maxVal) ? "min" : "max";
@@ -47,6 +48,7 @@ var USlider = class USlider extends UFormControlElement {
 				document.removeEventListener("pointermove", handleDocumentMove);
 				document.removeEventListener("pointerup", handleDocumentUp);
 				this.dragging = null;
+				if (JSON.stringify(this.value) !== before) this.emitChange();
 			};
 			document.addEventListener("pointermove", handleDocumentMove);
 			document.addEventListener("pointerup", handleDocumentUp);
@@ -82,9 +84,11 @@ var USlider = class USlider extends UFormControlElement {
 			}
 			e.preventDefault();
 			const newVal = this.snap(currentVal + delta);
+			const before = JSON.stringify(this.value);
 			if (thumb === "min") if (this.range) this.minVal = Math.min(newVal, this.maxVal);
 			else this.value = newVal;
 			else this.maxVal = Math.max(newVal, this.minVal);
+			if (JSON.stringify(this.value) !== before) this.emitChange();
 		};
 	}
 	static {
@@ -197,6 +201,10 @@ var USlider = class USlider extends UFormControlElement {
 		if (Array.isArray(this.value)) this.value = [this.snap(this.value[0]), this.snap(this.value[1])];
 		else if (typeof this.value === "number") this.value = this.snap(this.value);
 		this.internals?.setFormValue(this.valueAsNumber.toString());
+	}
+	/** 사용자 상호작용으로 값이 확정된 경로에서만 호출한다 — 프로그램적 value 세팅은
+	*  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다. */
+	emitChange() {
 		this.dispatchEvent(new Event("change", {
 			bubbles: true,
 			composed: true
@@ -229,7 +237,7 @@ var USlider = class USlider extends UFormControlElement {
     `;
 	}
 	formatDisplay() {
-		if (this.range) return `${this.formatValue(this.minVal)} ??${this.formatValue(this.maxVal)}`;
+		if (this.range) return `${this.formatValue(this.minVal)} ~ ${this.formatValue(this.maxVal)}`;
 		else return this.formatValue(this.valueAsNumber);
 	}
 	formatValue(val) {
@@ -269,6 +277,16 @@ __decorate([property({ type: Number }), __decorateMetadata("design:type", Number
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Number)], USlider.prototype, "min", void 0);
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Number)], USlider.prototype, "max", void 0);
 __decorate([property({ type: Number }), __decorateMetadata("design:type", Number)], USlider.prototype, "step", void 0);
+__decorate([property({ converter: { fromAttribute: (value) => {
+	if (value == null) return void 0;
+	if (value.trim().startsWith("[")) try {
+		return JSON.parse(value);
+	} catch {
+		return;
+	}
+	const n = Number(value);
+	return Number.isNaN(n) ? void 0 : n;
+} } }), __decorateMetadata("design:type", Object)], USlider.prototype, "value", void 0);
 __decorate([state(), __decorateMetadata("design:type", Object)], USlider.prototype, "dragging", void 0);
 __decorate([query(".track"), __decorateMetadata("design:type", typeof HTMLElement === "undefined" ? Object : HTMLElement)], USlider.prototype, "trackEl", void 0);
 __decorate([query(".container"), __decorateMetadata("design:type", typeof HTMLElement === "undefined" ? Object : HTMLElement)], USlider.prototype, "containerEl", void 0);

package/dist/components/spinner/USpinner.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./USpinner.styles.js";
 import { html } from "lit";
 import { customElement, property, state } from "lit/decorators.js";

package/dist/components/split-panel/USplitPanel.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { arrayAttrConverter } from "../../utilities/converters.js";
 import { styles } from "./USplitPanel.styles.js";
 import { html } from "lit";

package/dist/components/switch/USwitch.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import { styles } from "./USwitch.styles.js";

package/dist/components/tab/UTab.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../button/UButton.js";
 import "../icon/UIcon.js";
 import { styles } from "./UTab.styles.js";

package/dist/components/tab-panel/UTabPanel.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UPanel } from "../panel/UPanel.js";
 import { UTab } from "../tab/UTab.js";
 import { styles } from "./UTabPanel.styles.js";

package/dist/components/tag/UTag.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { styles } from "./UTag.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/textarea/UTextarea.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import "../field/UField.js";

package/dist/components/tooltip/UTooltip.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UFloatingElement } from "../UFloatingElement.js";
 import { styles } from "./UTooltip.styles.js";
 import { html } from "lit";

package/dist/components/tree/UTree.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import { UTreeItem } from "../tree-item/UTreeItem.js";
 import { styles } from "./UTree.styles.js";
 import { html } from "lit";

package/dist/components/tree-item/UTreeItem.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.138.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";
 import { styles } from "./UTreeItem.styles.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "keywords": [
     "iyulab",
     "components",
@@ -46,8 +46,8 @@
     "build": "eslint && vite build && npm run build:plugins"
   },
   "dependencies": {
-    "@floating-ui/dom": "^1.7.6",
-    "focus-trap": "^8.2.0",
+    "@floating-ui/dom": "^1.8.0",
+    "focus-trap": "^8.2.2",
     "lit": "^3.3.3"
   },
   "peerDependencies": {
@@ -64,18 +64,18 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
-    "@types/node": "^25.8.0",
-    "@vitest/browser-playwright": "^4.1.8",
+    "@types/node": "^26.1.1",
+    "@vitest/browser-playwright": "^4.1.10",
     "eslint": "^9.39.4",
     "eslint-plugin-lit": "^2.3.1",
     "glob": "^13.0.6",
-    "globals": "^17.6.0",
-    "react": "^19.2.6",
+    "globals": "^17.7.0",
+    "react": "^19.2.7",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.59.3",
-    "vite": "^8.0.13",
-    "vite-plugin-dts": "^5.0.0",
-    "vite-plugin-static-copy": "^4.1.0",
-    "vitest": "^4.1.8"
+    "typescript-eslint": "^8.64.0",
+    "vite": "^8.1.4",
+    "vite-plugin-dts": "^5.0.3",
+    "vite-plugin-static-copy": "^4.1.1",
+    "vitest": "^4.1.10"
   }
 }