sellmate-design-system-react 9.0.0-beta.103 → 9.0.0-beta.104

package/AGENTS.md

@@ -51,6 +51,7 @@
 | **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
 | **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
 | **알림** | `SToast` `SToastContainer` |
+| **국제화** | `SLocaleProvider`(컴포넌트 내장 문구의 언어 — 앱 루트 1회) `useLocale` |
 
 표에 없는 UI 를 만들어야 할 때만 `div` 로 직접 조립하고, 그때도 §1-2 · §2 의 토큰 규칙을 지킨다.
 
@@ -675,6 +676,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
 | --- | --- | --- |
 | `SModal.*` 로 띄운 모달이 그려질 자리를 만든다 | `SModalOutlet` | §4-1 |
 | `SToast` 가 그려질 자리를 만든다 | `SToastContainer` | §4-1 |
+| 컴포넌트 내장 문구(aria-label·placeholder·"전체" 등)를 사용자 언어로 바꾼다 (국제화) | `SLocaleProvider` | §4-1 |
 
 ### 3-1. 라벨/표시류 — STag vs SBadge vs SChip
 
@@ -1915,7 +1917,7 @@ useEffect(() => {
 | `STimePicker` | md | lg |
 | `STimeRangePicker` | md | lg (오전/오후 표시는 두 사이즈 모두 lg) |
 
-`SDatePicker`·`SDateRangePicker` 에 `showWeekday` 를 켜면 날짜 뒤에 요일이 붙어(`2026-10-19 월요일`) 붙는 글자(띄어쓰기 + 요일 3자) 폭만큼 위 표의 하한·상한이 넓어진다 — 등급이 바뀌는 것이 아니다. 늘어난 폭은 컴포넌트가 스스로 잡으므로 요일 때문에 `width` 를 따로 주지 않는다. 표시만 바뀌고 값 형식은 그대로라, **요일을 붙이려고 값을 가공하거나 `hint` 에 요일을 따로 적지 않는다.**
+`SDatePicker`·`SDateRangePicker` 에 `showWeekday` 를 켜면 날짜 뒤에 요일이 붙어(`2026-10-19 월요일`) 붙는 글자(띄어쓰기 + 요일) 폭만큼 위 표의 하한·상한이 넓어진다 — 등급이 바뀌는 것이 아니다. 늘어난 폭은 컴포넌트가 스스로 잡으므로(요일 문구는 `SLocaleProvider` 로케일을 따라 `2026-10-19 Monday` 처럼 바뀌고, 폭도 그에 맞춰 잡힌다) 요일 때문에 `width` 를 따로 주지 않는다. 표시만 바뀌고 값 형식은 그대로라, **요일을 붙이려고 값을 가공하거나 `hint` 에 요일을 따로 적지 않는다.**
 
 `SDateRangePicker` 가 한 등급씩 위인 것은 값이 `YYYY-MM-DD ~ YYYY-MM-DD` 로 두 배가 넘기 때문이다. 같은 이유로 `STimeRangePicker` 의 오전/오후 모드도 sm 에서 한 등급 위를 쓴다 — 그 모드의 최소 폭이 md 등급을 이미 넘어, 그대로 두면 하한이 상한을 넘어 상한이 무력해진다.
 
@@ -2475,7 +2477,7 @@ import { SLocaleProvider, SModalOutlet } from 'sellmate-design-system-react';
 - **`ja`·`zh` 문구는 원어민 검수 전 초안이다.** 사용자에게 노출하기 전에 검수한다.
 - 일부 문구만 바꾸려면 `messages` 로 덮어쓴다 — 나머지는 로케일 문구를 유지한다. `messages` 는 모듈 상수나 `useMemo` 로 안정시킨다(렌더마다 새 객체를 만들면 하위 컴포넌트가 매번 다시 그려진다).
 - 개별 prop(`placeholder` 등)을 직접 주면 로케일 문구보다 prop 이 우선한다. **내장 문구를 앱이 직접 번역해 prop 으로 넘기지 않는다** — Provider 가 이미 처리한다.
-- 아직 로케일을 따르는 컴포넌트는 `SPagination`·`SSelect` 뿐이고, 나머지는 순차로 옮기는 중이다. 로케일을 바꿔도 그 밖의 컴포넌트 문구는 한국어로 남는다.
+- 컴포넌트가 사용자에게 보여 주는 내장 문구는 모두 로케일을 따른다 — 날짜·시간 컴포넌트의 요일·월·오전/오후 라벨, `SEditor` 툴바, `rules` 의 기본 오류 문구(`false` 를 돌려줄 때)까지 포함한다. **날짜 값의 형식(`YYYY-MM-DD`)은 그대로다.** 개발자에게 던지는 예외·콘솔 메시지는 한국어로 남는다. 예외는 앱이 정하는 데이터다 — 서비스 이름 목록(`SLauncherListBox`)과 `rules` 가 직접 돌려준 오류 문구, 앱이 넘긴 `label`·`options` 는 Provider 가 바꾸지 않는다.
 
 **최소 너비는 `SLayout` 이 보장한다 — 앱이 `min-w-*` 를 직접 주지 않는다.** 창이 최소 너비(`SLAYOUT_MIN_WIDTH`, GNB 포함한 전체 기준)보다 좁아지면 GNB·상단바는 제자리에 남고 **`SPage` 안에만 가로 스크롤이 생긴다.** 문서(브라우저 창)에는 가로 스크롤이 생기지 않는다. 그래서 셸을 감싸는 요소에 `min-width` 나 `overflow-x` 를 걸지 않는다 — 걸면 창 전체가 스크롤되어 GNB 가 화면 밖으로 밀린다.
 

package/dist/components/SAccountListBox/accountListBox.config.d.ts

@@ -7,7 +7,10 @@ export declare const ACCOUNT_LIST_BOX_ICONS: {
     readonly language: "global";
     readonly logout: "logout";
 };
-/** 행 라벨 기본값 — 시안 문구. 앱이 바꿀 수 있다 */
+/**
+ * 행 라벨의 한국어 시안 문구. 컴포넌트는 이 값이 아니라 `SLocaleProvider` 로케일(`accountListBox.*`)을 따른다 —
+ * 앱이 `label` 로 직접 주면 그 값이 우선한다. 시안 문구를 참조하는 소비 앱을 위해 남겨 둔다.
+ */
 export declare const ACCOUNT_LIST_BOX_LABELS: {
     readonly accountSetting: "계정 설정";
     readonly language: "언어 변경";

package/dist/components/SBarcodeInput/README.md

@@ -13,7 +13,7 @@
 | `clearable?` | `boolean` | `false` |  |
 | `autoFocus?` | `boolean` | — |  |
 | `name?` | `string` | — |  |
-| `placeholder?` | `string` | `'입력해 주세요.'` |  |
+| `placeholder?` | `string` | — | 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "입력해 주세요.")를 쓴다 |
 | `disabled?` | `boolean` | `false` |  |
 | `readOnly?` | `boolean` | `false` |  |
 | `rules?` | `Rule[]` | — |  |

package/dist/components/SBarcodeInput/SBarcodeInput.d.ts

@@ -16,6 +16,7 @@ export interface SBarcodeInputProps {
     clearable?: boolean;
     autoFocus?: boolean;
     name?: string;
+    /** 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "입력해 주세요.")를 쓴다 */
     placeholder?: string;
     disabled?: boolean;
     readOnly?: boolean;

package/dist/components/SCalendarBoard/CalendarDayEventListBox.d.ts

@@ -6,7 +6,7 @@ import type { SCalendarBoardEvent } from './types';
  * 칸에서 자라난 것처럼 보이게 하기 위함이다. 위치와 최소 높이는 SCalendarBoard 가 정하고,
  * 그보다 내용이 길면 자라다 상한에서 멈춘다.
  */
-export declare function CalendarDayEventListBox({ date, events, onEventClick, minWidth, minHeight, onClose, closeLabel, }: {
+export declare function CalendarDayEventListBox({ date, events, onEventClick, minWidth, minHeight, onClose, closeLabel: closeLabelProp, }: {
     /** YYYY-MM-DD */
     date: string;
     /**

package/dist/components/SCalendarBoard/README.md

@@ -18,7 +18,7 @@
 | `dayColors?` | `Record<string, SCalendarBoardDayColor>` | — | 날짜별 칸 배경. 키는 `YYYY-MM-DD`, 없는 날짜는 `'default'` 다. 그날의 성격(마감·완료·휴무 등)을 칸 전체로 알릴 때 쓴다 — 일정 하나의 색은 `events[].color` 다. |
 | `dayContent?` | `Record<string, ReactNode>` | — | 날짜별 칸 본문. 키는 `YYYY-MM-DD`, 준 날짜는 **일정 자리를 통째로 이 내용이 차지한다** — 그날의 `events` 는 그리지 않고 목록 판도 열리지 않는다. 일정으로 표현되지 않는 것(재고 현황· 매출 요약 같은 그날치 요약)을 칸에 그대로 얹을 때 쓴다. |
 | `focusedEventId?` | `string \| null` | — | 집중할 일정의 `id`. 그 일정만 또렷하게 남고 **나머지 일정과 "N개 더보기" 는 흐려진다** — 판 밖의 무언가(목록의 행 등)에 손이 닿았을 때 판에서 그에 대응하는 일정을 짚어 주는 데 쓴다. 그 일정이 칸에 담기는 줄 수를 넘겨 **"N개 더보기" 에 접혀 있으면, 그 "더보기" 자리에 대신 그려져** 집중하는 동안만 드러난다. 이미 보이고 있으면 자리는 그대로다 — 어느 쪽이든 다른 일정의 줄 배정은 달라지지 않으므로, 집중이 오가도 판이 출렁이지 않는다. 자리를 내준 칸은 그 동안 "더보기" 를 그리지 않는다(한 줄에 둘을 넣을 수 없다). 거기 남은 일정은 칸을 눌러 목록 판으로 본다. `id` 가 없는 일정은 지목할 수 없다. |
-| `todayLabel?` | `string` | `'오늘'` | 헤더 오른쪽 "오늘" 버튼 레이블. 빈 문자열이면 버튼을 그리지 않는다 |
+| `todayLabel?` | `string` | — | 헤더 오른쪽 "오늘" 버튼 레이블. 빈 문자열이면 버튼을 그리지 않는다 |
 | `moreLabel?` | `string` | — | "N개" 뒤에 붙는 말 |
 | `headerRight?` | `ReactNode` | — | 헤더 오른쪽 끝에 붙일 추가 컨트롤 |
 | `className?` | `string` | — |  |

package/dist/components/SCalendarBoard/SCalendarBoard.d.ts

@@ -80,4 +80,4 @@ export interface SCalendarBoardProps {
  * 보일지" 를 정한다 — 그래서 놓는 자리에 높이를 주어야 한다 (`<div className="h-[640px]">` ·
  * `SPage` 본문의 남은 높이 등). 높이를 주지 않으면 칸이 `dayCard.minHeight` 로 주저앉는다.
  */
-export declare function SCalendarBoard({ year, month, defaultYear, defaultMonth, onViewChange, selectable, value, onValueChange, events, dayColors, dayContent, focusedEventId, onEventClick, onMoreClick, todayLabel, moreLabel, headerRight, className, style, }: SCalendarBoardProps): import("react").JSX.Element;
+export declare function SCalendarBoard({ year, month, defaultYear, defaultMonth, onViewChange, selectable, value, onValueChange, events, dayColors, dayContent, focusedEventId, onEventClick, onMoreClick, todayLabel: todayLabelProp, moreLabel, headerRight, className, style, }: SCalendarBoardProps): import("react").JSX.Element;

package/dist/components/SChatInput/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `value?` | `string` | `''` | 입력값 (제어) |
-| `placeholder?` | `string` | `DEFAULT_PLACEHOLDER` | 안내 문구. 세 제품이 같은 말로 서도록 기본값을 쥐고 있다 |
+| `placeholder?` | `string` | — | 안내 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "메시지를 입력해 주세요...")를 쓴다 |
 | `disabled?` | `boolean` | `false` | 비활성 |
 | `hasAttachments?` | `boolean` | `false` | 보낼 첨부가 쌓여 있는지. 켜면 글이 비어도 전송 버튼이 열린다 — 파일·이미지만 보낼 수 있다. 첨부 목록은 앱이 쥐므로 입력창은 그 유무만 받는다. 첨부를 받는 대화면 쌓인 첨부 수로 켠다. |
 | `attachAccept?` | `string` | — | 파일 선택 창에서 고를 수 있는 형식 (`<input accept>` 와 같다). 예: `'image/*,.pdf'` |

package/dist/components/SChatInput/SChatInput.d.ts

@@ -8,7 +8,7 @@ export interface SChatInputProps extends Omit<TextareaHTMLAttributes<HTMLTextAre
     value?: string;
     /** 값 변경 */
     onValueChange?: (value: string) => void;
-    /** 안내 문구. 세 제품이 같은 말로 서도록 기본값을 쥐고 있다 */
+    /** 안내 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "메시지를 입력해 주세요...")를 쓴다 */
     placeholder?: string;
     /** 비활성 */
     disabled?: boolean;

package/dist/components/SConfirmModal/README.md

@@ -23,7 +23,7 @@
 | `tagSlot?` | `ReactNode` | — | 콘텐츠 박스 tag 위치 커스텀 콘텐츠 (미지정 시 tagLabel 기반 STag) |
 | `optionSlot?` | `ReactNode` | — | 콘텐츠 박스에서 태그 오른쪽 커스텀 콘텐츠 (미지정 시 slotLabel 텍스트) |
 | `contentSlot?` | `ReactNode` | — | 콘텐츠 박스 바로 아래에 통으로 들어가는 커스텀 콘텐츠 (전체 폭) |
-| `mainButtonLabel?` | `string` | `'확인'` | 메인(확인) 버튼에 찍히는 글자 |
+| `mainButtonLabel?` | `string` | — | 메인(확인) 버튼에 찍히는 글자. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "확인")를 쓴다 |
 | `mainButtonOutline?` | `boolean` | — | 메인 버튼을 아웃라인(테두리)으로 세울지. 지정하지 않으면 `type` 이 정한다 — positive·negative 는 채운 버튼, default 는 아웃라인. **색은 여기서 고르지 않는다.** `type` 이 정한다(positive=primary / negative=danger / default=neutral) — 아이콘·제목이 말하는 것과 버튼 색이 어긋나면 읽는 사람이 헷갈리므로 그 조합은 타입에서 막는다. 글자는 `mainButtonLabel` 이다. `type="default"` 에 `false` 를 주면 테두리 없는 흰 버튼이 된다(neutral 은 solid·outline 이 같은 흰 면이고 테두리 유무만 다르다). 확인 버튼이 눌러야 할 것으로 안 읽히므로 권하지 않는다. |
 | `mainButtonDisabled?` | `boolean` | `false` | 메인 버튼을 눌리지 않게 한다. **기본값 `false`.** 모달 안에서 **아직 확정할 수 없을 때** 쓴다 — 동의 체크를 아직 안 했거나, `contentSlot` 의 입력이 덜 찼거나, 확인 뒤에 나갈 요청이 이미 나가는 중일 때. **왜 못 누르는지는 화면이 말해야 한다.** 흐려진 버튼만 남으면 사용자는 고장으로 읽는다 — 못 채운 것을 `bottomMessage` 나 `contentSlot` 안에서 함께 보인다. 서브(취소) 버튼은 따라 잠기지 않는다. 확정하지 못하는 상태일수록 **나가는 길은 열려 있어야** 하기 때문이다. 그래서 서브 버튼을 막는 prop 은 두지 않는다. |
 | `subButtonLabel?` | `string` | — | 서브 버튼에 찍히는 글자. **주지 않는 것이 기본이다** — 비어 있으면 버튼이 아예 서지 않고 확인 하나만 남는다. **`onCancel` 이 닫는 것 말고 따로 할 일이 있을 때만 준다.** 눌러도 창만 닫힌다면 X 버튼이 이미 그 일을 하므로(X 는 늘 서 있고, `persistent` 를 켜지 않았으면 백드롭·ESC 로도 닫힌다) 같은 일을 하는 버튼을 하나 더 세우지 않는다. 되묻는 모달이라고 해서 예외가 아니다 — "삭제할까요?" 에 답하지 않고 나가는 것은 X 로 충분하다. 그래서 서브 버튼이 설 자리는 **확인과 대등한 두 번째 선택지**다. 그때 글자는 `취소`·`닫기` 가 아니라 그 버튼이 하는 일의 이름이 된다. ```tsx ✅ { mainButtonLabel: '자동 취소', subButtonLabel: '수동 처리' } // 두 갈래를 고르게 한다 ❌ { mainButtonLabel: '삭제', subButtonLabel: '취소' } // X 가 이미 하는 일 ``` |

package/dist/components/SConfirmModal/SConfirmModal.d.ts

@@ -29,7 +29,7 @@ export interface SConfirmModalProps {
     optionSlot?: ReactNode;
     /** 콘텐츠 박스 바로 아래에 통으로 들어가는 커스텀 콘텐츠 (전체 폭) */
     contentSlot?: ReactNode;
-    /** 메인(확인) 버튼에 찍히는 글자 */
+    /** 메인(확인) 버튼에 찍히는 글자. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "확인")를 쓴다 */
     mainButtonLabel?: string;
     /**
      * 메인 버튼을 아웃라인(테두리)으로 세울지. 지정하지 않으면 `type` 이 정한다 —
@@ -81,4 +81,4 @@ export interface SConfirmModalProps {
     onClose?: () => void;
 }
 /** SConfirmModal — sd-confirm-modal 포팅. 아이콘+제목+메시지+태그+확인/취소 버튼. */
-export declare function SConfirmModal({ open, onOpenChange, persistent, type, modalTitle, titleClassName, topMessage, bottomMessage, tagLabel, tagShape, tagSize, tagColor, slotLabel, tagSlot, optionSlot, contentSlot, mainButtonLabel, mainButtonOutline, mainButtonDisabled, subButtonLabel, onOk, onCancel, onClose, }: SConfirmModalProps): import("react").JSX.Element;
+export declare function SConfirmModal({ open, onOpenChange, persistent, type, modalTitle, titleClassName, topMessage, bottomMessage, tagLabel, tagShape, tagSize, tagColor, slotLabel, tagSlot, optionSlot, contentSlot, mainButtonLabel: mainButtonLabelProp, mainButtonOutline, mainButtonDisabled, subButtonLabel, onOk, onCancel, onClose, }: SConfirmModalProps): import("react").JSX.Element;

package/dist/components/SEditor/README.md

@@ -59,7 +59,7 @@
 |------|------|---------|-------------|
 | `value?` | `string` | — | 값 (제어) — HTML 문자열 |
 | `defaultValue?` | `string` | — | 초기값 (비제어) — HTML 문자열 |
-| `placeholder?` | `string` | `'내용을 입력해 주세요.'` | 빈 문서에 보일 안내 문구 |
+| `placeholder?` | `string` | — | 빈 문서에 보일 안내 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "내용을 입력해 주세요.")를 쓴다 |
 | `minHeight?` | `number \| string` | `200` | 편집 영역 최소 높이 (숫자=px) |
 | `maxHeight?` | `number \| string` | — | 편집 영역 최대 높이 (숫자=px). 넘으면 편집 영역 안에서만 스크롤한다 |
 | `simple?` | `boolean` | `false` | **글자에 거는 서식만** 남긴다 — 목록·정렬·인용·코드·링크·이미지·구분선이 빠진다. 막대와 버블 메뉴 양쪽에 함께 걸린다 (한쪽에만 남으면 아무것도 막지 못한다). 받은 글의 문단 구조까지 작성자를 따라가면 곤란한 자리 — 좁은 칸의 메모·사유·짧은 안내문 — 에 쓴다. 반대로 서식이 아예 필요 없다면 `SEditor` 가 아니라 `STextarea` 다. |

package/dist/components/SEditor/SEditor.d.ts

@@ -30,7 +30,7 @@ export interface SEditorProps {
     defaultValue?: string;
     /** 값 변경 (sdUpdate) — 빈 문서면 빈 문자열을 준다 */
     onValueChange?: (html: string) => void;
-    /** 빈 문서에 보일 안내 문구 */
+    /** 빈 문서에 보일 안내 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "내용을 입력해 주세요.")를 쓴다 */
     placeholder?: string;
     /** 편집 영역 최소 높이 (숫자=px) */
     minHeight?: number | string;

package/dist/components/SEditor/editor.config.d.ts

@@ -47,6 +47,10 @@ export declare const SEDITOR_SIMPLE_BUBBLE_MENU: SEditorToolbarItem[];
 /** 제목 단계 — 본문 12px 위로 14 / 16 / 18 (DS 타이포 heading sm·md·lg) */
 export declare const SEDITOR_HEADING_LEVELS: readonly [1, 2, 3];
 export type SEditorHeadingLevel = (typeof SEDITOR_HEADING_LEVELS)[number];
+/**
+ * 저장된 HTML 을 읽는 화면이 제목 단계를 부를 때 쓰는 한국어 기본 라벨이다.
+ * 에디터 툴바는 이 값이 아니라 `SLocaleProvider` 로케일(`editor.heading`·`editor.headingBody`)을 따른다.
+ */
 export declare const SEDITOR_HEADING_LABELS: Record<SEditorHeadingLevel | 0, string>;
 /**
  * 글자 크기 선택지 (px) — 워드프로세서의 눈금과 같은 단계다.
@@ -78,7 +82,10 @@ export interface SEditorColorOption {
  * 이미 저장된 글도 따라간다. 대신 **DS `theme.css` 가 없는 환경(메일 본문 등)으로 그대로
  * 내보내면 색이 풀린다** — 그런 반출이 필요하면 내보내는 쪽에서 토큰을 실제 색으로 푼다.
  */
-export declare const SEDITOR_DEFAULT_COLORS: SEditorColorOption[];
+export declare const SEDITOR_DEFAULT_COLORS: (SEditorColorOption & {
+    /** 로케일 메시지(`editor.*`)에서 라벨을 찾는 키 — `label` 은 한국어 기본값이다 */
+    key: 'colorDefault' | 'colorSecondary' | 'colorMuted' | 'colorAccent' | 'colorBrand' | 'colorSuccess' | 'colorWarning' | 'colorDanger';
+})[];
 /**
  * ProseMirror 가 만드는 요소에 붙는 클래스 — 자식 선택자의 기준점이 된다.
  *

package/dist/components/SFooter/README.md

@@ -50,7 +50,7 @@ export type SFooterSize = 'sm' | 'md';
  * **`size` 만 뺀다.** 버튼 크기는 놓이는 위치가 정하므로 footer 의 `size` 가 정한다
  * (AGENTS.md §3-5-2) — 버튼이 자기 크기를 따로 주장할 자리가 아니다.
  *
- * `label`·`color` 는 주지 않으면 footer 가 주 액션 기본값(`'확인'`·`'primary'`)으로 잡는다.
+ * `label`·`color` 는 주지 않으면 footer 가 주 액션 기본값(로케일의 "확인"·`'primary'`)으로 잡는다.
  * 파괴적 액션이라 `danger` 가 필요한 경우는 열어 둔다 (§3-5-3).
  */
 export type SFooterButton = Omit<SButtonProps, 'size'>;

package/dist/components/SFooter/SFooter.d.ts

@@ -18,7 +18,7 @@ export type SFooterSize = 'sm' | 'md';
  * **`size` 만 뺀다.** 버튼 크기는 놓이는 위치가 정하므로 footer 의 `size` 가 정한다
  * (AGENTS.md §3-5-2) — 버튼이 자기 크기를 따로 주장할 자리가 아니다.
  *
- * `label`·`color` 는 주지 않으면 footer 가 주 액션 기본값(`'확인'`·`'primary'`)으로 잡는다.
+ * `label`·`color` 는 주지 않으면 footer 가 주 액션 기본값(로케일의 "확인"·`'primary'`)으로 잡는다.
  * 파괴적 액션이라 `danger` 가 필요한 경우는 열어 둔다 (§3-5-3).
  */
 export type SFooterButton = Omit<SButtonProps, 'size'>;

package/dist/components/SGnbSystem/gnbSystem.config.d.ts

@@ -118,7 +118,3 @@ export declare const GNB_SYSTEM_LAYOUT: {
  * 전용 토큰이 없어 시안 값을 상수로 둔다.
  */
 export declare const GNB_SYSTEM_ALERT_DOT_SIZE = 6;
-/** 알림 버튼 기본 라벨 */
-export declare const GNB_SYSTEM_ALERT_LABEL = "\uC54C\uB9BC";
-/** 설정 버튼 기본 라벨 */
-export declare const GNB_SYSTEM_SETTING_LABEL = "\uC124\uC815";

package/dist/components/SGuide/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `type?` | `SGuideType` | `'tip'` | 가이드 타입 (tip: 팝업, notion: 외부 링크) |
-| `label?` | `string` | `''` | 버튼 레이블 (없으면 type 기본값) |
+| `label?` | `string` | `''` | 버튼 레이블. 생략하면 type 별 기본 문구(tip: "활용 TIP", notion: "사용법 안내" — `SLocaleProvider` 로케일을 따른다) |
 | `message?` | `SGuideMessage` | `''` | 팝업 메시지 (배열이면 리스트, 중첩 배열이면 depth 표현) |
 | `url?` | `string` | `''` | notion 타입 클릭 시 이동 URL |
 | `popupTitle?` | `string` | `''` | 팝업 제목 (없으면 type 기본값) |

package/dist/components/SGuide/SGuide.d.ts

@@ -5,7 +5,7 @@ export type SGuideMessage = string | SGuideMessage[];
 export interface SGuideProps {
     /** 가이드 타입 (tip: 팝업, notion: 외부 링크) */
     type?: SGuideType;
-    /** 버튼 레이블 (없으면 type 기본값) */
+    /** 버튼 레이블. 생략하면 type 별 기본 문구(tip: "활용 TIP", notion: "사용법 안내" — `SLocaleProvider` 로케일을 따른다) */
     label?: string;
     /** 팝업 메시지 (배열이면 리스트, 중첩 배열이면 depth 표현) */
     message?: SGuideMessage;

package/dist/components/SIcon/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `name` | `SIconName` | — | 아이콘명 |
-| `size?` | `number \| string` | `24` | 아이콘 크기(px 또는 CSS 길이). 토큰 크기 `var(--cmp-…)` 도 그대로 넘긴다 |
+| `size?` | `number \| string` | `24` | 아이콘 크기(px 또는 CSS 길이). 토큰 크기 `var(--cmp-…)` 도 그대로 넘긴다. 8 · 10 · 12 · 16 · 20 · 24 · 32 에서는 stroke 아이콘의 선 두께가 화면 px 로 고정돼 작게 줄여도 선이 흐려지지 않는다. 그 밖의 크기와 CSS 길이는 선 두께가 크기에 비례해 줄어든다 |
 | `color?` | `SColor` | — | 아이콘 색상. 팔레트 키(`grey_65`, `red_95` …) 또는 임의 CSS 색상. 미지정 시 currentColor 상속 |
 | `rotate?` | `0 \| 90 \| 180 \| 270` | — | 회전 각도 |
 | `label?` | `string` | — | 접근성 라벨. 없으면 aria-hidden 처리 |

package/dist/components/SIcon/SIcon.d.ts

@@ -4,7 +4,11 @@ import { type SIconName } from './icons.gen';
 export interface SIconProps {
     /** 아이콘명 */
     name: SIconName;
-    /** 아이콘 크기(px 또는 CSS 길이). 토큰 크기 `var(--cmp-…)` 도 그대로 넘긴다 */
+    /**
+     * 아이콘 크기(px 또는 CSS 길이). 토큰 크기 `var(--cmp-…)` 도 그대로 넘긴다.
+     * 8 · 10 · 12 · 16 · 20 · 24 · 32 에서는 stroke 아이콘의 선 두께가 화면 px 로 고정돼 작게 줄여도
+     * 선이 흐려지지 않는다. 그 밖의 크기와 CSS 길이는 선 두께가 크기에 비례해 줄어든다
+     */
     size?: number | string;
     /** 아이콘 색상. 팔레트 키(`grey_65`, `red_95` …) 또는 임의 CSS 색상. 미지정 시 currentColor 상속 */
     color?: SColor;

package/dist/components/SIcon/icons.gen.d.ts

@@ -1,7 +1,9 @@
 import type { SVGProps } from 'react';
 export type IconRenderProps = {
     size?: number | string;
-} & SVGProps<SVGSVGElement>;
+    /** stroke 아이콘의 선 두께(화면 px). 주면 크기와 무관하게 고정되고, 없으면 24 격자 기준 1.5 로 함께 축소된다 */
+    strokeWidth?: number;
+} & Omit<SVGProps<SVGSVGElement>, 'strokeWidth'>;
 export declare const ICONS: {
     readonly account: (p: IconRenderProps) => import("react").JSX.Element;
     readonly add: (p: IconRenderProps) => import("react").JSX.Element;

package/dist/components/SMeatballButton/README.md

@@ -11,8 +11,8 @@
 | `size?` | `SMeatballButtonSize` | `'sm'` | 버튼 크기 |
 | `intent?` | `SMeatballButtonIntent` | `'default'` | 색상 의도. 어두운 배경 위에서는 inverse |
 | `items?` | `SMeatballButtonItem[]` | `[]` | 메뉴 항목 목록 |
-| `tooltipText?` | `string` | `'기능 더 보기'` | 호버 시 표시할 툴팁 텍스트. 빈 문자열이면 툴팁을 띄우지 않는다. 메뉴가 열려 있는 동안은 숨는다. |
-| `ariaLabel?` | `string` | — | 스크린리더용 접근성 레이블. 미지정 시 tooltipText, 그것도 비면 '기능 더 보기' |
+| `tooltipText?` | `string` | — | 호버 시 표시할 툴팁 텍스트. 빈 문자열이면 툴팁을 띄우지 않는다. 메뉴가 열려 있는 동안은 숨는다. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "기능 더 보기")를 쓴다. |
+| `ariaLabel?` | `string` | — | 스크린리더용 접근성 레이블. 미지정 시 tooltipText, 그것도 비면 로케일의 기본 문구(ko: '기능 더 보기') |
 | `disabled?` | `boolean` | `false` | 비활성 |
 | `className?` | `string` | — | 버튼을 감싸는 요소의 클래스. 위치 조정(absolute 배치 등)용 |
 | `style?` | `CSSProperties` | — | 버튼을 감싸는 요소의 스타일. 위치 조정용 |

package/dist/components/SMeatballButton/SMeatballButton.d.ts

@@ -18,9 +18,12 @@ export interface SMeatballButtonProps {
     intent?: SMeatballButtonIntent;
     /** 메뉴 항목 목록 */
     items?: SMeatballButtonItem[];
-    /** 호버 시 표시할 툴팁 텍스트. 빈 문자열이면 툴팁을 띄우지 않는다. 메뉴가 열려 있는 동안은 숨는다. */
+    /**
+     * 호버 시 표시할 툴팁 텍스트. 빈 문자열이면 툴팁을 띄우지 않는다. 메뉴가 열려 있는 동안은 숨는다.
+     * 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "기능 더 보기")를 쓴다.
+     */
     tooltipText?: string;
-    /** 스크린리더용 접근성 레이블. 미지정 시 tooltipText, 그것도 비면 '기능 더 보기' */
+    /** 스크린리더용 접근성 레이블. 미지정 시 tooltipText, 그것도 비면 로케일의 기본 문구(ko: '기능 더 보기') */
     ariaLabel?: string;
     /** 비활성 */
     disabled?: boolean;

package/dist/components/SModalContainer/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `open?` | `boolean` | — | 표시 여부 (제어) |
-| `ariaTitle?` | `string` | `'모달'` | 접근성 제목 (스크린리더용). 시각 제목은 children이 담당 |
+| `ariaTitle?` | `string` | — | 접근성 제목 (스크린리더용). 시각 제목은 children이 담당. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "모달")를 쓴다. |
 | `showClose?` | `boolean` | `false` | 우측 상단 닫기 버튼 |
 | `persistent?` | `boolean` | `true` | 백드롭 클릭·ESC로 닫히지 않고 흔들림(shake) 애니메이션 (sd-modal-container persistent). **기본값 true** — 모달은 작성 중인 내용을 잃지 않도록 임의 닫힘을 막는 것이 기본이다. 닫기 경로는 X 버튼과 모달 안의 버튼뿐이다. false로 주면 백드롭·ESC 닫기가 열린다. |
 | `width?` | `number \| string` | — | 너비/높이 |

package/dist/components/SModalContainer/SModalContainer.d.ts

@@ -9,7 +9,10 @@ export interface SModalContainerProps {
     open?: boolean;
     /** 표시 상태 변경 */
     onOpenChange?: (open: boolean) => void;
-    /** 접근성 제목 (스크린리더용). 시각 제목은 children이 담당 */
+    /**
+     * 접근성 제목 (스크린리더용). 시각 제목은 children이 담당.
+     * 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "모달")를 쓴다.
+     */
     ariaTitle?: string;
     /** 우측 상단 닫기 버튼 */
     showClose?: boolean;
@@ -38,4 +41,4 @@ export interface SModalContainerProps {
  * 소비자는 직접 import 할 수 없고, SConfirmModal/SActionModal/SLoadingModal 세 모달의
  * 공통 컨테이너로만 조합해 쓴다. barrel(src/index.ts)에 다시 추가하지 말 것.
  */
-export declare function SModalContainer({ open, onOpenChange, ariaTitle, showClose, onClose, persistent, width, height, children, className, style, }: SModalContainerProps): import("react").JSX.Element;
+export declare function SModalContainer({ open, onOpenChange, ariaTitle: ariaTitleProp, showClose, onClose, persistent, width, height, children, className, style, }: SModalContainerProps): import("react").JSX.Element;

package/dist/components/SNumberInput/README.md

@@ -23,7 +23,7 @@
 | `inputStyle?` | `CSSProperties` | — | 네이티브 input style |
 | `autoFocus?` | `boolean` | — | 마운트 시 자동 포커스 |
 | `name?` | `string` | — | 폼 연동 name |
-| `placeholder?` | `string` | `'입력해 주세요.'` |  |
+| `placeholder?` | `string` | — |  |
 | `disabled?` | `boolean` | `false` |  |
 | `readOnly?` | `boolean` | `false` |  |
 | `rules?` | `Rule[]` | — | 유효성 규칙 — blur 시 검증 |

package/dist/components/SSearchInput/README.md

@@ -10,7 +10,7 @@
 |------|------|---------|-------------|
 | `value?` | `string \| number` | — | 값 (제어) |
 | `size?` | `SSearchInputSize` | `'sm'` | 크기 |
-| `placeholder?` | `string` | `'결과 내 검색'` | 플레이스홀더 |
+| `placeholder?` | `string` | — | 플레이스홀더. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "결과 내 검색")를 쓴다 |
 | `clearable?` | `boolean` | `false` | 지우기 버튼 — 값이 있을 때만 나타난다 |
 | `disabled?` | `boolean` | `false` | 비활성 |
 | `width?` | `SFieldWidth` | — | 컨트롤 너비 — 폭 등급(`'xs' | 'sm' | 'md' | 'lg' | 'xl'`) · 숫자=px · CSS 길이. 등급은 `--cmp-field-width-*` 토큰으로 풀리므로 토큰이 바뀌면 화면이 따라간다. 값 길이에 상한이 없으면 `"100%"` 로 두어 행 전체를 쓴다. 미지정 시 부모 폭을 채운다. |

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

@@ -16,7 +16,7 @@ export interface SSearchInputProps extends Omit<InputHTMLAttributes<HTMLInputEle
     onSearch?: (value: string) => void;
     /** 크기 */
     size?: SSearchInputSize;
-    /** 플레이스홀더 */
+    /** 플레이스홀더. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "결과 내 검색")를 쓴다 */
     placeholder?: string;
     /** 지우기 버튼 — 값이 있을 때만 나타난다 */
     clearable?: boolean;

package/dist/components/SStepper/README.md

@@ -13,7 +13,7 @@
 | `size?` | `SStepperSize` | `'sm'` | 크기 |
 | `vertical?` | `boolean` | `false` | 세로형 여부 |
 | `clickable?` | `boolean` | — | 단계 클릭 가능 여부. 미지정 시 가로형=false, 세로형=true |
-| `ariaLabel?` | `string` | `'진행 단계'` | 접근성 레이블 |
+| `ariaLabel?` | `string` | — | 접근성 레이블. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "진행 단계")를 쓴다 |
 | `className?` | `string` | — |  |
 | `style?` | `CSSProperties` | — |  |
 

package/dist/components/SStepper/SStepper.d.ts

@@ -13,7 +13,7 @@ export interface SStepperProps {
     clickable?: boolean;
     /** 단계 선택 시 호출 */
     onValueChange?: (value: string, item: SStepperItem, index: number) => void;
-    /** 접근성 레이블 */
+    /** 접근성 레이블. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "진행 단계")를 쓴다 */
     ariaLabel?: string;
     className?: string;
     style?: CSSProperties;
@@ -22,7 +22,7 @@ export interface SStepperProps {
  * ref 로 노출되는 커스텀 툴팁 제어 API. 세로형 전용 — items 중 error 가 true 인 첫 번째
  * 아이템의 텍스트+뱃지 영역에 표시된다.
  *
- * 지금은 대상(첫 번째 error 아이템 하나)·문구·스타일이 hover 툴팁(ERROR_TOOLTIP_MESSAGE, danger)과
+ * 지금은 대상(첫 번째 error 아이템 하나)·문구·스타일이 hover 툴팁(로케일의 stepper.errorTooltip, danger)과
  * 동일하게 고정되어 있다 — 열고 닫는 타이밍만 소비자가 제어한다. 대상 아이템을 지정하거나
  * content·type 을 커스터마이즈하는 기능은 필요해지면 추가한다(지금은 만들지 않음).
  */

package/dist/components/STable/README.md

@@ -14,7 +14,7 @@
 | `rowKey?` | `string` | `'id'` | 행 식별 필드 |
 | `selectable?` | `boolean` | `false` | 행 선택 체크박스 |
 | `rowSelectLabel?` | `(row: TRow) => string` | — | 행 선택 체크박스의 접근성 이름 — 화면 낭독기가 어느 행의 체크박스인지 읽게 한다. 그 행을 가리키는 글자(주문번호·상품명 등)로 만든다: `row => \`${row.orderNo} 선택\``. 주지 않으면 모든 행이 `행 선택` 으로 읽혀 행끼리 구분되지 않는다. |
-| `selectAllLabel?` | `string` | `'전체 선택'` | 헤더 전체 선택 체크박스의 접근성 이름 |
+| `selectAllLabel?` | `string` | — | 헤더 전체 선택 체크박스의 접근성 이름. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "전체 선택")를 쓴다 |
 | `dragSelectable?` | `boolean` | `false` | 행을 드래그해서 고른다. 기본 `false`. 고르는 수단만 다를 뿐 `selectable` 과 같은 선택이다 — `selected` · `onSelectedChange` · `isRowSelectable` 을 그대로 쓴다. 체크박스 열은 생기지 않고, 대신 고른 구간이 배경색과 바깥 테두리로 표시된다. **`selectable` 과 함께 켜면 `selectable` 이 이긴다** — 체크박스가 있는 표에서 드래그까지 걸리면 글자를 긁으려던 손이 선택을 갈아치운다. 둘 다 필요해 보이면 체크박스 쪽만 남긴다. 누른 자리가 구간의 기준점이고, 끌어간 자리까지가 구간이다. **새로 끌면 이전 선택은 풀린다** — 기존 선택에 더하려면 `Ctrl`(macOS 는 `Cmd`)을 짚고 끈다. 잠긴 행(`isRowSelectable`)은 구간 안에 있어도 그냥 지나간다. **켜 두면 셀 안의 글자를 긁어 복사할 수 없다** — 끌기가 곧 선택이라 글자 선택과 같은 손짓을 두고 다툰다. 값을 복사해 가는 표에는 켜지 않는다. 셀 안의 버튼·입력은 그대로 눌린다. |
 | `contextMenuItems?` | `STableContextMenuItem[]` | — | 드래그 선택에서 **행을 오른쪽 클릭했을 때** 커서 자리에 뜨는 메뉴의 항목. 주지 않거나 비면 메뉴가 뜨지 않고 브라우저 기본 메뉴가 나온다. **`dragSelectable` 에서만 동작한다** — 체크박스 모드에서는 무시된다. 고르지 않은 행에서 누르면 **그 행만 고른 뒤** 열린다. 메뉴가 다룰 대상과 화면에 칠해진 것이 어긋나지 않게 하기 위함이다. 잠긴 행(`isRowSelectable`) 위에서는 열리지 않는다 — 고를 수 없는 행을 대상으로 삼을 수 없기 때문이다. |
 | `isRowSelectable?` | `(row: TRow) => boolean` | — | 이 행을 고를 수 있는가. 주지 않으면 모든 행을 고를 수 있다. 고를 수 없는 행은 체크박스가 잠기고, **전체 선택·Shift 구간 선택의 셈에서도 빠진다** — 잠긴 행이 셈에 남으면 "전부 선택됨"에 닿지 못해 헤더 체크박스가 해제 방향으로 가지 못한다. 목록에서 지워 버리는 것과 다르다. 실패 0건인 차수처럼 **자리는 보여야 하지만 대상이 될 수는 없는 행**에 쓴다. 아예 대상이 아니라면 `rows` 에서 거르는 편이 낫다. 잠금은 그리기 시점의 판정일 뿐이라, 이미 `selected` 에 든 행이 나중에 잠겨도 DS 가 빼지 않는다(제어 상태를 말없이 바꾸지 않는다). 다만 헤더의 전체 해제로는 걷어낼 수 있다. |
@@ -28,7 +28,7 @@
 | `stickyColumn?` | `STableStickyColumn` | — | 고정할 좌/우 컬럼 수 |
 | `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
 | `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. 페이지네이션 바의 테두리와 1px 겹침(`-mt-px`)도 함께 꺼진다. 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다. |
-| `emptyLabel?` | `string` | `'데이터가 없습니다.'` |  |
+| `emptyLabel?` | `string` | — | 데이터가 없을 때 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "데이터가 없습니다.")를 쓴다 |
 | `emptySlot?` | `ReactNode` | — | 데이터가 없을 때 body 영역 전체를 대체하는 슬롯. 지정하면 `emptyLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다. |
 | `loading?` | `boolean` | `false` |  |
 | `dense?` | `boolean` | `false` | 행 높이를 좁게 (세로 여백만 줄인다 — 좌우 패딩은 그대로). **시작 밀도이자 밀도 토글의 스위치다.** 켜면 하단 바 우측에 `좁게 보기` · `넓게 보기` 토글이 붙는다 — 페이지네이션이 없으면 이 바를 토글만 담아 그린다. 누른 뒤의 밀도는 테이블이 내부 상태로 들고 가므로 `onDenseChange` 를 받지 않아도 토글은 동작하고, 넓게 본 뒤에도 토글은 그대로 남는다(붙일지는 이 prop 이 정한다). 이 prop 값이 바뀌면 내부 밀도도 그 값으로 맞춰진다. |
@@ -36,7 +36,7 @@
 | `pagination?` | `STablePagination` | — | 페이지네이션 (있으면 하단 표시) |
 | `internalPagination?` | `boolean` | `false` | 테이블 내부에서 페이지네이션을 직접 관리 (rows를 내부 슬라이싱) |
 | `showRowsPerPageSelect?` | `boolean` | `false` | 페이지당 행 수 셀렉트 표시 |
-| `rowsPerPageOption?` | `SSelectOption[]` | `DEFAULT_ROWS_PER_PAGE_OPTION` |  |
+| `rowsPerPageOption?` | `SSelectOption[]` | — | 페이지당 행 수 선택지. 생략하면 10·25·50·100 을 `SLocaleProvider` 로케일 문구(ko: "10개씩 보기")로 보여 준다 |
 | `virtualScroll?` | `boolean` | `false` | 가상 스크롤 |
 | `rowHeight?` | `number` | — | 행 높이의 **출발점**(px). 미지정이면 밀도에 따라 44 / 32. 행마다 높이가 달라도 된다 — 화면에 나온 행은 실제 높이를 재서 덮으므로, 이 값은 **아직 안 그려진 행의 추정치**이자 행의 최소 높이일 뿐이다. 실측이 쌓일수록 뒤쪽 추정도 그 평균으로 수렴한다. 그래서 높이가 제각각인 표에서 "가장 흔한 높이"를 넣어 두면 충분하다. 값이 실제와 멀수록 아직 안 그려진 구간의 스크롤바 길이만 덜 정확할 뿐, 그리는 위치는 어긋나지 않는다. |
 | `virtualBuffer?` | `number` | `5` |  |

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

@@ -259,7 +259,7 @@ export interface STableProps<TRow extends SRow = SRow> {
      * 주지 않으면 모든 행이 `행 선택` 으로 읽혀 행끼리 구분되지 않는다.
      */
     rowSelectLabel?: (row: TRow) => string;
-    /** 헤더 전체 선택 체크박스의 접근성 이름 */
+    /** 헤더 전체 선택 체크박스의 접근성 이름. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "전체 선택")를 쓴다 */
     selectAllLabel?: string;
     /**
      * 행을 드래그해서 고른다. 기본 `false`.
@@ -363,6 +363,7 @@ export interface STableProps<TRow extends SRow = SRow> {
      * 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
      */
     bordered?: boolean;
+    /** 데이터가 없을 때 문구. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "데이터가 없습니다.")를 쓴다 */
     emptyLabel?: string;
     /**
      * 데이터가 없을 때 body 영역 전체를 대체하는 슬롯.
@@ -395,6 +396,7 @@ export interface STableProps<TRow extends SRow = SRow> {
     internalPagination?: boolean;
     /** 페이지당 행 수 셀렉트 표시 */
     showRowsPerPageSelect?: boolean;
+    /** 페이지당 행 수 선택지. 생략하면 10·25·50·100 을 `SLocaleProvider` 로케일 문구(ko: "10개씩 보기")로 보여 준다 */
     rowsPerPageOption?: SSelectOption[];
     onRowsPerPageChange?: (perPage: number) => void;
     /** 가상 스크롤 */

package/dist/components/STableBar/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `title?` | `ReactNode` | — | 건수 앞에 서는 제목 슬롯. 이 바가 무엇의 목록인지 말한다. 문자열을 주면 바의 기본 타이포로 그린다. 다른 모양이 필요하면 요소를 통째로 넘긴다 — 슬롯이라 안에 무엇이 오든 자리만 잡아 준다. |
-| `total?` | `number` | — | 전체 건수. 지정하면 "총 N 건" 을 표시한다 (천단위 구분 자동) |
+| `total?` | `number` | — | 전체 건수. 지정하면 "총 N 건" 을 표시한다 (천단위 구분 자동, 문구는 `SLocaleProvider` 로케일을 따른다) |
 | `selected?` | `number` | — | 선택 건수. 지정하면 "N건 선택" 을 표시한다 |
 | `actions?` | `ReactNode` | — | 구분선 오른쪽 좌측 액션 영역 |
 | `rightActions?` | `ReactNode` | — | 우측 정렬 액션 영역 |

package/dist/components/STableBar/STableBar.d.ts

@@ -7,7 +7,7 @@ export interface STableBarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
      * 슬롯이라 안에 무엇이 오든 자리만 잡아 준다.
      */
     title?: ReactNode;
-    /** 전체 건수. 지정하면 "총 N 건" 을 표시한다 (천단위 구분 자동) */
+    /** 전체 건수. 지정하면 "총 N 건" 을 표시한다 (천단위 구분 자동, 문구는 `SLocaleProvider` 로케일을 따른다) */
     total?: number;
     /** 선택 건수. 지정하면 "N건 선택" 을 표시한다 */
     selected?: number;

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

@@ -1,3 +1,4 @@
+import { type SLocaleMessages } from '../../lib/locale';
 import { type SFieldWidthGrade } from '../../lib/field-width';
 export type STimePickerSize = 'sm' | 'md';
 export type STimePickerType = 'default' | 'midday';
@@ -30,4 +31,4 @@ export declare function parseTimeValue(value: string | null | undefined): {
     minute: number;
 };
 export declare function formatTimeValue(hour: number, minute: number): string;
-export declare function formatTimeDisplay(value: string | null | undefined, type: STimePickerType): string;
+export declare function formatTimeDisplay(value: string | null | undefined, type: STimePickerType, t: SLocaleMessages['date']): string;

package/dist/components/STimeRangePicker/time-range-picker.config.d.ts

@@ -1,3 +1,4 @@
+import { type SLocaleMessages } from '../../lib/locale';
 import { TIMEPICKER_SIZE_CONFIG, clampTimePart, formatTimeDisplay, formatTimeValue, parseTimeValue, type STimePickerMeridiem, type STimePickerSize, type STimePickerType } from '../STimePicker/timepicker.config';
 export type STimeRangePickerSize = STimePickerSize;
 export type STimeRangePickerType = STimePickerType;
@@ -6,4 +7,4 @@ export type STimeRangePickerRangeOrder = 'strict' | 'allow-cross-day';
 export type STimeRangeValue = [string, string] | null;
 export { TIMEPICKER_SIZE_CONFIG as TIME_RANGE_PICKER_SIZE_CONFIG, clampTimePart, formatTimeDisplay, formatTimeValue, parseTimeValue, };
 export declare function normalizeTimeRangeValue(value: STimeRangeValue, rangeOrder?: STimeRangePickerRangeOrder): STimeRangeValue;
-export declare function formatTimeRangeDisplay(value: STimeRangeValue, type: STimeRangePickerType): string;
+export declare function formatTimeRangeDisplay(value: STimeRangeValue, type: STimeRangePickerType, t: SLocaleMessages['date']): string;

package/dist/components/STimeline/README.md

@@ -9,7 +9,7 @@
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `groups` | `STimelineGroup[]` | — | 머리글로 묶은 항목 목록. 순서 그대로 그린다 |
-| `emptyText?` | `ReactNode` | `'내역이 없습니다.'` | 항목이 하나도 없을 때 가운데 띄우는 안내. 불러오는 중에는 `null` 을 넘겨 빈 안내가 먼저 깜빡이지 않게 한다. |
+| `emptyText?` | `ReactNode` | — | 항목이 하나도 없을 때 가운데 띄우는 안내. 불러오는 중에는 `null` 을 넘겨 빈 안내가 먼저 깜빡이지 않게 한다. 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "내역이 없습니다.")를 쓴다. |
 
 ## Types
 

package/dist/components/STimeline/STimeline.d.ts

@@ -21,6 +21,7 @@ export interface STimelineProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
     /**
      * 항목이 하나도 없을 때 가운데 띄우는 안내.
      * 불러오는 중에는 `null` 을 넘겨 빈 안내가 먼저 깜빡이지 않게 한다.
+     * 생략하면 `SLocaleProvider` 로케일의 기본 문구(ko: "내역이 없습니다.")를 쓴다.
      */
     emptyText?: ReactNode;
 }