@makitt.io/mds-mcp-server 0.1.1 → 0.1.2

package/dist/data/playbook/feedback.md

@@ -121,31 +121,55 @@ import { Banner } from '@makitt/mds';
 
 ---
 
-## 5. Notification (영속) — TBD (mds 추가 예정)
+## 5. Notification (영속) — `overlays/Notification/` (Step 14 완료)
 
-> mds 에 영속 Notification 컴포넌트 미존재. 현재는 `<Banner>` 의 long-lived 사용으로 대체.
+영속 알림 inbox + Compound API. `notificationStore` (sessionStorage persist) + `useNotification()` hook.
 
-### 향후 추가 예정
+### Compound API
 
 ```tsx
-// (예정)
-<Notification tone="warning" persistent onDismiss={dismiss}>
-  라이선스가 7일 후 만료됩니다.
-  <Button onClick={renew}>지금 갱신</Button>
-</Notification>
+import { Notification, useNotification } from '@makitt/mds';
+
+// (A) Drawer 안 알림 센터 (Slack inbox 패턴)
+<Drawer.Root>
+  <Drawer.Trigger>알림</Drawer.Trigger>
+  <Drawer.Content side="right">
+    <Drawer.Header><Drawer.Title>알림</Drawer.Title><Drawer.Close /></Drawer.Header>
+    <Drawer.Body>
+      <Notification.Root />  {/* store-bound list 자동 render */}
+    </Drawer.Body>
+  </Drawer.Content>
+</Drawer.Root>
+
+// (B) imperative API — 알림 추가
+const { push, markRead, dismiss, clear } = useNotification();
+
+push({
+  level: 'warning',
+  title: '라이선스 만료 임박',
+  description: '7일 후 만료',
+  action: { label: '갱신', onClick: renew },
+});
 ```
 
-### Banner 와 차이 — 일단 design
+### 핵심
+
+- **`overlays/Notification/`** layer — 알림 센터 는 Drawer / Popover overlay 안 mount (caller 위치 결정, mds 강요 X)
+- **`notificationStore`** — sessionStorage persist (새 session 시 자동 clear, 동일 session 의 dismiss state 유지)
+- **`useNotification()`** hook — items / unreadCount / push / markRead / markAllRead / dismiss / clear
+- **Compound parts** — `Notification.Root` (store-bound list + header + auto empty state)
+- **4 level** — info / success / warning / danger (axe-pass: `role="alert"` for warning/danger, `role="status"` for info/success)
+
+### Banner 와 차이
 
 - **Banner** = 페이지 inline (그 페이지의 상태)
-- **Notification** = global inbox (모든 페이지에서 표시)
-- Persistent = sessionStorage / 서버 상태 — 명시 닫기 전 유지
+- **Notification** = global inbox (모든 페이지 — Drawer / Popover 안 mount)
+- **Persistent** = sessionStorage 명시 dismiss 전 유지 (새 session 시 reset)
 
-### TBD
+### TBD (별도 cycle)
 
-- Notification 의 mount 위치 (top of shell? side inbox?)
-- 다중 notification 의 stacking
-- 닫기 후 다시 나타나는 조건 (서버 trigger / cookie 기반)
+- Server-side dismiss persistence (현재 = sessionStorage client only)
+- Sub-component 분리 export (`Notification.Header`, `Notification.Item`, `Notification.EmptyState`)
 
 ---
 

package/dist/data/playbook/form.md

@@ -68,10 +68,37 @@
 - input 의 a11y attribute (htmlFor / aria-describedby / aria-errormessage / aria-invalid) 자동 wire
 - 원자 input 직접 사용 보다 `Field` compound 권장 (Storybook 의 stories 도 Field 사용 예시)
 
-### 파일 / 이미지 — Step 13 별도
-
-> mds 에 일반 `FileUpload` 컴포넌트 없음 (Step 13 — 별도 신규 작업). 현재 도메인별 구현 (예: web 의 PersonCell avatar / blog 의 cover image).
-> 임시 — domain feature 의 `shared/ui/FileInput/` (TBD), 또는 raw `<input type="file">` + mds wrapper (a11y 보강).
+### 파일 / 이미지 — `FileUpload` (Step 13 완료)
+
+`compounds/FileUpload/` — drag-drop + file picker + preview + per-file progress.
+
+**핵심 — `upload` prop injection** (WYSIWYG editor 패턴):
+
+```tsx
+<Field.Root>
+  <Field.Label>제품 이미지</Field.Label>
+  <FileUpload
+    accept="image/*"
+    multiple
+    maxFiles={10}
+    maxSize={5 * 1024 * 1024}
+    upload={async (file, onProgress) => {
+      const { url } = await uploadToS3(file, onProgress);
+      return { url };
+    }}
+    value={files}
+    onChange={setFiles}
+    onReject={(rejected) => toast.error(rejected[0]?.message)}
+  />
+  <Field.Hint>최대 10MB / image only</Field.Hint>
+</Field.Root>
+```
+
+- mds 는 picker / drag-drop / preview / progress UI 만 책임. server upload (S3 / Cloudinary / 자체 API / multipart) 는 caller 결정.
+- `upload` 안 주면 deferred mode (File 객체 만 보관, form submit 시 caller 가 처리).
+- Controlled (`value` + `onChange`) + Uncontrolled (`defaultValue`) 둘 다 지원.
+- `FileItem`: `{ id, file?, url?, name, size, type, status: 'pending'|'uploading'|'success'|'error', progress?, error? }` — File 객체 + server URL 양쪽 표현 가능 (편집 시 기존 URL 도 자연 처리).
+- `onReject` callback — `accept` / `maxSize` / `maxFiles` validation fail 시.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makitt.io/mds-mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for @makitt/mds — AI 가 catalog + playbook 자동 query (fabrication 0)",
   "repository": {
     "type": "git",