@sellmate/design-system 1.20.0 → 1.21.0

package/dist/esm/sd-loading-container.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, h } from './index-CAxodB5I.js';
+import { r as registerInstance, h } from './index-C7HJ-NfO.js';
 
 const sdLoadingContainerCss = () => `sd-loading-container .sd-loading-container{position:fixed;inset:0;display:flex;align-items:center;justify-content:center;z-index:var(--sd-loading-container-z-index, 999);opacity:0;visibility:hidden;transition:opacity 0.2s ease, visibility 0s linear 0.2s;pointer-events:none}sd-loading-container .sd-loading-container--visible{opacity:1;visibility:visible;transition:opacity 0.2s ease, visibility 0s linear 0s;pointer-events:auto}sd-loading-container .sd-loading-container__backdrop{position:absolute;inset:0;background:rgba(0, 0, 0, 0.4)}sd-loading-container .sd-loading-container__content{position:relative;display:flex;flex-direction:column;align-items:center;gap:16px}sd-loading-container .sd-loading-container__message{margin:0;color:#ffffff;font-size:14px;font-weight:500;line-height:22px;text-align:center;max-width:400px;word-break:keep-all}`;
 
@@ -8,18 +8,20 @@ const SdLoadingContainer = class {
     }
     visible = false;
     message = '';
+    /** 로딩 오버레이를 표시합니다. */
     async show(options = {}) {
         this.message = options.message ?? '';
         this.visible = true;
     }
+    /** 로딩 오버레이를 숨깁니다. */
     async hide() {
         this.visible = false;
     }
     render() {
-        return (h("div", { key: '6525405e4edafd9257be9887cca824a436b2807c', class: {
+        return (h("div", { key: 'b8efbc6422fded2472a6e575c9a7102375f90600', class: {
                 'sd-loading-container': true,
                 'sd-loading-container--visible': this.visible,
-            }, "aria-hidden": this.visible ? 'false' : 'true' }, h("div", { key: 'd5f1e1e3df8b704d4a5dabe8cf7b50cc07a2699a', class: "sd-loading-container__backdrop" }), h("div", { key: '40dce62049e04a997b982ab65b47a755b6e917c7', class: "sd-loading-container__content" }, h("sd-circle-progress", { key: '9cb7a1ed52433f2d0982ceef1a298b1367a99dd4', indeterminate: true, type: "inverse" }), this.message && (h("p", { key: 'bc581b692122ef5553e4e8eb99056b89257eb6d9', class: "sd-loading-container__message" }, this.message)))));
+            }, "aria-hidden": this.visible ? 'false' : 'true' }, h("div", { key: '1ff327157be008e278636d49069945e553c1ecbd', class: "sd-loading-container__backdrop" }), h("div", { key: 'd55d2ab11528e35c04e8dd98f8c10d0f913a536e', class: "sd-loading-container__content" }, h("sd-circle-progress", { key: '29060ee18eb4e5a47bae25462abe11b8d5abfb0c', indeterminate: true, type: "inverse" }), this.message && h("p", { key: 'cf0478da282996ba4f7ecb920d8262181369af8a', class: "sd-loading-container__message" }, this.message))));
     }
 };
 SdLoadingContainer.style = sdLoadingContainerCss();

package/dist/esm/sd-modal-container.entry.js

@@ -1,18 +1,21 @@
-import { r as registerInstance, a as getElement, h } from './index-CAxodB5I.js';
+import { r as registerInstance, a as getElement, h } from './index-C7HJ-NfO.js';
 import { u as unregisterModal, r as registerModal, s as setModalInteractive, i as isTopInteractiveModal, a as requestCloseForModal } from './modal-stack-DRVnqiWc.js';
 
 const sdModalContainerCss = () => `sd-modal-container{display:block}sd-modal-container .sd-modal-container{position:fixed;inset:0;z-index:var(--sd-modal-container-z-index, 997);pointer-events:none}sd-modal-container .sd-modal-container__layer{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;pointer-events:none}sd-modal-container .sd-modal-container__backdrop{position:absolute;inset:0;background:rgba(0, 0, 0, 0.4);opacity:0;transition:opacity 0.3s ease-out;pointer-events:none}sd-modal-container .sd-modal-container__backdrop--visible{opacity:1;pointer-events:auto}sd-modal-container .sd-modal-container__modal{position:relative;z-index:1;opacity:0;transform:scale(0);pointer-events:auto;transition:opacity 0.3s ease-out, transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1)}sd-modal-container .sd-modal-container__modal--visible{opacity:1;transform:scale(1)}sd-modal-container .sd-modal-container__modal--shake{animation:modal-shake 0.3s ease-out}@keyframes modal-shake{0%,100%{transform:scale(1)}25%{transform:scale(1.03)}50%{transform:scale(0.97)}75%{transform:scale(1.01)}}`;
 
 let modalIdCounter = 0;
 const ANIMATION_DURATION = 350;
+const FOCUSABLE_SELECTOR = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])';
 const SdModalContainer = class {
     constructor(hostRef) {
         registerInstance(this, hostRef);
     }
     get el() { return getElement(this); }
+    /** 마지막 모달이 닫힐 때 자신을 DOM에서 제거할지 여부 */
     autoRemove = false;
     entries = [];
     layerRefs = new Map();
+    /** 확인 모달을 열고 모달 ID를 반환합니다. */
     async open(options, modalRef) {
         const id = `modal-${++modalIdCounter}`;
         const modalEl = this.createConfirmModal(id, options);
@@ -27,6 +30,7 @@ const SdModalContainer = class {
         });
         return id;
     }
+    /** 로딩 모달을 열고 모달 ID를 반환합니다. */
     async openLoading(options, modalRef) {
         const id = `modal-${++modalIdCounter}`;
         const modalEl = this.createLoadingModal(id, options);
@@ -41,6 +45,7 @@ const SdModalContainer = class {
         });
         return id;
     }
