@lawkit/ui 0.1.58 → 0.1.59

package/dist/ui-v3/src/lib/useControllableState.d.ts

@@ -0,0 +1,21 @@
+export interface UseControllableStateOptions<T> {
+    /** 제어 값 — `undefined`면 uncontrolled 모드 */
+    value?: T;
+    /** uncontrolled 모드 초기값 (lazy initializer 지원) */
+    defaultValue: T | (() => T);
+    /** 변경 콜백 — controlled/uncontrolled 무관하게 항상 호출 (기존 컴포넌트 동작) */
+    onChange?: (value: T) => void;
+}
+/**
+ * controlled(`value` 전달) / uncontrolled(`defaultValue`) 상태를 통합하는 훅.
+ *
+ * 기존 컴포넌트들의 패턴을 그대로 추출:
+ * ```ts
+ * const isControlled = controlledValue !== undefined;
+ * const value = isControlled ? controlledValue : internalValue;
+ * const set = (next) => { if (!isControlled) setInternalValue(next); onChange?.(next); };
+ * ```
+ *
+ * 반환된 setter는 React의 state setter처럼 참조가 안정적이다.
+ */
+export declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateOptions<T>): [T, (next: T) => void];

package/dist/ui-v3/src/lib/useDismissibleLayer.d.ts

@@ -0,0 +1,27 @@
+import { RefObject } from 'react';
+export interface UseDismissibleLayerOptions {
+    /** 레이어 활성 여부 (보통 open) */
+    enabled: boolean;
+    /** dismiss 동작 (ESC / 바깥 클릭 공통) */
+    onDismiss: () => void;
+    /** 바깥 클릭 판정 기준 요소 — `closeOnOutsideClick`일 때 필수 */
+    ref?: RefObject<HTMLElement | null>;
+    /** Escape 키로 닫기 (기본 true) */
+    closeOnEscape?: boolean;
+    /** 바깥 mousedown으로 닫기 (기본 true, `ref` 필요) */
+    closeOnOutsideClick?: boolean;
+    /** ESC 처리 시 `e.stopPropagation()` 호출 (Modal 계열 기존 동작) */
+    stopEscapePropagation?: boolean;
+    /** ESC 전용 dismiss — 지정 시 ESC에서는 `onDismiss` 대신 호출 (CalendarPopover의 onClose 동반 호출용) */
+    onEscape?: () => void;
+}
+/**
+ * 오버레이 dismiss(ESC 키 + 바깥 mousedown) 감지 훅.
+ *
+ * 기존 컴포넌트들이 각자 등록하던 document 레벨 리스너를 추출한 것으로,
+ * 판정/등록 방식을 그대로 유지한다:
+ * - 바깥 클릭: `mousedown`에서 `ref.current.contains(e.target)` 검사
+ * - ESC: `keydown`에서 `e.key === "Escape"` 검사
+ * - 각 오버레이가 독립적으로 리스너를 갖는 구조 (중첩 시 각자 닫힘 — 기존과 동일)
+ */
+export declare function useDismissibleLayer({ enabled, onDismiss, ref, closeOnEscape, closeOnOutsideClick, stopEscapePropagation, onEscape, }: UseDismissibleLayerOptions): void;

package/dist/ui-v3/src/lib/usePresence.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 닫힘 트랜지션 동안 마운트를 유지하는 훅.
+ *
+ * open → 즉시 마운트, close → `exiting` 상태로 전환 클래스 적용 후
+ * `exitDuration`(ms) 타이머가 끝나면 언마운트. (jsdom에서 transitionend가
+ * 오지 않는 문제를 피하려고 기존 Drawer가 쓰던 setTimeout 방식 그대로)
+ *
+ * @returns `mounted` — 렌더 유지 여부(`open || exiting`), `exiting` — 닫힘 트랜지션 중 여부
+ */
+export declare function usePresence(open: boolean, exitDuration: number): {
+    mounted: boolean;
+    exiting: boolean;
+};

package/dist/ui-v3/src/lib/useScrollLock.d.ts

@@ -0,0 +1,9 @@
+/**
+ * body 스크롤락 획득/복원 훅.
+ *
+ * 기존 Modal/SweetAlert/FullScreenModal/Drawer의 패턴 그대로:
+ * 활성화 시 `document.body.style.overflow`를 `"hidden"`으로 바꾸고,
+ * 해제 시 이전 인라인 값으로 복원한다.
+ * (중첩 시 안쪽 오버레이가 바깥의 `"hidden"`을 이전 값으로 복원 — 기존 동작 동일)
+ */
+export declare function useScrollLock(enabled: boolean): void;

package/dist/ui-v3/src/styles/sprinkles.css.d.ts

@@ -3,27 +3,27 @@ export declare const sprinkles: ((props: {
         mobile?: "flex" | "grid" | "block" | "inline-flex" | "none" | undefined;
         tablet?: "flex" | "grid" | "block" | "inline-flex" | "none" | undefined;
         desktop?: "flex" | "grid" | "block" | "inline-flex" | "none" | undefined;
-    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<2 | 1 | 3, "flex" | "grid" | "block" | "inline-flex" | "none" | null>;
+    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<1 | 2 | 3, "flex" | "grid" | "block" | "inline-flex" | "none" | null>;
     alignItems?: ("stretch" | "center" | {
         mobile?: "stretch" | "center" | undefined;
         tablet?: "stretch" | "center" | undefined;
         desktop?: "stretch" | "center" | undefined;
-    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<2 | 1 | 3, "stretch" | "center" | null>;
+    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<1 | 2 | 3, "stretch" | "center" | null>;
     justifyContent?: ("space-between" | "center" | "flex-start" | {
         mobile?: "space-between" | "center" | "flex-start" | undefined;
         tablet?: "space-between" | "center" | "flex-start" | undefined;
         desktop?: "space-between" | "center" | "flex-start" | undefined;
-    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<2 | 1 | 3, "space-between" | "center" | "flex-start" | null>;
+    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<1 | 2 | 3, "space-between" | "center" | "flex-start" | null>;
     width?: ("100%" | {
         mobile?: "100%" | undefined;
         tablet?: "100%" | undefined;
         desktop?: "100%" | undefined;
-    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<2 | 1 | 3, "100%" | null>;
+    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<1 | 2 | 3, "100%" | null>;
     gap?: ("x1" | "x2" | "x3" | "x4" | "x5" | "x6" | {
         mobile?: "x1" | "x2" | "x3" | "x4" | "x5" | "x6" | undefined;
         tablet?: "x1" | "x2" | "x3" | "x4" | "x5" | "x6" | undefined;
         desktop?: "x1" | "x2" | "x3" | "x4" | "x5" | "x6" | undefined;
-    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<2 | 1 | 3, "x1" | "x2" | "x3" | "x4" | "x5" | "x6" | null>;
+    } | undefined) | import('@vanilla-extract/sprinkles').ResponsiveArray<1 | 2 | 3, "x1" | "x2" | "x3" | "x4" | "x5" | "x6" | null>;
 }) => string) & {
     properties: Set<"alignItems" | "display" | "justifyContent" | "width" | "gap">;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawkit/ui",
-  "version": "0.1.58",
+  "version": "0.1.59",
   "type": "module",
   "description": "LDS Design System — React component library with design tokens",
   "main": "./dist/index.js",