sellmate-design-system-react 9.0.0-beta.9 → 9.0.0-beta.91

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,10 +42,9 @@
 | `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` | 부모 선택 시 하위 노드까지 함께 토글 |
 | `leading?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 leading 콘텐츠 |
 | `trailing?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 trailing 콘텐츠 |
 
@@ -56,6 +55,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,13 +80,11 @@ export interface STreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'childr
     /** 타이포그래피 크기 */
     size?: STreeSize;
     /** 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 */
-    useAll?: boolean;
+    showSelectAll?: boolean;
     /** depth 연결선 표시 여부 */
     guideline?: boolean;
     /** 아이템 하단 border 표시 여부 */
     border?: boolean;
-    /** 부모 선택 시 하위 노드까지 함께 토글 */
-    cascadeSelection?: boolean;
     /** 사용자 지정 leading 콘텐츠 */
     leading?: ReactNode | ((state: STreeItemRenderState) => ReactNode);
     /** 사용자 지정 trailing 콘텐츠 */

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

@@ -0,0 +1,49 @@
+# STreeTable
+
+> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
+
+### STreeTable
+
+#### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `rows?` | `TRow[]` | `[]` | 최상위 행. 하위 행은 각 행의 `childrenKey` 필드에 같은 모양으로 넣는다. 펼친 행만 표에 그려진다. 나머지 prop(`columns` · `selectable` · `sort` · `stickyColumn` · `virtualScroll` …)은 `STable` 과 같다. `STable` 처럼 행을 직접 정렬하지 않고 받은 순서대로 그리므로, 정렬하려면 소비 앱이 **형제끼리** 정렬해 넘긴다. 그리는 행이 펼침에 따라 늘고 줄므로, 컬럼의 `renderCell` 로 **`rowSpan` 세로 병합을 하지 않는다** — 행이 접히면 사라진 행 몫까지 병합이 남아 아래 행의 칸을 덮는다. 한 행 안의 `colSpan` 은 된다. |
+| `childrenKey?` | `string` | `'children'` | 하위 행 배열이 든 필드 |
+| `resizable?` | `boolean` | `true` | 컬럼 폭 조절. **`STable` 과 달리 기본이 `true` 다** — 깊이에 따라 트리 컬럼이 필요로 하는 폭이 달라 화면마다 맞는 폭을 미리 정하기 어렵다. 폭이 고정이어야 하는 표만 `false` 로 끈다. 켜 두면 트리 컬럼에 `minWidth` 를 준다. 하한이 없으면 들여쓰기보다 좁게 줄어 깊은 행의 이름이 통째로 가려진다. |
+| `treeColumn?` | `string` | — | 펼침 버튼과 들여쓰기가 붙는 컬럼의 `name`. 주지 않으면 보이는 첫 컬럼이다. 하위 행이 있는 행은 **이 셀 전체가 펼침 영역**이다 — 어디를 눌러도 접고 펴고, 행 클릭(`onRowClick`)으로는 가지 않는다. 셀 안에 넣은 링크·버튼·입력은 자기 동작만 하고 펼침은 일어나지 않는다. 이 컬럼에는 `renderCell` 을 쓰지 않는다 — `<td>` 를 통째로 바꾸면 펼침 버튼을 넣을 자리가 없다. 셀 내용은 `render` · `format` 으로 바꾼다. 들여쓰기가 왼쪽에서 쌓이므로 `align` 은 왼쪽으로 둔다. |
+| `expandedKeys?` | `STreeTableKey[]` | — | 펼친 행의 키 목록 (controlled) |
+| `defaultExpandedKeys?` | `STreeTableKey[]` | — | 비제어 펼침 초기값. 주지 않으면 하위 행이 있는 최상위 행이 펼쳐진 채로 시작한다 (`STree` 와 같다) |
+| `selected?` | `TRow[]` | `[]` | 고른 행 (controlled). 접혀서 보이지 않는 행도 들어 있을 수 있다. 선택은 계층을 따른다. 부모를 고르면 하위 행이 모두 함께 골라지고, 하위 행이 일부만 골라진 부모는 체크박스가 "일부 선택"으로 그려진다. 하위 행이 모두 골라지면 부모도 골라진 것으로 친다 — `onSelectedChange` 로 오는 목록에 부모가 들어간다. 고를 수 없는 행(`isRowSelectable`)과 그 아래는 함께 골라지지 않는다. |
+
+#### Events
+
+| Event | Type | Description |
+|-------|------|-------------|
+| `onExpandedChange` | `(expandedKeys: STreeTableKey[], row: TRow) => void` | 펼침 변경. 바뀐 뒤의 키 목록과 누른 행이 온다 |
+| `onSelectedChange` | `(rows: TRow[]) => void` | 선택 변경. 계층 순서(부모 다음에 그 하위 행)대로 정렬된 목록이 온다 |
+
+## Types
+
+### STreeTableKey
+
+```ts
+/** 행 식별 값 — `rowKey` 필드에 든 값이다 */
+export type STreeTableKey = string | number;
+```
+
+## Dependencies
+
+### Depends on
+
+- [SGhostButton](../SGhostButton)
+- [STable](../STable)
+
+### Graph
+
+```mermaid
+graph TD;
+  STreeTable --> SGhostButton
+  STreeTable --> STable
+  style STreeTable fill:#f9f,stroke:#333,stroke-width:4px
+```

