@solapi/ui-kit 1.0.2 → 1.0.4

package/README.md

@@ -9,6 +9,16 @@ Solapi 공용 UI 컴포넌트 라이브러리.
 npm install @solapi/ui-kit
 ```
 
+### CSS 스타일 import
+
+npm 패키지 사용 시 CSS를 별도로 import해야 합니다. (Module Federation은 CSS가 자동 포함되므로 불필요)
+
+```ts
+import '@solapi/ui-kit/styles'
+```
+
+> **주의**: CSS를 import하지 않으면 Modal, Snackbar, Confirm 등 UI 컴포넌트가 렌더링되지만 화면에 보이지 않습니다.
+
 ## Module Federation Exposes
 
 | 모듈 | 경로 | 설명 |
@@ -39,6 +49,8 @@ const UI_KIT_PROVIDER = async () => {
   try {
     return await import('@solapi-frontend/ui-kit/provider')
   } catch {
+    // npm fallback 시 CSS 로드 (Federation은 CSS 자동 포함)
+    await import('@solapi/ui-kit/styles')
     return await import('@solapi/ui-kit')
   }
 }
@@ -126,7 +138,8 @@ const loadModule = async () => {
   try {
     return await import('@solapi-frontend/ui-kit/createMutationConfig')
   } catch {
-    return await import('@solapi/ui-kit/createMutationConfig')
+    // 메인 entry에서 import하여 GlobalUIProvider와 동일한 store 인스턴스 공유
+    return await import('@solapi/ui-kit')
   }
 }
 
@@ -141,7 +154,40 @@ export const loadConfigureMfa = async () => {
 }
 ```
 
-### 6. 사용
+### 6. Error Boundary 감싸기 (선택)
+
+Federation 모듈 로드 실패 시 앱 전체가 깨지는 것을 방지합니다.
+
+```tsx
+// src/uiKit/FederationErrorBoundary.tsx
+import { FederationErrorBoundary } from '@solapi/ui-kit/federation'
+
+function App() {
+  return (
+    <FederationErrorBoundary
+      onError={(error, errorInfo) => {
+        // 에러 로깅 서비스로 전송
+        console.error('Federation 모듈 로드 실패:', error)
+      }}
+      message="UI 모듈을 불러오지 못했습니다."
+    >
+      <GlobalUIProvider>
+        {/* 앱 컨텐츠 */}
+      </GlobalUIProvider>
+    </FederationErrorBoundary>
+  )
+}
+```
+
+| Props | 타입 | 설명 |
+|-------|------|------|
+| `fallback` | `React.ComponentType<{ error, onRetry, onReload }>` | 커스텀 에러 UI |
+| `onError` | `(error, errorInfo) => void` | 에러 발생 시 콜백 |
+| `onRetry` | `() => void` | 재시도 버튼 클릭 시 콜백 |
+| `showDetails` | `boolean` | 에러 상세 정보 표시 여부 |
+| `message` | `string` | 커스텀 에러 메시지 |
+
+### 7. 사용
 
 ```tsx
 import { Tabs, TextInput, Button, Box } from 'uiKit/safeCompLoader'