@iyulab/components 0.1.7 → 0.1.9

package/dist/components/icon-button/{IconButton.js → UIconButton.component.js}

@@ -1,9 +1,9 @@
 import { html } from 'lit';
 import { property } from 'lit/decorators.js';
 import { BaseElement } from '../BaseElement.js';
-import { Spinner } from '../spinner/Spinner.js';
-import { Icon } from '../icon/Icon.js';
-import { styles } from './IconButton.styles.js';
+import { USpinner } from '../spinner/USpinner.component.js';
+import { UIcon } from '../icon/UIcon.component.js';
+import { styles } from './UIconButton.styles.js';
 
 var __defProp = Object.defineProperty;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -14,46 +14,46 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (result) __defProp(target, key, result);
   return result;
 };
-class IconButton extends BaseElement {
+class UIconButton extends BaseElement {
   constructor() {
     super(...arguments);
     this.borderless = false;
     this.disabled = false;
     this.loading = false;
-    this.library = "default";
+    this.lib = "default";
   }
   static {
     this.styles = [super.styles, styles];
   }
   static {
     this.dependencies = {
-      "u-spinner": Spinner,
-      "u-icon": Icon
+      "u-spinner": USpinner,
+      "u-icon": UIcon
     };
   }
   render() {
     return html`
       <button part="base"
         ?disabled=${this.disabled || this.loading}>
-        ${this.loading ? html`<u-spinner></u-spinner>` : html`<u-icon .library=${this.library} .name=${this.name}></u-icon>`}
+        ${this.loading ? html`<u-spinner></u-spinner>` : html`<u-icon .lib=${this.lib} .name=${this.name}></u-icon>`}
       </button>
     `;
   }
 }
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], IconButton.prototype, "borderless");
+], UIconButton.prototype, "borderless");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], IconButton.prototype, "disabled");
+], UIconButton.prototype, "disabled");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], IconButton.prototype, "loading");
+], UIconButton.prototype, "loading");
 __decorateClass([
-  property({ type: String, attribute: "lib" })
-], IconButton.prototype, "library");
+  property({ type: String })
+], UIconButton.prototype, "lib");
 __decorateClass([
   property({ type: String })
-], IconButton.prototype, "name");
+], UIconButton.prototype, "name");
 
-export { IconButton };
+export { UIconButton };

package/dist/components/icon-button/UIconButton.d.ts

@@ -0,0 +1,7 @@
+import { UIconButton } from './UIconButton.component.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        "u-icon-button": UIconButton;
+    }
+}
+export { UIconButton };

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

@@ -0,0 +1,5 @@
+import { UIconButton } from './UIconButton.component.js';
+
+UIconButton.define("u-icon-button");
+
+export { UIconButton };

package/dist/components/input/{Input.d.ts → UInput.component.d.ts}

@@ -1,17 +1,21 @@
 import { PropertyValues } from 'lit';
 import { BaseElement } from '../BaseElement.js';
-/** 지원하는 input 타입 */
+/**
+ * Supported input types for Input component
+ *
+ * - Excludes: checkbox, radio, range, color, file, hidden, image, reset, submit, button
+ */
 type InputType = ('text' | 'password' | 'email' | 'tel' | 'url' | 'search' | 'number' | 'date' | 'time' | 'datetime-local' | 'month' | 'week');
 /**
  * Input 컴포넌트는 사용자 입력을 받는 텍스트 입력 필드입니다.
  * prefix, suffix 슬롯과 라벨, 도움말, 유효성 검사 등의 기능을 제공합니다.
  */