package/dist/components/STreeTable/STreeTable.d.ts

@@ -0,0 +1,70 @@
+import { type ReactElement } from 'react';
+import { type SRow, type STableProps } from '../STable';
+/** 행 식별 값 — `rowKey` 필드에 든 값이다 */
+export type STreeTableKey = string | number;
+/**
+ * STable 에서 받지 않는 prop.
+ *
+ * - 페이지네이션: 페이지 경계가 부모와 자식 사이를 자르면 계층이 읽히지 않는다.
+ * - 드래그 선택·오른쪽 클릭 메뉴: 펼친 순서의 구간은 계층과 어긋난다 — 접힌 자식은 구간에 들지 않는다.
+ * - `isRowIndeterminate`: 일부 선택 표시는 STreeTable 이 계층에서 계산한다.
+ */
+type OmittedTableProps = 'rows' | 'selected' | 'onSelectedChange' | 'isRowIndeterminate' | 'pagination' | 'onPageChange' | 'internalPagination' | 'showRowsPerPageSelect' | 'rowsPerPageOption' | 'onRowsPerPageChange' | 'dragSelectable' | 'contextMenuItems' | 'onContextMenuItemClick';
+export interface STreeTableProps<TRow extends SRow = SRow> extends Omit<STableProps<TRow>, OmittedTableProps> {
+    /**
+     * 최상위 행. 하위 행은 각 행의 `childrenKey` 필드에 같은 모양으로 넣는다.
+     *
+     * 펼친 행만 표에 그려진다. 나머지 prop(`columns` · `selectable` · `sort` · `stickyColumn` ·
+     * `virtualScroll` …)은 `STable` 과 같다. `STable` 처럼 행을 직접 정렬하지 않고 받은 순서대로 그리므로,
+     * 정렬하려면 소비 앱이 **형제끼리** 정렬해 넘긴다.
+     *
+     * 그리는 행이 펼침에 따라 늘고 줄므로, 컬럼의 `renderCell` 로 **`rowSpan` 세로 병합을 하지 않는다** —
+     * 행이 접히면 사라진 행 몫까지 병합이 남아 아래 행의 칸을 덮는다. 한 행 안의 `colSpan` 은 된다.
+     */
+    rows?: TRow[];
+    /** 하위 행 배열이 든 필드 */
+    childrenKey?: string;
+    /**
+     * 컬럼 폭 조절. **`STable` 과 달리 기본이 `true` 다** — 깊이에 따라 트리 컬럼이 필요로 하는 폭이
+     * 달라 화면마다 맞는 폭을 미리 정하기 어렵다. 폭이 고정이어야 하는 표만 `false` 로 끈다.
+     *
+     * 켜 두면 트리 컬럼에 `minWidth` 를 준다. 하한이 없으면 들여쓰기보다 좁게 줄어 깊은 행의 이름이
+     * 통째로 가려진다.
+     */
+    resizable?: boolean;
+    /**
+     * 펼침 버튼과 들여쓰기가 붙는 컬럼의 `name`. 주지 않으면 보이는 첫 컬럼이다.
+     *
+     * 하위 행이 있는 행은 **이 셀 전체가 펼침 영역**이다 — 어디를 눌러도 접고 펴고, 행 클릭(`onRowClick`)으로는
+     * 가지 않는다. 셀 안에 넣은 링크·버튼·입력은 자기 동작만 하고 펼침은 일어나지 않는다.
+     *
+     * 이 컬럼에는 `renderCell` 을 쓰지 않는다 — `<td>` 를 통째로 바꾸면 펼침 버튼을 넣을 자리가 없다.
+     * 셀 내용은 `render` · `format` 으로 바꾼다. 들여쓰기가 왼쪽에서 쌓이므로 `align` 은 왼쪽으로 둔다.
+     */
+    treeColumn?: string;
+    /** 펼친 행의 키 목록 (controlled) */
+    expandedKeys?: STreeTableKey[];
+    /** 비제어 펼침 초기값. 주지 않으면 하위 행이 있는 최상위 행이 펼쳐진 채로 시작한다 (`STree` 와 같다) */
+    defaultExpandedKeys?: STreeTableKey[];
+    /** 펼침 변경. 바뀐 뒤의 키 목록과 누른 행이 온다 */
+    onExpandedChange?: (expandedKeys: STreeTableKey[], row: TRow) => void;
+    /**
+     * 고른 행 (controlled). 접혀서 보이지 않는 행도 들어 있을 수 있다.
+     *
+     * 선택은 계층을 따른다. 부모를 고르면 하위 행이 모두 함께 골라지고, 하위 행이 일부만 골라진 부모는
+     * 체크박스가 "일부 선택"으로 그려진다. 하위 행이 모두 골라지면 부모도 골라진 것으로 친다 —
+     * `onSelectedChange` 로 오는 목록에 부모가 들어간다. 고를 수 없는 행(`isRowSelectable`)과 그 아래는
+     * 함께 골라지지 않는다.
+     */
+    selected?: TRow[];
+    /** 선택 변경. 계층 순서(부모 다음에 그 하위 행)대로 정렬된 목록이 온다 */
+    onSelectedChange?: (rows: TRow[]) => void;
+}
+/**
+ * STreeTable — `STable` 에 행 계층(펼침·접힘)을 붙인 표.
+ *
+ * 계층을 펼친 순서의 평평한 행 목록으로 바꿔 `STable` 에 넘기고, 트리 컬럼 셀에 들여쓰기와
+ * 펼침 버튼을 넣는다. 그래서 헤더·셀·테두리·밀도·정렬 버튼·sticky·가상 스크롤은 `STable` 과 같다.
+ */
+export declare function STreeTable<TRow extends SRow = SRow>({ rows, columns, rowKey, childrenKey, resizable, treeColumn, expandedKeys, defaultExpandedKeys, onExpandedChange, selectable, isRowSelectable, rowClassName, selected, onSelectedChange, ...rest }: STreeTableProps<TRow>): ReactElement | null;
+export {};

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

