@iyulab/components 1.32.0 → 1.33.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [1.33.0] - 2026-08-21
+
+### Added
+
+- **`u-radio` and `u-rating` now support `.focus()`/`.blur()` on the host element too**,
+  completing the same contract added to the rest of the form controls in `1.32.0`. Both are
+  option/symbol *groups* rather than a single target, so `.focus()` delegates to the first
+  option (`u-radio`) or the first symbol (`u-rating`) regardless of the current selection —
+  the same "one fixed delegation target" contract every other control in this library now
+  shares, rather than adding value-aware branching.
+
 ## [1.32.0] - 2026-08-21
 
 ### Added

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

@@ -31,6 +31,11 @@ export declare class URadio extends UFormControlElement<string> {
     render(): import('lit-html').TemplateResult<1>;
     protected setValidity(): void;
     reset(): void;
+    /** 그룹의 첫 포커스 가능 옵션으로 위임한다(선택된 값과 무관 — 나머지 폼 컨트롤과
+     *  같은 "위임 대상이 하나로 고정된 단순 계약"을 유지한다). 옵션 자신이 host에
+     *  실제 tabindex를 갖는 커스텀 엘리먼트라 `UOption.focus()`가 이미 동작한다. */
+    focus(options?: FocusOptions): void;
+    blur(): void;
     private setup;
     private cleanup;
     private onChangeValue;

package/dist/components/radio/URadio.js

@@ -108,6 +108,15 @@ var URadio = class URadio extends UFormControlElement {
 		this.value = void 0;
 		this.invalid = false;
 	}
+	/** 그룹의 첫 포커스 가능 옵션으로 위임한다(선택된 값과 무관 — 나머지 폼 컨트롤과
+	*  같은 "위임 대상이 하나로 고정된 단순 계약"을 유지한다). 옵션 자신이 host에
+	*  실제 tabindex를 갖는 커스텀 엘리먼트라 `UOption.focus()`가 이미 동작한다. */
+	focus(options) {
+		this.options.find((o) => !o.disabled)?.focus(options);
+	}
+	blur() {
+		(this.shadowRoot?.activeElement)?.blur();
+	}
 	setup(options) {
 		for (const option of options) {
 			option.removeEventListener("click", this.handleOptionClick);

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

@@ -37,6 +37,13 @@ export declare class URating extends UFormControlElement<number> {
     protected setValidity(): void;
     private isStepMismatch;
     reset(): void;
+    /** 첫(최저 점수) 심볼로 위임한다(선택된 값과 무관 — 나머지 폼 컨트롤과 같은
+     *  "위임 대상이 하나로 고정된 단순 계약"을 유지한다). 심볼은 shadow DOM 안의
+     *  `<span>`이라 disabled/readonly일 때 `tabindex="-1"`(=`!interactive`)이고,
+     *  다른 컴포넌트의 `.container`/thumb와 같은 이유로 프로그램적 focus는 여전히
+     *  통과하므로 직접 가드한다. */
+    focus(options?: FocusOptions): void;
+    blur(): void;
     private onChangeValue;
     /** 사용자 상호작용으로 값이 바뀐 경로에서만 호출한다 — 프로그램적 value 세팅은
      *  네이티브 폼 컨트롤과 동일하게 change를 발화하지 않는다.

package/dist/components/rating/URating.js

@@ -175,6 +175,18 @@ var URating = class URating extends UFormControlElement {
 		this.value = 0;
 		this.invalid = false;
 	}
+	/** 첫(최저 점수) 심볼로 위임한다(선택된 값과 무관 — 나머지 폼 컨트롤과 같은
+	*  "위임 대상이 하나로 고정된 단순 계약"을 유지한다). 심볼은 shadow DOM 안의
+	*  `<span>`이라 disabled/readonly일 때 `tabindex="-1"`(=`!interactive`)이고,
+	*  다른 컴포넌트의 `.container`/thumb와 같은 이유로 프로그램적 focus는 여전히
+	*  통과하므로 직접 가드한다. */
+	focus(options) {
+		if (!this.interactive) return;
+		this.renderRoot.querySelector(".symbol")?.focus(options);
+	}
+	blur() {
+		(this.shadowRoot?.activeElement)?.blur();
+	}
 	onChangeValue() {
 		this.buffer = -1;
 		this.internals?.setFormValue(this.value?.toString() || "");

package/package.json

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

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

@@ -58,6 +58,8 @@ Radio group built from `u-option` children. Form-associated.
 |--------|-------------|
 | `validate()` | Validate; sets `invalid` |
 | `reset()` | Reset selection |
+| `focus(options?)` | Focus the first option (regardless of selection) |
+| `blur()` | Blur the currently focused option, if any |
 
 ## CSS Parts
 

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

@@ -56,6 +56,8 @@ Star/custom-symbol rating input. Supports fractional precision and custom symbol
 |--------|-------------|
 | `validate()` | Validate; sets `invalid` |
 | `reset()` | Reset value |
+| `focus(options?)` | Focus the first symbol (regardless of value) |
+| `blur()` | Blur the currently focused symbol, if any |
 
 ## CSS Parts