-export declare class Input extends BaseElement {
+export declare class UInput extends BaseElement {
     static styles: import('lit').CSSResultGroup[];
     static dependencies: Record<string, typeof BaseElement>;
     inputEl: HTMLInputElement;
-    /** 유효성 검사 실패 여부 */
-    isInvalid: boolean;
+    /** 유효성 여부 */
+    isValid: boolean;
     /** 현재 표시할 유효성 검사 메시지 */
     currentValidationMessage: string;
     /** password type인 경우 비밀번호 표시/숨김 상태 */
@@ -31,7 +35,7 @@ export declare class Input extends BaseElement {
     /** 라벨 텍스트 */
     label?: string;
     /** 라벨 도움말 (툴팁) */
-    labelhelp?: string;
+    help?: string;
     /** placeholder 텍스트 */
     placeholder?: string;
     /** 컴포넌트 하단 설명 텍스트 */
@@ -52,14 +56,14 @@ export declare class Input extends BaseElement {
     validationMessage?: string;
     protected updated(changedProperties: PropertyValues): void;
     render(): import('lit-html').TemplateResult<1>;
-    /** 유효성 검사를 수행합니다. */
-    validate(): boolean;
-    /** 입력값을 초기화합니다. */
-    clear(): void;
     /** 입력 필드에 포커스를 설정합니다. */
     focus(): void;
     /** 입력 필드의 포커스를 해제합니다. */
     blur(): void;
+    /** 입력값을 초기화합니다. */
+    clear(): void;
+    /** 유효성 검사를 수행합니다. */
+    validate(): boolean;
     /** input 이벤트 핸들러 */
     private handleInput;
     /** change 이벤트 핸들러 */
@@ -69,6 +73,6 @@ export declare class Input extends BaseElement {
     /** 비밀번호 표시/숨김 토글 핸들러 */
     private handlePasswordTogglerClick;
     /** 클리어 버튼 클릭 핸들러 */
-    private handleClearBtnClick;
+    private handleClearButtonClick;
 }
 export {};

package/dist/components/input/{Input.js → UInput.component.js}

@@ -1,11 +1,11 @@
-import { nothing, html } from 'lit';
+import { html } from 'lit';
 import { query, state, property } from 'lit/decorators.js';
 import { ifDefined } from 'lit/directives/if-defined.js';
 import { live } from 'lit/directives/live.js';
 import { BaseElement } from '../BaseElement.js';
-import { Icon } from '../icon/Icon.js';
-import { Tooltip } from '../tooltip/Tooltip.js';
-import { styles } from './Input.styles.js';
+import { UIcon } from '../icon/UIcon.component.js';
+import { UTooltip } from '../tooltip/UTooltip.component.js';
+import { styles } from './UInput.styles.js';
 
 var __defProp = Object.defineProperty;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -16,10 +16,10 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (result) __defProp(target, key, result);
   return result;
 };
-class Input extends BaseElement {
+class UInput extends BaseElement {
   constructor() {
     super(...arguments);
-    this.isInvalid = false;
+    this.isValid = true;
     this.currentValidationMessage = "";
     this.showPassword = false;
     this.type = "text";
@@ -33,10 +33,6 @@ class Input extends BaseElement {
     this.handleInput = (e) => {
       const input = e.target;
       this.value = input.value;
-      if (this.isInvalid) {
-        this.isInvalid = false;
-        this.currentValidationMessage = "";
-      }
       this.emit("u-input", { value: this.value });
     };
     /** change 이벤트 핸들러 */
@@ -46,7 +42,7 @@ class Input extends BaseElement {
       this.emit("u-change", { value: this.value });
     };
     /** blur 이벤트 핸들러 */
-    this.handleInputBlur = () => {
+    this.handleInputBlur = (_) => {
       this.validate();
     };
     /** 비밀번호 표시/숨김 토글 핸들러 */
@@ -57,7 +53,7 @@ class Input extends BaseElement {
       this.focus();
     };
     /** 클리어 버튼 클릭 핸들러 */
-    this.handleClearBtnClick = (e) => {
+    this.handleClearButtonClick = (e) => {
       e.preventDefault();
       e.stopPropagation();
       this.clear();
@@ -68,8 +64,8 @@ class Input extends BaseElement {
   }
   static {
     this.dependencies = {
-      "u-icon": Icon,
-      "u-tooltip": Tooltip
+      "u-icon": UIcon,
+      "u-tooltip": UTooltip
     };
   }
   updated(changedProperties) {
@@ -83,21 +79,22 @@ class Input extends BaseElement {
   render() {
     return html`
       <div class="header" ?hidden=${!this.label}>
-        ${this.required ? html`<span class="required-mark">*</span>` : nothing}
+        <span class="required" ?hidden=${!this.required}>*</span>
       
         <label class="label" @click=${this.focus}>
           ${this.label}
         </label>
         
-        ${this.labelhelp ? html`
-            <u-icon class="help-icon" lib="internal" name="info-circle-fill"></u-icon>
-            <u-tooltip class="help-tooltip" trigger-selectors=".help-icon" placement="right-end">
-              ${this.labelhelp}
-            </u-tooltip>` : nothing}
+        <div class="helper" ?hidden=${!this.help}>
+          <u-icon lib="internal" name="info-circle-fill"></u-icon>
+          <u-tooltip distance="6" placement="right-end">
+            ${this.help}
+          </u-tooltip>
+        </div>
       </div>
       
       <div class="container"
-        ?invalid=${this.isInvalid}
+        ?invalid=${!this.isValid}
         ?disabled=${this.disabled}
         ?readonly=${this.readonly}>
 
@@ -123,20 +120,18 @@ class Input extends BaseElement {
         
         <slot name="suffix"></slot>
         
-        <div class="suffix-items">
-          <u-icon
-            lib="internal"
-            name=${this.showPassword ? "eye-slash" : "eye"}
-            ?hidden=${this.type !== "password" || this.disabled || this.readonly}
-            @click=${this.handlePasswordTogglerClick}
-          ></u-icon>
-          <u-icon
-            lib="internal"
-            name="x-lg"
-            ?hidden=${!this.clearable || !this.value || this.disabled || this.readonly}
-            @click=${this.handleClearBtnClick}
-          ></u-icon>
-        </div>
+        <u-icon class="suffix icon" tabindex="0"
+          ?hidden=${this.type !== "password" || this.disabled || this.readonly}  
+          lib="internal"
+          name=${this.showPassword ? "eye-slash" : "eye"}
+          @click=${this.handlePasswordTogglerClick}
+        ></u-icon>
+        <u-icon class="suffix icon" tabindex="0"
+          ?hidden=${!this.clearable || this.disabled || this.readonly}
+          lib="internal"
+          name="x-lg"
+          @click=${this.handleClearButtonClick}
+        ></u-icon>
       </div>
 
       <div class="validation-message" ?hidden=${!this.currentValidationMessage}>
@@ -148,25 +143,6 @@ class Input extends BaseElement {
       </div>
     `;
   }
-  /** 유효성 검사를 수행합니다. */
-  validate() {
-    if (!this.inputEl) return true;
-    const isValid = this.inputEl.checkValidity();
-    this.isInvalid = !isValid;
-    if (!isValid) {
-      this.currentValidationMessage = this.validationMessage || this.inputEl.validationMessage;
-    } else {
-      this.currentValidationMessage = "";
-    }
-    return isValid;
-  }
-  /** 입력값을 초기화합니다. */
-  clear() {
-    this.value = "";
-    this.isInvalid = false;
-    this.currentValidationMessage = "";
-    this.focus();
-  }
   /** 입력 필드에 포커스를 설정합니다. */
   focus() {
     this.inputEl?.focus();
@@ -175,69 +151,88 @@ class Input extends BaseElement {
   blur() {
     this.inputEl?.blur();
   }
+  /** 입력값을 초기화합니다. */
+  clear() {
+    this.value = "";
+    this.isValid = true;
+    this.currentValidationMessage = "";
+    this.focus();
+  }
+  /** 유효성 검사를 수행합니다. */
+  validate() {
+    if (!this.inputEl) return true;
+    const validity = this.inputEl.validity;
+    this.isValid = validity.valid;
+    if (this.isValid) {
+      this.currentValidationMessage = "";
+    } else {
+      this.currentValidationMessage = validity.patternMismatch ? this.validationMessage || this.inputEl.validationMessage : this.inputEl.validationMessage;
+    }
+    return this.isValid;
+  }
 }
 __decorateClass([
   query("input")
-], Input.prototype, "inputEl");
+], UInput.prototype, "inputEl");
 __decorateClass([
   state()
-], Input.prototype, "isInvalid");
+], UInput.prototype, "isValid");
 __decorateClass([
   state()
-], Input.prototype, "currentValidationMessage");
+], UInput.prototype, "currentValidationMessage");
 __decorateClass([
   state()
-], Input.prototype, "showPassword");
+], UInput.prototype, "showPassword");
 __decorateClass([
   property({ type: String, reflect: true })
-], Input.prototype, "type");
+], UInput.prototype, "type");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], Input.prototype, "required");
+], UInput.prototype, "required");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], Input.prototype, "readonly");
+], UInput.prototype, "readonly");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], Input.prototype, "disabled");
+], UInput.prototype, "disabled");
 __decorateClass([
   property({ type: Boolean, reflect: true })
-], Input.prototype, "clearable");
+], UInput.prototype, "clearable");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "name");
+], UInput.prototype, "name");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "label");
+], UInput.prototype, "label");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "labelhelp");
+], UInput.prototype, "help");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "placeholder");
+], UInput.prototype, "placeholder");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "description");
+], UInput.prototype, "description");
 __decorateClass([
   property({ type: Number })
-], Input.prototype, "minlength");
+], UInput.prototype, "minlength");
 __decorateClass([
   property({ type: Number })
-], Input.prototype, "maxlength");
+], UInput.prototype, "maxlength");
 __decorateClass([
   property({ type: Boolean })
-], Input.prototype, "spellcheck");
+], UInput.prototype, "spellcheck");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "autocomplete");
+], UInput.prototype, "autocomplete");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "value");
+], UInput.prototype, "value");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "pattern");
+], UInput.prototype, "pattern");
 __decorateClass([
   property({ type: String })
-], Input.prototype, "validationMessage");
+], UInput.prototype, "validationMessage");
 