@@ -0,0 +1,32 @@
+import type { STableColumn } from '../STable';
+/** 스토리·playground 가 함께 쓰는 예시 데이터 — 카테고리 > 상품 > 옵션 3단 */
+export interface TreeTableExampleRow {
+    id: string;
+    name: string;
+    code: string;
+    stock: number;
+    price: number;
+    /** 판매 중지 — 선택 잠금 예시에 쓴다 */
+    stopped?: boolean;
+    children?: TreeTableExampleRow[];
+}
+export declare const treeTableRows: TreeTableExampleRow[];
+export declare const treeTableColumns: STableColumn<TreeTableExampleRow>[];
+/**
+ * 가로로 스크롤되는 넓은 표 — sticky 예시에 쓴다.
+ * 맨 왼쪽은 트리 컬럼(상품명), 맨 오른쪽은 상태다. 남은 폭을 먹는 스페이서는 두지 않는다 —
+ * 스페이서가 끝에 있으면 오른쪽 고정 컬럼이 스페이서가 된다.
+ */
+export declare const treeTableWideColumns: STableColumn<TreeTableExampleRow>[];
+/** 하위 행을 가진 모든 행의 키 — "모두 펼치기" 예시에 쓴다 */
+export declare const treeTableParentKeys: string[];
+/** 깊은 트리 예시 — 창고 > 구역 > 랙 > 단 > 칸, 5단계 로케이션 */
+export interface TreeTableLocationRow {
+    id: string;
+    name: string;
+    qty: number;
+    children?: TreeTableLocationRow[];
+}
+export declare const treeTableLocationRows: TreeTableLocationRow[];
+export declare const treeTableLocationParentKeys: string[];
+export declare const treeTableLocationColumns: STableColumn<TreeTableLocationRow>[];

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

@@ -0,0 +1 @@
+export { STreeTable, type STreeTableProps, type STreeTableKey } from './STreeTable';

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.