@iyulab/components 1.7.1 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## [1.8.0] - 2026-07-22
+
+### Fixed
+- **`u-icon` 아이콘 리졸브가 재렌더·재마운트마다 다시 fetch되던 스톰 수정** — `IconRegistry.resolve()`가 리졸버 결과를 캐시하지 않아, SSE 스트리밍처럼 같은 아이콘이 반복 재마운트되는 UI에서 단일 아이콘에 수백 회 fetch가 발생했다(미존재 아이콘은 404 스톰으로 콘솔 오염 + dev 서버 부하 — SMI.AIMS 실측, ISSUE-components-20260722-iconregistry-resolver-no-cache). 이제 레지스트리가 (lib, name) 단위 캐싱과 동시 요청 in-flight dedupe를 소유해, 커스텀 리졸버를 포함한 모든 라이브러리에서 아이콘당 세션 1회만 리졸브된다. `u-icon`의 `src` 경로·무-lib 기본(baseUrl) 경로도 신설 `IconRegistry.resolveUrl(url)`을 경유해 동일하게 캐시된다.
+- 내장 CDN 리졸버(tabler/heroicons/lucide/bootstrap)가 네트워크 오류를 `undefined`로 삼키던 것을 throw 전파로 교정 — 일시 장애가 세션 내 not-found로 오인·고착되지 않고 다음 조회에서 재시도된다.
+
+### Changed
+- **`IconResolver` 계약 명확화 (동작 변경)** — 리졸버의 `undefined` 반환은 이제 **not-found 확정**을 뜻하며 네거티브 캐시되어 세션 내 재호출되지 않는다(탈출구: `IconCache.clear()`). **일시 오류(네트워크 장애 등)에는 `undefined` 대신 `throw`를 사용할 것** — throw는 캐시되지 않아 다음 조회 시 재시도된다. 일시 실패에 `undefined`를 반환하던 커스텀 리졸버는 throw로 전환해야 재시도 동작을 유지한다.
+- `IconRegistry.unregister(lib)`가 해당 라이브러리의 캐시 항목을 함께 비운다 — 내장 CDN 라이브러리를 로컬 리졸버로 교체(`unregister` → `register`, 폐쇄망 대응)할 때 이전 리졸버의 stale 결과가 남지 않는다.
+
+### Added
+- `IconRegistry.resolveUrl(url)` — URL 직접 리졸브(캐시 + dedupe). 예약 네임스페이스 `url`로 `IconCache`에 저장되며 소비앱의 prewarm 용도로도 사용 가능.
+- `IconCache.clear(lib)` — 특정 라이브러리 항목만 클리어(전체 클리어는 기존대로 인자 없이).
+- `IconCache.set()`이 `undefined`(네거티브 항목) 저장을 허용.
+
+### Documentation
+- `docs/icons.md`·skills 레퍼런스에 리졸버 계약(성공/not-found/일시 오류)·캐싱 동작·내장 라이브러리 오버라이드 절차(`unregister`→`register`) 문서화. CDN 버전 표기 드리프트 교정(lucide 0.577.0, bootstrap 1.13.1).
+
+## [1.7.2] - 2026-07-19
+
+### Fixed
+- **`Dialog.show()`가 영구 대기(hang)에 빠지던 결함 수정** — 프로미스 executor 가 `async` 였던 탓에 `await dialog.updateComplete` 가 reject 되면 예외가 삼켜지고 `hide` 리스너가 등록조차 되지 않아, `await Dialog.show(...)` 호출자가 **영원히 매달렸다**. 이제 리스너를 `await` **이전에** 등록하고(대기 중 발생한 `hide` 를 놓치던 경합도 함께 해소), 업데이트 실패 시 `console.error` 후 문서화된 "닫힘 = null" 규약대로 `null` 로 종료하며 고아 엘리먼트를 DOM 에서 제거한다. 회귀 테스트 3건 추가(정상 resolve / 닫힘 null / updateComplete reject).
+- `UOverlayElement`: 삼항 연산자를 문(statement)으로 사용하던 `open ? setup() : cleanup()` 을 `if/else` 로 교정.
+- `URating`/`USelect`/`UTree`: `switch` case 블록 안의 `const` 선언이 블록 스코프를 벗어나 다른 case 로 누출될 수 있던 형태를 중괄호 블록으로 격리(`no-case-declarations`).
+
+### Changed
+- **이 패키지의 eslint 가 실제로 동작하기 시작했다.** `eslint.config.js` 의 두 결함 — (1) `files: ["src/**/*"]` 가 ESLint 9 에서 universal 패턴으로 취급돼 `.ts` 를 린팅 대상으로 opt-in 하지 못함, (2) 배열 프리셋(`tseslint.configs.recommended`)을 객체 스프레드해 프리셋이 통째로 무력화됨 — 을 수정했다. `build` 스크립트에 `eslint &&` 게이트가 있었으나 매칭 파일이 0개라 **항상 통과**하고 있었다. 위 결함들은 모두 이 복구로 처음 드러난 것이다.
+- `npm run lint` / `npm run lint:fix` 스크립트 추가(flex-table·u-widgets 와 통일).
+- 내부 타입 정밀화: `Dialog`/`Theme`/`UTooltip`/`UInput`/`UTextarea` 의 `any` 캐스팅을 실제 타입(`CloseOnPolicy[]`, `UInput`, `InputType`, `VirtualElement`, `unknown[]`)으로 교체. 공개 API 시그니처 변경 없음.
+
+## [1.7.1] - 2026-07-19
+
+### Fixed
+- `UInput.type` 을 host 요소로 **reflect** 하도록 수정 — 미반영 시 `u-input[type="number"]::part(input)` 같은 속성 셀렉터가 HTML 속성으로 준 경우에만 매칭되고, React/Lit 의 property 바인딩(`.type=`, `el.type=`)에서는 host 에 속성이 나타나지 않아 무효였다. 형제 컴포넌트 `URadio.type` 은 이미 reflect 하고 있어 리포 내 비일관이기도 했다.
+
+### Documentation
+- `docs/theming.md` 에 `::part()` 커스터마이즈 섹션 신설 — 텍스트 정렬 레시피(`text-align` + `font-variant-numeric: tabular-nums`), 숫자 입력 우측정렬을 기본값으로 두지 않는 근거, 비반영 속성용 클래스 셀렉터 대안, 숫자 포맷팅 책임 범위.
+- `docs/architecture.md` CSS Parts 절에서 `theming.md` 로 상호 링크. `UInput` 의 `@csspart input` JSDoc 보강.
+
 ## [1.7.0] - 2026-07-17
 
 ### Fixed

