@sellmate/design-system 1.20.1 → 1.21.0

package/dist/types/components/sd-field/sd-field.d.ts

@@ -4,24 +4,43 @@ import { SdTooltipProps } from '../sd-tooltip/sd-tooltip.config';
 import { type FieldAddonAlign, type FieldSize } from './sd-field.config';
 export declare class SdField implements ValidatableField {
     el: HTMLElement;
+    /** 폼 연동용 name 속성 */
     name: string;
+    /** 유효성 검사 규칙 목록 */
     rules?: Rule[];
+    /** 에러 상태 여부 */
     error?: boolean;
+    /** 비활성 상태 여부 */
     disabled?: boolean;
+    /** 읽기 전용 여부 */
     readonly?: boolean;
+    /** 호버 상태 여부 */
     hovered?: boolean;
+    /** 포커스 상태 여부 */
     focused?: boolean;
+    /** 필드 상태 (없으면 rules 결과로 자동 결정) */
     status?: 'default' | 'pass' | 'error';
+    /** 필드 하단 힌트 텍스트 */
     hint: string;
+    /** 에러 메시지 */
     errorMessage: string;
+    /** 필드 너비 (숫자면 px, 문자열이면 그대로 적용) */
     width: string | number;
+    /** 필드 크기 */
     size: FieldSize;
+    /** 레이블 텍스트 */
     label: string;
+    /** 레이블 너비 */
     labelWidth: string | number;
+    /** 필드 우측 어드온 레이블 */
     addonLabel: string;
+    /** 어드온 정렬 방향 */
     addonAlign: FieldAddonAlign;
+    /** 레이블 영역 아이콘 */
     icon?: IconProps;
+    /** 레이블 툴팁 텍스트 */
     labelTooltip: string;
+    /** 레이블 툴팁 상세 옵션 */
     labelTooltipProps: SdTooltipProps | null;
     errorMsg: string;
     private hostElement;
@@ -32,9 +51,13 @@ export declare class SdField implements ValidatableField {
     private findHostElement;
     private registerToForm;
     private unregisterFromForm;
+    /** 유효성 검사를 실행합니다. */
     sdValidate(): Promise<boolean>;
+    /** 필드 값과 유효성 상태를 초기화합니다. */
     sdReset(): Promise<void>;
+    /** 유효성 상태만 초기화합니다. */
     sdResetValidation(): Promise<void>;
+    /** 필드에 포커스를 이동하고 스크롤합니다. */
     sdFocus(): Promise<void>;
     private setError;
     render(): any;

package/dist/types/components/sd-file-picker/sd-file-picker.d.ts

@@ -4,37 +4,64 @@ import { SdTooltipProps } from '../sd-tooltip/sd-tooltip.config';
 import { type FieldAddonAlign } from '../sd-field/sd-field.config';
 export declare class SdFilePicker implements ComponentInterface {
     el: HTMLElement;
+    /** 선택된 파일 값 */
     value?: File[] | File | null;
+    /** 파일 미선택 시 표시할 placeholder */
     placeholder: string;
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** sd-field 없이 인라인으로 표시하는 모드 여부 */
     inline: boolean;
+    /** 다중 파일 선택 여부 */
     multiple: boolean;
+    /** 허용할 파일 타입 (input accept 속성과 동일) */
     accept?: string;
+    /** 파일 한 개의 최대 크기 (bytes) */
     maxFileSize?: number | string;
+    /** 전체 파일의 최대 용량 합계 (bytes) */
     maxTotalSize?: number | string;
+    /** 최대 파일 개수 */
     maxFiles?: number | string;
+    /** 폼 연동용 name 속성 */
     name: string;
+    /** 레이블 텍스트 */
     label: string;
+    /** 레이블 너비 */
     labelWidth: string | number;
+    /** 필드 우측 어드온 레이블 */
     addonLabel: string;
+    /** 어드온 정렬 방향 */
     addonAlign: FieldAddonAlign;
+    /** 필드 하단 힌트 텍스트 */
     hint: string;
+    /** 에러 메시지 */
     errorMessage: string;
+    /** 필드 너비 (숫자면 px, 문자열이면 그대로 적용) */
     width: string | number;
+    /** 유효성 검사 규칙 목록 */
     rules?: Rule[];
+    /** 에러 상태 여부 */
     error: boolean;
+    /** 필드 상태 (없으면 rules 결과로 자동 결정) */
     status?: 'default' | 'pass' | 'error';
+    /** 레이블 영역 아이콘 */
     icon?: IconProps;
+    /** 레이블 툴팁 텍스트 */
     labelTooltip: string;
+    /** 레이블 툴팁 상세 옵션 */
     labelTooltipProps: SdTooltipProps | null;
+    /** 포커스 상태 여부 */
     focused: boolean;
+    /** 호버 상태 여부 */
     hovered: boolean;
     private internalValue;
     private showTooltip;
     private fileInputRef?;
     private fileNamesRef?;
     private formField?;
+    /** 파일 선택 또는 삭제 시 현재 파일 값을 전달합니다. */
     update: EventEmitter<File[] | File | null>;
+    /** 파일이 크기·개수 제한을 초과하여 거부됐을 때 발생합니다. */
     reject: EventEmitter<{
         files: File[];
         reason: 'max-file-size' | 'max-total-size' | 'max-files';
@@ -42,8 +69,11 @@ export declare class SdFilePicker implements ComponentInterface {
     valueChanged(newValue: File[] | File | null): void;
     componentDidLoad(): void;
     componentDidUpdate(): void;
+    /** 유효성 검사를 실행합니다. */
     sdValidate(): Promise<boolean>;
+    /** 파일 값과 유효성 상태를 초기화합니다. */
     sdReset(): Promise<void>;
+    /** 유효성 상태만 초기화합니다. */
     sdResetValidate(): Promise<void>;
     private toBytes;
     private validateFiles;

package/dist/types/components/sd-floating-portal/sd-floating-portal.d.ts

@@ -1,12 +1,19 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 export declare class SdFloatingPopover {
     el: HTMLElement;
+    /** 포탈 콘텐츠를 마운트할 대상 (CSS 선택자 또는 HTMLElement) */
     to: HTMLElement | string;
+    /** 위치 기준이 되는 부모 엘리먼트 */
     parentRef: HTMLElement | null;
+    /** [x, y] 오프셋 (px) */
     offset: [number, number];
+    /** z-index */
     zIndex: number;
+    /** 콘텐츠를 표시할 방향 */
     placement: 'top' | 'bottom' | 'left' | 'right';
+    /** 표시 여부 */
     open: boolean;
+    /** 외부 클릭 등으로 닫힐 때 발생합니다. */
     close: EventEmitter<void>;
     private container?;
     private wrapper?;
@@ -20,6 +27,11 @@ export declare class SdFloatingPopover {
     componentDidRender(): void;
     disconnectedCallback(): void;
     private resolveContainer;
+    /**
+     * 트리거(parentRef)가 모달 내부에 있으면 해당 모달보다 위에, 아니면 페이지 기본값에 둔다.
+     * 페이지 기본값(996)은 모달(997)보다 낮아, 모달 뒤의 페이지 포털이 모달 위로 떠오르지 않는다.
+     */
+    private resolveZIndex;
     private createWrapper;
     private moveSlotContent;
     updatePosition(): void;

package/dist/types/components/sd-form/sd-form.d.ts

@@ -10,18 +10,26 @@ export interface ValidatableField {
 }
 export type FieldIdentifier = ValidatableField | string;
 export declare class SdForm {
+    /** form 엘리먼트에 추가할 클래스 */
     formClass: string;
     private fields;
+    /** 유효성 검사 통과 후 submit 시 발생합니다. */
     sdSubmit: EventEmitter<void>;
+    /** 유효성 검사 실패 시 실패한 필드 name 목록을 전달합니다. */
     sdValidationError: EventEmitter<{
         names: string[];
     }>;
     private sortFieldsByDomOrder;
+    /** 폼에 필드를 등록합니다. */
     sdRegisterField(field: ValidatableField): Promise<void>;
+    /** 폼에서 필드를 제거합니다. */
     sdUnregisterField(fieldOrName: FieldIdentifier): Promise<void>;
     private runValidation;
+    /** 모든 등록된 필드의 유효성 검사를 실행합니다. */
     sdValidate(): Promise<boolean>;
+    /** 모든 필드의 값과 유효성 상태를 초기화합니다. */
     sdReset(): Promise<void>;
+    /** 모든 필드의 유효성 상태만 초기화합니다. */
     sdResetValidation(): Promise<void>;
     private onSubmit;
     render(): any;

package/dist/types/components/sd-ghost-button/sd-ghost-button.d.ts

@@ -1,14 +1,21 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { type GhostButtonIntent, type GhostButtonSize } from './sd-ghost-button.config';
 export declare class SdGhostButton {
+    /** 버튼에 표시할 아이콘명 */
     icon: IconName;
+    /** 버튼 크기 */
     size: GhostButtonSize;
+    /** 버튼 색상 의도 */
     intent: GhostButtonIntent;
+    /** 스크린리더용 접근성 레이블 */
     ariaLabel: string;
+    /** 호버 시 표시할 툴팁 텍스트 */
     tooltipText?: string;
+    /** 비활성 상태 여부 */
     disabled: boolean;
     hostEl: HTMLElement;
     private isTooltipOpen;
+    /** 버튼 클릭 시 발생합니다. */
     click: EventEmitter<MouseEvent>;
     private hasWarnedMissingAriaLabel;
     componentWillLoad(): void;

package/dist/types/components/sd-guide/sd-guide.d.ts

@@ -1,11 +1,17 @@
 export type GuideType = 'tip' | 'notion';
 export declare class SdGuide {
     el: HTMLElement;
+    /** 가이드 타입 (tip: 팝업, notion: 외부 링크) */
     type: GuideType;
+    /** 버튼에 표시할 레이블 (없으면 type에 따른 기본값 사용) */
     label: string;
+    /** 팝업에 표시할 메시지 (배열이면 리스트로 렌더링) */
     message: string | string[];
+    /** notion 타입일 때 클릭 시 이동할 URL */
     url: string;
+    /** 팝업 제목 (없으면 type에 따른 기본값 사용) */
     popupTitle: string;
+    /** 팝업 너비 (px, 없으면 426px) */
     popupWidth?: number;
     popupShow: boolean;
     private guideRef?;

package/dist/types/components/sd-icon/sd-icon.d.ts

@@ -9,6 +9,7 @@ export declare class SdIcon {
     rotate?: 0 | 90 | 180 | 270;
     /** 접근성을 위한 라벨 */
     label?: string;
+    /** 아이콘 i 엘리먼트에 적용할 인라인 스타일 */
     iconStyle: StyleProps;
     private getIconClasses;
     private get resolvedColor();

package/dist/types/components/sd-input/sd-input.d.ts

@@ -5,36 +5,67 @@ import { type InputSize } from './sd-input.config';
 import { type FieldAddonAlign } from '../sd-field/sd-field.config';
 export declare class SdInput {
     host: HTMLElement;
+    /** 입력 값 */
     value?: string | number | null;
+    /** 입력 타입 */
     type: 'text' | 'password' | 'email';
+    /** 입력 크기 */
     size: InputSize;
+    /** 필드 우측 어드온 레이블 */
     addonLabel: string;
+    /** 어드온 정렬 방향 */
     addonAlign: FieldAddonAlign;
+    /** 플레이스홀더 텍스트 */
     placeholder: string;
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** 값이 있을 때 지우기 버튼 표시 여부 */
     clearable: boolean;
+    /** 필드 너비 (숫자면 px, 문자열이면 그대로 적용) */
     width: string | number;
+    /** 유효성 검사 규칙 목록 */
     rules?: Rule[];
+    /** 마운트 시 자동 포커스 여부 */
     autoFocus: boolean;
+    /** autocomplete 속성 값 */
     autocomplete: string;
+    /** 최대 입력 글자 수 */
     maxlength?: number;
+    /** 최소 입력 글자 수 */
     minlength?: number;
+    /** 모바일 키보드 타입 */
     inputmode?: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
+    /** 모바일 Enter 키 힌트 */
     enterkeyhint?: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
+    /** 맞춤법 검사 여부 */
     spellcheck: boolean;
+    /** 필드 상태 (없으면 rules 결과로 자동 결정) */
     status?: 'default' | 'pass' | 'error';
+    /** 필드 하단 힌트 텍스트 */
     hint: string;
+    /** 에러 메시지 */
     errorMessage: string;
+    /** 네이티브 input에 추가할 클래스 */
     inputClass: string;
+    /** 읽기 전용 여부 */
     readonly: boolean;
+    /** 에러 상태 여부 */
     error: boolean;
+    /** 포커스 상태 여부 */
     focused: boolean;
+    /** 호버 상태 여부 */
     hovered: boolean;
+    /** 레이블 텍스트 */
     label?: string;
+    /** 레이블 너비 */
     labelWidth: string | number;
+    /** 레이블 영역 아이콘 */
     icon?: IconProps;
+    /** 레이블 툴팁 텍스트 */
     labelTooltip: string;
+    /** 레이블 툴팁 상세 옵션 */
     labelTooltipProps: SdTooltipProps | null;
+    /** 네이티브 input에 적용할 인라인 스타일 */
     inputStyle: {
         [key: string]: string;
     };
@@ -42,16 +73,25 @@ export declare class SdInput {
     private passwordVisible;
     private nativeEl;
     private formField?;
+    /** 폼 연동용 name 속성 */
     name: string;
+    /** 값이 변경될 때 발생합니다. */
     input?: EventEmitter<string | number | null>;
+    /** 포커스될 때 발생합니다. */
     focus?: EventEmitter<Event>;
+    /** 포커스를 잃을 때 발생합니다. */
     blur?: EventEmitter<Event>;
     valueChanged(newValue: string | number | null): void;
     internalValueChanged(newValue: string | number | null): void;
+    /** 네이티브 input 엘리먼트를 반환합니다. */
     sdGetNativeElement(): Promise<HTMLInputElement | null>;
+    /** 유효성 검사를 실행합니다. */
     sdValidate(): Promise<void>;
+    /** 값과 유효성 상태를 초기화합니다. */
     sdReset(): Promise<void>;
+    /** 유효성 상태만 초기화합니다. */
     sdResetValidate(): Promise<void>;
+    /** 입력 필드에 포커스를 이동합니다. */
     sdFocus(): Promise<void>;
     componentWillLoad(): void;
     componentDidLoad(): void;

package/dist/types/components/sd-key-value-table/sd-key-value-table.d.ts

@@ -17,7 +17,9 @@ export declare class SdKeyValueTable {
      * - 'full': 상하단 모두 radius 0 (요소 사이에 끼워 쓸 때)
      */
     radius: 'default' | 'useTop' | 'full';
+    /** 필드 값이 변경될 때 `{ name, value }` 형태로 발생합니다. */
     change: EventEmitter<SdKeyValueChangeDetail>;
+    /** search 패널의 검색 버튼 클릭 시 발생합니다. */
     searchEvent: EventEmitter<void>;
     private emit;
     private handleSearchClick;

package/dist/types/components/sd-linear-progress/sd-linear-progress.d.ts

@@ -1,8 +1,12 @@
 import { type LinearProgressType } from './sd-linear-progress.config';
 export declare class SdLinearProgress {
+    /** true이면 진행률 없이 무한 애니메이션 표시 */
     indeterminate: boolean;
+    /** 진행률 (0–100) */
     value: number;
+    /** 색상 타입 */
     type: LinearProgressType;
+    /** 하단에 표시할 레이블 텍스트 */
     label?: string;
     private get clampedValue();
     render(): any;

package/dist/types/components/sd-loading-container/sd-loading-container.d.ts

@@ -2,7 +2,9 @@ import type { SdLoadingShowArgs } from './sd-loading-container.config';
 export declare class SdLoadingContainer {
     visible: boolean;
     message: string;
+    /** 로딩 오버레이를 표시합니다. */
     show(options?: SdLoadingShowArgs): Promise<void>;
+    /** 로딩 오버레이를 숨깁니다. */
     hide(): Promise<void>;
     render(): any;
 }

package/dist/types/components/sd-loading-modal/sd-loading-modal.d.ts

@@ -1,13 +1,21 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { type LoadingModalState } from './sd-loading-modal.config';
 export declare class SdLoadingModal {
+    /** 모달 상태 (loading: 로딩 중, error: 에러) */
     state: LoadingModalState;
+    /** 표시할 메시지 (배열이면 여러 줄로 렌더링) */
     message: string | string[];
+    /** 하단 버튼 표시 여부 */
     useButton: boolean;
+    /** 버튼 레이블 (없으면 state에 따른 기본값 사용) */
     buttonLabel: string;
+    /** 모달 너비 */
     width?: string | number;
+    /** 모달 높이 */
     height?: string | number;
+    /** sd-circle-progress에 전달할 진행률 (0–100) */
     progress?: number;
+    /** 버튼 클릭 시 발생합니다. */
     click: EventEmitter<void>;
     private get resolvedState();
     private get resolvedMessage();

package/dist/types/components/sd-modal-container/sd-modal-container.d.ts

@@ -5,15 +5,21 @@ interface InternalEntry extends ModalEntry {
 }
 export declare class SdModalContainer {
     el: HTMLElement;
+    /** 마지막 모달이 닫힐 때 자신을 DOM에서 제거할지 여부 */
     autoRemove: boolean;
     entries: InternalEntry[];
     private layerRefs;
+    /** 확인 모달을 열고 모달 ID를 반환합니다. */
     open(options: ConfirmModalOptions, modalRef: ModalDialogRefLike): Promise<string>;
+    /** 로딩 모달을 열고 모달 ID를 반환합니다. */
     openLoading(options: LoadingModalOptions, modalRef: ModalDialogRefLike): Promise<string>;
+    /** 커스텀 엘리먼트를 모달로 등록하고 모달 ID를 반환합니다. */
     createCustom(element: HTMLElement, options: SdModalCreateOptions, modalRef: ModalDialogRefLike): Promise<string>;
     componentDidRender(): void;
     disconnectedCallback(): void;
+    /** 지정한 ID의 모달을 닫습니다. */
     dismissById(id: string, reason?: 'confirm' | 'cancel' | 'close'): Promise<void>;
+    /** 열려있는 모달의 props를 동적으로 업데이트합니다. */
     update(id: string, props: Partial<ConfirmModalOptions> | Partial<LoadingModalOptions>): Promise<void>;
     private mountEntry;
     private attachModalEventListeners;

package/dist/types/components/sd-number-input/sd-number-input.d.ts

@@ -5,45 +5,79 @@ import { type NumberInputSize } from './sd-number-input.config';
 import { type FieldAddonAlign } from '../sd-field/sd-field.config';
 export declare class SdNumberInput {
     el: HTMLElement;
+    /** 입력 크기 */
     size: NumberInputSize;
+    /** 최솟값 */
     min: number;
+    /** 최댓값 */
     max: number;
+    /** 스텝 단위 */
     step: number;
+    /** 증감 버튼 표시 여부 */
     useButton: boolean;
+    /** 소수점 입력 허용 여부 */
     useDecimal: boolean;
+    /** 입력 값 */
     value?: string | number | null;
+    /** 레이블 텍스트 */
     label?: string;
+    /** 레이블 너비 */
     labelWidth: string | number;
+    /** 레이블 영역 아이콘 */
     icon?: IconProps;
+    /** 레이블 툴팁 텍스트 */
     labelTooltip: string;
+    /** 레이블 툴팁 상세 옵션 */
     labelTooltipProps: SdTooltipProps | null;
+    /** 필드 우측 어드온 레이블 */
     addonLabel: string;
+    /** 어드온 정렬 방향 */
     addonAlign: FieldAddonAlign;
+    /** 플레이스홀더 텍스트 */
     placeholder: string;
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** 필드 너비 (숫자면 px, 문자열이면 그대로 적용) */
     width?: number | string;
+    /** 유효성 검사 규칙 목록 */
     rules?: Rule[];
+    /** 마운트 시 자동 포커스 여부 */
     autoFocus: boolean;
+    /** 필드 상태 (없으면 rules 결과로 자동 결정) */
     status?: 'default' | 'pass' | 'error';
+    /** 필드 하단 힌트 텍스트 */
     hint: string;
+    /** 에러 메시지 */
     errorMessage: string;
+    /** 입력 앞에 표시할 접두 텍스트 */
     inputPrefix: string;
+    /** 입력 뒤에 표시할 접미 텍스트 */
     inputSuffix: string;
+    /** 네이티브 input에 추가할 클래스 */
     inputClass: string;
+    /** 읽기 전용 여부 */
     readonly: boolean;
+    /** 네이티브 input에 적용할 인라인 스타일 */
     inputStyle: {
         [key: string]: string;
     };
+    /** 에러 상태 여부 */
     error: boolean;
+    /** 포커스 상태 여부 */
     focused: boolean;
+    /** 호버 상태 여부 */
     hovered: boolean;
     private internalValue;
     private displayValue;
     private nativeEl;
     private formField?;
+    /** 폼 연동용 name 속성 */
     name: string;
+    /** 값이 변경될 때 발생합니다. */
     update?: EventEmitter<number | null>;
+    /** 포커스될 때 발생합니다. */
     focus?: EventEmitter<Event>;
+    /** 포커스를 잃을 때 발생합니다. */
     blur?: EventEmitter<Event>;
     private toNumber;
     private formatWithCommas;
@@ -54,10 +88,15 @@ export declare class SdNumberInput {
     private isDecrementDisabled;
     valueChanged(newValue: string | number | null): void;
     internalValueChanged(newValue: number | null): void;
+    /** 유효성 검사를 실행합니다. */
     sdValidate(): Promise<void>;
+    /** 값과 유효성 상태를 초기화합니다. */
     sdReset(): Promise<void>;
+    /** 유효성 상태만 초기화합니다. */
     sdResetValidate(): Promise<void>;
+    /** 입력 필드에 포커스를 이동합니다. */
     sdFocus(): Promise<void>;
+    /** 네이티브 input 엘리먼트를 반환합니다. */
     sdGetNativeElement(): Promise<HTMLInputElement | null>;
     componentWillLoad(): void;
     componentDidLoad(): void;

package/dist/types/components/sd-pagination/sd-pagination.d.ts

@@ -1,8 +1,12 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 export declare class SdPagination {
+    /** 현재 페이지 번호 */
     currentPage: number;
+    /** 마지막 페이지 번호 */
     lastPage: number;
+    /** true이면 현재/마지막 페이지만 표시하는 단순 모드 */
     simple: boolean;
+    /** 페이지가 변경될 때 새 페이지 번호를 전달합니다. */
     pageChange: EventEmitter<number>;
     private get pageNumbers();
     private get buttonWidth();

package/dist/types/components/sd-popover/sd-popover.d.ts

@@ -12,22 +12,38 @@ export type PopoverLink = Partial<Pick<SdTextLink, 'icon' | 'iconColor' | 'right
 };
 export declare class SdPopover {
     el: HTMLElement;
+    /** 팝오버 표시 여부 */
     show: boolean;
+    /** 팝오버를 표시할 방향 */
     placement: 'top' | 'bottom' | 'left' | 'right';
+    /** 아이콘 트리거 색상 */
     color: string;
+    /** 아이콘 트리거 아이콘명 */
     icon: IconName;
+    /** 아이콘 트리거 크기 */
     iconSize: number;
+    /** 버튼 트리거 레이블 (있으면 아이콘 대신 버튼 렌더링) */
     label: string;
+    /** 버튼 트리거 프리셋 */
     name: ButtonName;
+    /** 버튼 트리거 우측 아이콘 */
     rightIcon?: IconName;
+    /** 스크린리더용 접근성 레이블 */
     ariaLabel: string;
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** 버튼 type 속성 */
     type: ButtonType;
+    /** 팝오버 메뉴 제목 */
     menuTitle?: string;
+    /** 팝오버 하단 좌측 링크 옵션 */
     leftLink?: PopoverLink;
+    /** 팝오버 하단 버튼 옵션 */
     button?: PopoverButton;
+    /** 팝오버 메뉴에 추가할 클래스 */
     menuClass: string;
     slotContentHTML: string;
+    /** 팝오버 표시 상태가 바뀔 때 발생합니다. */
     showChange: EventEmitter<boolean>;
     private buttonEl?;
     private setShow;

package/dist/types/components/sd-popup/sd-popup.d.ts

@@ -2,10 +2,15 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import type { ButtonProps } from '../sd-button/sd-button.config';
 import { type PopupType } from './sd-popup.config';
 export declare class SdPopup {
+    /** 팝업 헤더에 표시할 제목 */
     popupTitle: string;
+    /** 팝업 타입 */
     type: PopupType;
+    /** 하단 footer 영역 표시 여부 */
     useFooter: boolean;
+    /** 확인 버튼 커스텀 props */
     submitButtonProps?: ButtonProps;
+    /** 확인 버튼 클릭 시 발생합니다. */
     submit: EventEmitter<void>;
     render(): any;
 }

package/dist/types/components/sd-portal/sd-portal.d.ts

@@ -1,13 +1,21 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 export declare class SdPortal {
     hostEl: HTMLElement;
+    /** 포탈 콘텐츠를 마운트할 대상 (CSS 선택자 또는 HTMLElement) */
     to: HTMLElement | string;
+    /** 위치 기준이 되는 부모 엘리먼트 */
     parentRef: HTMLElement | null;
+    /** [x, y] 오프셋 (px) */
     offset: [number, number];
+    /** 뷰포트 경계 여백 (px) */
     viewportPadding: number;
+    /** z-index */
     zIndex: number;
+    /** 표시 여부 */
     open: boolean;
+    /** 콘텐츠를 표시할 방향 (공간이 부족하면 자동으로 반대 방향으로 전환) */
     placement: 'top' | 'bottom';
+    /** 외부 클릭 등으로 닫힐 때 발생합니다. */
     close: EventEmitter<void>;
     private container?;
     private wrapper?;
@@ -24,6 +32,11 @@ export declare class SdPortal {
     componentDidRender(): void;
     disconnectedCallback(): void;
     private resolveContainer;
+    /**
+     * 트리거(parentRef)가 모달 내부에 있으면 해당 모달보다 위에, 아니면 페이지 기본값에 둔다.
+     * 페이지 기본값(996)은 모달(997)보다 낮아, 모달 뒤의 페이지 포털이 모달 위로 떠오르지 않는다.
+     */
+    private resolveZIndex;
     private createWrapper;
     private ensureWrapper;
     private syncPortalState;

package/dist/types/components/sd-radio/sd-radio.d.ts

@@ -1,10 +1,15 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 export type RadioValue = string | number | boolean;
 export declare class SdRadio {
+    /** 라디오 그룹의 현재 선택 값 */
     value: RadioValue;
+    /** 이 라디오 아이템의 값 */
     val: RadioValue;
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** 표시할 라벨 텍스트 */
     label?: string;
+    /** 선택 값이 변경될 때 발생합니다. */
     update: EventEmitter<RadioValue>;
     valueChanged(newValue: RadioValue): void;
     private get isSelected();

package/dist/types/components/sd-radio-button/sd-radio-button.d.ts

@@ -6,11 +6,17 @@ export type RadioOption = {
     disabled?: boolean;
 };
 export declare class SdRadioButton {
+    /** 현재 선택된 값 */
     value: RadioValue;
+    /** 라디오 버튼 옵션 목록 */
     options: RadioOption[];
+    /** 버튼 크기 */
     size: 'xs' | 'sm';
+    /** 비활성 상태 여부 */
     disabled: boolean;
+    /** input name 속성 (없으면 자동 생성) */
     name?: string;
+    /** 선택 값이 변경될 때 발생합니다. */
     change: EventEmitter<RadioValue>;
     componentWillLoad(): void;
     private handleRadioChange;