@iyulab/components 1.0.10 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [1.1.1] - 2026-06-26
+
+### Fixed
+- `UAlert`: Moved padding from `:host` to the Shadow DOM `.container`. A consumer-side light-DOM reset (e.g. Tailwind preflight's `*{padding:0}`) targets the host element directly and overrode the `:host` padding, collapsing toast/alert spacing to zero. Padding on a Shadow DOM inner element is immune to outer-tree resets.
+- `UDrawer`: `.panel` now honors `--drawer-size`. Previously the panel never referenced the variable, so setting `--drawer-size` had no effect and the panel sized to its intrinsic content width. Slide-axis size is now `width: var(--drawer-size, 28rem)` (left/right) / `height: var(--drawer-size, 16rem)` (top/bottom), with `max-width`/`max-height: 100%` for narrow viewports.
+
+### Added
+- `UDrawer`: Documented `--drawer-size` as a public CSS custom property (`@cssproperty`).
+
+## [1.1.0] - 2026-06-22
+
+### Added
+- Validation messages: Introduced a locale registry (English default + `registerLocale`) so consumers can register and switch validation-message locales.
+
+## [1.0.10] - 2026-06-09
+
+### Fixed
+- `UInput`: Fixed broken IME composition input and prevented duplicate `input` event dispatch.
+
+## [1.0.9] - 2026-05-27
+
+### Changed
+- `Toast`: Default duration changed from 3000ms to 4000ms.
+
+## [1.0.8] - 2026-05-21
+
+### Added
+- `vite-plugin-react-wrapper`: Added an `exclude` option.
+
+## [1.0.7] - 2026-05-21
+
+### Changed
+- `UAlert`: Increased padding (8px→12px vertical, 12px→16px horizontal) to improve toast spacing.
+
 ## [1.0.6] - 2026-05-15
 
 ### Changed

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

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.137.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);
@@ -6,4 +6,4 @@ function __decorate(decorators, target, key, desc) {
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 //#endregion
-export { __decorate };
+export { __decorate as default };

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

@@ -1,6 +1,6 @@
-//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 //#endregion
-export { __decorateMetadata };
+export { __decorateMetadata as default };

package/dist/components/UFloatingElement.js

@@ -1,6 +1,6 @@
 import { UElement } from "./UElement.js";
-import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { getParentElement, querySelectorAllWithin } from "../utilities/elements.js";
 import { styles } from "./UFloatingElement.styles.js";
 import { property, state } from "lit/decorators.js";

package/dist/components/UFormControlElement.d.ts

@@ -23,6 +23,8 @@ export declare abstract class UFormControlElement<T> extends UElement {
     description?: string;
     /** 커스텀 유효성 검증 메시지 */
     validationMessage?: string;
+    /** chrome 문자열(검증 메시지 등)에 사용할 로케일 태그 (예: 'ko-KR'). 미지정 시 전역 기본/문서 언어를 따른다. */
+    locale?: string;
     /** 폼 제출 시 사용되는 이름 */
     name?: string;
     /** 폼 제출 시 사용되는 값 */

package/dist/components/UFormControlElement.js

@@ -1,7 +1,7 @@
 import { UElement } from "./UElement.js";
 import { styles } from "./UFormControlElement.styles.js";
-import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { property } from "lit/decorators.js";
 //#region src/components/UFormControlElement.ts
 /**
@@ -62,6 +62,7 @@ __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, "validationMessage", void 0);
+__decorate([property({ type: String }), __decorateMetadata("design:type", String)], UFormControlElement.prototype, "locale", 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);
 //#endregion

package/dist/components/UOverlayElement.js

@@ -1,6 +1,6 @@
 import { UElement } from "./UElement.js";
-import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import "../button/UButton.js";
 import { styles } from "./UAlert.styles.js";

package/dist/components/alert/UAlert.styles.js

@@ -39,7 +39,12 @@ var styles = css`
     min-width: 200px;
     max-width: 100%;
     max-height: 50vh;
-    padding: 12px 16px;
+    /*
+     * 내부 여백은 .container 에 둔다(:host 아님).
+     * 소비앱의 light-DOM 리셋(예: Tailwind preflight 의 *{padding:0})은
+     * 호스트 엘리먼트의 :host padding 을 덮어버리므로, Shadow DOM 내부
+     * 엘리먼트(.container)에 패딩을 두어 외부 리셋으로부터 보호한다.
+     */
     border-radius: 8px;
     box-shadow: 0 4px 12px var(--u-shadow-color-normal);
     
@@ -87,6 +92,7 @@ var styles = css`
     display: flex;
     flex-direction: column;
     overflow: hidden;
+    padding: 12px 16px;
   }
 
   .header {

package/dist/components/avatar/UAvatar.js

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

package/dist/components/badge/UBadge.js

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

package/dist/components/breadcrumb/UBreadcrumb.js

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

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

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

package/dist/components/button/UButton.js

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

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

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { styles } from "./UCard.styles.js";
 import { customElement, property } from "lit/decorators.js";
 import { html } from "lit";

package/dist/components/carousel/UCarousel.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import "../button/UButton.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import { styles } from "./UCheckbox.styles.js";

package/dist/components/chip/UChip.js

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

package/dist/components/dialog/UDialog.js

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

package/dist/components/divider/UDivider.js

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

package/dist/components/drawer/UDrawer.d.ts

@@ -12,6 +12,10 @@ export type DrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
  * @csspart header - 헤더 영역
  * @csspart body - 본문 영역
  * @csspart close-btn - 닫기 버튼
+ *
+ * @cssproperty [--drawer-size=28rem] - 드로어 패널의 슬라이드 축 방향 크기.
+ *   좌우(left/right) placement는 너비, 상하(top/bottom) placement는 높이로 적용된다(상하 기본 16rem).
+ *   화면이 좁으면 max-width/max-height:100%로 자동 축소된다.
  */
 export declare class UDrawer extends UOverlayElement {
     static styles: CSSResultGroup;

package/dist/components/drawer/UDrawer.js

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

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

@@ -7,19 +7,35 @@ var styles = css`
   :host([placement="top"])    { flex-direction: column; justify-content: flex-start; }
   :host([placement="bottom"]) { flex-direction: column; justify-content: flex-end; }
 
-  /* 좌우: 높이 100% */
+  /*
+   * 패널 크기 — 슬라이드 축 방향 크기를 --drawer-size 로 제어한다.
+   *   좌우(left/right): 너비 = --drawer-size (기본 28rem), 높이 100%
+   *   상하(top/bottom): 높이 = --drawer-size (기본 16rem), 너비 100%
+   * 호스트 앱이 style="--drawer-size: 600px" 로 오버라이드한다.
+   */
+  /* 좌우: 높이 100%, 너비 = --drawer-size */
   :host([placement="left"]) .panel,
   :host([placement="right"]) .panel {
     height: 100%;
+    width: var(--drawer-size, 28rem);
     max-width: 100%;
   }
-  /* 상하: 너비 100% */
+  /* 상하: 너비 100%, 높이 = --drawer-size */
   :host([placement="top"]) .panel,
   :host([placement="bottom"]) .panel {
     width: 100%;
+    height: var(--drawer-size, 16rem);
     max-height: 100%;
   }
 
+  /* 모바일: 좌우 드로어는 전체 너비로 펼쳐 입력 공간을 확보한다. */
+  @media (max-width: 640px) {
+    :host([placement="left"]) .panel,
+    :host([placement="right"]) .panel {
+      width: 100%;
+    }
+  }
+
   /* 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); }

package/dist/components/field/UField.js

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

package/dist/components/form/UForm.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { IconRegistry, getDefaultBaseUrl } from "../../utilities/icons.js";
 import { styles } from "./UIcon.styles.js";
 import { customElement, property } from "lit/decorators.js";

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

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

package/dist/components/input/UInput.js

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

package/dist/components/menu/UMenu.js

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

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

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import { styles } from "./UOption.styles.js";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/panel/UPanel.js

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

package/dist/components/popover/UPopover.js

@@ -1,5 +1,5 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { styles } from "./UProgressBar.styles.js";
 import { customElement, property, state } from "lit/decorators.js";
 import { html } from "lit";

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

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

package/dist/components/radio/URadio.js

@@ -1,5 +1,5 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../field/UField.js";
 import { UOption } from "../option/UOption.js";

package/dist/components/rating/URating.js

@@ -1,5 +1,6 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import { formatTemplate, getLocaleStrings, resolveLocale } from "../../core/locale.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import "../field/UField.js";
@@ -153,23 +154,24 @@ var URating = class URating extends UFormControlElement {
 	}
 	getValidity() {
 		const v = this.value || 0;
+		const s = getLocaleStrings(resolveLocale(this.locale));
 		if (this.required && !v) return {
 			flags: { valueMissing: true },
-			message: "This field is required"
+			message: s.required
 		};
 		if (v && v < this.min) return {
 			flags: { rangeUnderflow: true },
-			message: `Value must be at least ${this.min}`
+			message: formatTemplate(s.minValue, { min: this.min })
 		};
 		if (v && v > this.max) return {
 			flags: { rangeOverflow: true },
-			message: `Value must be no more than ${this.max}`
+			message: formatTemplate(s.maxValue, { max: this.max })
 		};
 		if (v && this.precision < 1) {
 			const remainder = Math.abs(v % this.precision);
 			if (remainder > .001 && Math.abs(remainder - this.precision) > .001) return {
 				flags: { stepMismatch: true },
-				message: `Value must be a multiple of ${this.precision}`
+				message: formatTemplate(s.stepMismatch, { step: this.precision })
 			};
 		}
 		return {

package/dist/components/select/USelect.js

@@ -1,5 +1,6 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import { formatTemplate, getLocaleStrings, resolveLocale } from "../../core/locale.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import "../spinner/USpinner.js";
@@ -261,17 +262,18 @@ var USelect = class USelect extends UFormControlElement {
 		}));
 	}
 	getValidity(values) {
+		const s = getLocaleStrings(resolveLocale(this.locale));
 		if (this.required && !values.length) return {
 			flags: { valueMissing: true },
-			message: "This field is required"
+			message: s.required
 		};
 		if (this.multiple && this.minCount != null && values.length > 0 && values.length < this.minCount) return {
 			flags: { rangeUnderflow: true },
-			message: `Please select at least ${this.minCount} items`
+			message: formatTemplate(s.minCount, { min: this.minCount })
 		};
 		if (this.multiple && this.maxCount != null && values.length > this.maxCount) return {
 			flags: { rangeOverflow: true },
-			message: `Please select no more than ${this.maxCount} items`
+			message: formatTemplate(s.maxCount, { max: this.maxCount })
 		};
 		return {
 			flags: {},

package/dist/components/skeleton/USkeleton.js

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

package/dist/components/slider/USlider.js

@@ -1,5 +1,6 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import { formatTemplate, getLocaleStrings, resolveLocale } from "../../core/locale.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../tooltip/UTooltip.js";
 import "../field/UField.js";
@@ -194,17 +195,18 @@ var USlider = class USlider extends UFormControlElement {
 	}
 	getValidity() {
 		const v = this.valueAsNumber;
+		const s = getLocaleStrings(resolveLocale(this.locale));
 		if (this.required && !v) return {
 			flags: { valueMissing: true },
-			message: "This field is required"
+			message: s.required
 		};
 		if (v < this.min) return {
 			flags: { rangeUnderflow: true },
-			message: `Value must be at least ${this.min}`
+			message: formatTemplate(s.minValue, { min: this.min })
 		};
 		if (v > this.max) return {
 			flags: { rangeOverflow: true },
-			message: `Value must be at most ${this.max}`
+			message: formatTemplate(s.maxValue, { max: this.max })
 		};
 		return {
 			flags: {},

package/dist/components/spinner/USpinner.js

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

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

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { arrayAttrConverter } from "../../utilities/converters.js";
 import { styles } from "./USplitPanel.styles.js";
 import { customElement, property, query } from "lit/decorators.js";

package/dist/components/switch/USwitch.js

@@ -1,5 +1,5 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { styles } from "./USwitch.styles.js";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/tab/UTab.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import "../button/UButton.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.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.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { styles } from "./UTag.styles.js";
 import { customElement, property } from "lit/decorators.js";
 import { html } from "lit";

package/dist/components/textarea/UTextarea.js

@@ -1,5 +1,5 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../field/UField.js";
 import { styles } from "./UTextarea.styles.js";

package/dist/components/tooltip/UTooltip.js

@@ -1,5 +1,5 @@
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UFloatingElement } from "../UFloatingElement.js";
 import { styles } from "./UTooltip.styles.js";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/tree/UTree.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import { __decorateMetadata } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorateMetadata.js";
-import { __decorate } from "../../_virtual/_@oxc-project_runtime@0.133.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/decorate.js";
 import { UTreeItem } from "../tree-item/UTreeItem.js";
 import { styles } from "./UTree.styles.js";
 import { customElement, property, state } from "lit/decorators.js";

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

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

package/dist/core/locale.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @iyulab/components 의 경량 로케일 레지스트리.
+ *
+ * 범위: 라이브러리가 스스로 생성하는 chrome 문자열(검증 메시지 등)만 대상.
+ * 일반 i18n 프레임워크가 아니다. 앱 콘텐츠 번역은 consumer 의 i18n 계층(예:
+ * modern-app 의 i18next)이 담당한다.
+ *
+ * 영어가 내장 기본값이며, 한국어 등 도메인 로케일은 consumer 가 등록한다:
+ *   registerLocale('ko', { required: '필수 항목입니다.', ... });
+ *   setDefaultLocale('ko');
+ *
+ * 모노레포 로케일 표준(packages/u-widgets/src/core/locale.ts)과 동일한 계약을 따른다.
+ */
+export interface UComponentsLocaleStrings {
+    required: string;
+    minValue: string;
+    maxValue: string;
+    stepMismatch: string;
+    minCount: string;
+    maxCount: string;
+}
+/**
+ * 로케일을 등록한다. 부분 등록은 영어 기본값에 병합된다.
+ */
+export declare function registerLocale(lang: string, strings: Partial<UComponentsLocaleStrings>): void;
+/**
+ * 주어진 언어 태그에 대한 로케일 문자열을 해석한다.
+ *
+ * 해석 순서:
+ *   1. 정확히 일치 (예: 'ko-KR')
+ *   2. 기반 언어 (예: 'ko')
+ *   3. 영어 폴백
+ */
+export declare function getLocaleStrings(lang?: string): UComponentsLocaleStrings;
+/**
+ * 템플릿 문자열의 {key} 플레이스홀더를 치환한다.
+ */
+export declare function formatTemplate(template: string, params: Record<string, string | number>): string;
+/**
+ * 영어 기본값을 반환한다 (테스트/참조용).
+ */
+export declare function getDefaultLocale(): UComponentsLocaleStrings;
+/**
+ * 모든 컴포넌트에 적용되는 전역 기본 로케일을 설정한다.
+ *
+ * 해석 순서(우선순위 높은 순):
+ *   1. 컴포넌트별 `locale` 속성/프로퍼티
+ *   2. setDefaultLocale() 값
+ *   3. document.documentElement.lang (브라우저)
+ *   4. 영어 폴백
+ *
+ * @example
+ * ```ts
+ * import { setDefaultLocale } from '@iyulab/components';
+ * setDefaultLocale('ko-KR');
+ * ```
+ */
+export declare function setDefaultLocale(lang: string | undefined): void;
+/**
+ * setDefaultLocale() 로 설정된 전역 기본 로케일을 반환한다.
+ * 설정되지 않았으면 undefined 를 반환한다.
+ */
+export declare function getEffectiveLocale(): string | undefined;
+/**
+ * 컴포넌트가 사용할 로케일을 해석한다.
+ *
+ * 우선순위: widgetLocale > setDefaultLocale() > document.lang > undefined
+ */
+export declare function resolveLocale(widgetLocale?: string | null): string | undefined;

package/dist/core/locale.js

@@ -0,0 +1,85 @@
+//#region src/core/locale.ts
+var EN = {
+	required: "This field is required",
+	minValue: "Value must be at least {min}",
+	maxValue: "Value must be at most {max}",
+	stepMismatch: "Value must be a multiple of {step}",
+	minCount: "Please select at least {min} items",
+	maxCount: "Please select no more than {max} items"
+};
+var registry = /* @__PURE__ */ new Map();
+/**
+* 로케일을 등록한다. 부분 등록은 영어 기본값에 병합된다.
+*/
+function registerLocale(lang, strings) {
+	registry.set(lang.toLowerCase(), {
+		...EN,
+		...strings
+	});
+}
+/**
+* 주어진 언어 태그에 대한 로케일 문자열을 해석한다.
+*
+* 해석 순서:
+*   1. 정확히 일치 (예: 'ko-KR')
+*   2. 기반 언어 (예: 'ko')
+*   3. 영어 폴백
+*/
+function getLocaleStrings(lang) {
+	if (!lang) return EN;
+	const key = lang.toLowerCase();
+	if (registry.has(key)) return registry.get(key);
+	const base = key.split("-")[0];
+	if (base !== key && registry.has(base)) return registry.get(base);
+	return EN;
+}
+/**
+* 템플릿 문자열의 {key} 플레이스홀더를 치환한다.
+*/
+function formatTemplate(template, params) {
+	return template.replace(/\{(\w+)\}/g, (_, key) => params[key] != null ? String(params[key]) : `{${key}}`);
+}
+/**
+* 영어 기본값을 반환한다 (테스트/참조용).
+*/
+function getDefaultLocale() {
+	return { ...EN };
+}
+var _defaultLocale;
+/**
+* 모든 컴포넌트에 적용되는 전역 기본 로케일을 설정한다.
+*
+* 해석 순서(우선순위 높은 순):
+*   1. 컴포넌트별 `locale` 속성/프로퍼티
+*   2. setDefaultLocale() 값
+*   3. document.documentElement.lang (브라우저)
+*   4. 영어 폴백
+*
+* @example
+* ```ts
+* import { setDefaultLocale } from '@iyulab/components';
+* setDefaultLocale('ko-KR');
+* ```
+*/
+function setDefaultLocale(lang) {
+	_defaultLocale = lang;
+}
+/**
+* setDefaultLocale() 로 설정된 전역 기본 로케일을 반환한다.
+* 설정되지 않았으면 undefined 를 반환한다.
+*/
+function getEffectiveLocale() {
+	return _defaultLocale;
+}
+/**
+* 컴포넌트가 사용할 로케일을 해석한다.
+*
+* 우선순위: widgetLocale > setDefaultLocale() > document.lang > undefined
+*/
+function resolveLocale(widgetLocale) {
+	if (widgetLocale) return widgetLocale;
+	if (_defaultLocale) return _defaultLocale;
+	if (typeof document !== "undefined" && document.documentElement?.lang) return document.documentElement.lang;
+}
+//#endregion
+export { formatTemplate, getDefaultLocale, getEffectiveLocale, getLocaleStrings, registerLocale, resolveLocale, setDefaultLocale };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './core/locale.js';
 export * from './components/UFormControlElement.js';
 export * from './components/UDataElement.js';
 export * from './components/UElement.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+import { formatTemplate, getDefaultLocale, getEffectiveLocale, getLocaleStrings, registerLocale, resolveLocale, setDefaultLocale } from "./core/locale.js";
 import { UElement } from "./components/UElement.js";
 import { UFormControlElement } from "./components/UFormControlElement.js";
 import { IconCache, IconRegistry, getDefaultBaseUrl, setDefaultBaseUrl } from "./utilities/icons.js";
@@ -53,4 +54,4 @@ import { BrowserStorage } from "./utilities/BrowserStorage.js";
 import { Dialog } from "./utilities/Dialog.js";
 import { Theme } from "./utilities/Theme.js";
 import { Toast } from "./utilities/Toast.js";
-export { BrowserStorage, Dialog, IconCache, IconRegistry, OverlayManager, Theme, Toast, UAlert, UAvatar, UBadge, UBreadcrumb, UBreadcrumbItem, UButton, UButtonGroup, UCard, UCarousel, UCheckbox, UChip, UDataElement, UDialog, UDivider, UDrawer, UElement, UField, UFloatingElement, UForm, UFormControlElement, UIcon, UIconButton, UInput, UMenu, UMenuItem, UOption, UOverlayElement, UPanel, UPopover, UProgressBar, UProgressRing, URadio, URating, USelect, USkeleton, USlider, USpinner, USplitPanel, USwitch, UTab, UTabPanel, UTag, UTextarea, UTooltip, UTree, UTreeItem, arrayAttrConverter, booleanAttrConverter, buildElementHTML, dateAttrConverter, escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, getDefaultBaseUrl, getParentElement, jsonAttrConverter, querySelectorAllWithin, querySelectorWithin, setDefaultBaseUrl, stripZeroWidth, urlAttrConverter };
+export { BrowserStorage, Dialog, IconCache, IconRegistry, OverlayManager, Theme, Toast, UAlert, UAvatar, UBadge, UBreadcrumb, UBreadcrumbItem, UButton, UButtonGroup, UCard, UCarousel, UCheckbox, UChip, UDataElement, UDialog, UDivider, UDrawer, UElement, UField, UFloatingElement, UForm, UFormControlElement, UIcon, UIconButton, UInput, UMenu, UMenuItem, UOption, UOverlayElement, UPanel, UPopover, UProgressBar, UProgressRing, URadio, URating, USelect, USkeleton, USlider, USpinner, USplitPanel, USwitch, UTab, UTabPanel, UTag, UTextarea, UTooltip, UTree, UTreeItem, arrayAttrConverter, booleanAttrConverter, buildElementHTML, dateAttrConverter, escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, formatTemplate, getDefaultBaseUrl, getDefaultLocale, getEffectiveLocale, getLocaleStrings, getParentElement, jsonAttrConverter, querySelectorAllWithin, querySelectorWithin, registerLocale, resolveLocale, setDefaultBaseUrl, setDefaultLocale, stripZeroWidth, urlAttrConverter };

package/dist/utilities/elements.js

@@ -58,7 +58,7 @@ function querySelectorAllWithin(element, selectors) {
 * // → '<u-ref-tag href="https://example.com" disabled>Click</u-ref-tag>'
 */
 function buildElementHTML(tag, attrs = {}, content = "") {
-	const URL_ATTR = new Set(["href", "src"]);
+	const URL_ATTR = /* @__PURE__ */ new Set(["href", "src"]);
 	const attrStr = Object.entries(attrs).flatMap(([k, v]) => {
 		if (v === void 0 || v == null || v === false) return [];
 		if (v === true) return [k];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.0.10",
+  "version": "1.1.1",
   "keywords": [
     "iyulab",
     "components",
@@ -39,7 +39,9 @@
     "./plugins/*": "./plugins/*"
   },
   "scripts": {
-    "test": "vite --force",
+    "dev": "vite --force",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "build:plugins": "tsc -p plugins/tsconfig.json",
     "build": "eslint && vite build && npm run build:plugins"
   },
@@ -72,6 +74,7 @@
     "typescript-eslint": "^8.59.3",
     "vite": "^8.0.13",
     "vite-plugin-dts": "^5.0.0",
-    "vite-plugin-static-copy": "^4.1.0"
+    "vite-plugin-static-copy": "^4.1.0",
+    "vitest": "^4.1.8"
   }
 }