sellmate-design-system-react 9.0.0-beta.40 → 9.0.0-beta.41

package/dist/components/SSearchInput/README.md

@@ -14,9 +14,9 @@
 | `clearable?` | `boolean` | `false` | 지우기 버튼 — 값이 있을 때만 나타난다 |
 | `disabled?` | `boolean` | `false` | 비활성 |
 | `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. 미지정 시 부모 폭을 채운다. |
-| `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
-| `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
-| `inputClass?` | `string` | — | 내부 input 요소 className |
+| `focused?` | `boolean` | — | 포커스 상태를 밖에서 지정한다 — 강조 테두리·링이 즉시 걸린다 (SField 로 그대로 넘어간다) |
+| `hovered?` | `boolean` | — | 호버 상태를 밖에서 지정한다 — 강조는 `focused` 와 같다 (SField 로 그대로 넘어간다) |
+| `inputClassName?` | `string` | — | 내부 input 요소 className |
 | `inputStyle?` | `CSSProperties` | — | 내부 input 요소 style |
 | `className?` | `string` | — |  |
 | `style?` | `CSSProperties` | — |  |

package/dist/components/SSearchInput/SSearchInput.d.ts

@@ -29,12 +29,12 @@ export interface SSearchInputProps extends Omit<InputHTMLAttributes<HTMLInputEle
      * 미지정 시 부모 폭을 채운다.
      */
     width?: SFieldWidth;
-    /** 포커스 상태 (제어/반영) */
+    /** 포커스 상태를 밖에서 지정한다 — 강조 테두리·링이 즉시 걸린다 (SField 로 그대로 넘어간다) */
     focused?: boolean;
-    /** 호버 상태 (제어/반영) */
+    /** 호버 상태를 밖에서 지정한다 — 강조는 `focused` 와 같다 (SField 로 그대로 넘어간다) */
     hovered?: boolean;
     /** 내부 input 요소 className */
-    inputClass?: string;
+    inputClassName?: string;
     /** 내부 input 요소 style */
     inputStyle?: CSSProperties;
     className?: string;

package/dist/components/SSelect/README.md

@@ -8,13 +8,13 @@
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `value?` | `(string \| number \| SSelectOption) \| (string \| number \| SSelectOption)[] \| null` | — | 선택 값. multi 타입이면 배열. emitValue=false(기본) 라운드트립을 위해 SSelectOption 객체도 허용 |
-| `emitValue?` | `boolean` | `false` | true면 SSelectOption 대신 원시값(string|number) 방출 |
+| `value?` | `(string \| number \| SSelectOption) \| (string \| number \| SSelectOption)[] \| null` | — | 선택 값. multi 타입이면 배열. 기본(valueAsPrimitive=false) 라운드트립을 위해 SSelectOption 객체도 허용 |
+| `valueAsPrimitive?` | `boolean` | `false` | `value`·`onValueChange` 가 옵션 객체 대신 원시값(string|number)을 주고받는다. **기본값 `false`(옵션 객체)는 유지한다** — 원본(sd-select) 호환 때문이고, 뒤집으면 이 값을 주지 않던 화면이 조용히 다른 모양의 값을 받게 되어 타입으로도 잡히지 않는다. 새로 쓰는 화면은 켜는 쪽이 다루기 쉽다 — 서버로 보내는 것도, 폼 상태에 담는 것도 결국 값 하나이기 때문이다. |
 | `name?` | `string` | — | 폼 연동용 name 속성 |
 | `options?` | `SSelectOption[]` | `[]` | 옵션 목록 (children으로 계층 표현) |
 | `type?` | `SSelectType` | `'default'` | 타입: default | multi | default_depth | multi_depth |
-| `useSearch?` | `boolean` | `false` | 검색 입력 사용 |
-| `useSelectAll?` | `boolean` | `false` | 전체선택 옵션 사용 (multi 전용) |
+| `showSearch?` | `boolean` | `false` | 검색 입력 사용 |
+| `showSelectAll?` | `boolean` | `false` | 전체선택 옵션 사용 (multi 전용) |
 | `allSelectedLabel?` | `string` | `'전체'` | 전체선택 레이블 |
 | `placeholder?` | `string` | `'선택'` | placeholder |
 | `disabled?` | `boolean` | `false` | 비활성 |
@@ -42,7 +42,7 @@
 
 | Event | Type | Description |
 |-------|------|-------------|
-| `onValueChange` | `(value: any) => void` | 값 변경 (sdUpdate). emitValue=false(기본)면 SSelectOption(들), true면 원시값 |
+| `onValueChange` | `(value: any) => void` | 값 변경. 기본은 SSelectOption(들)이 오고, `valueAsPrimitive` 면 원시값이 온다 |
 | `onOpenChange` | `(open: boolean) => void` | 열림/닫힘 변경 (sdDropDownShow) |
 
 #### Methods (ref)

package/dist/components/SSelect/SSelect.d.ts

@@ -14,14 +14,22 @@ export interface SSelectHandle {
     open: () => void;
 }
 export interface SSelectProps {
-    /** 선택 값. multi 타입이면 배열. emitValue=false(기본) 라운드트립을 위해 SSelectOption 객체도 허용 */
+    /** 선택 값. multi 타입이면 배열. 기본(valueAsPrimitive=false) 라운드트립을 위해 SSelectOption 객체도 허용 */
     value?: (string | number | SSelectOption) | (string | number | SSelectOption)[] | null;
-    /** 값 변경 (sdUpdate). emitValue=false(기본)면 SSelectOption(들), true면 원시값 */
+    /** 값 변경. 기본은 SSelectOption(들)이 오고, `valueAsPrimitive` 면 원시값이 온다 */
     onValueChange?: (value: any) => void;
     /** 열림/닫힘 변경 (sdDropDownShow) */
     onOpenChange?: (open: boolean) => void;
-    /** true면 SSelectOption 대신 원시값(string|number) 방출 */
-    emitValue?: boolean;
+    /**
+     * `value`·`onValueChange` 가 옵션 객체 대신 원시값(string|number)을 주고받는다.
+     *
+     * **기본값 `false`(옵션 객체)는 유지한다** — 원본(sd-select) 호환 때문이고, 뒤집으면 이 값을
+     * 주지 않던 화면이 조용히 다른 모양의 값을 받게 되어 타입으로도 잡히지 않는다.
+     *
+     * 새로 쓰는 화면은 켜는 쪽이 다루기 쉽다 — 서버로 보내는 것도, 폼 상태에 담는 것도
+     * 결국 값 하나이기 때문이다.
+     */
+    valueAsPrimitive?: boolean;
     /** 폼 연동용 name 속성 */
     name?: string;
     /** 옵션 목록 (children으로 계층 표현) */
@@ -29,9 +37,9 @@ export interface SSelectProps {
     /** 타입: default | multi | default_depth | multi_depth */
     type?: SSelectType;
     /** 검색 입력 사용 */
-    useSearch?: boolean;
+    showSearch?: boolean;
     /** 전체선택 옵션 사용 (multi 전용) */
-    useSelectAll?: boolean;
+    showSelectAll?: boolean;
     /** 전체선택 레이블 */
     allSelectedLabel?: string;
     /** placeholder */

package/dist/components/SSplitter/README.md

@@ -12,7 +12,7 @@
 | `defaultValue?` | `number` | — | 첫 패널 초기 크기. uncontrolled. 기본은 '%' 면 50, 'px' 면 240 |
 | `unit?` | `SSplitterUnit` | `'%'` | 모델·limits 를 읽는 단위 |
 | `limits?` | `readonly [number, number]` | — | [최소, 최대]. 생략하면 '%' 는 [10, 90], 'px' 는 [50, Infinity] |
-| `emitImmediately?` | `boolean` | `false` | 드래그하는 동안에도 onValueChange 를 계속 보낸다 |
+| `updateWhileDragging?` | `boolean` | `false` | 드래그하는 동안에도 `onValueChange` 를 계속 보낸다. 기본은 놓는 순간 한 번만 — 미리보기는 컴포넌트가 내부에서 그리므로, 값을 저장하는 쪽이 프레임마다 불릴 이유가 없다. 패널 크기에 맞춰 밖의 무언가를 실시간으로 다시 그려야 할 때만 켠다. |
 | `vertical?` | `boolean` | `false` | true면 패널을 위아래로 쌓는다 (Quasar q-splitter 의 horizontal 에 해당) |
 | `disabled?` | `boolean` | `false` | true면 크기를 바꿀 수 없다. 커서도 구분선도 나오지 않는다 |
 | `dividerClassName?` | `string` | — | 구분선에 얹을 클래스 |
@@ -23,7 +23,7 @@
 
 | Event | Type | Description |
 |-------|------|-------------|
-| `onValueChange` | `(value: number) => void` | 크기가 확정될 때. emitImmediately 가 아니면 드래그를 놓는 순간 한 번만 온다 |
+| `onValueChange` | `(value: number) => void` | 크기가 확정될 때. `updateWhileDragging` 이 아니면 드래그를 놓는 순간 한 번만 온다 |
 
 ## Types
 

package/dist/components/SSplitter/SSplitter.d.ts

@@ -7,14 +7,18 @@ export interface SSplitterProps extends Omit<HTMLAttributes<HTMLDivElement>, 'de
     value?: number;
     /** 첫 패널 초기 크기. uncontrolled. 기본은 '%' 면 50, 'px' 면 240 */
     defaultValue?: number;
-    /** 크기가 확정될 때. emitImmediately 가 아니면 드래그를 놓는 순간 한 번만 온다 */
+    /** 크기가 확정될 때. `updateWhileDragging` 이 아니면 드래그를 놓는 순간 한 번만 온다 */
     onValueChange?: (value: number) => void;
     /** 모델·limits 를 읽는 단위 */
     unit?: SSplitterUnit;
     /** [최소, 최대]. 생략하면 '%' 는 [10, 90], 'px' 는 [50, Infinity] */
     limits?: readonly [number, number];
-    /** 드래그하는 동안에도 onValueChange 를 계속 보낸다 */
-    emitImmediately?: boolean;
+    /**
+     * 드래그하는 동안에도 `onValueChange` 를 계속 보낸다. 기본은 놓는 순간 한 번만 —
+     * 미리보기는 컴포넌트가 내부에서 그리므로, 값을 저장하는 쪽이 프레임마다 불릴 이유가 없다.
+     * 패널 크기에 맞춰 밖의 무언가를 실시간으로 다시 그려야 할 때만 켠다.
+     */
+    updateWhileDragging?: boolean;
     /** true면 패널을 위아래로 쌓는다 (Quasar q-splitter 의 horizontal 에 해당) */
     vertical?: boolean;
     /** true면 크기를 바꿀 수 없다. 커서도 구분선도 나오지 않는다 */

package/dist/components/SSwitch/README.md

@@ -11,7 +11,6 @@
 | `value?` | `boolean` | `false` | on/off 상태 |
 | `leftLabel?` | `string` | — | 스위치 좌측 라벨 |
 | `rightLabel?` | `string` | — | 스위치 우측 라벨 |
-| `label?` | `string` | — |  |
 | `disabled?` | `boolean` | `false` | 비활성 |
 | `className?` | `string` | — |  |
 | `style?` | `CSSProperties` | — |  |

package/dist/components/SSwitch/SSwitch.d.ts

@@ -6,8 +6,6 @@ export interface SSwitchProps {
     leftLabel?: string;
     /** 스위치 우측 라벨 */
     rightLabel?: string;
-    /** @deprecated `rightLabel` 사용. 우측 라벨(하위호환) */
-    label?: string;
     /** 비활성 */
     disabled?: boolean;
     /** 변경 (sdUpdate) */
@@ -16,4 +14,4 @@ export interface SSwitchProps {
     style?: CSSProperties;
 }
 /** SSwitch — sd-switch 포팅 (Radix SSwitch). 32×20 트랙, 16 노브. 좌/우 라벨 지원. */
-export declare function SSwitch({ value, leftLabel, rightLabel, label, disabled, onValueChange, className, style, }: SSwitchProps): import("react").JSX.Element;
+export declare function SSwitch({ value, leftLabel, rightLabel, disabled, onValueChange, className, style, }: SSwitchProps): import("react").JSX.Element;

package/dist/components/STable/README.md

@@ -18,20 +18,19 @@
 | `resizable?` | `boolean` | `false` | 컬럼 너비 조절 |
 | `width?` | `string` | — |  |
 | `height?` | `string` | — |  |
-| `stickyHeader?` | `boolean` | — |  |
 | `stickyColumn?` | `STableStickyColumn` | — | 고정할 좌/우 컬럼 수 |
 | `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
 | `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. 페이지네이션 바의 테두리와 1px 겹침(`-mt-px`)도 함께 꺼진다. 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다. |
-| `noDataLabel?` | `string` | `'데이터가 없습니다.'` |  |
-| `noDataSlot?` | `ReactNode` | — | 데이터가 없을 때 body 영역 전체를 대체하는 슬롯. 지정하면 `noDataLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다. |
-| `isLoading?` | `boolean` | `false` |  |
+| `emptyLabel?` | `string` | `'데이터가 없습니다.'` |  |
+| `emptySlot?` | `ReactNode` | — | 데이터가 없을 때 body 영역 전체를 대체하는 슬롯. 지정하면 `emptyLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다. |
+| `loading?` | `boolean` | `false` |  |
 | `dense?` | `boolean` | `false` | 행 높이를 좁게 (세로 여백만 줄인다 — 좌우 패딩은 그대로). **시작 밀도이자 밀도 토글의 스위치다.** 켜면 하단 바 우측에 `좁게 보기` · `넓게 보기` 토글이 붙는다 — 페이지네이션이 없으면 이 바를 토글만 담아 그린다. 누른 뒤의 밀도는 테이블이 내부 상태로 들고 가므로 `onDenseChange` 를 받지 않아도 토글은 동작하고, 넓게 본 뒤에도 토글은 그대로 남는다(붙일지는 이 prop 이 정한다). 이 prop 값이 바뀌면 내부 밀도도 그 값으로 맞춰진다. |
-| `noHover?` | `boolean` | `false` | true면 행에 마우스를 올려도 hover 배경(grey_05)을 표시하지 않는다 |
+| `hoverable?` | `boolean` | `true` | true면 행에 마우스를 올려도 hover 배경(grey_05)을 표시하지 않는다 |
 | `pagination?` | `STablePagination` | — | 페이지네이션 (있으면 하단 표시) |
-| `useInternalPagination?` | `boolean` | `false` | 테이블 내부에서 페이지네이션을 직접 관리 (rows를 내부 슬라이싱) |
-| `useRowsPerPageSelect?` | `boolean` | `false` | 페이지당 행 수 셀렉트 표시 |
+| `internalPagination?` | `boolean` | `false` | 테이블 내부에서 페이지네이션을 직접 관리 (rows를 내부 슬라이싱) |
+| `showRowsPerPageSelect?` | `boolean` | `false` | 페이지당 행 수 셀렉트 표시 |
 | `rowsPerPageOption?` | `SSelectOption[]` | `DEFAULT_ROWS_PER_PAGE_OPTION` |  |
-| `useVirtualScroll?` | `boolean` | `false` | 가상 스크롤 |
+| `virtualScroll?` | `boolean` | `false` | 가상 스크롤 |
 | `rowHeight?` | `number` | — |  |
 | `virtualBuffer?` | `number` | `5` |  |
 | `virtualEndThreshold?` | `number` | `10` |  |
@@ -58,7 +57,7 @@
 |--------|------|-------------|
 | `isRowSelected` | `(row: SRow) => boolean` | 행 선택 여부 |
 | `getIsAllChecked` | `(rows: SRow[]) => boolean \| null` | 주어진 행들의 전체 선택 상태 (true/false/null=indeterminate) |
-| `getPaginationInfo` | `<union 2종>` | 내부 페이지네이션 정보 (useInternalPagination 아니면 null) |
+| `getPaginationInfo` | `<union 2종>` | 내부 페이지네이션 정보 (internalPagination 아니면 null) |
 | `getStickyStyle` | `(colIdx: number) => CSSProperties` | 컬럼 sticky 스타일 (CSS 변수 + 고정폭) |
 | `setRowCount` | `(count: number) => void` | 가상 스크롤 총 행 수 설정 |
 | `updateRowSelect` | `(row: SRow) => void` | 단일 행 선택 토글 (sd-table updateRowSelect) — onSelectedChange 발생 |

package/dist/components/STable/STable.d.ts

@@ -163,7 +163,7 @@ export interface STableHandle {
     isRowSelected: (row: SRow) => boolean;
     /** 주어진 행들의 전체 선택 상태 (true/false/null=indeterminate) */
     getIsAllChecked: (rows: SRow[]) => boolean | null;
-    /** 내부 페이지네이션 정보 (useInternalPagination 아니면 null) */
+    /** 내부 페이지네이션 정보 (internalPagination 아니면 null) */
     getPaginationInfo: () => {
         startIndex: number;
         endIndex: number;
@@ -207,8 +207,6 @@ export interface STableProps {
     resizable?: boolean;
     width?: string;
     height?: string;
-    /** @deprecated 헤더는 항상 세로 스크롤에서 제외되어 고정됩니다 (body만 세로 스크롤) */
-    stickyHeader?: boolean;
     /** 고정할 좌/우 컬럼 수 */
     stickyColumn?: STableStickyColumn;
     /** border-radius 제어 */
@@ -223,13 +221,13 @@ export interface STableProps {
      * 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
      */
     bordered?: boolean;
-    noDataLabel?: string;
+    emptyLabel?: string;
     /**
      * 데이터가 없을 때 body 영역 전체를 대체하는 슬롯.
-     * 지정하면 `noDataLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다.
+     * 지정하면 `emptyLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다.
      */
-    noDataSlot?: ReactNode;
-    isLoading?: boolean;
+    emptySlot?: ReactNode;
+    loading?: boolean;
     /**
      * 행 높이를 좁게 (세로 여백만 줄인다 — 좌우 패딩은 그대로).
      *
@@ -247,18 +245,18 @@ export interface STableProps {
      */
     onDenseChange?: (dense: boolean) => void;
     /** true면 행에 마우스를 올려도 hover 배경(grey_05)을 표시하지 않는다 */
-    noHover?: boolean;
+    hoverable?: boolean;
     /** 페이지네이션 (있으면 하단 표시) */
     pagination?: STablePagination;
     onPageChange?: (page: number) => void;
     /** 테이블 내부에서 페이지네이션을 직접 관리 (rows를 내부 슬라이싱) */
-    useInternalPagination?: boolean;
+    internalPagination?: boolean;
     /** 페이지당 행 수 셀렉트 표시 */
-    useRowsPerPageSelect?: boolean;
+    showRowsPerPageSelect?: boolean;
     rowsPerPageOption?: SSelectOption[];
     onRowsPerPageChange?: (perPage: number) => void;
     /** 가상 스크롤 */
-    useVirtualScroll?: boolean;
+    virtualScroll?: boolean;
     rowHeight?: number;
     virtualBuffer?: number;
     virtualEndThreshold?: number;

package/dist/components/STabs/README.md

@@ -10,7 +10,7 @@
 |------|------|---------|-------------|
 | `value` | `string` | — | 현재 선택된 탭 value |
 | `tabs` | `STabOption[]` | — | 탭 옵션 목록 |
-| `isSub?` | `boolean` | `false` | 서브 탭(밑줄형) 스타일 |
+| `sub?` | `boolean` | `false` | 서브 탭(밑줄형) 스타일 |
 | `vertical?` | `boolean` | `false` | 세로 배치 (sub 전용 — main 폴더형은 항상 가로) |
 | `className?` | `string` | — |  |
 | `style?` | `CSSProperties` | — |  |

package/dist/components/STabs/STabs.d.ts

@@ -8,7 +8,7 @@ export interface STabsProps {
     /** 탭 변경 (sdUpdate) */
     onValueChange?: (value: string) => void;
     /** 서브 탭(밑줄형) 스타일 */
-    isSub?: boolean;
+    sub?: boolean;
     /** 세로 배치 (sub 전용 — main 폴더형은 항상 가로) */
     vertical?: boolean;
     className?: string;
@@ -19,4 +19,4 @@ export interface STabsProps {
  * main = 폴더형(탭 줄에 파란 baseline, 탭은 위쪽만 둥글고 하단 테두리 없음),
  * sub = 밑줄형(선택 시 하단 라인). 뱃지(STag), 세로 배치, value 제어 + onValueChange(sdUpdate).
  */
-export declare function STabs({ value, tabs, onValueChange, isSub, vertical, className, style, }: STabsProps): import("react").JSX.Element;
+export declare function STabs({ value, tabs, onValueChange, sub, vertical, className, style, }: STabsProps): import("react").JSX.Element;

package/dist/components/STextLink/README.md

@@ -12,7 +12,7 @@
 | `icon?` | `SIconName` | — | 좌측 아이콘 |
 | `iconColor?` | `SColor` | — | 좌측 아이콘 색상. 팔레트 키(`grey_65`, `red_95` …) 또는 임의 CSS 색상 |
 | `iconRotate?` | `0 \| 90 \| 180 \| 270` | — | 좌측 아이콘 회전 각도. 같은 아이콘을 방향만 바꿔 쓸 때 (`SIcon` 의 `rotate` 로 그대로 간다) |
-| `labelClass?` | `string` | — | 레이블 span에 추가할 클래스 |
+| `labelClassName?` | `string` | — | 레이블 span에 추가할 클래스 |
 | `rightArrow?` | `STextLinkArrow` | `'none'` | 우측 화살표 |
 | `rightArrowRotate?` | `0 \| 90 \| 180 \| 270` | — | 우측 화살표 회전 각도. 같은 화살표를 방향만 바꿔 쓸 때 (`SIcon` 의 `rotate` 로 그대로 간다) |
 | `underline?` | `boolean` | `false` | 밑줄 여부 |

package/dist/components/STextLink/STextLink.d.ts

@@ -13,7 +13,7 @@ export interface STextLinkProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'o
     /** 좌측 아이콘 회전 각도. 같은 아이콘을 방향만 바꿔 쓸 때 (`SIcon` 의 `rotate` 로 그대로 간다) */
     iconRotate?: 0 | 90 | 180 | 270;
     /** 레이블 span에 추가할 클래스 */
-    labelClass?: string;
+    labelClassName?: string;
     /** 우측 화살표 */
     rightArrow?: STextLinkArrow;
     /** 우측 화살표 회전 각도. 같은 화살표를 방향만 바꿔 쓸 때 (`SIcon` 의 `rotate` 로 그대로 간다) */

package/dist/components/STextarea/README.md

@@ -12,9 +12,9 @@
 | `rows?` | `number` | `3` | 행 수 |
 | `rules?` | `Rule[]` | — | 유효성 규칙 — blur 시 자동 검증 |
 | `status?` | `SFieldStatus` | — | 필드 상태 ('default' | 'pass' | 'error') |
-| `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
-| `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
-| `textareaClass?` | `string` | — | 내부 textarea 요소 className |
+| `focused?` | `boolean` | — | 포커스 상태를 밖에서 지정한다 — 강조 테두리·링이 즉시 걸린다 (SField 로 그대로 넘어간다) |
+| `hovered?` | `boolean` | — | 호버 상태를 밖에서 지정한다 — 강조는 `focused` 와 같다 (SField 로 그대로 넘어간다) |
+| `textareaClassName?` | `string` | — | 내부 textarea 요소 className |
 | `textareaStyle?` | `CSSProperties` | — | 내부 textarea 요소 style |
 | `label?` | `string` | — |  |
 | `labelWidth?` | `number \| string` | — |  |

package/dist/components/STextarea/STextarea.d.ts

@@ -18,12 +18,12 @@ export interface STextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextArea
     rules?: Rule[];
     /** 필드 상태 ('default' | 'pass' | 'error') */
     status?: SFieldStatus;
-    /** 포커스 상태 (제어/반영) */
+    /** 포커스 상태를 밖에서 지정한다 — 강조 테두리·링이 즉시 걸린다 (SField 로 그대로 넘어간다) */
     focused?: boolean;
-    /** 호버 상태 (제어/반영) */
+    /** 호버 상태를 밖에서 지정한다 — 강조는 `focused` 와 같다 (SField 로 그대로 넘어간다) */
     hovered?: boolean;
     /** 내부 textarea 요소 className */
-    textareaClass?: string;
+    textareaClassName?: string;
     /** 내부 textarea 요소 style */
     textareaStyle?: CSSProperties;
     label?: string;

package/dist/components/STimePicker/README.md

@@ -14,7 +14,7 @@
 | `placeholder?` | `string` | `'00:00'` |  |
 | `disabled?` | `boolean` | `false` |  |
 | `clearable?` | `boolean` | `false` |  |
-| `useMeridiem?` | `boolean` | — | 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. |
+| `showMeridiem?` | `boolean` | — | 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. |
 | `minuteStep?` | `number` | `1` |  |
 | `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. |
 | `name?` | `string` | — |  |

