@x-plat/design-system 0.8.3 → 0.9.0

package/dist/validation-Dqo1zqhT.d.cts

@@ -0,0 +1,13 @@
+/**
+ * 폼 컨트롤 공통 검증 타입.
+ *
+ * 모든 폼 컴포넌트가 같은 모양으로 에러·경고·안내를 받는다.
+ * 렌더는 `components/FieldMessage` 가 전담한다.
+ */
+type ValidationStatus = "error" | "warning" | "success" | "default";
+interface Validation {
+    status: ValidationStatus;
+    message: string;
+}
+
+export type { Validation as V };

package/dist/validation-Dqo1zqhT.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 폼 컨트롤 공통 검증 타입.
+ *
+ * 모든 폼 컴포넌트가 같은 모양으로 에러·경고·안내를 받는다.
+ * 렌더는 `components/FieldMessage` 가 전담한다.
+ */
+type ValidationStatus = "error" | "warning" | "success" | "default";
+interface Validation {
+    status: ValidationStatus;
+    message: string;
+}
+
+export type { Validation as V };

package/guidelines/components/form.md

@@ -1,5 +1,31 @@
 # 폼 컨트롤: CheckBox / Radio / Switch
 
+## 검증 메시지 — 모든 폼 컴포넌트 공통
+
+폼 컨트롤은 **전부 같은 `validations` prop** 으로 에러·경고·안내를 받는다.
+컴포넌트마다 다른 이름이나 모양을 쓰지 않는다.
+
+```tsx
+<Input validations={[{ status: "error", message: "필수 항목입니다" }]} />
+<Select validations={[{ status: "error", message: "선택해 주세요" }]}>…</Select>
+<CheckBox label="동의" validations={[{ status: "error", message: "동의가 필요합니다" }]} />
+```
+
+| | |
+|---|---|
+| 타입 | `{ status: "error" \| "warning" \| "success" \| "default"; message: string }[]` |
+| 적용 | `Input` `PasswordInput` `TextArea` `AutoResizeTextArea` `Select` `CheckBox` `Radio` `Switch` `ChatInput` `FileUpload` `ImageSelector` |
+| 렌더 | `FieldMessage` 가 전담 — 아이콘·색·간격이 한 곳에 모여 있다 |
+
+- 배열이라 **여러 줄을 동시에** 보여줄 수 있다 (비밀번호 규칙 등).
+- `status: "error"` 가 하나라도 있으면 내부 컨트롤에 **`aria-invalid` 가 자동으로** 붙는다.
+- `validations` 를 주지 않으면 **DOM 이 전혀 바뀌지 않는다.** 래퍼도 생기지 않는다.
+
+`Select` 의 `error?: boolean` 은 메시지 없이 테두리만 붉게 할 때를 위해 남아 있다.
+`validations` 와 함께 쓰면 둘 중 하나만 참이어도 에러 스타일이 적용된다.
+
+---
+
 ## CheckBox
 
 ```tsx

package/package.json

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