@iyulab/components 1.40.3 → 1.41.1

package/dist/components/field/UField.js

@@ -1,11 +1,32 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import { devWarnOnce } from "../../utilities/devWarning.js";
 import { styles } from "./UField.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";
 import { isFocusable } from "tabbable";
 //#region src/components/field/UField.ts
+/** 네이티브로 «폼 컨트롤이거나 포커스를 받도록 저작된» 태그 — 가시성과 무관한 구조 사실이다. */
+var NATIVE_CONTROL_TAGS = /* @__PURE__ */ new Set([
+	"INPUT",
+	"SELECT",
+	"TEXTAREA",
+	"BUTTON"
+]);
+/**
+* **구조상** 폼 컨트롤인가 — `UField.hasControlInSubtree` 가 쓰는 술어.
+* `isFocusable()`(tabbable)과 달리 **렌더 여부도 `disabled` 도 보지 않는다**: 숨겨진 폼도,
+* 비활성 입력도 «라벨이 가리킬 대상» 이라는 사실은 같다. 근거는 `hasControlInSubtree` 주석.
+*/
+function isFormControlByStructure(node) {
+	if (node.constructor.formAssociated === true) return true;
+	if (NATIVE_CONTROL_TAGS.has(node.tagName)) return true;
+	if (node.tagName === "A" && node.hasAttribute("href")) return true;
+	if (node.hasAttribute("tabindex")) return true;
+	if (node.hasAttribute("contenteditable")) return true;
+	return false;
+}
 var UField = class UField extends UElement {
 	constructor(..._args) {
 		super(..._args);
@@ -43,11 +64,123 @@ var UField = class UField extends UElement {
 	*  공개 API로도 노출해, 소비자가 임의의 폼 컨트롤(자체 웹 컴포넌트가 아닌 것 포함)을
 	*  슬롯에 꽂아도 host의 `.focus()`가 `UInput.focus()`와 같은 계약으로 동작하게 한다. */
 	focus(options) {
-		const nodes = (this.shadowRoot?.querySelector("slot:not([name])"))?.assignedElements({ flatten: true }) || [];
-		for (const node of nodes) if (isFocusable(node)) {
-			node.focus(options);
+		this.focusTarget?.focus(options);
+	}
+	get assignedRoots() {
+		return (this.shadowRoot?.querySelector("slot:not([name])"))?.assignedElements({ flatten: true }) || [];
+	}
+	/**
+	* 포커스 대상은 **감싸개 안쪽까지** 본다. 이 패키지의 폼 컨트롤들은 자기 내부 `u-field` 에
+	* `<div class="container">` 를 슬롯하고 진짜 `<input>` 은 그 안에 있다 — 최상위만 보면
+	* *라이브러리 자신의 정상 사용*이 «컨트롤 없음» 이 된다(첫 판이 실제로 그렇게 오탐했다).
+	*/
+	get focusTarget() {
+		const named = this.controlToName;
+		if (named) return named;
+		for (const root of this.assignedRoots) {
+			if (isFocusable(root)) return root;
+			const inner = Array.from(root.querySelectorAll("*")).find((n) => isFocusable(n));
+			if (inner) return inner;
+		}
+		return null;
+	}
+	/**
+	* 라벨이 가리키는 대상 — `focus()` 와 접근성 이름 부여가 **같은 것**을 골라야 한다.
+	*
+	* 🔴**`isFocusable()` 만으로는 이 리포의 주된 사용 형태를 통째로 놓친다.** `tabbable` 은
+	* 기본적으로 섀도우 루트를 들여다보지 않으므로 `<u-input>` 같은 커스텀 엘리먼트 호스트에
+	* `false` 를 돌려준다(실측: `isFocusable(u-input)=false` · `isFocusable(<input>)=true`).
+	* ⇒ 종전 `focus()` 는 **네이티브 엘리먼트를 슬롯한 경우에만** 동작했고, 레퍼런스 문서가
+	* 가르치는 `u-*` 컨트롤 형태에서는 라벨 클릭이 **조용히 아무 일도 하지 않았다.**
+	*
+	* ⇒ 판정을 «포커스 가능» 하나가 아니라 **«폼 컨트롤인가»** 로 넓힌다: 네이티브로 포커스
+	* 가능하거나, **form-associated 커스텀 엘리먼트**(`static formAssociated = true` — 이
+	* 패키지의 `UFormControlElement` 전부가 그렇다)이면 대상이다. 섀도우를 파고들어 안쪽
+	* 네이티브 노드를 잡지는 않는다 — 그것은 컨트롤 자신의 API 를 우회하는 것이고, 그쪽이
+	* 다시 렌더하면 우리가 얹은 속성이 지워진다.
+	*/
+	get controlToName() {
+		for (const node of this.assignedRoots) if (node.constructor.formAssociated === true || isFocusable(node)) return node;
+		return null;
+	}
+	/**
+	* 🔴**«이 필드가 이름 줄 컨트롤을 가졌는가» 는 «지금 포커스 가능한가» 와 다른 질문이다 —
+	* 그 둘을 한 술어로 답한 것이 결함이었다.**
+	*
+	* 종전 경고는 `focusTarget`(위)의 부재로 판정했는데, 그 게터는 후보를 `isFocusable()` 로
+	* 고르고 **`tabbable` 의 기본 `displayCheck` 는 렌더 여부를 본다.** ⇒ 닫힌 `u-drawer`·
+	* 접힌 아코디언·비활성 탭 패널·마법사의 다음 단계처럼 **`display:none` 하위에서 처음
+	* 렌더되면 정상 컨트롤이 «없는 것» 이 된다**(실측: `<u-input label="X">` 가 숨겨져 있기만
+	* 하면 발화 · 같은 마크업이 보이면 침묵). 그 셋은 이 스택이 겨냥한 LOB 화면형 그 자체다.
+	*
+	* ⚠**그리고 오탐보다 그 다음이 나쁘다** — `devWarnOnce` 는 키당 한 번이라 오탐이 먼저 나면
+	* 뒤이은 **진짜 위반이 조용히 억제된다.** 이 리포가 반복 기록한 *«초록으로 틀린 말»* 이
+	* 여기서는 «침묵으로 틀린 말» 이 된다. (키 세분화는 아래 `nameSlottedControl` 참조.)
+	*
+	* ⇒ 판정은 **구조로만** 한다: form-associated 커스텀 엘리먼트 · 네이티브 폼/포커스 태그 ·
+	* `tabindex` · `contenteditable`. **가시성도 `disabled` 도 보지 않는다** — 비활성 입력도
+	* 라벨이 가리키는 대상이고, 숨겨진 폼도 구조는 같다.
+	* ⚠`focusTarget` 은 **그대로 `isFocusable` 을 쓴다** — `focus()` 위임에서는 «지금 포커스
+	* 가능한가» 가 맞는 질문이다. 두 게터가 같은 술어를 공유한 것이 원인이었다.
+	*/
+	get hasControlInSubtree() {
+		for (const root of this.assignedRoots) {
+			if (isFormControlByStructure(root)) return true;
+			if (Array.from(root.querySelectorAll("*")).some(isFormControlByStructure)) return true;
+		}
+		return false;
+	}
+	firstUpdated(changed) {
+		super.firstUpdated(changed);
+		(this.shadowRoot?.querySelector("slot:not([name])"))?.addEventListener("slotchange", () => this.nameSlottedControl());
+	}
+	updated(changed) {
+		super.updated(changed);
+		if (changed.has("label") || changed.has("description")) this.nameSlottedControl();
+	}
+	/**
+	* 🔴**이 컴포넌트의 존재 이유가 «라벨과 컨트롤을 한 칸으로 짝짓는 것»인데, 오랫동안
+	* 라벨을 «그리기만» 하고 연결하지 않았다** — 섀도의 `label` 에 `for` 가 없고 슬롯된
+	* 컨트롤의 `id`·`aria-label`·`aria-labelledby` 가 전부 빈 채였다 — 라벨을 가진 폼 한 장이
+	* 통째로 «이름 없는 입력» 이 된다. 화면은 멀쩡하고 콘솔도 조용해서 **시각 사용자에게는
+	* 아무 신호가 없다.**
+	*
+	* ⚠**`aria-labelledby` 로 잇지 않는다 — 섀도우 경계를 넘지 못한다.** 그 대신 «문자열
+	* 복사»를 슬롯 호스트의 `aria-label` 로 얹고, 폼 컨트롤 쪽이 그것을 내부 네이티브
+	* 컨트롤로 내려보낸다(`UFormControlElement.resolvedAriaLabel` — `u-button` 이 먼저 채택한
+	* 처방을 공통 기반으로 올린 것). 네이티브 엘리먼트를 슬롯한
+	* 경우에는 그 호스트가 곧 컨트롤이라 같은 한 줄이 그대로 듣는다.
+	*
+	* ⚠**자기 이름을 이미 가진 컨트롤은 건드리지 않는다** — 그쪽이 더 구체적이고,
+	* 덮으면 눈에 보이는 라벨과 접근성 이름이 어긋난다(WCAG 2.5.3 Label in Name).
+	*
+	* ⚠**경고 키에 라벨을 넣는다 — 형제 경고들이 이미 그렇게 한다.** 종전 키는 평평한
+	* `field-no-control` 하나여서 **페이지당 한 번**만 발화했고, 그래서 위반이 여럿이면
+	* 첫 하나만 보인다. `u-icon` 은 `icon:${lib}:${name}`, `u-split-panel` 은
+	* `split-panel:${id}` 로 이미 구분된 키를 쓴다 — 그리고 `u-icon` 의 경고가 태어난 계기가
+	* 정확히 *"메뉴 30개가 한꺼번에 틀렸는데 신호가 0"* 이었다. 같은 부류에 같은 처방을 한다.
+	* (메시지 문안은 그대로다 — 키는 중복 제거 단위일 뿐 공개 표면이 아니다.)
+	*/
+	nameSlottedControl() {
+		const control = this.controlToName;
+		if (!control) {
+			if (this.label && !this.hasControlInSubtree) devWarnOnce(`field-no-control:${this.label}`, `u-field label="${this.label}" has no form control in its default slot — the label names nothing. Slot a form control, or drop the label.`);
 			return;
 		}
+		if (!!control.label || control.hasAttribute("aria-labelledby") || control.hasAttribute("aria-label") && control.getAttribute("aria-label") !== this.lastAppliedLabel) {
+			if (this.label && control.label) devWarnOnce(`field-double-label:${this.label}`, `u-field label="${this.label}" wraps a control that also sets label="${control.label}" — the label renders twice. Set it on one of them.`);
+			return;
+		}
+		if (this.label) {
+			control.setAttribute("aria-label", this.label);
+			this.lastAppliedLabel = this.label;
+		} else if (this.lastAppliedLabel !== void 0) {
+			control.removeAttribute("aria-label");
+			this.lastAppliedLabel = void 0;
+		}
+		if (this.description) control.setAttribute("aria-description", this.description);
+		else if (control.getAttribute("aria-description") === this.lastAppliedDescription) control.removeAttribute("aria-description");
+		this.lastAppliedDescription = this.description;
 	}
 };
 __decorate([property({

package/dist/components/file-input/UFileInput.d.ts

@@ -37,6 +37,17 @@ export declare class UFileInput extends UFormControlElement<File[] | null> {
      *  넘긴다 — 네이티브 `<input type="file" multiple>`의 제출 형태와 동일하다. */
     protected updated(changedProperties: PropertyValues): void;
     private syncFormValue;
+    /**
+     * 이 컨트롤의 포커스 대상은 값을 담는 입력이 아니라 **파일 선택 버튼**이다. 그래서 바깥
+     * 라벨을 그대로 `aria-label` 로 얹으면 버튼의 보이는 글자("파일 선택")가 접근성 이름에서
+     * 사라진다 — WCAG SC 2.5.3 Label in Name 위반이고, 음성 조작 사용자가 보이는 글자로
+     * 그 버튼을 부를 수 없게 된다. ⇒ **덮지 않고 합성한다**: 보이는 글자를 **앞에** 두고
+     * 라벨을 맥락으로 덧붙인다(이름이 보이는 글자를 담으므로 2.5.3 을 만족하고, 같은 화면에
+     * 파일 선택 버튼이 여럿일 때 서로 구분된다).
+     *
+     * 라벨이 없으면 아무것도 얹지 않는다 — 버튼의 보이는 글자가 곧 이름이다.
+     */
+    private get triggerAriaLabel();
     render(): import('lit-html').TemplateResult<1>;
     protected setValidity(): void;
     reset(): void;

package/dist/components/file-input/UFileInput.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import { Locale } from "../../utilities/Locale.js";
@@ -65,6 +65,20 @@ var UFileInput = class UFileInput extends UFormControlElement {
 			this.internals?.setFormValue(fd);
 		}
 	}
+	/**
+	* 이 컨트롤의 포커스 대상은 값을 담는 입력이 아니라 **파일 선택 버튼**이다. 그래서 바깥
+	* 라벨을 그대로 `aria-label` 로 얹으면 버튼의 보이는 글자("파일 선택")가 접근성 이름에서
+	* 사라진다 — WCAG SC 2.5.3 Label in Name 위반이고, 음성 조작 사용자가 보이는 글자로
+	* 그 버튼을 부를 수 없게 된다. ⇒ **덮지 않고 합성한다**: 보이는 글자를 **앞에** 두고
+	* 라벨을 맥락으로 덧붙인다(이름이 보이는 글자를 담으므로 2.5.3 을 만족하고, 같은 화면에
+	* 파일 선택 버튼이 여럿일 때 서로 구분된다).
+	*
+	* 라벨이 없으면 아무것도 얹지 않는다 — 버튼의 보이는 글자가 곧 이름이다.
+	*/
+	get triggerAriaLabel() {
+		const label = this.resolvedAriaLabel;
+		return label ? `${Locale.getValue("chooseFile")}, ${label}` : void 0;
+	}
 	render() {
 		const files = this.value ?? [];
 		const hasFiles = files.length > 0;
@@ -81,6 +95,7 @@ var UFileInput = class UFileInput extends UFormControlElement {
         <div class="container" part="container">
           <button class="trigger" part="trigger"
             type="button"
+            aria-label=${ifDefined(this.triggerAriaLabel)}
             ?disabled=${this.disabled || this.readonly}
             @click=${this.handleTriggerClick}
           >${Locale.getValue("chooseFile")}</button>

package/dist/components/form/UForm.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { IconRegistry, getDefaultBaseUrl } from "../../utilities/icons.js";
 import { devWarnOnce } from "../../utilities/devWarning.js";
 import { styles } from "./UIcon.styles.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";
@@ -180,8 +180,8 @@ var UInput = class UInput extends UFormControlElement {
 
           <input part="input"
             type=${this.type === "password" && this.showPassword ? "text" : this.type}
-            aria-label=${ifDefined(this.label)}
-            aria-description=${ifDefined(this.description)}
+            aria-label=${ifDefined(this.resolvedAriaLabel)}
+            aria-description=${ifDefined(this.resolvedAriaDescription)}
             name=${ifDefined(this.name)}
             ?required=${this.required}
             ?disabled=${this.disabled}

package/dist/components/menu/UMenu.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import "../popover/UPopover.js";
 import { UDivider } from "../divider/UDivider.js";

package/dist/components/option/UOption.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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,6 +1,6 @@
 import { isCoarsePointer } from "../../utilities/elements.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import "../field/UField.js";
@@ -93,8 +93,8 @@ var URadio = class URadio extends UFormControlElement {
       >
         <div class="container" part="container"
           role="radiogroup"
-          aria-label=${ifDefined(this.label)}
-          aria-description=${ifDefined(this.description)}>
+          aria-label=${ifDefined(this.resolvedAriaLabel)}
+          aria-description=${ifDefined(this.resolvedAriaDescription)}>
           <slot @slotchange=${this.handleSlotChange}></slot>
         </div>
       </u-field>

package/dist/components/rating/URating.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../icon/UIcon.js";
 import { Locale } from "../../utilities/Locale.js";
@@ -112,8 +112,8 @@ var URating = class URating extends UFormControlElement {
         .validationMessage=${this.validationMessage}
       >
         <div class="symbols" part="container" role="radiogroup"
-          aria-label=${ifDefined(this.label)}
-          aria-description=${ifDefined(this.description)}>
+          aria-label=${ifDefined(this.resolvedAriaLabel)}
+          aria-description=${ifDefined(this.resolvedAriaDescription)}>
           ${Array.from({ length: this.max }, (_, i) => {
 			const score = i + 1;
 			const fill = Math.max(0, Math.min(1, value - score + 1));

package/dist/components/select/USelect.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";
@@ -173,8 +173,8 @@ var USelect = class USelect extends UFormControlElement {
 
         <div class="container" part="container" tabindex=${this.disabled ? "-1" : "0"}
           role="combobox"
-          aria-label=${ifDefined(this.label)}
-          aria-description=${ifDefined(this.description)}
+          aria-label=${ifDefined(this.resolvedAriaLabel)}
+          aria-description=${ifDefined(this.resolvedAriaDescription)}
           aria-haspopup=${this.searchable ? "dialog" : "listbox"}
           aria-expanded=${this.open}
           aria-controls=${this.searchable ? this.popupId : this.listboxId}>
@@ -209,7 +209,7 @@ var USelect = class USelect extends UFormControlElement {
       <u-popover part="popover"
         id=${this.popupId}
         role=${ifDefined(this.searchable ? "dialog" : void 0)}
-        aria-label=${ifDefined(this.searchable ? this.label || Locale.getValue("search") : void 0)}
+        aria-label=${ifDefined(this.searchable ? this.resolvedAriaLabel || Locale.getValue("search") : void 0)}
         scrollable
         autofocus
         for=".container"

package/dist/components/skeleton/USkeleton.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import "../tooltip/UTooltip.js";
@@ -230,7 +230,7 @@ var USlider = class USlider extends UFormControlElement {
 		return html`
       <div class="thumb" part=${isEnd ? "thumb-end" : "thumb"}
         role="slider"
-        aria-label=${ifDefined(this.label)}
+        aria-label=${ifDefined(this.resolvedAriaLabel)}
         aria-valuenow=${val}
         aria-valuemin=${this.min}
         aria-valuemax=${this.max}

package/dist/components/spinner/USpinner.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { arrayAttrConverter } from "../../utilities/converters.js";
 import { devWarnOnce } from "../../utilities/devWarning.js";
 import { Locale } from "../../utilities/Locale.js";

package/dist/components/switch/USwitch.js

@@ -1,10 +1,11 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import { styles } from "./USwitch.styles.js";
 import { html } from "lit";
 import { customElement, property, query } from "lit/decorators.js";
+import { ifDefined } from "lit/directives/if-defined.js";
 import { live } from "lit/directives/live.js";
 //#region src/components/switch/USwitch.ts
 var USwitch = class USwitch extends UFormControlElement {
@@ -38,6 +39,7 @@ var USwitch = class USwitch extends UFormControlElement {
       <label class="wrapper" part="wrapper">
         <input
           type="checkbox"
+          aria-label=${ifDefined(this.contentAriaLabel)}
           ?disabled=${this.disabled || this.readonly}
           ?required=${this.required}
           .checked=${live(this.checked)}
@@ -60,7 +62,13 @@ var USwitch = class USwitch extends UFormControlElement {
           </span>
         </span>
         <span class="label" part="label">
-          <slot></slot>
+          <!-- 형제 u-checkbox 는 슬롯 폴백으로 label 을 그리는데 여기만 없었다 — 상속받은
+               공개 프로퍼티(UFormControlElement.label)를 이 컴포넌트만 한 번도 읽지 않아
+               u-switch 에 label 속성을 주면 눈에 보이는 라벨도 접근성 이름도 생기지 않았다
+               문서는 기본 슬롯만 가르쳐 왔으므로 문서 위반이
+               아니라 «선언은 있는데 동작이 없는» 자리다.
+               주의: 이 주석에 백틱을 쓰지 말 것 — html 태그드 템플릿을 그 자리에서 끝낸다. -->
+          <slot @slotchange=${this.handleLabelSlotChange}>${this.label}</slot>
           <span class="required" ?hidden=${!this.required}>*</span>
         </span>
       </label>

package/dist/components/tab/UTab.js

@@ -1,6 +1,6 @@
 import { UElement } from "../UElement.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import "../icon/UIcon.js";
 import { statusIcon } from "../../utilities/statusIcon.js";
 import { styles } from "./UTag.styles.js";

package/dist/components/text/UText.js

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

package/dist/components/textarea/UTextarea.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import { UFormControlElement } from "../UFormControlElement.js";
 import { Locale } from "../../utilities/Locale.js";
 import "../field/UField.js";
@@ -56,8 +56,8 @@ var UTextarea = class UTextarea extends UFormControlElement {
         <div class="container" part="container">
           <textarea part="textarea"
             scrollable
-            aria-label=${ifDefined(this.label)}
-            aria-description=${ifDefined(this.description)}
+            aria-label=${ifDefined(this.resolvedAriaLabel)}
+            aria-description=${ifDefined(this.resolvedAriaDescription)}
             ?required=${this.required}
             ?disabled=${this.disabled}
             ?readonly=${this.readonly}

package/dist/components/tooltip/UTooltip.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.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.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import "../spinner/USpinner.js";
 import "../icon/UIcon.js";
 import { styles } from "./UTreeItem.styles.js";

package/dist/utilities/accent.d.ts

@@ -41,7 +41,7 @@ export declare const MIN_STEP_SEPARATION = 1.2;
 export declare function parseColor(value: string): [number, number, number] | null;
 export declare function toHex([r, g, b]: [number, number, number]): string;
 export declare function luminance(color: string): number;
-/** WCAG 2.1 명암비. */
+/** WCAG 2.x 명암비(상대 휘도 공식 — 2.2 에서 바뀌지 않았다). */
 export declare function contrast(a: string, b: string): number;
 /** `color-mix(in srgb, a p%, b)` 와 같은 계산. */
 export declare function mix(a: string, b: string, p: number): string;

package/dist/utilities/accent.js

@@ -39,7 +39,7 @@ function luminance(color) {
 	const [r, g, b] = rgb.map((v) => channelLum(v / 255));
 	return .2126 * r + .7152 * g + .0722 * b;
 }
-/** WCAG 2.1 명암비. */
+/** WCAG 2.x 명암비(상대 휘도 공식 — 2.2 에서 바뀌지 않았다). */
 function contrast(a, b) {
 	const [x, y] = [luminance(a), luminance(b)];
 	return (Math.max(x, y) + .05) / (Math.min(x, y) + .05);