+    /** 커스텀 엘리먼트를 모달로 등록하고 모달 ID를 반환합니다. */
     async createCustom(element, options, modalRef) {
         const id = `modal-${++modalIdCounter}`;
         element.setAttribute('data-modal-id', id);
@@ -74,6 +79,7 @@ const SdModalContainer = class {
                         return;
                     this.entries = this.entries.map(e => (e.id === id ? { ...e, backdropVisible: true } : e));
                     modalEl.classList.add('sd-modal-container__modal--visible');
+                    this.focusInitialElement(modalEl);
                 });
             });
         }
@@ -85,12 +91,14 @@ const SdModalContainer = class {
             unregisterModal(entry.id);
         }
     }
+    /** 지정한 ID의 모달을 닫습니다. */
     async dismissById(id, reason) {
         const entry = this.entries.find(e => e.id === id);
         if (!entry)
             return;
         this.requestDismiss(id, reason);
     }
+    /** 열려있는 모달의 props를 동적으로 업데이트합니다. */
     async update(id, props) {
         const entry = this.entries.find(e => e.id === id && !e.closing);
         if (!entry)
@@ -103,7 +111,14 @@ const SdModalContainer = class {
         this.applyProps(entry.modalEl, props);
     }
     mountEntry(entry) {
-        this.entries = [...(this.entries ?? []), entry];
+        const activeElement = typeof document !== 'undefined' ? document.activeElement : null;
+        this.entries = [
+            ...(this.entries ?? []),
+            {
+                ...entry,
+                previousActiveElement: activeElement,
+            },
+        ];
         registerModal({
             id: entry.id,
             persistent: entry.persistent,
@@ -161,6 +176,7 @@ const SdModalContainer = class {
             clearTimeout(currentEntry.dismissTimerId);
         currentEntry.modalEl.remove();
         unregisterModal(id);
+        this.restoreFocus(currentEntry.previousActiveElement);
         currentEntry.modalRef._triggerDismissed();
         this.layerRefs.delete(id);
         this.entries = (this.entries ?? []).filter(e => e.id !== id);
@@ -246,6 +262,44 @@ const SdModalContainer = class {
             return;
         requestCloseForModal(id);
     }
+    /**
+     * 모달이 열릴 때 트리거 요소(버튼 등)에 남아 있던 포커스를 모달 내부로
+     * 이동시킨다. 이를 하지 않으면 모달을 연 버튼이 계속 포커스를 가져,
+     * Enter 키를 누를 때마다 트리거가 재실행되어 모달이 중첩으로 쌓인다.
+     */
+    focusInitialElement(modalEl) {
+        const target = this.getInitialFocusTarget(modalEl);
+        target?.focus();
+    }
+    getInitialFocusTarget(modalEl) {
+        const explicit = modalEl.querySelector('[autofocus]');
+        if (explicit)
+            return explicit;
+        // 각 모달 타입의 메인(주요 액션) 버튼에 우선 포커스해 Enter 로 확정 가능하게 한다.
+        // confirm/action/loading 모두 대응한다.
+        const mainButton = modalEl.querySelector([
+            '.sd-confirm-modal__button sd-button:last-of-type button',
+            '.sd-action-modal__footer > sd-button button',
+            '.sd-loading-modal__button sd-button button',
+        ].join(','));
+        if (mainButton)
+            return mainButton;
+        // 그 외(커스텀 모달 등): 헤더의 닫기(X) 버튼을 제외한 첫 포커스 가능 요소.
+        const focusables = Array.from(modalEl.querySelectorAll(FOCUSABLE_SELECTOR));
+        const preferred = focusables.find(el => !el.closest('.sd-action-modal__close, .sd-confirm-modal__close-button'));
+        if (focusables.length > 0)
+            return preferred ?? focusables[0];
+        if (!modalEl.hasAttribute('tabindex'))
+            modalEl.setAttribute('tabindex', '-1');
+        return modalEl;
+    }
+    restoreFocus(previousActiveElement) {
+        if (previousActiveElement &&
+            typeof previousActiveElement.focus === 'function' &&
+            previousActiveElement.isConnected) {
+            previousActiveElement.focus();
+        }
+    }
     shakeModal(modalEl) {
         const cls = 'sd-modal-container__modal--shake';
         modalEl.classList.remove(cls);

package/dist/esm/sd-pagination_4.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, c as createEvent, h, F as Fragment, a as getElement, H as Host } from './index-CAxodB5I.js';
+import { r as registerInstance, c as createEvent, h, F as Fragment, a as getElement, H as Host } from './index-C7HJ-NfO.js';
 import { T as TABLE_ID_ATTR } from './constants-sZMi_32I.js';
 import { a as TABLE_SELECTABLE_COLUMN_WIDTH, r as resolveTableIconColor, e as resolveSortIconName, c as TABLE_BORDER, f as TABLE_HEADER_RESIZING_BAR, g as TABLE_HEADER_TYPOGRAPHY, h as TABLE_HEADER_COLORS, i as TABLE_HEADER_LAYOUT, T as TABLE_BODY_LAYOUT, j as TABLE_SEPARATOR, b as TABLE_BODY_TYPOGRAPHY } from './sd-table.config-B3wuA5wX.js';
 import './component.table-D6GUzecR.js';
@@ -78,9 +78,13 @@ const SdPagination = class {
         registerInstance(this, hostRef);
         this.pageChange = createEvent(this, "sdPageChange", 7);
     }
+    /** 현재 페이지 번호 */
     currentPage = 1;
+    /** 마지막 페이지 번호 */
     lastPage = 1;
+    /** true이면 현재/마지막 페이지만 표시하는 단순 모드 */
     simple = false;
+    /** 페이지가 변경될 때 새 페이지 번호를 전달합니다. */
     pageChange;
     get pageNumbers() {
         const start = Math.floor((this.currentPage - 1) / PER_PAGE) * PER_PAGE + 1;
@@ -152,13 +156,13 @@ const SdPagination = class {
             '--sd-pagination-bg-selected': PAGINATION_COLORS.bgSelected,
             '--sd-pagination-item-width': `${this.buttonWidth}px`,
         };
-        return (h("div", { key: '8a2219bbc3a17951ed66501e7246f230f0495e74', class: {
+        return (h("div", { key: '733bf7952c4e38a65a1042c6a8784d6502c81667', class: {
                 'sd-pagination': true,
                 'sd-pagination--simple': this.simple,
-            }, style: cssVars }, h("div", { key: '7e9ddb98aff7506fc3b6053d84c1be211e3d1ff7', class: "sd-pagination__group sd-pagination__group--prev" }, this.renderPrevButtons()), this.simple ? (h("div", { class: "sd-pagination__info" }, h("span", { class: "sd-pagination__current" }, this.currentPage), h("span", { class: "sd-pagination__divider" }, "/"), h("span", { class: "sd-pagination__last" }, this.lastPage))) : (h("div", { class: "sd-pagination__numbers" }, this.pageNumbers.map(n => (h("button", { type: "button", "aria-current": this.currentPage === n ? 'page' : undefined, class: {
+            }, style: cssVars }, h("div", { key: '4c23bdfb9a58950a04107fc4b4c921bbafa4e601', class: "sd-pagination__group sd-pagination__group--prev" }, this.renderPrevButtons()), this.simple ? (h("div", { class: "sd-pagination__info" }, h("span", { class: "sd-pagination__current" }, this.currentPage), h("span", { class: "sd-pagination__divider" }, "/"), h("span", { class: "sd-pagination__last" }, this.lastPage))) : (h("div", { class: "sd-pagination__numbers" }, this.pageNumbers.map(n => (h("button", { type: "button", "aria-current": this.currentPage === n ? 'page' : undefined, class: {
                 'sd-pagination__item': true,
                 'sd-pagination__item--selected': this.currentPage === n,
-            }, onClick: () => this.handlePageChange(n) }, n))))), h("div", { key: '937554ea8d3ae71da85e2c1f49d82c99658141f0', class: "sd-pagination__group sd-pagination__group--next" }, this.renderNextButtons())));
+            }, onClick: () => this.handlePageChange(n) }, n))))), h("div", { key: 'a0406c1f9cd13970d47f25ed88095ac1c684203c', class: "sd-pagination__group sd-pagination__group--next" }, this.renderNextButtons())));
     }
 };
 SdPagination.style = sdPaginationCss();
@@ -170,6 +174,7 @@ const SdTbody = class {
         registerInstance(this, hostRef);
     }
     get el() { return getElement(this); }
+    /** 렌더링할 행 데이터 목록 */
     rows = [];
     tableId = '';
     topSpacerHeight = 0;
@@ -213,9 +218,9 @@ const SdTbody = class {
         }
     }
     render() {
-        return (h(Host, { key: 'ae49b4a7e18afd3d44d07e7da6c3663a6a043796', slot: `${this.tableId}-body` }, h("tbody", { key: '7275cf9214f6917c5437b8a72a06cde3ca48dc8c', class: { tbody: true } }, [
+        return (h(Host, { key: '0f85168b22221551714f3c75bd12c366538cc5ec', slot: `${this.tableId}-body` }, h("tbody", { key: 'f9a8528d40c51988cfbca2c349905dafdafce8d3', class: { tbody: true } }, [
             this.topSpacerHeight > 0 && (h("tr", { key: "spacer-top", class: "tbody__spacer", style: { height: `${this.topSpacerHeight}px`, display: 'block' } })),
-            h("slot", { key: '6455be878c24df5371e094fbfe9687ddb992e0e6' }),
+            h("slot", { key: '7ecfe2f730b4c909d394fdee2d9aa015c5410cb4' }),
             this.bottomSpacerHeight > 0 && (h("tr", { key: "spacer-bottom", class: "tbody__spacer", style: { height: `${this.bottomSpacerHeight}px`, display: 'block' } })),
         ])));
     }
@@ -235,15 +240,25 @@ const SdThead = class {
         this.sdColumnSort = createEvent(this, "sdColumnSort", 7);
     }
     get el() { return getElement(this); }
+    /** 테이블 컬럼 목록 */
     columns;
+    /** 행 선택 기능 사용 여부 */
     selectable;
+    /** 컬럼 너비 조절 가능 여부 */
     resizable;
+    /** 고정 컬럼 설정 */
     stickyColumn;
+    /** 헤더 고정 여부 */
     stickyHeader;
+    /** 좌측 스크롤 여부 */
     scrolledLeft;
+    /** 우측 스크롤 여부 */
     scrolledRight;
+    /** 전체 선택 체크박스용 행 데이터 */
     rows = [];
+    /** 컬럼 너비 목록 */
     columnWidths = [];
+    /** 컬럼 정렬 버튼 클릭 시 발생합니다. */
     sdColumnSort;
     tableId = '';
     _columns = [];
@@ -309,12 +324,15 @@ const SdThead = class {
             this.columnWidths = [];
         }
     }
+    /** 테이블 설정을 다시 불러옵니다. */
     async refreshConfig() {
         this.resolveConfig();
     }
+    /** 컬럼 너비를 업데이트합니다. */
     async setColumnWidths(widths) {
         this.columnWidths = Array.isArray(widths) ? widths : [];
     }
+    /** 전체 선택 체크박스 상태를 갱신합니다. */
     async refreshSelection() {
         const checkbox = this.el.querySelector('sd-checkbox');
         if (checkbox) {
@@ -390,16 +408,16 @@ const SdThead = class {
             '--table-border-color': TABLE_BORDER.color,
             '--table-border-width': `${TABLE_BORDER.width}px`,
         };
-        return (h(Host, { key: 'c25f6f9704c079d4cb93da7e65c8c15b6dedcb67', slot: `${this.tableId}-head`, style: headStyle }, h("thead", { key: 'd91019378caafa2ec32dfa838eaa4d1fe815fb0d', class: {
+        return (h(Host, { key: '26981191de95775401cad61e80fbf1e22cb0250b', slot: `${this.tableId}-head`, style: headStyle }, h("thead", { key: 'a53d430f1b71a45b98de2912b563d3f17cd20b24', class: {
                 'thead': true,
                 'thead--sticky': this._stickyHeader,
-            } }, h("tr", { key: '84e581f5c564693d356f56525f57d6b1da211442', class: "tr" }, this._selectable && (h("th", { key: 'fb92e978229c32d560f46af4e90e0980c9c0a213', class: {
+            } }, h("tr", { key: '27ce13b70bfda4b210b36eb746fb60d369d9f5be', class: "tr" }, this._selectable && (h("th", { key: 'e353b00c7a02b82781e5107b1fd73dc556427edf', class: {
                 'th': true,
                 'th--selected': true,
                 'sticky-left': true,
                 'sticky-left-edge': stickyLeftCount === 0,
                 'is-scrolled-left': stickyLeftCount === 0 && this._scrolledLeft,
-            }, style: { '--sticky-left-offset': '0px' } }, h("sd-checkbox", { key: '157f59b56a4ef2a8529318c8beaf6f59b91e12f0', value: this.getIsAllChecked(), disabled: safeRows.length === 0, onSdUpdate: (e) => this.handleSelectAll(e.detail) }), h("div", { key: 'b65e099ebe4940b26cc251961e66a375400f2379', class: "th__bar" }))), stickyLeftCols.map((col, idx) => (h("th", { key: col.name, class: {
+            }, style: { '--sticky-left-offset': '0px' } }, h("sd-checkbox", { key: '18eeabbcc4fc10196d6448bd9d0493b55778f9f1', value: this.getIsAllChecked(), disabled: safeRows.length === 0, onSdUpdate: (e) => this.handleSelectAll(e.detail) }), h("div", { key: '1a5a0561fc94be53a8244827ac9ae4f98fa766c2', class: "th__bar" }))), stickyLeftCols.map((col, idx) => (h("th", { key: col.name, class: {
                 'th': true,
                 [`${col.thClass}`]: Boolean(col.thClass),
                 'sticky-left': true,
@@ -446,11 +464,17 @@ const SdTr = class {
         registerInstance(this, hostRef);
     }
     get el() { return getElement(this); }
+    /** 테이블 컬럼 목록 */
     columns;
+    /** 행 선택 기능 사용 여부 */
     selectable;
+    /** 고정 컬럼 설정 */
     stickyColumn;
+    /** 행 식별 키 */
     rowKey = '';
+    /** 행 데이터 객체 */
     row = {};
+    /** 구분선 높이 (4 또는 6px, null이면 일반 행) */
     separator = null;
     tableId = '';
     columnWidths = [];
@@ -503,12 +527,15 @@ const SdTr = class {
             this.columnWidths = [...config.columnWidths];
         }
     }
+    /** 테이블 설정을 다시 불러옵니다. */
     async refreshConfig() {
         this.resolveConfig();
     }
+    /** 셀 병합 버전을 갱신해 td를 재렌더링합니다. */
     async bumpSpansVersion() {
         this.spansVersion = this.spansVersion + 1;
     }
+    /** 페이지네이션에 따른 행 표시 여부를 갱신합니다. */
     async updateVisibility() {
         this.updateVisibilitySync();
     }
@@ -521,9 +548,11 @@ const SdTr = class {
         }
         this.isVisible = rowIndex >= pageInfo.startIndex && rowIndex < pageInfo.endIndex;
     }
+    /** 컬럼 너비를 업데이트합니다. */
     async setColumnWidths(widths) {
         this.columnWidths = widths;
     }
+    /** 체크박스 선택 상태를 갱신합니다. */
     async refreshSelection() {
         const checkbox = this.el.querySelector('sd-checkbox');
         if (checkbox) {

package/dist/esm/sd-popover.entry.js

@@ -1,5 +1,5 @@
-import { r as registerInstance, c as createEvent, a as getElement, h, F as Fragment } from './index-CAxodB5I.js';
-import { T as TooltipArrow } from './tooltipArrow-DLr6VvUK.js';
+import { r as registerInstance, c as createEvent, a as getElement, h, F as Fragment } from './index-C7HJ-NfO.js';
+import { T as TooltipArrow } from './tooltipArrow-Bgf3crs7.js';
 
 const popover = {
 	"default": {
@@ -16,22 +16,38 @@ const SdPopover = class {
         this.showChange = createEvent(this, "sdShowChange", 7);
     }
     get el() { return getElement(this); }
+    /** 팝오버 표시 여부 */
     show = false;
+    /** 팝오버를 표시할 방향 */
     placement = 'bottom';
+    /** 아이콘 트리거 색상 */
     color = '#01BB4B';
+    /** 아이콘 트리거 아이콘명 */
     icon = 'helpOutline';
+    /** 아이콘 트리거 크기 */
     iconSize = 12;
+    /** 버튼 트리거 레이블 (있으면 아이콘 대신 버튼 렌더링) */
     label = '';
+    /** 버튼 트리거 프리셋 */
     name = 'primary_sm';
+    /** 버튼 트리거 우측 아이콘 */
     rightIcon;
+    /** 스크린리더용 접근성 레이블 */
     ariaLabel = '';
+    /** 비활성 상태 여부 */
     disabled = false;
+    /** 버튼 type 속성 */
     type = 'button';
+    /** 팝오버 메뉴 제목 */
     menuTitle;
+    /** 팝오버 하단 좌측 링크 옵션 */
     leftLink;
+    /** 팝오버 하단 버튼 옵션 */
     button;
+    /** 팝오버 메뉴에 추가할 클래스 */
     menuClass = '';
     slotContentHTML = '';
+    /** 팝오버 표시 상태가 바뀔 때 발생합니다. */
     showChange;
     buttonEl;
     setShow = (next) => {
@@ -66,17 +82,17 @@ const SdPopover = class {
         const leftLink = this.leftLink;
         const button = this.button;
         const hasFooter = !!leftLink || !!button;
-        return (h(Fragment, { key: '649e07ee45d3e7e5f72a438ef2939bfe6d3c56e4' }, this.label !== '' ? (h("sd-button", { ref: el => (this.buttonEl = el), name: this.name ?? 'primary_sm', label: this.label, icon: icon, rightIcon: this.rightIcon, ariaLabel: this.ariaLabel || this.label || icon || 'Open popover', disabled: this.disabled, type: this.type ?? 'button', class: "sd-popover", onSdClick: () => this.setShow(!this.show) })) : (h("sd-icon", { ref: el => (this.buttonEl = el), name: icon, size: iconSize, color: color, class: "sd-popover", onClick: () => this.setShow(!this.show) })), this.show && (h("sd-floating-portal", { key: '486d1859387b0c8cc82646ab5e7b6800792ca2be', parentRef: this.buttonEl, onSdClose: this.handleClose, placement: placement, offset: this.popoverOffset }, h("div", { key: '4418e064c76478a5b4dfd2fb69d11e1603a22530', class: {
+        return (h(Fragment, { key: '94fcf54c8b20ffd1bcf2c7f540de31e1f41154fa' }, this.label !== '' ? (h("sd-button", { ref: el => (this.buttonEl = el), name: this.name ?? 'primary_sm', label: this.label, icon: icon, rightIcon: this.rightIcon, ariaLabel: this.ariaLabel || this.label || icon || 'Open popover', disabled: this.disabled, type: this.type ?? 'button', class: "sd-popover", onSdClick: () => this.setShow(!this.show) })) : (h("sd-icon", { ref: el => (this.buttonEl = el), name: icon, size: iconSize, color: color, class: "sd-popover", onClick: () => this.setShow(!this.show) })), this.show && (h("sd-floating-portal", { key: '9f1585f2d268452f3d5c713e30ff865c3fc5fbac', parentRef: this.buttonEl, onSdClose: this.handleClose, placement: placement, offset: this.popoverOffset }, h("div", { key: '2cd2103f56c45364df5db9b73a2d89447b7c2bcc', class: {
                 'sd-floating-menu': true,
                 'sd-floating-menu--popover': true,
                 [`sd-floating-menu--${placement}`]: true,
                 [menuClass]: menuClass !== '',
             }, style: {
                 '--sd-floating-bg': popoverTokens.popover.default.bg,
-            } }, h("i", { key: 'a181ce40ae957e77be7c8f9b10e6f1fe8190cd52', class: `sd-floating-menu__arrow sd-floating-menu__arrow--${placement}` }, h(TooltipArrow, { key: '323bca17c3c245063cbd1ac55ed64bf6f6df9e3e' })), h("div", { key: '06e98cf6e888dc66a6a700710669c61ac9d9c494', class: "sd-floating-menu__content" }, this.menuTitle && h("div", { key: '831ca9893ccafcad8e0858fb28269428ebac6a07', class: "sd-floating-menu__title" }, this.menuTitle), this.slotContentHTML && (h("div", { key: 'cdd2eafe18d5b0b44f10dbebbb68ed9d010173b1', class: "sd-floating-menu__messages", innerHTML: this.slotContentHTML })), hasFooter && (h("div", { key: '8149044a08de968ef38f432ee3303d969b49eace', class: {
+            } }, h("i", { key: '5fd6c333790d3bb45bf4d43391ed1457d5eb54c3', class: `sd-floating-menu__arrow sd-floating-menu__arrow--${placement}` }, h(TooltipArrow, { key: '062b11e3b6cee1e87f20064ab62a589a23f3eb26' })), h("div", { key: 'b863abd8e31c8ce0dfddfdb25b6a49be69f34da1', class: "sd-floating-menu__content" }, this.menuTitle && h("div", { key: '1873c595d7ad91b3a7c71d979414820694c23ff5', class: "sd-floating-menu__title" }, this.menuTitle), this.slotContentHTML && (h("div", { key: '7a197b43d34a59ec298ed5e733cae0f3390c87a3', class: "sd-floating-menu__messages", innerHTML: this.slotContentHTML })), hasFooter && (h("div", { key: 'be9034b4150421be08c17978beba643e73c5568d', class: {
                 'sd-floating-menu__buttons': true,
                 'sd-floating-menu__buttons--with-link': !!leftLink,
-            } }, leftLink && (h("sd-text-link", { key: '4c7e9c2b4fe8664b3af375a3c89b1cd50d64a9c3', class: "sd-floating-menu__left-link", label: leftLink.label, icon: leftLink.icon ?? '', iconColor: leftLink.iconColor ?? '', rightArrow: leftLink.rightArrow ?? 'none', underline: !!leftLink.underline, disabled: !!leftLink.disabled, onSdClick: leftLink.onClick })), button && (h("sd-button", { key: '730d867339257f168c11d7d1417c9d28a408f462', name: button.name ?? 'secondary_xs', label: button.label, icon: button.icon, rightIcon: button.rightIcon, ariaLabel: button.ariaLabel || button.label || button.icon || 'Open popover', disabled: button.disabled, type: button.type, onSdClick: button.onClick }))))), h("sd-ghost-button", { key: '7a1f2edf0a601c0dfa91b4a02405c815d3257214', class: "sd-floating-menu__close-button", icon: "close", ariaLabel: "close", size: "xs", onClick: this.handleClose }))))));
+            } }, leftLink && (h("sd-text-link", { key: '890a163609b8544450ad1b8c009648d73ef0d269', class: "sd-floating-menu__left-link", label: leftLink.label, icon: leftLink.icon ?? '', iconColor: leftLink.iconColor ?? '', rightArrow: leftLink.rightArrow ?? 'none', underline: !!leftLink.underline, disabled: !!leftLink.disabled, onSdClick: leftLink.onClick })), button && (h("sd-button", { key: '128270add7ea99f7c9f61abe9f2a113f152465d8', name: button.name ?? 'secondary_xs', label: button.label, icon: button.icon, rightIcon: button.rightIcon, ariaLabel: button.ariaLabel || button.label || button.icon || 'Open popover', disabled: button.disabled, type: button.type, onSdClick: button.onClick }))))), h("sd-ghost-button", { key: 'bc4c4d982da8fe72c85cd4ae7ba6cd2e09154164', class: "sd-floating-menu__close-button", icon: "close", ariaLabel: "close", size: "xs", onClick: this.handleClose }))))));
     }
 };
 SdPopover.style = sdPopoverCss();

package/dist/esm/sd-popup.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, c as createEvent, h } from './index-CAxodB5I.js';
+import { r as registerInstance, c as createEvent, h } from './index-C7HJ-NfO.js';
 import { s as systemTokens } from './system-BJfiMC9H.js';
 
 const popup$1 = {
@@ -72,12 +72,16 @@ const SdPopup = class {
         registerInstance(this, hostRef);
         this.submit = createEvent(this, "sdSubmit", 7);
     }
+    /** 팝업 헤더에 표시할 제목 */
     popupTitle = '';
+    /** 팝업 타입 */
     type = 'default';
     // 기본 footer 표시가 자연스러운 UX. prop 이름 변경(hideFooter 등)은 public API breaking 이라 별도 이슈로 분리.
-    // eslint-disable-next-line stencil/ban-default-true
+    /** 하단 footer 영역 표시 여부 */
     useFooter = true;
+    /** 확인 버튼 커스텀 props */
     submitButtonProps;
+    /** 확인 버튼 클릭 시 발생합니다. */
     submit;
     render() {
         const cssVars = {
@@ -103,7 +107,7 @@ const SdPopup = class {
             ...DEFAULT_SUBMIT_BUTTON_PROPS,
             ...this.submitButtonProps,
         };
-        return (h("div", { key: 'fd14b75d27d3006978ceae9287486d9716bbbf5a', class: `sd-popup sd-popup--${this.type}`, style: cssVars }, h("header", { key: 'ac0222dc9512b99cd1d1b4684b9775cd462f39fa', class: "sd-popup__header" }, h("h2", { key: 'a11bea9fac5828161090d09d06d6e1c54c390392', class: "sd-popup__title" }, this.popupTitle)), h("div", { key: 'ced8961a853cdf014d602c235cfc839a648fb19e', class: "sd-popup__body" }, h("slot", { key: '142807fd74e8b32a31ffb7ed8f3dfdcb07a6a1ba' })), this.useFooter && (h("footer", { key: '35a6b42e82ec13890b4fa56bda5b9781adeff229', class: "sd-popup__footer" }, h("div", { key: '44b2471e0f302bd001fdf1e1d72485dff4af094f', class: "sd-popup__footer-slot sd-popup__footer-slot--left" }, h("slot", { key: 'd1c8e29b60eb7ce86639e336c99a48a67437103a', name: "footer-left" })), h("sd-button", { key: '67b0a8530cae73e344cdae2ac0cb48fa3bdf4827', ...submitButtonProps, class: "sd-popup__submit", onSdClick: () => this.submit.emit() })))));
+        return (h("div", { key: '4455120f02fc1df1b1661062a22f3d82508627c4', class: `sd-popup sd-popup--${this.type}`, style: cssVars }, h("header", { key: '96a5e7cdc21fa239e4275f4b57379f36246048f4', class: "sd-popup__header" }, h("h2", { key: 'cdf8d05561f470fef31c46e6508e1e0c41aa7fa9', class: "sd-popup__title" }, this.popupTitle)), h("div", { key: 'ddb32332f8822634f544f2fa5a246c5f37c7fcc2', class: "sd-popup__body" }, h("slot", { key: '8f36daf8c918da6babcbb4383957e979930bfd73' })), this.useFooter && (h("footer", { key: '2b84ed134a8d53633bb4feb7ab423e58955dfdae', class: "sd-popup__footer" }, h("div", { key: '95e55875b38102ff809e752a3cc647dc830699a9', class: "sd-popup__footer-slot sd-popup__footer-slot--left" }, h("slot", { key: 'fbd86c77e1117018793279c9b90fd8e2f6db4934', name: "footer-left" })), h("sd-button", { key: 'e8710c15d20e52d0476e7f656e800cda008187d8', ...submitButtonProps, class: "sd-popup__submit", onSdClick: () => this.submit.emit() })))));
     }
 };
 SdPopup.style = sdPopupCss();

package/dist/esm/sd-radio-button.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, c as createEvent, h } from './index-CAxodB5I.js';
+import { r as registerInstance, c as createEvent, h } from './index-C7HJ-NfO.js';
 
 const radioButton = {
 	xs: {
@@ -102,11 +102,17 @@ const SdRadioButton = class {
         registerInstance(this, hostRef);
         this.change = createEvent(this, "sdUpdate", 7);
     }
+    /** 현재 선택된 값 */
     value;
+    /** 라디오 버튼 옵션 목록 */
     options = [];
+    /** 버튼 크기 */
     size = 'sm';
+    /** 비활성 상태 여부 */
     disabled = false;
+    /** input name 속성 (없으면 자동 생성) */
     name;
+    /** 선택 값이 변경될 때 발생합니다. */
     change;
     componentWillLoad() {
         this.size ??= 'sm';
@@ -176,7 +182,7 @@ const SdRadioButton = class {
             '--sd-radio-button-content-select': RADIO_BUTTON_COLORS.content.select,
             '--sd-radio-button-content-disabled': RADIO_BUTTON_COLORS.content.disabled,
         };
-        return (h("div", { key: 'b916d790862409f8b8e1da566f049daadfc4e5e2', class: this.getGroupClasses(), style: cssVars, role: "radiogroup", "aria-disabled": this.disabled.toString() }, this.options.map(option => {
+        return (h("div", { key: 'c0ed4c6927bd32a7335e003856de4b43ead97b1c', class: this.getGroupClasses(), style: cssVars, role: "radiogroup", "aria-disabled": this.disabled.toString() }, this.options.map(option => {
             const isSelected = this.isOptionSelected(option);
             const isDisabled = this.isOptionDisabled(option);
             return (h("label", { key: `radio-${option.value}`, class: this.getButtonClasses(option), "aria-label": option.label || 'radio option', "data-label": option.label }, h("input", { type: "radio", name: this.groupName, value: option.value.toString(), checked: isSelected, disabled: isDisabled, onInput: () => this.handleRadioChange(option.value, option.disabled) }), option.label && h("span", { class: "sd-radio-button__label" }, option.label)));

package/dist/esm/sd-radio.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, c as createEvent, h } from './index-CAxodB5I.js';
+import { r as registerInstance, c as createEvent, h } from './index-C7HJ-NfO.js';
 
 const radio = {
 	size: "16",
@@ -82,10 +82,15 @@ const SdRadio = class {
         registerInstance(this, hostRef);
         this.update = createEvent(this, "sdUpdate", 7);
     }
+    /** 라디오 그룹의 현재 선택 값 */
     value;
+    /** 이 라디오 아이템의 값 */
     val;
+    /** 비활성 상태 여부 */
     disabled = false;
+    /** 표시할 라벨 텍스트 */
     label;
+    /** 선택 값이 변경될 때 발생합니다. */
     update;
     valueChanged(newValue) {
         this.value = newValue;
@@ -128,7 +133,7 @@ const SdRadio = class {
             '--sd-radio-label-color': RADIO_COLORS.label.default,
             '--sd-radio-label-disabled-color': RADIO_COLORS.label.disabled,
         };
-        return (h("label", { key: 'f403a1fd88109a6907cc37b03b35fe5a7bbafdfb', class: this.radioClasses, style: cssVars, "aria-checked": this.isSelected ? 'true' : 'false', "aria-disabled": this.disabled ? 'true' : 'false' }, h("input", { key: 'ba8c105d6d52bc4452e1b9614f42dfa2d99221e1', type: "radio", name: String(this.val), value: String(this.val), checked: this.isSelected, disabled: this.disabled, "aria-label": this.label || String(this.val), onInput: this.handleRadioChange }), h("span", { key: 'd92352c59bf7f144a68decd3652dc7208b813a0e', class: "sd-radio__circle" }), this.label && (h("span", { key: 'bc0b1384dee0b22efec56249edc88184a96c6efe', class: "sd-radio__label", "data-label": this.label }, this.label))));
+        return (h("label", { key: 'f220a45add2be550bc696cd2442b8520ea0143f0', class: this.radioClasses, style: cssVars, "aria-checked": this.isSelected ? 'true' : 'false', "aria-disabled": this.disabled ? 'true' : 'false' }, h("input", { key: '64692f5bf49783f166be9327877a474816a556ca', type: "radio", name: String(this.val), value: String(this.val), checked: this.isSelected, disabled: this.disabled, "aria-label": this.label || String(this.val), onInput: this.handleRadioChange }), h("span", { key: '3c30268adcbd735857b4163ecba444b5a57cba08', class: "sd-radio__circle" }), this.label && (h("span", { key: 'b641086ab4ff9161ba4fb733b87c751b6863fe06', class: "sd-radio__label", "data-label": this.label }, this.label))));
     }
     static get watchers() { return {
         "value": [{

package/dist/esm/sd-select-list-item_2.entry.js

@@ -1,4 +1,4 @@
-import { r as registerInstance, c as createEvent, h } from './index-CAxodB5I.js';
+import { r as registerInstance, c as createEvent, h } from './index-C7HJ-NfO.js';
 import { g as LIST_ITEM_LAYOUT, i as isHtmlLabel, h as LIST_ITEM_TYPOGRAPHY, j as LIST_ITEM_COLORS, k as SEARCH_DEBOUNCE_MS } from './sd-select.config-D6ktrl7E.js';
 import { s as sanitizeInlineHtml } from './sanitize-inline-html-BE4tnQ2Z.js';
 import './component.listItem-U8VaRj9c.js';
@@ -10,12 +10,19 @@ const SdSelectListItem = class {
         registerInstance(this, hostRef);
         this.listItemClick = createEvent(this, "sdListItemClick", 7);
     }
+    /** 렌더링할 옵션 데이터 */
     option;
+    /** 계층 깊이 (1~3) */
     depth = 1;
+    /** 선택 상태 (null=중간) */
     isSelected = false;
+    /** 키보드 포커스 상태 여부 */
     isFocused = false;
+    /** 체크박스 표시 여부 */
     useCheckbox = false;
+    /** 다중 선택 시 (선택/전체) 카운트 */
     countInfo;
+    /** 항목 클릭 시 발생합니다. */
     listItemClick;
     get isGroup() {
         return !!this.option.children;
@@ -79,7 +86,7 @@ const SdSelectListItem = class {
         return (
         // 키보드 네비게이션은 부모 listbox 의 ArrowUp/Down + Enter 가 담당. 항목 자체는 role=option, tabindex=-1 으로 표시.
         // eslint-disable-next-line jsx-a11y/click-events-have-key-events
-        h("div", { key: '4322a04d65e4b2e1d82d0a6b09fdf6a57cce79ca', role: "option", tabindex: -1, "aria-selected": this.isSelected === true ? 'true' : 'false', class: {
+        h("div", { key: '7717c82ea9f36bd44bf8a19d16ba7df6441f6715', role: "option", tabindex: -1, "aria-selected": this.isSelected === true ? 'true' : 'false', class: {
                 'sd-select-list-item': true,
                 'sd-select-list-item--group': isGroup,
                 'sd-select-list-item--depth1-group': isDepth1Group,
@@ -89,7 +96,7 @@ const SdSelectListItem = class {
                 'sd-select-list-item--focused': this.isFocused,
                 'sd-select-list-item--selectable': this.isSelectable && !this.option.disabled,
                 'sd-select-list-item--disabled': !!this.option.disabled,
-            }, style: cssVars, onClick: this.handleClick }, this.useCheckbox && (h("sd-checkbox", { key: '47ae4bbe3c2fd960dcee0f1157ae8003dc45f205', value: this.isSelected === null ? null : !!this.isSelected, disabled: this.option.disabled, inverse: this.isFocused && this.isSelected !== false, class: "sd-select-list-item__checkbox", onClick: this.handleCheckboxClick, onSdUpdate: this.handleCheckboxUpdate })), isHtmlLabel(this.option.label) ? (h("span", { class: "sd-select-list-item__label", ref: el => el && (el.innerHTML = sanitizeInlineHtml(this.option.label)) })) : (h("span", { class: "sd-select-list-item__label" }, this.option.label)), this.countInfo && (h("span", { key: 'c89ba1e3ef52a1809d1252aaee5a18c40ff7cd61', class: "sd-select-list-item__count" }, "(", this.countInfo.selected, "/", this.countInfo.total, ")"))));
+            }, style: cssVars, onClick: this.handleClick }, this.useCheckbox && (h("sd-checkbox", { key: '68d8c03d580fc2c411ee4fba917207705f3cf2d2', value: this.isSelected === null ? null : !!this.isSelected, disabled: this.option.disabled, inverse: this.isFocused && this.isSelected !== false, class: "sd-select-list-item__checkbox", onClick: this.handleCheckboxClick, onSdUpdate: this.handleCheckboxUpdate })), isHtmlLabel(this.option.label) ? (h("span", { class: "sd-select-list-item__label", ref: el => el && (el.innerHTML = sanitizeInlineHtml(this.option.label)) })) : (h("span", { class: "sd-select-list-item__label" }, this.option.label)), this.countInfo && (h("span", { key: '56ae08c55215a3970df99ecd74549ded5667265c', class: "sd-select-list-item__count" }, "(", this.countInfo.selected, "/", this.countInfo.total, ")"))));
     }
 };
 SdSelectListItem.style = sdSelectListItemCss();
@@ -102,9 +109,12 @@ const SdSelectListItemSearch = class {
         this.searchFilter = createEvent(this, "sdSearchFilter", 7);
         this.searchFocus = createEvent(this, "sdSearchFocus", 7);
     }
+    /** 리스트가 스크롤된 상태 여부 (그림자 효과용) */
     isScrolled = false;
     searchText = '';
+    /** 검색어가 변경될 때 발생합니다. */
     searchFilter;
+    /** 검색 입력에 포커스될 때 발생합니다. */
     searchFocus;
     inputEl;
     debounceTimer;
@@ -116,6 +126,7 @@ const SdSelectListItemSearch = class {
             });
         });
     }
+    /** 검색 입력에 포커스를 이동합니다. */
     async sdFocus() {
         this.inputEl?.focus();
     }
@@ -142,15 +153,15 @@ const SdSelectListItemSearch = class {
             clearTimeout(this.debounceTimer);
     }
     render() {
-        return (h("div", { key: '94215143f5e47887943c726147739cdb1a9fcbf7', class: {
+        return (h("div", { key: 'fed1a43f1901d23c7c007a4597b95970c0aad4ad', class: {
                 'sd-select-list-item-search': true,
                 'sd-select-list-item-search--scrolled': this.isScrolled,
-            } }, h("div", { key: '0ff422b93d0e15f2425ef760706ae0e6e2cb79f6', class: "sd-select-list-item-search__inner" }, h("sd-icon", { key: 'cc3468339c8b76103b67182309fa3aa2baf24380', name: "search", size: 16, color: "grey_70", class: "sd-select-list-item-search__icon" }), h("input", { key: 'acc468ede845d0f5890c7908311443ea2aa156cf', ref: el => {
+            } }, h("div", { key: '23b278a4b40b7b8506a13f284b3759b96b613b99', class: "sd-select-list-item-search__inner" }, h("sd-icon", { key: '2150f73e1f20f05a28407b984977f7e91131217e', name: "search", size: 16, color: "grey_70", class: "sd-select-list-item-search__icon" }), h("input", { key: '7dc4470ea57b54ebc5f3313f6e22d100f4cc4591', ref: el => {
                 this.inputEl = el;
-            }, type: "text", class: "sd-select-list-item-search__input", placeholder: "\uAC80\uC0C9\uC5B4 \uC785\uB825", value: this.searchText, onInput: this.handleInput, onFocus: () => this.searchFocus.emit() }), h("button", { key: 'b1f1539aea4eb76458794dcb041e53c7af7b91e2', type: "button", class: {
+            }, type: "text", class: "sd-select-list-item-search__input", placeholder: "\uAC80\uC0C9\uC5B4 \uC785\uB825", value: this.searchText, onInput: this.handleInput, onFocus: () => this.searchFocus.emit() }), h("button", { key: '60a363380da8689baa1e9e20b075df749846137a', type: "button", class: {
                 'sd-select-list-item-search__clear': true,
                 'sd-select-list-item-search__clear--hidden': this.searchText === '',
-            }, onClick: this.handleClear, tabindex: this.searchText !== '' ? 0 : -1, "aria-hidden": this.searchText !== '' ? 'false' : 'true' }, h("sd-icon", { key: 'a137986e0c801a6cf95e279edeb6a9b21cf00170', name: "close", size: 12, color: "#888888" })))));
+            }, onClick: this.handleClear, tabindex: this.searchText !== '' ? 0 : -1, "aria-hidden": this.searchText !== '' ? 'false' : 'true' }, h("sd-icon", { key: '7b27eb444864674578f97eaa374d1e9af486f97a', name: "close", size: 12, color: "#888888" })))));
     }
 };
 SdSelectListItemSearch.style = sdSelectListItemSearchCss();