sellmate-design-system-react 9.0.0-beta.8 → 9.0.0-beta.80

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` | — |  |
@@ -51,6 +51,30 @@
 | `onClose` | `() => void` | 닫기 (sdClose) |
 | `onButtonClick` | `(e: MouseEvent) => void` | 버튼 클릭 (sdButtonClick) |
 
+## Types
+
+### SToastPosition
+
+```ts
+export type SToastPosition =
+  'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+```
+
+### SToastNotifyOptions
+
+```ts
+export interface SToastNotifyOptions extends Omit<SToastProps, 'onClose'> {
+  /** 자동 닫힘 지연(ms). 0이면 자동 닫힘 없음 (없으면 defaultDuration) */
+  duration?: number;
+}
+```
+
+### SToastType
+
+```ts
+export type SToastType = 'default' | 'danger' | 'caution' | 'complete' | 'accent' | 'info';
+```
+
 ## Dependencies
 
 ### Depends on

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/SToggle/README.md

@@ -21,3 +21,11 @@
 |-------|------|-------------|
 | `onValueChange` | `(value: boolean) => void` | 변경 (sdUpdate) |
 
+## Types
+
+### SToggleSize
+
+```ts
+export type SToggleSize = 'xs' | 'sm';
+```
+

package/dist/components/SToggle/index.d.ts

@@ -1 +1 @@
-export { SToggle, type SToggleProps } from './SToggle';
+export { SToggle, type SToggleProps, type SToggleSize } from './SToggle';

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'` | 기본(아이콘) 트리거 설정 |
@@ -40,15 +40,38 @@
 | `show` | `() => void` | 툴팁을 표시합니다. |
 | `hide` | `() => void` | 툴팁을 숨깁니다. |
 
+## Types
+
+### STooltipTrigger
+
+```ts
+export type STooltipTrigger = 'hover' | 'click' | 'none';
+```
+
+### STooltipPlacement
+
+```ts
+export type STooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+```
+
+### STooltipType
+
+```ts
+export type STooltipType = 'default' | 'danger' | 'warning' | 'accent';
+```
+
 ## Dependencies
 
 ### Used by
 
  - [SChipFilter](../SChipFilter)
  - [SField](../SField)
+ - [SGnbSystem](../SGnbSystem)
  - [SKeyValueTable](../SKeyValueTable)
+ - [SRadioButton](../SRadioButton)
  - [SSectionHeaderCard](../SSectionHeaderCard)
  - [SStepper](../SStepper)
+ - [STable](../STable)
 
 ### Depends on
 
@@ -63,8 +86,11 @@ graph TD;
   STooltip --> SIcon
   SChipFilter --> STooltip
   SField --> STooltip
+  SGnbSystem --> STooltip
   SKeyValueTable --> STooltip
+  SRadioButton --> STooltip
   SSectionHeaderCard --> STooltip
   SStepper --> STooltip
+  STable --> STooltip
   style STooltip fill:#f9f,stroke:#333,stroke-width:4px
 ```

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` | 부모 선택 시 하위 노드까지 함께 토글 |
@@ -56,6 +56,44 @@
 | `onValueChange` | `(value: string[], node: STreeNode) => void` | 선택 변경 |
 | `onExpandedChange` | `(expandedIds: string[], node: STreeNode) => void` | 펼침 변경 |
 
+## Types
+
+### STreeNode
+
+```ts
+export interface STreeNode {
+  /** 노드 고유 ID */
+  id: string;
+  /** 노드 라벨 */
+  label: ReactNode;
+  /** 하위 노드 */
+  children?: STreeNode[];
+  /** 선택 비활성. 체크박스만 막고 접기·펼치기는 그대로 된다 (전체 선택·부모 선택에서도 제외) */
+  disabled?: boolean;
+}
+```
+
+### STreeSize
+
+```ts
+export type STreeSize = 'sm' | 'md';
+```
+
+### STreeItemRenderState
+
+```ts
+export interface STreeItemRenderState {
+  node: STreeNode;
+  depth: number;
+  size: STreeSize;
+  expanded: boolean;
+  selected: boolean;
+  indeterminate: boolean;
+  disabled: boolean;
+  hasChildren: boolean;
+}
+```
+
 ## Dependencies
 
 ### Depends on

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

