@x-plat/design-system 0.12.0 → 0.13.0

package/guidelines/components/file-media.md

@@ -14,16 +14,27 @@ import { FileUpload } from "@x-plat/design-system";
 | multiple | `boolean` | `false` | 다중 파일 허용 |
 | maxSize | `number` | — | 최대 파일 크기 (bytes). 초과 파일은 자동 필터 |
 | onChange | `(files: File[]) => void` | — | 파일 선택 콜백 |
-| label | `string` | `"파일을 드래그하거나 클릭하여 업로드"` | 안내 텍스트 |
-| description | `string` | — | 부가 설명 |
+| placeholder | `string` | `"파일을 드래그하거나 클릭하여 업로드"` | **상자 안** 안내 텍스트 |
+| description | `string` | — | 상자 안 부가 설명 |
+| label | `ReactNode` | — | **상자 위** 필드 라벨. 클릭하면 파일 선택창이 열린다 |
+| required | `boolean` | `false` | 라벨 뒤에 `*` 표시 |
+| validations | `Validation[]` | — | 상자 아래 검증 메시지 |
+
+> ⚠ **0.13.0 에서 `label` 의 뜻이 바뀌었다.** 예전에는 상자 **안** 글자였고
+> 지금은 상자 **위** 필드 라벨이다. 상자 안 글자는 `placeholder` 로 옮겼다.
+> 타입 오류가 나지 않고 글자 위치만 바뀌므로 눈으로 확인해야 한다.
+> 자세한 것은 [마이그레이션 노트](../MIGRATION.md) 참고.
 
 ```tsx
 <FileUpload
+  label="첨부파일"
+  required
   accept="image/*"
   multiple
   maxSize={5 * 1024 * 1024}
   onChange={(files) => console.log(files)}
   description="최대 5MB, 이미지만 허용"
+  validations={[{ status: "error", message: "파일을 첨부하세요" }]}
 />
 ```
 
@@ -40,13 +51,19 @@ import { ImageSelector } from "@x-plat/design-system";
 | Prop | 타입 | 기본값 | 설명 |
 |------|------|--------|------|
 | value | `File` | — | 선택된 이미지 파일 |
-| label | `string` | `"이미지 추가하기"` | 빈 상태 안내 텍스트 |
+| placeholder | `string` | `"이미지 추가하기"` | **상자 안** 빈 상태 안내 텍스트 |
 | onChange | `(value: File \| undefined) => void` | — | 변경 콜백 (삭제 시 `undefined`) |
+| label | `ReactNode` | — | **상자 위** 필드 라벨 |
+| required | `boolean` | `false` | 라벨 뒤에 `*` 표시 |
+| validations | `Validation[]` | — | 상자 아래 검증 메시지 |
+
+> ⚠ `FileUpload` 와 같은 변경이 0.13.0 에 있었다. `label` 은 이제 필드 라벨이고,
+> 상자 안 글자는 `placeholder` 다.
 
 ```tsx
 const [image, setImage] = useState<File | undefined>();
 
-<ImageSelector value={image} onChange={setImage} />
+<ImageSelector label="대표 이미지" required value={image} onChange={setImage} />
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x-plat/design-system",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "XPLAT UI Design System",
   "author": "XPLAT WOONG",
   "main": "dist/index.cjs",