-export { Input };
+export { UInput };

package/dist/components/input/UInput.d.ts

@@ -0,0 +1,7 @@
+import { UInput } from './UInput.component.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        "u-input": UInput;
+    }
+}
+export { UInput };

package/dist/components/input/UInput.js

@@ -0,0 +1,5 @@
+import { UInput } from './UInput.component.js';
+
+UInput.define("u-input");
+
+export { UInput };

package/dist/components/input/{Input.styles.js → UInput.styles.js}

@@ -16,26 +16,26 @@ const styles = css`
   .header {
     display: flex;
     flex-direction: row;
+    justify-content: flex-start;
     align-items: center;
     margin-bottom: 0.5em;
+    font-size: 0.8em;
     user-select: none;
   }
+  .header .required {
+    color: var(--u-red-600);
+    margin-right: 0.25em;
+  }
   .header .label {
-    font-size: 0.8em;
     font-weight: 500;
-    line-height: 1.2;
+    line-height: 1.25;
     cursor: pointer;
   }
-  .header .required-mark {
-    color: var(--u-red-600);
-    margin-right: 0.25em;
-  }
-  .header .help-icon {
-    font-size: 0.8em;
+  .header .helper u-icon {
     margin-left: 0.5em;
     cursor: help;
   }
-  .header .help-tooltip {
+  .header .helper u-tooltip {
     font-size: 0.6em;
   }
 
@@ -49,23 +49,24 @@ const styles = css`
     border-radius: 0.25em;
     background-color: var(--u-input-bg-color);
     transition: border-color 0.2s ease, box-shadow 0.2s ease;