package/dist/components/STimePicker/STimePicker.d.ts

@@ -21,7 +21,7 @@ export interface STimePickerProps {
     disabled?: boolean;
     clearable?: boolean;
     /** 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. */
-    useMeridiem?: boolean;
+    showMeridiem?: boolean;
     minuteStep?: number;
     /**
      * 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이.
@@ -46,11 +46,11 @@ export interface STimePickerProps {
     className?: string;
     style?: CSSProperties;
 }
-export declare function TimeSelector({ value, useMeridiem, minuteStep, onChange, }: {
+export declare function TimeSelector({ value, showMeridiem, minuteStep, onChange, }: {
     value?: string | null;
-    useMeridiem: boolean;
+    showMeridiem: boolean;
     minuteStep: number;
     onChange: (time: string) => void;
 }): import("react").JSX.Element;
 /** STimePicker — sd-time-picker 포팅. SField + Popover(TimeSelector). */
-export declare function STimePicker({ value, onValueChange, onOpenChange, type, size, placeholder, disabled, clearable, useMeridiem, minuteStep, width, name, rules, status, label, labelWidth, icon, iconColor, labelTooltip, labelTooltipProps, addonLabel, addonAlign, hint, error, errorMessage, className, style, }: STimePickerProps): import("react").JSX.Element;
+export declare function STimePicker({ value, onValueChange, onOpenChange, type, size, placeholder, disabled, clearable, showMeridiem, minuteStep, width, name, rules, status, label, labelWidth, icon, iconColor, labelTooltip, labelTooltipProps, addonLabel, addonAlign, hint, error, errorMessage, className, style, }: STimePickerProps): import("react").JSX.Element;

package/dist/components/STimeRangePicker/README.md

@@ -14,7 +14,7 @@
 | `placeholder?` | `string` | `'00:00 ~ 23:59'` |  |
 | `disabled?` | `boolean` | `false` |  |
 | `clearable?` | `boolean` | `false` |  |
-| `useMeridiem?` | `boolean` | — | 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. |
+| `showMeridiem?` | `boolean` | — | 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. |
 | `minuteStep?` | `number` | `1` |  |
 | `rangeOrder?` | `STimeRangePickerRangeOrder` | `'strict'` | 범위 순서 정책. strict는 시작 시간이 종료 시간보다 늦어지지 않도록 보정합니다. |
 | `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. |

package/dist/components/STimeRangePicker/STimeRangePicker.d.ts

@@ -21,7 +21,7 @@ export interface STimeRangePickerProps {
     disabled?: boolean;
     clearable?: boolean;
     /** 오전/오후 선택 표시 여부. 지정하지 않으면 type="midday"일 때만 켜집니다. */
-    useMeridiem?: boolean;
+    showMeridiem?: boolean;
     minuteStep?: number;
     /** 범위 순서 정책. strict는 시작 시간이 종료 시간보다 늦어지지 않도록 보정합니다. */
     rangeOrder?: STimeRangePickerRangeOrder;
@@ -48,12 +48,12 @@ export interface STimeRangePickerProps {
     className?: string;
     style?: CSSProperties;
 }
-export declare function RangeTimeSelector({ value, useMeridiem, minuteStep, rangeOrder, onChange, }: {
+export declare function RangeTimeSelector({ value, showMeridiem, minuteStep, rangeOrder, onChange, }: {
     value?: STimeRangeValue;
-    useMeridiem: boolean;
+    showMeridiem: boolean;
     minuteStep: number;
     rangeOrder: STimeRangePickerRangeOrder;
     onChange: (range: [string, string]) => void;
 }): import("react").JSX.Element;
 /** STimeRangePicker — sd-time-range-picker 포팅. SField + Popover(RangeTimeSelector). */
-export declare function STimeRangePicker({ value, onValueChange, onOpenChange, type, size, placeholder, disabled, clearable, useMeridiem, minuteStep, rangeOrder, width, name, rules, status, label, labelWidth, icon, iconColor, labelTooltip, labelTooltipProps, addonLabel, addonAlign, hint, error, errorMessage, className, style, }: STimeRangePickerProps): import("react").JSX.Element;
+export declare function STimeRangePicker({ value, onValueChange, onOpenChange, type, size, placeholder, disabled, clearable, showMeridiem, minuteStep, rangeOrder, width, name, rules, status, label, labelWidth, icon, iconColor, labelTooltip, labelTooltipProps, addonLabel, addonAlign, hint, error, errorMessage, className, style, }: STimeRangePickerProps): import("react").JSX.Element;

package/dist/components/SToast/README.md

@@ -39,7 +39,7 @@
 | `link?` | `string` | — | 우측 링크 URL |
 | `linkLabel?` | `string` | — | 링크 레이블 (없으면 URL) |
 | `buttonLabel?` | `string` | — | 우측 버튼 레이블 |
-| `useClose?` | `boolean` | `false` | 닫기 버튼 표시 |
+| `showClose?` | `boolean` | `false` | 닫기 버튼 표시 |
 | `type?` | `SToastType` | `'default'` | 타입(색상/프리셋) |
 | `className?` | `string` | — |  |
 | `style?` | `CSSProperties` | — |  |

package/dist/components/SToast/SToast.d.ts

@@ -13,7 +13,7 @@ export interface SToastProps {
     /** 우측 버튼 레이블 */
     buttonLabel?: string;
     /** 닫기 버튼 표시 */
-    useClose?: boolean;
+    showClose?: boolean;
     /** 타입(색상/프리셋) */
     type?: SToastType;
     /** 닫기 (sdClose) */
@@ -24,4 +24,4 @@ export interface SToastProps {
     style?: CSSProperties;
 }
 /** SToast — sd-toast 포팅. 타입별 색상 + 아이콘/링크/버튼/닫기. */
-export declare function SToast({ icon, message, link, linkLabel, buttonLabel, useClose, type, onClose, onButtonClick, className, style, }: SToastProps): import("react").JSX.Element;
+export declare function SToast({ icon, message, link, linkLabel, buttonLabel, showClose, type, onClose, onButtonClick, className, style, }: SToastProps): import("react").JSX.Element;

package/dist/components/STooltip/README.md

@@ -15,7 +15,7 @@
 | `placement?` | `STooltipPlacement` | `'top'` | 표시 방향 |
 | `sideOffset?` | `number` | `8` | 앵커와의 간격(px) |
 | `tooltipType?` | `STooltipType` | `'default'` | 배경/텍스트 색상 타입 |
-| `useClose?` | `boolean` | `false` | 우측 상단 닫기 버튼. 켜면 자동 닫힘이 비활성화되고 X(또는 hide())로만 닫힘 (hover·click 공통, `trigger='none'` 에서는 무시) |
+| `showClose?` | `boolean` | `false` | 우측 상단 닫기 버튼. 켜면 자동 닫힘이 비활성화되고 X(또는 hide())로만 닫힘 (hover·click 공통, `trigger='none'` 에서는 무시) |
 | `disabled?` | `boolean` | `false` | 비활성 — 트리거만 렌더하고 툴팁을 열지 않음 |
 | `children?` | `ReactNode` | — | 커스텀 트리거. 없으면 아이콘 트리거를 렌더 |
 | `icon?` | `SIconName` | `'helpOutline'` | 기본(아이콘) 트리거 설정 |

package/dist/components/STooltip/STooltip.d.ts

@@ -22,7 +22,7 @@ export interface STooltipProps {
     /** 배경/텍스트 색상 타입 */
     tooltipType?: STooltipType;
     /** 우측 상단 닫기 버튼. 켜면 자동 닫힘이 비활성화되고 X(또는 hide())로만 닫힘 (hover·click 공통, `trigger='none'` 에서는 무시) */
-    useClose?: boolean;
+    showClose?: boolean;
     /** 비활성 — 트리거만 렌더하고 툴팁을 열지 않음 */
     disabled?: boolean;
     /** 커스텀 트리거. 없으면 아이콘 트리거를 렌더 */

package/dist/components/STree/README.md

@@ -9,9 +9,9 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `node` | `STreeNode` | — | 렌더링할 노드 |
-| `depth?` | `number` | `1` | 중첩 단계 |
-| `isLast?` | `boolean` | `true` | 마지막 자식 여부 |
-| `ancestorLast?` | `boolean[]` | `[]` | 상위 depth 별 마지막 자식 여부 |
+| `depth?` | `number` | `1` | 중첩 단계. 연결선의 들여쓰기 폭을 정한다. |
+| `last?` | `boolean` | `true` | 마지막 자식 여부. 연결선을 이 아이템에서 끊을지 결정한다. |
+| `ancestorLast?` | `boolean[]` | `[]` | 상위 depth 별 마지막 자식 여부. 조상 쪽 연결선을 어디까지 잇는지 정한다. |
 | `expanded?` | `boolean` | `false` | 펼침 상태 |
 | `selected?` | `boolean` | `false` | 선택 상태 |
 | `guideline?` | `boolean` | `true` | depth 연결선 표시 여부 |
@@ -42,7 +42,7 @@
 | `defaultExpandedIds?` | `string[]` | — | 비제어 펼침 초기값 |
 | `selectable?` | `boolean` | `true` | 체크박스 표시 여부 |
 | `size?` | `STreeSize` | `'sm'` | 타이포그래피 크기 |
-| `useAll?` | `boolean` | `false` | 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 |
+| `showSelectAll?` | `boolean` | `false` | 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 |
 | `guideline?` | `boolean` | `true` | depth 연결선 표시 여부 |
 | `border?` | `boolean` | `true` | 아이템 하단 border 표시 여부 |
 | `cascadeSelection?` | `boolean` | `true` | 부모 선택 시 하위 노드까지 함께 토글 |

package/dist/components/STree/STree.d.ts

@@ -23,11 +23,23 @@ export interface STreeItemRenderState {
 export interface STreeItemProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'title' | 'onSelect' | 'onToggle'> {
     /** 렌더링할 노드 */
     node: STreeNode;
-    /** 중첩 단계 */
+    /**
+     * 중첩 단계. 연결선의 들여쓰기 폭을 정한다.
+     *
+     * @nodemo STree 가 노드를 그리며 채운다 — 소비자가 직접 주는 값이 아니다.
+     */
     depth?: number;
-    /** 마지막 자식 여부 */
-    isLast?: boolean;
-    /** 상위 depth 별 마지막 자식 여부 */
+    /**
+     * 마지막 자식 여부. 연결선을 이 아이템에서 끊을지 결정한다.
+     *
+     * @nodemo STree 가 노드를 그리며 채운다 — 소비자가 직접 주는 값이 아니다.
+     */
+    last?: boolean;
+    /**
+     * 상위 depth 별 마지막 자식 여부. 조상 쪽 연결선을 어디까지 잇는지 정한다.
+     *
+     * @nodemo STree 가 노드를 그리며 채운다 — 소비자가 직접 주는 값이 아니다.
+     */
     ancestorLast?: boolean[];
     /** 펼침 상태 */
     expanded?: boolean;
@@ -68,7 +80,7 @@ export interface STreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'childr
     /** 타이포그래피 크기 */
     size?: STreeSize;
     /** 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 */
-    useAll?: boolean;
+    showSelectAll?: boolean;
     /** depth 연결선 표시 여부 */
     guideline?: boolean;
     /** 아이템 하단 border 표시 여부 */