motile-ui 0.9.6 → 1.0.0

package/README.md

@@ -9,6 +9,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/motile-ui.svg?style=flat-square)](https://www.npmjs.com/package/motile-ui)
 [![license](https://img.shields.io/npm/l/motile-ui.svg?style=flat-square)](https://github.com/Innopers/motile-ui/blob/main/LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square)](https://www.typescriptlang.org/)
+[![Website](https://img.shields.io/badge/Website-motile--ui.site-green?style=flat-square)](https://www.motile-ui.site/)
 
   <br/>
 

package/dist/components/Popover/Popover.d.ts

@@ -24,7 +24,7 @@ interface PopoverRootProps {
     children: React.ReactNode;
     /**
      * Popover 위치
-     * @default 'bottom'
+     * @default 'top'
      * @type {'top' | 'bottom' | 'left' | 'right'}
      */
     position?: Placement;

package/dist/hooks/useHistoryClose.d.ts

@@ -10,7 +10,7 @@
  * **동작 원리**
  * 1. 모달이 열릴 때 `window.history.pushState()`로 더미 히스토리 항목 추가
  * 2. 브라우저 뒤로가기 시 `popstate` 이벤트가 발생하면 모달 닫기
- * 3. 다른 방법(버튼 클릭, ESC, 외부 클릭 등)으로 닫을 때는 `history.back()`으로 더미 히스토리 제거
+ * 3. 다른 방법(버튼 클릭, ESC, 외부 클릭 등)으로 닫을 때는 히스토리 길이를 비교하여 정리
  *
  * **상태 관리**
  * - `useState`를 사용하여 히스토리 기반 닫기 여부를 추적
@@ -19,8 +19,15 @@
  *
  * **히스토리 정리**
  * - 뒤로가기로 닫을 때: 브라우저가 자동으로 히스토리 pop (history.back() 불필요)
- * - ESC/외부 클릭으로 닫을 때: `history.back()` 호출하여 더미 히스토리 제거
- * - 더미 히스토리가 남지 않아 사용자 경험 개선
+ * - ESC/외부 클릭으로 닫을 때:
+ *   - Sheet 내부에서 페이지 이동이 없었으면 `history.back()` 호출하여 더미 히스토리 제거
+ *   - Sheet 내부에서 페이지 이동이 있었으면 더미 히스토리를 유지 (navigation 우선)
+ * - 더미 히스토리가 불필요하게 남지 않아 사용자 경험 개선
+ *
+ * **Navigation 감지**
+ * - Sheet이 열릴 때 히스토리 길이 저장
+ * - Sheet이 닫힐 때 히스토리 길이 비교로 내부 navigation 여부 판단
+ * - React Router, Next.js Router 등 모든 라우팅 라이브러리와 호환
  *
  * @limitation
  * - 모달 열린 상태에서 새로고침 시 히스토리에 더미 state가 남음
@@ -47,4 +54,4 @@ export interface UseHistoryCloseProps {
      */
     onClose: () => void;
 }
-export declare function useHistoryClose({ onClose, isOpen, }: UseHistoryCloseProps): boolean;
+export declare function useHistoryClose({ onClose, isOpen }: UseHistoryCloseProps): boolean;