+    overflow: hidden;
   }
   .container[readonly],
   .container[disabled] {
     border-color: var(--u-border-color-weak);
     background-color: var(--u-bg-color-disabled);
   }
-  .container:hover:not([readonly]):not([disabled]) {
+  .container:not([readonly]):not([disabled]):hover {
     box-shadow: 
       0 0 0 1px var(--u-input-border-color-hover),
       0 0 0 3px rgba(59, 130, 246, 0.12);
   }
-  .container:focus-within:not([readonly]):not([disabled]) {
+  .container:not([readonly]):not([disabled]):focus-within {
     box-shadow:
       0 0 0 1px var(--u-input-border-color-focus),
       0 0 0 3px rgba(59, 130, 246, 0.22);
   }
-  .container[invalid]:not([readonly]):not([disabled]) {
+  .container:not([readonly]):not([disabled])[invalid] {
     box-shadow:
       0 0 0 1px var(--u-input-border-color-invalid),
       0 0 0 3px rgba(220, 38, 38, 0.12);
@@ -73,9 +74,9 @@ const styles = css`
 
   /* 입력 필드 */
   input {
-    flex: 1 1 auto;
-    min-width: 0;
     all: unset;
+    flex: 1 0 auto;
+    min-width: 0;
     font-size: 1em;
     line-height: 1.5;
   }
@@ -97,26 +98,28 @@ const styles = css`
     margin-left: 0.5em;
   }
 
-  /* 툴 영역 (clear, password toggle 등) */
-  .suffix-items {
-    display: flex;
-    flex-direction: row;
-    align-items: center;
-  }
-  .suffix-items u-icon {
+  /* 아이콘 영역 (clear, password toggle 등) */
+  .icon {
     color: var(--u-icon-color);
     font-size: 1em;
-    margin-left: 0.5em;
     transition: color 0.2s ease;
     cursor: pointer;
   }
-  .suffix-items u-icon:hover {
+  .icon:hover {
     color: var(--u-icon-color-hover);
   }
-  .suffix-items u-icon:active {
+  .icon:active {
     color: var(--u-icon-color-active);
   }
 
+  /* 접두/접미 아이콘 간격 */
+  .icon.prefix {
+    margin-right: 0.5em;
+  }
+  .icon.suffix {
+    margin-left: 0.5em;
+  }
+
   /* 유효성 검사 에러 메시지 */
   .validation-message {
     margin-top: 0.5em;

package/dist/components/menu/UMenu.component.d.ts

@@ -0,0 +1,70 @@
+import { PropertyValues } from 'lit';
+import { BaseElement } from '../BaseElement.js';
+import { FloatingElement } from '../FloatingElement.js';
+import { UMenuItem } from '../menu-item/UMenuItem.component.js';
+export type MenuType = 'default' | 'dropdown' | 'contextmenu' | 'submenu';
+export type MenuMode = 'none' | 'single' | 'multiple';
+type MenuItemFilter = 'all' | 'enabled' | 'disabled' | 'selected' | 'unselected' | 'checked' | 'unchecked';
+/**
+ * Menu 컴포넌트는 드롭다운 메뉴, 컨텍스트 메뉴, 서브메뉴 등을 구현하기 위한 컴포넌트입니다.
+ */
+export declare class UMenu extends FloatingElement {
+    static styles: import('lit').CSSResultGroup[];
+    static dependencies: Record<string, typeof BaseElement>;
+    items?: UMenuItem[];
+    /**
+     * 메뉴 타입
+     * - default: 일반 메뉴 (수동 제어)
+     * - dropdown: 드롭다운 메뉴 (앵커 클릭 시 토글)
+     * - contextmenu: 컨텍스트 메뉴 (앵커 우클릭 시 표시)
+     * - submenu: 서브메뉴 (앵커 호버/포커스 시 표시)
+     */
+    type: MenuType;
+    /**
+     * 메뉴 선택 모드
+     * - none: 액션만 실행, 상태 관리 없음
+     * - single: 하나만 선택 가능
+     * - multiple: 여러 개 선택 가능 (체크박스)
+     */
+    mode: MenuMode;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    render(): import('lit-html').TemplateResult<1>;
+    /**
+     * 특정 인덱스의 아이템에 포커스 (기본: 첫 번째)
+     * @param index 인덱스 (음수 가능)
+     */
+    focusAt: (index?: number) => Promise<void>;
+    /**
+     * 모든 아이템들의 선택 상태를 해제합니다
+     * 재귀적으로 서브메뉴의 아이템들도 해제됩니다.
+     */
+    clearAll(): void;
+    /**
+     * 조건에 맞는 메뉴 아이템들을 반환합니다
+     *
+     * @param filter - 필터 조건입니다
+     * @return 조건에 맞는 아이템들의 배열입니다
+     */
+    getItems(filter?: MenuItemFilter): UMenuItem[];
+    /** 앵커에 이벤트 바인딩 */
+    private bind;
+    /** 앵커에서 이벤트 바인딩 해제 */
+    private unbind;
+    private handleClick;
+    private handleKeydown;
+    private handleWindowFocusOut;
+    private handleWindowKeydown;
+    private handleWindowPointerDown;
+    private handleAnchorPointerEnter;
+    private handleAnchorPointerLeave;
+    private handleAnchorFocusIn;
+    private handleAnchorFocusOut;
+    private handleAnchorPointerDown;
+    private handleAnchorKeydown;
+    private handleAnchorContextMenu;
+    /** 이벤트로부터 활성화된 (비활성화되지 않은) 메뉴 아이템을 반환 */
+    private getEnabledItemFrom;
+}
+export {};