@iyulab/components 1.40.0 → 1.40.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.40.1] - 2026-09-13
+
+### Added
+
+- **Development-mode warnings for two states that were silently wrong.** Both are one-shot,
+  namespaced `[@iyulab/components]`, and compiled out of production builds (`import.meta.env.DEV`).
+  - `u-icon`: when a `name` does not resolve (404, unknown `lib`, unparsable SVG) the icon still
+    draws its `fallback` — that is intended — but now says so once per name, with what to check.
+    Thirty menu items rendering the same cube with no signal is how this was found.
+  - `u-split-panel`: when the host has no height of its own it sits at one line of content (18px
+    measured) and anything sized 100% inside its panels collapses; it now says so once and tells
+    you to size the host or its parent.
+
 ## [1.40.0] - 2026-09-10
 
 ### Changed

package/dist/components/icon/UIcon.js

@@ -2,6 +2,7 @@ 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 { IconRegistry, getDefaultBaseUrl } from "../../utilities/icons.js";
+import "../../utilities/devWarning.js";
 import { styles } from "./UIcon.styles.js";
 import { nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";
@@ -26,12 +27,18 @@ var UIcon = class UIcon extends UElement {
 	}
 	async resolve(name) {
 		let html;
-		if (this.lib) html = await IconRegistry.resolve(this.lib, name);
-		else {
+		let where;
+		if (this.lib) {
+			html = await IconRegistry.resolve(this.lib, name);
+			where = IconRegistry.has(this.lib) ? `lib "${this.lib}"` : `lib "${this.lib}" (not registered)`;
+		} else {
 			const url = `${getDefaultBaseUrl().replace(/\/$/, "")}/${name}.svg`;
 			html = await IconRegistry.resolveUrl(url);
+			where = `${url} (no lib given — the default base URL)`;
 		}
-		return this.sanitize(html);
+		const svg = this.sanitize(html);
+		if (svg === void 0) `${this.lib ?? ""}${name}`, `${name}${where}`, this.fallback;
+		return svg;
 	}
 	sanitize(html) {
 		if (!html) return void 0;

package/dist/components/split-panel/USplitPanel.d.ts

@@ -52,6 +52,12 @@ export declare class USplitPanel extends UElement {
     protected willUpdate(changedProperties: PropertyValues): void;
     render(): import('lit-html').TemplateResult<1>;
     private handleSlotChange;
+    /**
+     * 호스트에 높이(또는 세로 분할이면 폭) 제약이 없으면 이 컴포넌트는 손잡이 두께로 붕괴한다 —
+     * 실측 18px(cycle-565). 호스트가 `overflow: hidden` 이라 패널 내용에 닿을 방법이 없고,
+     * 오류도 없다. 첫 배치 뒤 한 번 재서 개발 모드에서 알린다(HD-61 ⒝).
+     */
+    private warnIfCollapsed;
     private handleSplitterSlotChange;
     private appendSplitters;
     private createSplitter;

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

@@ -33,6 +33,7 @@ var USplitPanel = class USplitPanel extends UElement {
 			this.panels = slot.assignedElements({ flatten: true }).filter((el) => el instanceof HTMLElement);
 			this.appendSplitters();
 			this.updatePanelLayout();
+			this.warnIfCollapsed();
 		};
 		this.handleSplitterSlotChange = (e) => {
 			const slot = e.target;
@@ -241,6 +242,12 @@ var USplitPanel = class USplitPanel extends UElement {
       </div>
     `;
 	}
+	/**
+	* 호스트에 높이(또는 세로 분할이면 폭) 제약이 없으면 이 컴포넌트는 손잡이 두께로 붕괴한다 —
+	* 실측 18px(cycle-565). 호스트가 `overflow: hidden` 이라 패널 내용에 닿을 방법이 없고,
+	* 오류도 없다. 첫 배치 뒤 한 번 재서 개발 모드에서 알린다(HD-61 ⒝).
+	*/
+	warnIfCollapsed() {}
 	appendSplitters() {
 		const root = this.renderRoot;
 		if (!root) return;

package/dist/utilities/devWarning.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 개발 모드 «사용 안내» 경고 — 오류 경로가 아닌, ***조용히 틀리는*** 상태를 한 번 알린다.
+ *
+ * 이 패키지에는 같은 모양의 경고가 이미 있다(`UElement.warnIfTokensMissing` — 토큰 시트 부재).
+ * 공통 규약: `[@iyulab/components]` 네임스페이스 · 개발 모드에서만(`import.meta.env.DEV`) ·
+ * 같은 키로는 **한 번만** · 무엇이 틀렸는지가 아니라 **무엇을 하면 되는지**를 적는다.
+ *
+ * 이 파일이 생긴 계기: 소비앱의 메뉴 30개가 해석되지 않는 아이콘 이름으로 **한꺼번에 같은
+ * 큐브 폴백**을 그렸는데 신호가 0 이었다(docket #265 R3). 폴백은 의도된 것이라(접힌 사이드바에서
+ * 아이콘이 없으면 메뉴가 «높이만 있는 빈 줄» 이 된다) 제거가 답이 아니다 — **없는 것은 경고다.**
+ * 같은 부류가 셋 더 있었다: 높이 제약이 없어 18px 로 붕괴하는 `u-split-panel`, 가상화가 꺼지는
+ * `flex-table`, 133px 로 앉는 `modern-app` 셸 — 모두 «에러 없이 틀린 화면» 이다(HD-61 ⒝).
+ */
+/** `key` 당 한 번만, 개발 모드에서만 `console.warn` 한다. 프로덕션 빌드에서는 호출 자체가 no-op 이다. */
+export declare function devWarnOnce(key: string, message: string): void;
+/** 테스트용 — 가드를 비운다. */
+export declare function resetDevWarnings(): void;

package/dist/utilities/devWarning.js

@@ -0,0 +1,5 @@
+//#region src/utilities/devWarning.ts
+/** `key` 당 한 번만, 개발 모드에서만 `console.warn` 한다. 프로덕션 빌드에서는 호출 자체가 no-op 이다. */
+function devWarnOnce(key, message) {}
+//#endregion
+export { devWarnOnce };

package/package.json

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