@m1kapp/kit 0.0.20 → 0.0.21

package/dist/index.d.mts

@@ -79,6 +79,9 @@ interface FabProps {
 /**
  * Floating Action Button — positioned absolute bottom-right inside AppShell.
  *
+ * Portals into the nearest `.in-app-sheet-content-portal` (AppShellContent wrapper)
+ * so it stays pinned regardless of scroll content height.
+ *
  * @example
  * <AppShellContent>
  *   {content}
@@ -588,6 +591,15 @@ declare function useEscapeKey(active: boolean, onEscape: () => void): void;
  */
 declare function useScrollLock(active: boolean, anchorRef?: RefObject<HTMLElement | null>): void;
 
+/**
+ * Finds the nearest portal container by walking up from a hidden anchor span.
+ * Searches for `selectors` in order via `.closest()`, falls back to `document.body`.
+ *
+ * Returns `[anchorRef, target]` — attach `anchorRef` to a hidden `<span>` so
+ * the DOM walk has a starting point.
+ */
+declare function usePortalTarget(selectors?: string | string[]): [React.RefObject<HTMLSpanElement | null>, HTMLElement | null];
+
 interface SkeletonProps {
     /** Tailwind classes for width / height (e.g. "h-4 w-3/4") */
     className?: string;
@@ -629,6 +641,8 @@ interface InAppSheetProps {
     onClose: () => void;
     children: React.ReactNode;
     className?: string;
+    /** 시트 상단 타이틀 — X 버튼과 나란히 정렬 */
+    title?: string;
     /** true면 시트가 AppShell 전체 높이를 채움 */
     fullHeight?: boolean;
     /** 우상단 X 버튼 숨기기. Default: false (보임) */
@@ -636,7 +650,7 @@ interface InAppSheetProps {
     /** 닫기 버튼 aria-label. Default: "닫기" */
     closeLabel?: string;
 }
-declare function InAppSheet({ open, onClose, children, className, fullHeight, hideClose, closeLabel, }: InAppSheetProps): react_jsx_runtime.JSX.Element;
+declare function InAppSheet({ open, onClose, children, className, title, fullHeight, hideClose, closeLabel, }: InAppSheetProps): react_jsx_runtime.JSX.Element;
 
 type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
@@ -851,4 +865,4 @@ declare function formatPrice(amount: number, currency?: string, locale?: string)
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, type ColorName, Dialog, type DialogProps, Divider, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, InAppSheet, type InAppSheetProps, KitStyles, PWAInstallButton, type PWAInstallState, Section, SectionHeader, type SectionHeaderProps, type SectionProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fontFamily, fonts, formatNumber, formatPrice, mobileViewport, relativeTime, svgIcon, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, useScrollLock, useShare, useToast };
+export { type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, type ColorName, Dialog, type DialogProps, Divider, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, InAppSheet, type InAppSheetProps, KitStyles, PWAInstallButton, type PWAInstallState, Section, SectionHeader, type SectionHeaderProps, type SectionProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fontFamily, fonts, formatNumber, formatPrice, mobileViewport, relativeTime, svgIcon, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast };

package/dist/index.d.ts

@@ -79,6 +79,9 @@ interface FabProps {
 /**
  * Floating Action Button — positioned absolute bottom-right inside AppShell.
  *
+ * Portals into the nearest `.in-app-sheet-content-portal` (AppShellContent wrapper)
+ * so it stays pinned regardless of scroll content height.
+ *
  * @example
  * <AppShellContent>
  *   {content}
@@ -588,6 +591,15 @@ declare function useEscapeKey(active: boolean, onEscape: () => void): void;
  */
 declare function useScrollLock(active: boolean, anchorRef?: RefObject<HTMLElement | null>): void;
 
+/**
+ * Finds the nearest portal container by walking up from a hidden anchor span.
+ * Searches for `selectors` in order via `.closest()`, falls back to `document.body`.
+ *
+ * Returns `[anchorRef, target]` — attach `anchorRef` to a hidden `<span>` so
+ * the DOM walk has a starting point.
+ */
+declare function usePortalTarget(selectors?: string | string[]): [React.RefObject<HTMLSpanElement | null>, HTMLElement | null];
+
 interface SkeletonProps {
     /** Tailwind classes for width / height (e.g. "h-4 w-3/4") */
     className?: string;
@@ -629,6 +641,8 @@ interface InAppSheetProps {
     onClose: () => void;
     children: React.ReactNode;
     className?: string;
+    /** 시트 상단 타이틀 — X 버튼과 나란히 정렬 */
+    title?: string;
     /** true면 시트가 AppShell 전체 높이를 채움 */
     fullHeight?: boolean;
     /** 우상단 X 버튼 숨기기. Default: false (보임) */
@@ -636,7 +650,7 @@ interface InAppSheetProps {
     /** 닫기 버튼 aria-label. Default: "닫기" */
     closeLabel?: string;
 }
-declare function InAppSheet({ open, onClose, children, className, fullHeight, hideClose, closeLabel, }: InAppSheetProps): react_jsx_runtime.JSX.Element;
+declare function InAppSheet({ open, onClose, children, className, title, fullHeight, hideClose, closeLabel, }: InAppSheetProps): react_jsx_runtime.JSX.Element;
 
 type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
@@ -851,4 +865,4 @@ declare function formatPrice(amount: number, currency?: string, locale?: string)
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, type ColorName, Dialog, type DialogProps, Divider, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, InAppSheet, type InAppSheetProps, KitStyles, PWAInstallButton, type PWAInstallState, Section, SectionHeader, type SectionHeaderProps, type SectionProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fontFamily, fonts, formatNumber, formatPrice, mobileViewport, relativeTime, svgIcon, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, useScrollLock, useShare, useToast };
+export { type ApiClient, type ApiClientOptions, ApiError, AppShell, AppShellContent, type AppShellContentProps, AppShellHeader, type AppShellHeaderProps, type AppShellProps, Avatar, type AvatarProps, Badge, type BadgeProps, Button, type ButtonProps, type ColorName, Dialog, type DialogProps, Divider, EmojiButton, type EmojiButtonProps, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, EmptyState, type EmptyStateProps, Fab, type FabProps, FontLinks, type FontName, GrassMap, type GrassMapData, type GrassMapLabels, type GrassMapProps, IOSInstallSheet, InAppSheet, type InAppSheetProps, KitStyles, PWAInstallButton, type PWAInstallState, Section, SectionHeader, type SectionHeaderProps, type SectionProps, ShareButton, type ShareButtonProps, Skeleton, type SkeletonProps, StatChip, type StatChipProps, THEME_SCRIPT, Tab, TabBar, type TabBarProps, type TabProps, ThemeButton, type ThemeButtonProps, ThemeDialog, type ThemeDialogLabels, type ThemeDialogProps, type ToastOptions, ToastProvider, type ToastVariant, Tooltip, type TooltipProps, Typewriter, type TypewriterProps, type UseFetchOptions, type UseFetchResult, type UseFormSubmitOptions, type UseFormSubmitResult, type UseInViewOptions, type UseInViewResult, type UsePWAInstallReturn, type UsePollingOptions, type UsePollingResult, type UseShareOptions, type UseShareReturn, Watermark, type WatermarkProps, type WatermarkSponsor, clearFetchCache, cn, colors, createApiClient, createManifest, fontFamily, fonts, formatNumber, formatPrice, mobileViewport, relativeTime, svgIcon, useDebounce, useEscapeKey, useFetch, useFocusTrap, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, usePortalTarget, useScrollLock, useShare, useToast };