@@ -7,7 +7,7 @@ export interface STreeNode {
     label: ReactNode;
     /** 하위 노드 */
     children?: STreeNode[];
-    /** 비활성 상태 */
+    /** 선택 비활성. 체크박스만 막고 접기·펼치기는 그대로 된다 (전체 선택·부모 선택에서도 제외) */
     disabled?: boolean;
 }
 export interface STreeItemRenderState {
@@ -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 표시 여부 */

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

@@ -2,3 +2,5 @@ import type { STreeNode } from './STree';
 export declare const treeUsageItems: STreeNode[];
 export declare const treeUsageDefaultValue: string[];
 export declare const treeUsageExpandedIds: string[];
+/** 부모가 disabled 여도 자식은 접고 펼 수 있고, 자식 중 정상 노드는 고를 수 있다 */
+export declare const treeDisabledItems: STreeNode[];

package/dist/docs/Gallery.d.ts

@@ -0,0 +1,9 @@
+/**
+ * "한눈에 보기" 그리드.
+ *
+ * 이 파일은 **나열 규칙만** 갖는다 — 분류·순서는 `categories.ts`(SSOT)가, 미리보기는
+ * `gallery-previews.tsx` 가, 링크 대상은 스토리의 `title` 이 정한다. 새 컴포넌트는
+ * 여기를 고치지 않고 그 셋만 채우면 자리를 잡는다.
+ */
+import type { ReactNode } from 'react';
+export default function Gallery(): ReactNode;

package/dist/docs/RecipeGallery.d.ts

@@ -0,0 +1,13 @@
+/**
+ * "페이지 레시피" 상단의 카드 그리드 — 레시피를 화면으로 먼저 보고 골라 들어가게 한다.
+ *
+ * 미리보기는 그림이 아니라 **레시피 파일 그 자체**를 축소해 렌더한 것이다. 그래서 레시피 코드가
+ * 바뀌면 카드도 함께 바뀌고, 따로 갱신할 자산이 없다. 규칙 설명은 이 아래에 AGENTS.md §4 가
+ * 그대로 렌더되므로 여기에는 쓰지 않는다.
+ *
+ * 레시피는 페이지 **안**의 골격이라 GNB·레이아웃은 그리지 않는다 — 셸 조합은 Layout Builder 의 몫이다.
+ *
+ * 새 레시피를 `src/recipes/` 에 만들면 여기에 한 줄을 더한다.
+ */
+import type { ReactNode } from 'react';
+export default function RecipeGallery(): ReactNode;

package/dist/docs/gallery-previews.d.ts

@@ -0,0 +1,24 @@
+/**
+ * "한눈에 보기" 페이지가 쓰는 컴포넌트별 미리보기.
+ *
+ * 이 저장소에서 **손으로 유지하는 유일한 문서 자산**이다. 그래서 두 가지를 지킨다.
+ *
+ * 1. **설명을 쓰지 않는다.** 카드에는 미리보기와 이름과 링크만 있다. "언제 쓰나" 는
+ *    AGENTS.md §3(Guide/컴포넌트 선택)이, Props 는 각 컴포넌트 Docs 탭이 갖는다.
+ *    여기에 한 줄 설명을 붙이는 순간 그 둘과 어긋나기 시작한다.
+ * 2. **빠지면 CI 가 잡는다.** 스토리가 있는 컴포넌트는 전부 여기 키가 있어야 한다 —
+ *    `npm run check:categories` 가 강제한다.
+ *
+ * 미리보기 상자는 `pointer-events-none` 이라 눌리지 않는다(Gallery.tsx). 갤러리는 보는
+ * 자리이고 만지는 자리는 각 컴포넌트의 Docs 탭이다 — 덕분에 오버레이가 열리거나 포커스를
+ * 뺏는 일 없이 수십 개를 한 화면에 살아 있는 채로 둘 수 있다.
+ *
+ * 화면 골격(앱 셸·모달·드로어)처럼 카드에 담기지 않는 것은 {@link note} 로 둔다.
+ * 억지로 축소해 알아볼 수 없는 그림을 넣느니 무엇인지 한 줄로 적는 편이 낫다.
+ */
+import type { ReactNode } from 'react';
+/**
+ * 컴포넌트 이름 → 미리보기.
+ * 키는 스토리 파일이 있는 컴포넌트와 정확히 같아야 한다 (check:categories).
+ */
+export declare const GALLERY_PREVIEWS: Record<string, ReactNode>;

package/dist/fonts/LICENSE.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2021, Kil Hyung-jin (https://github.com/orioncactus/pretendard),
+with Reserved Font Name Pretendard.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.