package/dist/components/UOverlayElement.js

@@ -48,7 +48,8 @@ var UOverlayElement = class extends UElement {
 	}
 	updated(changedProperties) {
 		super.updated(changedProperties);
-		if (changedProperties.has("open")) this.open ? this.setup() : this.cleanup();
+		if (changedProperties.has("open")) if (this.open) this.setup();
+		else this.cleanup();
 	}
 	/**
 	* 오버레이를 표시합니다. u-show 이벤트가 취소되면 열리지 않습니다.

package/dist/components/icon/UIcon.js

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

package/dist/components/tree/UTree.js

@@ -119,11 +119,12 @@ var UTree = class UTree extends UElement {
 					items[items.length - 1]?.focus();
 					break;
 				case "Enter":
-				case " ":
+				case " ": {
 					e.preventDefault();
 					const header = focused.shadowRoot?.querySelector(".header");
 					if (header) header.click();
 					break;
+				}
 			}
 		};
 	}

package/dist/utilities/Dialog.js

@@ -81,39 +81,46 @@ var Dialog = class {
 	* 커스텀 다이얼로그를 표시합니다.
 	* @returns 클릭된 액션의 value 또는 닫힌 경우 null
 	*/
-	static show(options) {
-		return new Promise(async (resolve) => {
-			let closeValue = null;
-			const dialog = this.createDialog(options);
-			const content = typeof options.content === "string" ? unsafeHTML(options.content) : options.content;
-			const actions = options.actions && options.actions.length > 0 ? options.actions : null;
-			render(html`
-        <div style="min-width: 320px; font-size: 14px; line-height: 1.6;">
-          ${content}
-          ${actions ? html`
-            <div style="display: flex; justify-content: flex-end; gap: 8px; margin-top: 16px;">
-              ${actions.map((action) => html`
-                <u-button
-                  variant=${action.variant || "solid"}
-                  @click=${() => {
-				closeValue = action.value;
-				dialog.hide();
-			}}
-                >${action.label}</u-button>
-              `)}
-            </div>
-          ` : nothing}
-        </div>
-      `, dialog);
-			(options.target || document.body).appendChild(dialog);
-			await dialog.updateComplete;
-			dialog.show();
+	static async show(options) {
+		let closeValue = null;
+		const dialog = this.createDialog(options);
+		const content = typeof options.content === "string" ? unsafeHTML(options.content) : options.content;
+		const actions = options.actions && options.actions.length > 0 ? options.actions : null;
+		render(html`
+      <div style="min-width: 320px; font-size: 14px; line-height: 1.6;">
+        ${content}
+        ${actions ? html`
+          <div style="display: flex; justify-content: flex-end; gap: 8px; margin-top: 16px;">
+            ${actions.map((action) => html`
+              <u-button
+                variant=${action.variant || "solid"}
+                @click=${() => {
+			closeValue = action.value;
+			dialog.hide();
+		}}
+              >${action.label}</u-button>
+            `)}
+          </div>
+        ` : nothing}
+      </div>
+    `, dialog);
+		(options.target || document.body).appendChild(dialog);
+		const closed = new Promise((resolve) => {
 			dialog.addEventListener("hide", (e) => {
 				if (e.target !== dialog) return;
 				setTimeout(() => dialog.remove(), 300);
 				resolve(closeValue);
 			});
 		});
+		try {
+			await dialog.updateComplete;
+		} catch (error) {
+			console.error("[Dialog] 다이얼로그를 표시하지 못했습니다.", error);
+			dialog.remove();
+			return null;
+		}
+		dialog.show();
+		return closed;
 	}
 	/** 다이얼로그 엘리먼트를 생성하고 옵션을 적용합니다. */
 	static createDialog(options) {

package/dist/utilities/Theme.js

@@ -51,7 +51,7 @@ var Theme = class {
 		}
 		if (options?.useBuiltIn ?? true) {
 			this.log("Import enabled: loading styles via internal assets");
-			for (let [name, module] of internalStyleBundle) {
+			for (const [name, module] of internalStyleBundle) {
 				const style = document.createElement("style");
 				style.setAttribute("data-name", name);
 				style.textContent = module;

package/dist/utilities/icons.d.ts

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

package/dist/utilities/icons.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "keywords": [
     "iyulab",
     "components",
@@ -42,6 +42,8 @@
     "start": "vite --force",
     "test": "vitest run",
     "test:browser": "vitest run --project=browser",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
     "build:plugins": "tsc -p plugins/tsconfig.json",
     "build": "eslint && vite build && npm run build:plugins"
   },

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

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