@m1kapp/kit 0.0.11 → 0.0.16

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default, { ReactNode, CSSProperties } from 'react';
 import { MetadataRoute, Viewport } from 'next';
 import { ClassValue } from 'clsx';
@@ -214,6 +214,12 @@ interface ThemeButtonProps {
  * - Without `color`: moon (light mode) or sun (dark mode) icon.
  */
 declare function ThemeButton({ color, dark: darkProp, onClick, className }: ThemeButtonProps): react_jsx_runtime.JSX.Element;
+interface ThemeDialogLabels {
+    title?: string;
+    light?: string;
+    dark?: string;
+    close?: string;
+}
 interface ThemeDialogProps {
     open: boolean;
     onClose: () => void;
@@ -223,12 +229,14 @@ interface ThemeDialogProps {
     onDarkToggle?: () => void;
     /** Override the color palette. Defaults to built-in colors. */
     palette?: Record<string, string>;
+    /** Override default Korean labels for i18n */
+    labels?: ThemeDialogLabels;
 }
 /**
  * Bottom-sheet style color picker dialog.
  * Shows a 5-column grid of color circles with check on the active one.
  */
-declare function ThemeDialog({ open, onClose, current, onSelect, dark: darkProp, onDarkToggle, palette, }: ThemeDialogProps): React.ReactPortal | null;
+declare function ThemeDialog({ open, onClose, current, onSelect, dark: darkProp, onDarkToggle, palette, labels: _labels, }: ThemeDialogProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Font presets for @m1kapp/ui.
@@ -324,16 +332,22 @@ interface EmojiButtonProps {
  * Use it anywhere — tab icons, headers, list items, etc.
  */
 declare function EmojiButton({ emoji, onClick, className }: EmojiButtonProps): react_jsx_runtime.JSX.Element;
+interface EmojiPickerLabels {
+    title?: string;
+    close?: string;
+}
 interface EmojiPickerProps {
     open: boolean;
     onClose: () => void;
     current: string;
     onSelect: (emoji: string) => void;
+    /** Override default Korean labels for i18n */
+    labels?: EmojiPickerLabels;
 }
 /**
  * Bottom-sheet emoji picker with categories.
  */
-declare function EmojiPicker({ open, onClose, current, onSelect }: EmojiPickerProps): React.ReactPortal | null;
+declare function EmojiPicker({ open, onClose, current, onSelect, labels: _labels }: EmojiPickerProps): react_jsx_runtime.JSX.Element;
 
 interface TooltipProps {
     label: string;
@@ -356,14 +370,24 @@ interface GrassMapData {
     date: string;
     count: number;
 }
+interface GrassMapLabels {
+    firstRecord?: string;
+    noRecord?: string;
+    today?: string;
+    less?: string;
+    more?: string;
+    first?: string;
+}
 interface GrassMapProps {
     data: GrassMapData[];
     accent: string;
     isDark?: boolean;
     /** Unit label appended to count in tooltip. e.g. "명", "commits". Default: "" */
     unit?: string;
+    /** Override default Korean labels for i18n */
+    labels?: GrassMapLabels;
 }
-declare function GrassMap({ data, accent, isDark, unit }: GrassMapProps): react_jsx_runtime.JSX.Element;
+declare function GrassMap({ data, accent, isDark, unit, labels: _labels }: GrassMapProps): react_jsx_runtime.JSX.Element;
 
 type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 type AvatarShape = "circle" | "rounded";
@@ -503,6 +527,15 @@ interface UseInViewResult {
  */
 declare function useInView(options?: UseInViewOptions): UseInViewResult;
 
+/**
+ * Traps keyboard focus inside a container while active.
+ * Tab / Shift+Tab cycle through focusable elements without escaping.
+ *
+ * @param active — whether the trap is currently engaged
+ * @returns ref to attach to the container element
+ */
+declare function useFocusTrap<T extends HTMLElement = HTMLElement>(active: boolean): React$1.RefObject<T | null>;
+
 interface SkeletonProps {
     /** Tailwind classes for width / height (e.g. "h-4 w-3/4") */
     className?: string;
@@ -533,26 +566,21 @@ interface DialogProps {
     children: React__default.ReactNode;
     /** Hide the backdrop click-to-close behaviour */
     persistent?: boolean;
+    /** Close button aria-label. Default: "닫기" */
+    closeLabel?: string;
     className?: string;
 }
-/**
- * Modal dialog with:
- * - Portal render (no z-index issues)
- * - Backdrop click to close
- * - Escape key to close
- * - Body scroll lock
- * - Smooth scale + fade animation
- *
- * @example
- * <Dialog open={open} onClose={() => setOpen(false)} title="삭제 확인">
- *   <p className="text-sm text-zinc-500">정말 삭제할까요?</p>
- *   <div className="flex gap-2 mt-4">
- *     <Button onClick={handleDelete}>삭제</Button>
- *     <Button onClick={() => setOpen(false)}>취소</Button>
- *   </div>
- * </Dialog>
- */
-declare function Dialog({ open, onClose, title, size, children, persistent, className, }: DialogProps): React__default.ReactPortal | null;
+declare function Dialog({ open, onClose, title, size, children, persistent, closeLabel, className, }: DialogProps): react_jsx_runtime.JSX.Element;
+
+interface InAppSheetProps {
+    open: boolean;
+    onClose: () => void;
+    children: React.ReactNode;
+    className?: string;
+    /** true면 시트가 AppShell 전체 높이를 채움 */
+    fullHeight?: boolean;
+}
+declare function InAppSheet({ open, onClose, children, className, fullHeight, }: InAppSheetProps): react_jsx_runtime.JSX.Element;
 
 type PWAInstallState = "android-ready" | "ios-safari" | "installed" | "unsupported";
 interface UsePWAInstallReturn {
@@ -597,6 +625,24 @@ interface IOSInstallSheetProps {
  */
 declare function IOSInstallSheet({ open, onClose, appName, iconSrc }: IOSInstallSheetProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * Drop into <head> in your root layout to pre-load kit styles and
+ * prevent the JS injection from re-running (eliminates FOUC).
+ *
+ * Usage:
+ *   // app/layout.tsx
+ *   import { KitStyles } from "@m1kapp/kit/pwa";
+ *   <head>
+ *     <KitStyles />
+ *   </head>
+ */
+declare function KitStyles(): React__default.DetailedReactHTMLElement<{
+    "data-m1kapp-ui": string;
+    dangerouslySetInnerHTML: {
+        __html: string;
+    };
+}, HTMLElement>;
+
 /**
  * Standard mobile viewport config for Next.js.
  * - Disables pinch zoom via maximumScale (Android, older iOS)
@@ -749,4 +795,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 EmojiPickerProps, EmptyState, type EmptyStateProps, type FontName, GrassMap, type GrassMapData, type GrassMapProps, IOSInstallSheet, 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 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, useFetch, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, 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, 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, useFetch, useFocusTrap, useFormSubmit, useInView, useLocalStorage, usePWAInstall, usePolling, useShare, useToast };