@gaozh1024/rn-kit 0.2.0-beta.0

package/dist/index.d.mts

@@ -0,0 +1,3465 @@
+import { ClassValue } from 'clsx';
+export { ClassValue, clsx } from 'clsx';
+import { ZodError, z, ZodSchema } from 'zod';
+export { z } from 'zod';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import React__default from 'react';
+export { useMutation, useQuery } from '@tanstack/react-query';
+import { ViewProps, ScrollViewProps, TextProps, PressableProps, StyleProp, TextStyle, ImageSourcePropType, ImageStyle, ListRenderItem, ViewStyle, TextInputProps, TextInput, StatusBarProps, StatusBarStyle } from 'react-native';
+import * as _react_navigation_native from '@react-navigation/native';
+import { LinkingOptions, Theme as Theme$1, NavigationProp, ParamListBase as ParamListBase$1, RouteProp, NavigationState } from '@react-navigation/native';
+export { NavigationContainer, NavigationContainerRef, NavigationProp, NavigationState, RouteProp, useFocusEffect, useIsFocused, useScrollToTop } from '@react-navigation/native';
+import * as _react_navigation_stack from '@react-navigation/stack';
+import { StackNavigationProp, StackScreenProps as StackScreenProps$1 } from '@react-navigation/stack';
+export { StackNavigationProp as NativeStackNavigationProp, StackScreenProps as NativeStackScreenProps } from '@react-navigation/stack';
+import * as _react_navigation_routers from '@react-navigation/routers';
+import * as _react_navigation_bottom_tabs from '@react-navigation/bottom-tabs';
+import { BottomTabNavigationProp, BottomTabScreenProps, BottomTabBarProps } from '@react-navigation/bottom-tabs';
+export { BottomTabNavigationProp, BottomTabScreenProps } from '@react-navigation/bottom-tabs';
+import * as _react_navigation_drawer from '@react-navigation/drawer';
+import { DrawerNavigationProp, DrawerScreenProps as DrawerScreenProps$1, DrawerContentComponentProps } from '@react-navigation/drawer';
+export { DrawerNavigationProp, DrawerScreenProps as NativeDrawerScreenProps } from '@react-navigation/drawer';
+export { SafeAreaProvider } from 'react-native-safe-area-context';
+export { twMerge } from 'tailwind-merge';
+
+/**
+ * 合并 Tailwind CSS 类名，自动处理类名冲突
+ *
+ * 使用 clsx 进行条件类名合并，使用 tailwind-merge 解决 Tailwind 类名冲突
+ *
+ * @param inputs - 要合并的类名数组，支持字符串、对象、数组等多种格式
+ * @returns 合并后的类名字符串
+ * @example
+ * ```ts
+ * cn('px-4 py-2', 'bg-blue-500', { 'text-white': true })
+ * // => 'px-4 py-2 bg-blue-500 text-white'
+ *
+ * cn('px-4', 'px-6') // 后者覆盖前者
+ * // => 'px-6'
+ * ```
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * RGB 颜色对象
+ */
+interface RgbObject {
+    /** 红色通道值 (0-255) */
+    r: number;
+    /** 绿色通道值 (0-255) */
+    g: number;
+    /** 蓝色通道值 (0-255) */
+    b: number;
+}
+/**
+ * 调色板对象，包含从 0 到 950 的色阶
+ * 兼容 Record<string, string> 类型
+ */
+interface ColorPalette$1 {
+    /** 最亮色 */
+    0: string;
+    /** 50 色阶 */
+    50: string;
+    /** 100 色阶 */
+    100: string;
+    /** 200 色阶 */
+    200: string;
+    /** 300 色阶 */
+    300: string;
+    /** 400 色阶 */
+    400: string;
+    /** 500 色阶（基准色） */
+    500: string;
+    /** 600 色阶 */
+    600: string;
+    /** 700 色阶 */
+    700: string;
+    /** 800 色阶 */
+    800: string;
+    /** 900 色阶 */
+    900: string;
+    /** 最暗色 */
+    950: string;
+    /** 索引签名，兼容 Record<string, string> */
+    [key: string]: string;
+}
+/**
+ * 将十六进制颜色转换为 RGB 对象
+ *
+ * @param hex - 十六进制颜色字符串（如 '#FF5733' 或 'FF5733'）
+ * @returns RGB 颜色对象
+ * @example
+ * ```ts
+ * hexToRgb('#FF5733')
+ * // => { r: 255, g: 87, b: 51 }
+ * ```
+ */
+declare function hexToRgb(hex: string): RgbObject;
+/**
+ * 将 RGB 对象转换为十六进制颜色字符串
+ *
+ * @param rgb - RGB 颜色对象
+ * @returns 十六进制颜色字符串（如 '#FF5733'）
+ * @example
+ * ```ts
+ * rgbToHex({ r: 255, g: 87, b: 51 })
+ * // => '#ff5733'
+ * ```
+ */
+declare function rgbToHex(rgb: RgbObject): string;
+/**
+ * 调整 RGB 颜色的亮度
+ *
+ * @param rgb - RGB 颜色对象
+ * @param factor - 亮度调整因子，正数变亮，负数变暗，范围建议在 -1 到 1 之间
+ * @returns 调整后的 RGB 颜色对象
+ * @example
+ * ```ts
+ * adjustBrightness({ r: 128, g: 128, b: 128 }, 0.5)
+ * // => { r: 191, g: 191, b: 191 }
+ *
+ * adjustBrightness({ r: 128, g: 128, b: 128 }, -0.5)
+ * // => { r: 64, g: 64, b: 64 }
+ * ```
+ */
+declare function adjustBrightness(rgb: RgbObject, factor: number): RgbObject;
+/**
+ * 基于基准色生成完整的调色板
+ *
+ * 生成包含 12 个色阶（0-950）的调色板，其中 500 为基准色
+ *
+ * @param baseHex - 基准十六进制颜色字符串
+ * @returns 完整的调色板对象
+ * @example
+ * ```ts
+ * generateColorPalette('#3B82F6')
+ * // => {
+ * //   0: '#e6f0fe',
+ * //   50: '#dbeafe',
+ * //   100: '#bfdbfe',
+ * //   ...
+ * //   500: '#3b82f6',
+ * //   ...
+ * //   950: '#172554'
+ * // }
+ * ```
+ */
+declare function generateColorPalette(baseHex: string): ColorPalette$1;
+
+/**
+ * 检查当前是否为开发环境
+ *
+ * 通过检查 process.env.NODE_ENV 是否为 'development' 来判断
+ *
+ * @returns 如果当前是开发环境返回 true，否则返回 false
+ * @example
+ * ```ts
+ * if (isDevelopment()) {
+ *   console.log('Running in development mode');
+ * }
+ * ```
+ */
+declare function isDevelopment(): boolean;
+
+/**
+ * 将日期格式化为指定格式的字符串
+ *
+ * @param date - 要格式化的日期对象
+ * @param format - 格式化模板，支持 'yyyy'（年）、'MM'（月）、'dd'（日），默认为 'yyyy-MM-dd'
+ * @returns 格式化后的日期字符串
+ * @example
+ * ```ts
+ * formatDate(new Date('2024-01-15'))
+ * // => '2024-01-15'
+ *
+ * formatDate(new Date('2024-01-15'), 'yyyy年MM月dd日')
+ * // => '2024年01月15日'
+ * ```
+ */
+declare function formatDate(date: Date, format?: string): string;
+/**
+ * 格式化日期为相对时间（如"刚刚"、"5分钟前"等）
+ *
+ * @param date - 要格式化的日期对象
+ * @returns 相对时间字符串
+ * @example
+ * ```ts
+ * formatRelativeTime(new Date()) // => '刚刚'
+ * formatRelativeTime(new Date(Date.now() - 5 * 60000)) // => '5分钟前'
+ * formatRelativeTime(new Date(Date.now() - 2 * 3600000)) // => '2小时前'
+ * formatRelativeTime(new Date(Date.now() - 3 * 86400000)) // => '3天前'
+ * formatRelativeTime(new Date('2023-01-01')) // => '2023-01-01'
+ * ```
+ */
+declare function formatRelativeTime(date: Date): string;
+
+/**
+ * 截断字符串，超出指定长度时添加后缀
+ *
+ * @param str - 要截断的字符串
+ * @param length - 目标长度（包含后缀长度）
+ * @param suffix - 截断后添加的后缀，默认为 '...'
+ * @returns 截断后的字符串
+ * @example
+ * ```ts
+ * truncate('Hello World', 8)
+ * // => 'Hello...'
+ *
+ * truncate('Hello World', 8, '>>')
+ * // => 'Hello >>'
+ *
+ * truncate('Hi', 8)
+ * // => 'Hi'
+ * ```
+ */
+declare function truncate(str: string, length: number, suffix?: string): string;
+/**
+ * 将字符串转换为 URL 友好的 slug 格式
+ *
+ * 移除特殊字符，将空格转换为连字符，合并多个连字符
+ *
+ * @param str - 要转换的字符串
+ * @returns slug 格式的字符串
+ * @example
+ * ```ts
+ * slugify('Hello World!')
+ * // => 'hello-world'
+ *
+ * slugify('This is a -- test!!!')
+ * // => 'this-is-a-test'
+ * ```
+ */
+declare function slugify(str: string): string;
+/**
+ * 将字符串首字母大写
+ *
+ * @param str - 要转换的字符串
+ * @returns 首字母大写的字符串
+ * @example
+ * ```ts
+ * capitalize('hello world')
+ * // => 'Hello world'
+ *
+ * capitalize('HELLO')
+ * // => 'HELLO'
+ * ```
+ */
+declare function capitalize(str: string): string;
+
+/**
+ * 将数字格式化为中文地区的字符串表示
+ *
+ * 使用千分位分隔符格式化数字
+ *
+ * @param num - 要格式化的数字
+ * @returns 格式化后的字符串
+ * @example
+ * ```ts
+ * formatNumber(1234567.89)
+ * // => '1,234,567.89'
+ *
+ * formatNumber(1000)
+ * // => '1,000'
+ * ```
+ */
+declare function formatNumber(num: number): string;
+/**
+ * 将数字格式化为货币字符串
+ *
+ * @param num - 要格式化的数字
+ * @param currency - 货币符号，默认为 '¥'
+ * @returns 格式化后的货币字符串
+ * @example
+ * ```ts
+ * formatCurrency(1234.5)
+ * // => '¥1,234.5'
+ *
+ * formatCurrency(1234.5, '$')
+ * // => '$1,234.5'
+ * ```
+ */
+declare function formatCurrency(num: number, currency?: string): string;
+/**
+ * 将小数格式化为百分比字符串
+ *
+ * @param num - 要格式化的小数（如 0.25 表示 25%）
+ * @param decimals - 小数位数，默认为 2
+ * @returns 格式化后的百分比字符串
+ * @example
+ * ```ts
+ * formatPercent(0.25)
+ * // => '25.00%'
+ *
+ * formatPercent(0.25, 0)
+ * // => '25%'
+ *
+ * formatPercent(0.1234, 1)
+ * // => '12.3%'
+ * ```
+ */
+declare function formatPercent(num: number, decimals?: number): string;
+/**
+ * 将数字限制在指定的最小值和最大值之间
+ *
+ * @param num - 要限制的数字
+ * @param min - 最小值
+ * @param max - 最大值
+ * @returns 限制后的数字
+ * @example
+ * ```ts
+ * clamp(50, 0, 100) // => 50
+ * clamp(150, 0, 100) // => 100
+ * clamp(-10, 0, 100) // => 0
+ * ```
+ */
+declare function clamp(num: number, min: number, max: number): number;
+
+/**
+ * 深度合并两个对象
+ *
+ * 递归合并 source 对象的属性到 target 对象，嵌套对象也会被合并
+ *
+ * @param target - 目标对象
+ * @param source - 源对象
+ * @returns 合并后的新对象
+ * @example
+ * ```ts
+ * deepMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 }, c: 3 })
+ * // => { a: 1, b: { x: 1, y: 2 }, c: 3 }
+ * ```
+ */
+declare function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T;
+/**
+ * 从对象中选取指定的属性
+ *
+ * @param obj - 源对象
+ * @param keys - 要选取的属性键数组
+ * @returns 仅包含指定属性的新对象
+ * @example
+ * ```ts
+ * pick({ a: 1, b: 2, c: 3 }, ['a', 'c'])
+ * // => { a: 1, c: 3 }
+ * ```
+ */
+declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * 从对象中排除指定的属性
+ *
+ * @param obj - 源对象
+ * @param keys - 要排除的属性键数组
+ * @returns 不包含指定属性的新对象
+ * @example
+ * ```ts
+ * omit({ a: 1, b: 2, c: 3 }, ['b'])
+ * // => { a: 1, c: 3 }
+ * ```
+ */
+declare function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+
+/**
+ * 将 Zod 验证错误转换为字段错误映射对象
+ *
+ * @param error - ZodError 实例
+ * @returns 字段路径到错误消息的映射对象
+ * @example
+ * ```ts
+ * const schema = z.object({
+ *   email: z.string().email(),
+ *   age: z.number().min(18)
+ * });
+ *
+ * const result = schema.safeParse({ email: 'invalid', age: 16 });
+ * if (!result.success) {
+ *   getValidationErrors(result.error)
+ *   // => { email: 'Invalid email', age: 'Number must be greater than or equal to 18' }
+ * }
+ * ```
+ */
+declare function getValidationErrors(error: ZodError): Record<string, string>;
+/**
+ * 验证邮箱地址格式是否有效
+ *
+ * @param email - 要验证的邮箱地址
+ * @returns 是否为有效的邮箱格式
+ * @example
+ * ```ts
+ * isValidEmail('user@example.com') // => true
+ * isValidEmail('invalid-email') // => false
+ * ```
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * 验证中国手机号码格式是否有效
+ *
+ * 支持以 1 开头，第二位为 3-9 的 11 位手机号码
+ *
+ * @param phone - 要验证的手机号码
+ * @returns 是否为有效的手机号码格式
+ * @example
+ * ```ts
+ * isValidPhone('13800138000') // => true
+ * isValidPhone('12345678901') // => false
+ * ```
+ */
+declare function isValidPhone(phone: string): boolean;
+
+interface ColorPalette {
+    0: string;
+    50: string;
+    100: string;
+    200: string;
+    300: string;
+    400: string;
+    500: string;
+    600: string;
+    700: string;
+    800: string;
+    900: string;
+    950: string;
+    [key: string]: string;
+}
+type ColorToken = string | ColorPalette;
+interface ThemeConfig {
+    colors: Record<string, ColorToken>;
+    spacing?: Record<string, number>;
+    borderRadius?: Record<string, number>;
+}
+interface Theme {
+    colors: Record<string, ColorPalette>;
+    spacing: Record<string, number>;
+    borderRadius: Record<string, number>;
+}
+
+declare function createTheme(config: ThemeConfig): Theme;
+
+interface ThemeContextValue {
+    theme: Theme;
+    isDark: boolean;
+    toggleTheme: () => void;
+}
+interface ThemeProviderProps {
+    children: React__default.ReactNode;
+    light: ThemeConfig;
+    dark?: ThemeConfig;
+    defaultDark?: boolean;
+    /**
+     * 受控暗色模式。
+     * 传入后会以该值为准，不再依赖内部 state。
+     */
+    isDark?: boolean;
+    /**
+     * 主题切换回调。
+     * 受控/非受控模式下都会在 toggleTheme 时触发。
+     */
+    onThemeChange?: (isDark: boolean) => void;
+}
+declare function ThemeProvider({ children, light, dark, defaultDark, isDark: controlledIsDark, onThemeChange, }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): ThemeContextValue;
+
+interface ThemeColorTokens {
+    primary: string;
+    primarySurface: string;
+    background: string;
+    card: string;
+    cardElevated: string;
+    text: string;
+    textSecondary: string;
+    textMuted: string;
+    textInverse: string;
+    border: string;
+    divider: string;
+    iconMuted: string;
+}
+declare function getThemeColors(theme: Theme, isDark: boolean): ThemeColorTokens;
+declare function useThemeColors(): ThemeColorTokens;
+
+/**
+ * @fileoverview 错误类型定义模块
+ * @module core/error/types
+ * @description 定义应用错误码枚举和错误对象接口
+ */
+/**
+ * 应用错误码枚举
+ * @enum {string}
+ * @example
+ * ```typescript
+ * if (error.code === ErrorCode.UNAUTHORIZED) {
+ *   redirectToLogin();
+ * }
+ * ```
+ */
+declare enum ErrorCode {
+    /** 数据校验错误 */
+    VALIDATION = "VALIDATION",
+    /** 网络连接错误 */
+    NETWORK = "NETWORK",
+    /** 未授权访问 */
+    UNAUTHORIZED = "UNAUTHORIZED",
+    /** 禁止访问 */
+    FORBIDDEN = "FORBIDDEN",
+    /** 服务器内部错误 */
+    SERVER = "SERVER",
+    /** 业务逻辑错误 */
+    BUSINESS = "BUSINESS",
+    /** 未知错误 */
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * 应用错误对象接口
+ * @example
+ * ```typescript
+ * const error: AppError = {
+ *   code: ErrorCode.VALIDATION,
+ *   message: 'Email format is invalid',
+ *   field: 'email',
+ *   retryable: false
+ * };
+ * ```
+ */
+interface AppError {
+    /** 错误码 */
+    code: ErrorCode;
+    /** 错误消息 */
+    message: string;
+    /** HTTP 状态码（如适用） */
+    statusCode?: number;
+    /** 相关字段（如校验错误） */
+    field?: string;
+    /** 是否可重试 */
+    retryable?: boolean;
+    /** 原始错误对象 */
+    original?: any;
+}
+
+/**
+ * @fileoverview 错误处理辅助函数模块
+ * @module core/error/helpers
+ * @description 提供 HTTP 状态码映射和错误对象增强功能
+ */
+
+/**
+ * 将 HTTP 状态码映射为应用错误码
+ * @param status - HTTP 状态码
+ * @returns 对应的 ErrorCode 枚举值
+ * @example
+ * ```typescript
+ * const errorCode = mapHttpStatus(404); // ErrorCode.VALIDATION
+ * const errorCode = mapHttpStatus(500); // ErrorCode.SERVER
+ * const errorCode = mapHttpStatus(401); // ErrorCode.UNAUTHORIZED
+ * ```
+ */
+declare function mapHttpStatus(status: number): ErrorCode;
+/**
+ * 增强错误对象，添加便捷的判断属性
+ * @param error - 基础应用错误对象
+ * @returns 增强后的错误对象，包含 isValidation、isNetwork、isAuth、isRetryable 等属性
+ * @example
+ * ```typescript
+ * const enhanced = enhanceError({
+ *   code: ErrorCode.NETWORK,
+ *   message: 'Connection timeout'
+ * });
+ *
+ * if (enhanced.isNetwork) {
+ *   showRetryButton();
+ * }
+ *
+ * if (enhanced.isRetryable) {
+ *   await retryRequest();
+ * }
+ * ```
+ */
+declare function enhanceError(error: AppError): AppError & {
+    isValidation: boolean;
+    isNetwork: boolean;
+    isAuth: boolean;
+    isRetryable: boolean;
+};
+
+/**
+ * @fileoverview 异步状态管理 Hook
+ * @module core/hooks/useAsyncState
+ * @description 提供用于异步操作状态管理的 React Hook
+ */
+
+/**
+ * useAsyncState Hook 返回的状态接口
+ * @template T - 数据的类型
+ * @example
+ * ```typescript
+ * const { data, error, loading, execute, reset } = useAsyncState<User>();
+ * ```
+ */
+interface UseAsyncState<T> {
+    /** 异步操作返回的数据 */
+    data: T | null;
+    /** 错误对象（如果发生错误） */
+    error: (AppError & {
+        isValidation: boolean;
+        isNetwork: boolean;
+        isAuth: boolean;
+        isRetryable: boolean;
+    }) | null;
+    /** 是否正在加载 */
+    loading: boolean;
+}
+/**
+ * 管理异步操作状态的 React Hook
+ * @template T - 异步操作返回数据的类型，默认为 any
+ * @returns 包含数据、错误、加载状态和操作方法的对象
+ * @example
+ * ```typescript
+ * function UserProfile({ userId }: { userId: number }) {
+ *   const { data: user, error, loading, execute } = useAsyncState<User>();
+ *
+ *   useEffect(() => {
+ *     execute(fetchUser(userId));
+ *   }, [userId, execute]);
+ *
+ *   if (loading) return <Loading />;
+ *   if (error?.isAuth) return <RedirectToLogin />;
+ *   if (error) return <ErrorMessage error={error} />;
+ *
+ *   return <UserCard user={user} />;
+ * }
+ * ```
+ */
+declare function useAsyncState<T = any>(): {
+    data: T | null;
+    error: (AppError & {
+        isValidation: boolean;
+        isNetwork: boolean;
+        isAuth: boolean;
+        isRetryable: boolean;
+    }) | null;
+    loading: boolean;
+    execute: (promise: Promise<T>) => Promise<T>;
+    reset: () => void;
+};
+
+/**
+ * @fileoverview API 类型定义模块
+ * @module core/api/types
+ * @description 定义 API 端点和配置的核心类型接口
+ */
+
+type ApiMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+interface ApiErrorContext {
+    /** 当前调用的 endpoint 名称 */
+    endpointName: string;
+    /** 当前 endpoint 的 path */
+    path: string;
+    /** HTTP 方法 */
+    method: ApiMethod;
+    /** 调用入参 */
+    input?: unknown;
+    /** 原始响应对象 */
+    response?: Response;
+    /** 已解析的响应数据 */
+    responseData?: unknown;
+}
+type ApiErrorHandler = (error: AppError, context: ApiErrorContext) => void | Promise<void>;
+type ApiBusinessErrorParser = (data: unknown, response: Response) => AppError | null;
+/**
+ * API 端点配置接口
+ * @template TInput - 请求输入数据的类型
+ * @template TOutput - 响应输出数据的类型
+ * @example
+ * ```typescript
+ * const userEndpoint: ApiEndpointConfig<{ id: number }, User> = {
+ *   method: 'GET',
+ *   path: '/users/:id',
+ *   input: z.object({ id: z.number() }),
+ *   output: z.instanceof(User)
+ * };
+ * ```
+ */
+interface ApiEndpointConfig<TInput, TOutput> {
+    /** HTTP 请求方法 */
+    method: ApiMethod;
+    /** API 路径（相对于 baseURL） */
+    path: string;
+    /** 请求数据的 Zod 校验模式（可选） */
+    input?: z.ZodSchema<TInput>;
+    /** 响应数据的 Zod 校验模式（可选） */
+    output?: z.ZodSchema<TOutput>;
+    /** 当前 endpoint 的业务错误解析器（可选） */
+    parseBusinessError?: ApiBusinessErrorParser;
+    /** 当前 endpoint 的错误监听器（可选） */
+    onError?: ApiErrorHandler;
+}
+/**
+ * API 配置接口
+ * @template TEndpoints - 端点配置映射类型
+ * @example
+ * ```typescript
+ * const config: ApiConfig<typeof myEndpoints> = {
+ *   baseURL: 'https://api.example.com/v1',
+ *   endpoints: {
+ *     getUser: { method: 'GET', path: '/users/:id' },
+ *     createUser: { method: 'POST', path: '/users' }
+ *   }
+ * };
+ * ```
+ */
+interface ApiConfig<TEndpoints extends Record<string, ApiEndpointConfig<any, any>>> {
+    /** API 基础 URL */
+    baseURL: string;
+    /** 端点配置映射 */
+    endpoints: TEndpoints;
+    /** 自定义 fetch 实现（可选） */
+    fetcher?: typeof fetch;
+    /** 全局业务错误解析器（可选） */
+    parseBusinessError?: ApiBusinessErrorParser;
+    /** 全局错误监听器（可选） */
+    onError?: ApiErrorHandler;
+}
+
+/**
+ * @fileoverview API 创建模块
+ * @module core/api/create-api
+ * @description 提供类型安全的 API 客户端创建功能，支持请求/响应数据的 Zod 校验
+ */
+
+/**
+ * 创建类型安全的 API 客户端
+ * @template TEndpoints - 端点配置映射类型
+ * @param config - API 配置对象，包含基础 URL 和端点定义
+ * @returns 代理对象，其方法对应配置的各个 API 端点
+ * @example
+ * ```typescript
+ * const api = createAPI({
+ *   baseURL: 'https://api.example.com',
+ *   endpoints: {
+ *     getUser: {
+ *       method: 'GET',
+ *       path: '/users/:id',
+ *       output: z.object({ id: z.number(), name: z.string() })
+ *     },
+ *     createUser: {
+ *       method: 'POST',
+ *       path: '/users',
+ *       input: z.object({ name: z.string(), email: z.string().email() }),
+ *       output: z.object({ id: z.number(), name: z.string(), email: z.string() })
+ *     }
+ *   }
+ * });
+ *
+ * // 调用会自动进行类型检查和数据校验
+ * const user = await api.getUser({ id: 1 });
+ * const newUser = await api.createUser({ name: 'John', email: 'john@example.com' });
+ * ```
+ */
+declare function createAPI<TEndpoints extends Record<string, ApiEndpointConfig<any, any>>>(config: ApiConfig<TEndpoints>): {
+    [K in keyof TEndpoints]: (input?: any) => Promise<any>;
+};
+
+/**
+ * @fileoverview 内存存储实现模块
+ * @module core/storage/memory-storage
+ * @description 提供基于内存的键值存储实现，适用于测试环境或不需要持久化的场景
+ */
+/**
+ * 内存存储类
+ * @description 使用 Map 实现的异步键值存储，数据仅在内存中保存，应用重启后丢失
+ * @example
+ * ```typescript
+ * const storage = new MemoryStorage();
+ *
+ * // 存储数据
+ * await storage.setItem('user', JSON.stringify({ id: 1, name: 'John' }));
+ *
+ * // 读取数据
+ * const userData = await storage.getItem('user');
+ * console.log(userData); // '{"id":1,"name":"John"}'
+ *
+ * // 删除数据
+ * await storage.removeItem('user');
+ *
+ * // 检查数据是否存在
+ * const exists = await storage.getItem('user'); // null
+ * ```
+ */
+declare class MemoryStorage {
+    /** 内部存储的 Map 实例 */
+    private memory;
+    /**
+     * 存储键值对
+     * @param key - 存储键名
+     * @param value - 要存储的字符串值
+     * @returns 解析为 void 的 Promise
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * 根据键名获取值
+     * @param key - 存储键名
+     * @returns 存储的字符串值，如果不存在则返回 null
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * 删除指定键名的存储项
+     * @param key - 要删除的键名
+     * @returns 解析为 void 的 Promise
+     */
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * 默认的内存存储实例
+ * @description 全局共享的内存存储单例，可用于跨模块的简单数据共享
+ * @example
+ * ```typescript
+ * import { storage } from './memory-storage';
+ *
+ * // 模块 A
+ * await storage.setItem('session', 'abc123');
+ *
+ * // 模块 B
+ * const session = await storage.getItem('session');
+ * console.log(session); // 'abc123'
+ * ```
+ */
+declare const storage: MemoryStorage;
+
+interface UseRequestOptions<T, P extends any[]> {
+    manual?: boolean;
+    deps?: any[];
+    defaultParams?: P;
+    onSuccess?: (data: T, params: P) => void;
+    onError?: (error: Error, params: P) => void;
+    onFinally?: (params: P) => void;
+    retryCount?: number;
+    retryDelay?: number;
+}
+declare function useRequest<T, P extends any[] = any[]>(service: (...params: P) => Promise<T>, options?: UseRequestOptions<T, P>): {
+    data: T | undefined;
+    loading: boolean;
+    error: Error | undefined;
+    run: (...params: P) => Promise<T>;
+    refresh: () => Promise<T>;
+    cancel: () => void;
+    mutate: (newData: T | ((prev: T | undefined) => T)) => void;
+};
+
+/**
+ * 分页参数
+ */
+interface PaginationParams {
+    /** 当前页码 */
+    current: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 其他自定义参数 */
+    [key: string]: any;
+}
+/**
+ * 分页结果
+ * 支持 data 或 list 作为数据字段
+ */
+interface PaginationResult<T> {
+    /** 数据列表（推荐） */
+    data?: T[];
+    /** 数据列表（兼容旧版本） */
+    list?: T[];
+    /** 总数据条数 */
+    total: number;
+}
+/**
+ * 分页选项
+ */
+interface UsePaginationOptions {
+    /** 默认当前页码 */
+    defaultCurrent?: number;
+    /** 默认每页数量 */
+    defaultPageSize?: number;
+    /** 依赖数组 */
+    deps?: any[];
+}
+/**
+ * 分页返回值
+ */
+interface UsePaginationReturn<T> {
+    /** 数据列表 */
+    data: T[];
+    /** 当前页码 */
+    current: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 总数据条数 */
+    total: number;
+    /** 是否还有更多数据 */
+    hasMore: boolean;
+    /** 是否加载中 */
+    loading: boolean;
+    /** 是否刷新中 */
+    refreshing: boolean;
+    /** 是否加载更多中 */
+    loadingMore: boolean;
+    /** 错误信息 */
+    error: Error | null;
+    /** 刷新数据 */
+    refresh: () => Promise<void>;
+    /** 加载更多数据 */
+    loadMore: () => Promise<void>;
+    /** 切换页码 */
+    changePage: (page: number) => Promise<void>;
+}
+/**
+ * 分页逻辑 Hook
+ * @param service - 分页数据请求函数
+ * @param options - 配置选项
+ * @returns 分页状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   data,
+ *   current,
+ *   total,
+ *   hasMore,
+ *   loading,
+ *   refreshing,
+ *   loadingMore,
+ *   refresh,
+ *   loadMore,
+ * } = usePagination(
+ *   async ({ current, pageSize, keyword }) => {
+ *     const res = await api.getList({ page: current, size: pageSize, keyword });
+ *     return { data: res.items, total: res.total };
+ *   },
+ *   { defaultPageSize: 20 }
+ * );
+ * ```
+ */
+declare function usePagination<T>(service: (params: PaginationParams) => Promise<PaginationResult<T>>, options?: UsePaginationOptions): UsePaginationReturn<T>;
+
+declare function usePrevious<T>(value: T): T | undefined;
+
+declare function useSetState<T extends Record<string, any>>(initialState: T): [T, (patch: Partial<T> | ((prev: T) => Partial<T>)) => void, () => void];
+
+declare function useMemoizedFn<T extends (...args: any[]) => any>(fn: T): T;
+
+declare function useUpdateEffect(effect: React.EffectCallback, deps?: React.DependencyList): void;
+
+/**
+ * 本地存储同步 Hook
+ * @param key - 存储键名
+ * @param defaultValue - 默认值
+ * @returns [值, 设置值, 删除值]
+ *
+ * @example
+ * ```tsx
+ * const [darkMode, setDarkMode] = useStorage('settings.darkMode', false);
+ *
+ * <Switch value={darkMode} onValueChange={setDarkMode} />
+ * ```
+ */
+declare function useStorage<T>(key: string, defaultValue: T): [T, (value: T | ((prev: T) => T)) => void, () => void];
+
+interface UseRefreshReturn<T> {
+    /** 数据 */
+    data: T | undefined;
+    /** 是否刷新中 */
+    refreshing: boolean;
+    /** 错误信息 */
+    error: Error | undefined;
+    /** 触发刷新 */
+    refresh: () => Promise<void>;
+}
+/**
+ * 下拉刷新逻辑 Hook
+ * @param fetcher - 数据获取函数
+ * @returns 刷新状态和触发方法
+ *
+ * @example
+ * ```tsx
+ * const { data, refreshing, refresh } = useRefresh(() => fetchUserList());
+ *
+ * <FlatList
+ *   refreshing={refreshing}
+ *   onRefresh={refresh}
+ *   data={data}
+ * />
+ * ```
+ */
+declare function useRefresh<T>(fetcher: () => Promise<T>): UseRefreshReturn<T>;
+
+interface UseInfiniteOptions {
+    /** 默认页码 */
+    defaultPage?: number;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 是否自动加载 */
+    autoLoad?: boolean;
+}
+interface UseInfiniteReturn<T> {
+    /** 累积的数据列表 */
+    data: T[];
+    /** 当前页码 */
+    page: number;
+    /** 是否初始加载中 */
+    loading: boolean;
+    /** 是否加载更多中 */
+    loadingMore: boolean;
+    /** 是否还有更多数据 */
+    hasMore: boolean;
+    /** 错误信息 */
+    error: Error | undefined;
+    /** 加载数据 */
+    load: () => Promise<void>;
+    /** 加载更多 */
+    loadMore: () => Promise<void>;
+    /** 刷新（重置到第一页） */
+    refresh: () => Promise<void>;
+    /** 重置 */
+    reset: () => void;
+}
+/**
+ * 无限滚动获取参数
+ * 支持扩展自定义参数
+ */
+interface InfiniteFetchParams {
+    /** 当前页码 */
+    page: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 其他自定义参数 */
+    [key: string]: any;
+}
+/**
+ * 无限滚动获取结果
+ * 支持 data 或 list 作为数据字段
+ */
+interface InfiniteFetchResult<T> {
+    /** 数据列表（推荐） */
+    data?: T[];
+    /** 数据列表（兼容旧版本） */
+    list?: T[];
+    /** 是否还有更多数据 */
+    hasMore: boolean;
+}
+/**
+ * 无限滚动逻辑 Hook
+ * @param fetcher - 数据获取函数，接收 { page, pageSize, ...其他参数 } 参数
+ * @param options - 配置选项
+ * @returns 无限滚动状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, loadingMore, hasMore, loadMore, refresh } = useInfinite(
+ *   async ({ page, pageSize, keyword }) => {
+ *     const res = await api.getList({ page, size: pageSize, keyword });
+ *     return { data: res.items, hasMore: res.hasMore };
+ *   },
+ *   { pageSize: 20 }
+ * );
+ *
+ * <FlatList
+ *   data={data}
+ *   onEndReached={hasMore && !loadingMore ? loadMore : null}
+ *   refreshing={loading}
+ *   onRefresh={refresh}
+ * />
+ * ```
+ */
+declare function useInfinite<T>(fetcher: (params: InfiniteFetchParams) => Promise<InfiniteFetchResult<T>>, options?: UseInfiniteOptions): UseInfiniteReturn<T>;
+
+/**
+ * AppView 组件属性接口
+ */
+interface AppViewProps extends ViewProps {
+    /** 是否使用 flex 布局，设为 true 使用 flex-1，设为数字使用 flex-${number} */
+    flex?: boolean | number;
+    /** 是否使用水平排列（flex-direction: row） */
+    row?: boolean;
+    /** 是否居中显示（items-center justify-center） */
+    center?: boolean;
+    /** 是否两端对齐（justify-between） */
+    between?: boolean;
+    /** 交叉轴对齐方式（align-items） */
+    items?: 'start' | 'center' | 'end' | 'stretch';
+    /** 主轴对齐方式（justify-content） */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    /** 内边距 */
+    p?: number;
+    /** 水平内边距 */
+    px?: number;
+    /** 垂直内边距 */
+    py?: number;
+    /** 子元素间距 */
+    gap?: number;
+    /** 背景颜色 */
+    bg?: string;
+    /** 语义化背景 */
+    surface?: 'background' | 'card' | 'muted';
+    /** 圆角大小 */
+    rounded?: string;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * AppView - 基础视图容器组件
+ *
+ * 基于 React Native 的 View 组件封装，提供便捷的 Flexbox 布局属性
+ * 和 Tailwind CSS 类名支持，简化日常布局开发
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <AppView>
+ *   <Text>内容</Text>
+ * </AppView>
+ *
+ * // Flex 布局
+ * <AppView flex row>
+ *   <Text>左侧</Text>
+ *   <Text>右侧</Text>
+ * </AppView>
+ *
+ * // 居中对齐
+ * <AppView center className="h-full">
+ *   <Text>居中内容</Text>
+ * </AppView>
+ *
+ * // 带间距和背景
+ * <AppView p={4} gap={2} bg="gray-100" rounded="lg">
+ *   <Text>带样式的容器</Text>
+ * </AppView>
+ * ```
+ */
+declare function AppView({ flex, row, center, between, items, justify, p, px, py, gap, bg, surface, rounded, className, children, style, ...props }: AppViewProps): react_jsx_runtime.JSX.Element;
+
+interface AppScrollViewProps extends ScrollViewProps {
+    /** 是否使用 flex 布局 */
+    flex?: boolean;
+    /** 背景颜色 */
+    bg?: string;
+    /** 语义化背景 */
+    surface?: 'background' | 'card' | 'muted';
+    /** 内边距 */
+    p?: number;
+    /** 水平内边距 */
+    px?: number;
+    /** 垂直内边距 */
+    py?: number;
+    /** 子元素间距 */
+    gap?: number;
+    /** 圆角大小 */
+    rounded?: string;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * AppScrollView - 带 Tailwind/快捷布局能力的滚动容器
+ */
+declare function AppScrollView({ flex, bg, p, px, py, gap, surface, rounded, className, children, style, ...props }: AppScrollViewProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * AppText 组件属性接口
+ */
+interface AppTextProps extends TextProps {
+    /** 字体大小：xs(12px)、sm(14px)、md(16px)、lg(18px)、xl(20px)、2xl(24px)、3xl(30px) */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
+    /** 字重：normal(400)、medium(500)、semibold(600)、bold(700) */
+    weight?: 'normal' | 'medium' | 'semibold' | 'bold';
+    /** 文字颜色，支持 Tailwind 颜色类名 */
+    color?: string;
+    /** 语义化文字色 */
+    tone?: 'default' | 'muted' | 'inverse' | 'primary' | 'secondary' | 'success' | 'warning' | 'error';
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * AppText - 基础文本组件
+ *
+ * 基于 React Native 的 Text 组件封装，提供预设的字体大小、字重和颜色选项
+ * 支持 Tailwind CSS 类名，简化文本样式定义
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <AppText>默认文本</AppText>
+ *
+ * // 不同大小
+ * <AppText size="xs">超小文本</AppText>
+ * <AppText size="lg">大文本</AppText>
+ * <AppText size="2xl">超大文本</AppText>
+ *
+ * // 不同字重
+ * <AppText weight="bold">粗体文本</AppText>
+ * <AppText weight="semibold">半粗文本</AppText>
+ *
+ * // 自定义颜色
+ * <AppText color="primary-500">主题色文本</AppText>
+ * <AppText color="red-500">红色文本</AppText>
+ *
+ * // 组合使用
+ * <AppText size="xl" weight="bold" color="gray-800">
+ *   标题文本
+ * </AppText>
+ * ```
+ */
+declare function AppText({ size, weight, color, tone, className, children, style, ...props }: AppTextProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * AppPressable 组件属性接口
+ */
+interface AppPressableProps extends PressableProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 按下状态时的类名 */
+    pressedClassName?: string;
+}
+/**
+ * AppPressable - 可按压组件
+ *
+ * 基于 React Native 的 Pressable 组件封装，支持按下状态样式切换
+ * 自动管理按下状态，支持自定义普通状态和按下状态的样式
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <AppPressable onPress={() => console.log('pressed')}>
+ *   <Text>点击我</Text>
+ * </AppPressable>
+ *
+ * // 带按下效果
+ * <AppPressable
+ *   className="p-4 bg-blue-500"
+ *   pressedClassName="bg-blue-600"
+ *   onPress={handlePress}
+ * >
+ *   <Text className="text-white">按钮</Text>
+ * </AppPressable>
+ *
+ * // 带透明度变化
+ * <AppPressable
+ *   className="p-3 rounded-lg"
+ *   pressedClassName="opacity-70"
+ *   onPress={handlePress}
+ * >
+ *   <Icon name="arrow-forward" />
+ * </AppPressable>
+ * ```
+ */
+declare function AppPressable({ className, pressedClassName, children, ...props }: AppPressableProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Row 组件属性接口
+ */
+interface RowProps extends AppViewProps {
+    /** 主轴对齐方式（justify-content） */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    /** 交叉轴对齐方式（align-items） */
+    items?: 'start' | 'center' | 'end' | 'stretch';
+}
+/**
+ * Row - 水平布局组件
+ *
+ * 基于 AppView 封装的水平排列布局组件，默认使用 flex-row
+ * 提供便捷的 justify 和 items 属性控制对齐方式
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Row>
+ *   <Text>左侧</Text>
+ *   <Text>右侧</Text>
+ * </Row>
+ *
+ * // 两端对齐
+ * <Row justify="between">
+ *   <Text>标题</Text>
+ *   <Icon name="arrow-forward" />
+ * </Row>
+ *
+ * // 居中对齐
+ * <Row justify="center" items="center" gap={4}>
+ *   <Icon name="star" />
+ *   <Text>评分</Text>
+ * </Row>
+ *
+ * // 带间距
+ * <Row gap={3}>
+ *   <Button>取消</Button>
+ *   <Button>确认</Button>
+ * </Row>
+ *
+ * // 组合使用
+ * <Row justify="between" items="center" className="p-4">
+ *   <AppView row gap={2}>
+ *     <Avatar source={avatar} />
+ *     <AppView>
+ *       <AppText weight="bold">用户名</AppText>
+ *       <AppText size="sm" color="gray-500">描述信息</AppText>
+ *     </AppView>
+ *   </AppView>
+ *   <Icon name="more-vert" />
+ * </Row>
+ * ```
+ */
+declare function Row({ justify, items, className, ...props }: RowProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Col 组件属性接口
+ */
+interface ColProps extends AppViewProps {
+    /** 主轴对齐方式（justify-content） */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    /** 交叉轴对齐方式（align-items） */
+    items?: 'start' | 'center' | 'end' | 'stretch';
+}
+/**
+ * Col - 垂直布局组件
+ *
+ * 基于 AppView 封装的垂直排列布局组件，默认使用 flex-col
+ * 提供便捷的 justify 和 items 属性控制对齐方式
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Col>
+ *   <Text>第一行</Text>
+ *   <Text>第二行</Text>
+ * </Col>
+ *
+ * // 两端对齐
+ * <Col justify="between" flex>
+ *   <Text>顶部内容</Text>
+ *   <Text>底部内容</Text>
+ * </Col>
+ *
+ * // 水平居中
+ * <Col items="center" gap={3}>
+ *   <Icon name="check-circle" size="xl" color="success-500" />
+ *   <AppText weight="bold">操作成功</AppText>
+ *   <AppText color="gray-500">您的订单已提交</AppText>
+ * </Col>
+ *
+ * // 带间距
+ * <Col gap={4}>
+ *   <Input placeholder="用户名" />
+ *   <Input placeholder="密码" secureTextEntry />
+ *   <Button>登录</Button>
+ * </Col>
+ *
+ * // 组合使用
+ * <Col className="p-4 bg-white rounded-lg">
+ *   <AppText size="lg" weight="bold">订单详情</AppText>
+ *   <Row justify="between" className="mt-2">
+ *     <AppText color="gray-500">订单号</AppText>
+ *     <AppText>12345678</AppText>
+ *   </Row>
+ *   <Row justify="between" className="mt-2">
+ *     <AppText color="gray-500">金额</AppText>
+ *     <AppText color="danger-500" weight="bold">¥99.00</AppText>
+ *   </Row>
+ * </Col>
+ * ```
+ */
+declare function Col({ justify, items, className, ...props }: ColProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Center 组件属性接口
+ */
+interface CenterProps extends Omit<AppViewProps, 'center'> {
+    /** 是否使用 flex 布局，默认为 true */
+    flex?: boolean | number;
+}
+/**
+ * Center - 居中布局组件
+ *
+ * 基于 AppView 封装的居中布局组件，内容在水平和垂直方向都居中
+ * 常用于空状态、加载状态等需要居中对齐的场景
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Center>
+ *   <Text>居中内容</Text>
+ * </Center>
+ *
+ * // 全屏居中
+ * <Center flex>
+ *   <Icon name="inbox" size="xl" />
+ *   <Text>暂无数据</Text>
+ * </Center>
+ *
+ * // 指定 flex 值
+ * <Center flex={2}>
+ *   <Text>占据更多空间</Text>
+ * </Center>
+ *
+ * // 组合使用
+ * <Center flex className="bg-gray-50">
+ *   <AppImage source={emptyImage} width={120} height={120} />
+ *   <AppText size="lg" weight="bold" className="mt-4">暂无订单</AppText>
+ *   <AppText color="gray-500" className="mt-2">快去选购商品吧</AppText>
+ *   <AppButton className="mt-6" onPress={goShopping}>去购物</AppButton>
+ * </Center>
+ * ```
+ */
+declare function Center({ flex, ...props }: CenterProps): react_jsx_runtime.JSX.Element;
+
+interface SafeScreenProps extends ViewProps {
+    /** 是否包含顶部安全区域 */
+    top?: boolean;
+    /** 是否包含底部安全区域 */
+    bottom?: boolean;
+    /** 是否包含左侧安全区域 */
+    left?: boolean;
+    /** 是否包含右侧安全区域 */
+    right?: boolean;
+    /** 背景颜色 */
+    bg?: string;
+    /** 是否使用 flex: 1 */
+    flex?: boolean;
+    /** 自定义样式类 */
+    className?: string;
+    /** 子元素 */
+    children: React__default.ReactNode;
+}
+/**
+ * 安全屏幕组件 - 自动适配刘海屏/全面屏的安全区域
+ *
+ * @example
+ * ```tsx
+ * <SafeScreen flex bg="white">
+ *   <AppText>内容在安全区域内</AppText>
+ * </SafeScreen>
+ * ```
+ */
+declare function SafeScreen({ top, bottom, left, right, bg, flex, className, children, style, ...props }: SafeScreenProps): react_jsx_runtime.JSX.Element;
+/**
+ * 页面容器组件 - 包含安全区域和基础布局
+ *
+ * @example
+ * ```tsx
+ * <Page>
+ *   <AppHeader title="首页" />
+ *   <AppView flex p={4}>
+ *     <AppText>页面内容</AppText>
+ *   </AppView>
+ * </Page>
+ * ```
+ */
+declare function Page({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
+/**
+ * 底部安全区域组件 - 只在底部添加安全距离
+ * 注意：此组件不会铺满全屏，只占据内容高度
+ *
+ * @example
+ * ```tsx
+ * <SafeBottom>
+ *   <AppButton>底部按钮</AppButton>
+ * </SafeBottom>
+ * ```
+ */
+declare function SafeBottom({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
+
+/**
+ * AppButton 组件属性接口
+ */
+interface AppButtonProps {
+    /** 按钮样式变体：solid(实心)、outline(描边)、ghost(透明) */
+    variant?: 'solid' | 'outline' | 'ghost';
+    /** 按钮尺寸：sm(小)、md(中)、lg(大) */
+    size?: 'sm' | 'md' | 'lg';
+    /** 按钮颜色主题 */
+    color?: 'primary' | 'secondary' | 'danger';
+    /** 是否显示加载状态 */
+    loading?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 点击回调 */
+    onPress?: () => void;
+    /** 按钮内容 */
+    children: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * AppButton - 按钮组件
+ *
+ * 功能完善的按钮组件，支持多种样式变体、尺寸和颜色主题
+ * 内置加载状态和禁用状态处理，提供统一的用户交互体验
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <AppButton onPress={handlePress}>确定</AppButton>
+ *
+ * // 不同变体
+ * <AppButton variant="solid">实心按钮</AppButton>
+ * <AppButton variant="outline">描边按钮</AppButton>
+ * <AppButton variant="ghost">透明按钮</AppButton>
+ *
+ * // 不同尺寸
+ * <AppButton size="sm">小按钮</AppButton>
+ * <AppButton size="md">中按钮</AppButton>
+ * <AppButton size="lg">大按钮</AppButton>
+ *
+ * // 不同颜色
+ * <AppButton color="primary">主题色</AppButton>
+ * <AppButton color="secondary">次要色</AppButton>
+ * <AppButton color="danger">危险操作</AppButton>
+ *
+ * // 加载状态
+ * <AppButton loading>加载中</AppButton>
+ *
+ * // 禁用状态
+ * <AppButton disabled>不可用</AppButton>
+ *
+ * // 组合使用
+ * <AppButton
+ *   variant="outline"
+ *   color="danger"
+ *   size="lg"
+ *   onPress={handleDelete}
+ * >
+ *   删除账号
+ * </AppButton>
+ * ```
+ */
+declare function AppButton({ variant, size, color, loading, disabled, onPress, children, className, }: AppButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Toast 组件属性接口
+ */
+interface ToastProps {
+    /** 提示消息内容 */
+    message: string;
+    /** 提示类型，决定背景颜色 */
+    type?: 'success' | 'error' | 'warning' | 'info';
+    /** 是否显示 */
+    visible?: boolean;
+}
+/**
+ * Toast - 轻提示组件
+ *
+ * 用于显示简短的操作反馈信息，自动根据类型显示不同颜色
+ * 通常配合 Toast 管理器使用，支持自动消失
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Toast message="操作成功" />
+ *
+ * // 不同类型
+ * <Toast message="保存成功" type="success" />
+ * <Toast message="网络错误" type="error" />
+ * <Toast message="请注意" type="warning" />
+ * <Toast message="提示信息" type="info" />
+ *
+ * // 控制显示
+ * <Toast
+ *   message="正在加载..."
+ *   type="info"
+ *   visible={isLoading}
+ * />
+ *
+ * // 配合管理器使用
+ * const { showToast } = useToast();
+ * showToast({ message: '操作成功', type: 'success' });
+ * ```
+ */
+declare function Toast({ message, type, visible }: ToastProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Alert 按钮配置
+ */
+interface AlertButton {
+    text: string;
+    onPress?: () => void;
+    style?: 'default' | 'cancel' | 'destructive';
+}
+/**
+ * Alert 组件属性接口
+ */
+interface AlertProps {
+    /** 是否显示 */
+    visible: boolean;
+    /** 标题 */
+    title: string;
+    /** 消息内容 */
+    message?: string;
+    /** 按钮配置 */
+    buttons: AlertButton[];
+    /** 关闭回调 */
+    onClose?: () => void;
+}
+/**
+ * Alert - 对话框组件，支持浅色/深色主题
+ */
+declare function Alert({ visible, title, message, buttons, onClose }: AlertProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loading 组件属性接口
+ */
+interface LoadingProps {
+    /** 加载提示文字 */
+    text?: string;
+    /** 指示器颜色 */
+    color?: string;
+    /** 是否显示遮罩层 */
+    overlay?: boolean;
+    /** 是否显示 */
+    visible?: boolean;
+    /** 测试 ID */
+    testID?: string;
+}
+/**
+ * Loading - 加载指示器组件
+ *
+ * 用于显示操作正在进行的视觉反馈，支持内联和遮罩两种模式
+ * 遮罩模式会覆盖整个屏幕，阻止用户操作
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Loading />
+ *
+ * // 带提示文字
+ * <Loading text="正在加载..." />
+ *
+ * // 遮罩模式（全屏）
+ * <Loading overlay text="保存中..." />
+ *
+ * // 条件显示
+ * {isLoading && <Loading text="加载中" />}
+ *
+ * // 配合请求使用
+ * const [loading, setLoading] = useState(false);
+ *
+ * const fetchData = async () => {
+ *   setLoading(true);
+ *   try {
+ *     const data = await api.getData();
+ *     setData(data);
+ *   } finally {
+ *     setLoading(false);
+ *   }
+ * };
+ *
+ * return (
+ *   <>
+ *     <FlatList data={data} renderItem={renderItem} />
+ *     <Loading overlay visible={loading} text="加载中..." />
+ *   </>
+ * );
+ * ```
+ */
+declare function Loading({ text, color, overlay, visible, testID, }: LoadingProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Progress 组件属性接口
+ */
+interface ProgressProps {
+    /** 当前进度值 */
+    value: number;
+    /** 最大值，默认为 100 */
+    max?: number;
+    /** 进度条高度：xs(4px)、sm(6px)、md(8px)、lg(12px)、xl(16px) */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** 进度条颜色 */
+    color?: 'primary' | 'secondary' | 'success' | 'warning' | 'error';
+    /** 测试 ID */
+    testID?: string;
+    /** 自定义容器样式 */
+    className?: string;
+    /** 自定义进度条样式 */
+    barClassName?: string;
+}
+/**
+ * Progress - 进度条组件
+ *
+ * 用于展示操作进度的可视化组件，支持浅色/深色主题
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Progress value={50} />
+ *
+ * // 不同尺寸
+ * <Progress value={30} size="sm" />
+ * <Progress value={60} size="lg" />
+ *
+ * // 不同颜色
+ * <Progress value={75} color="success" />
+ * <Progress value={90} color="warning" />
+ * ```
+ */
+declare function Progress({ value, max, size, color, testID, className, barClassName, }: ProgressProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Card 组件属性接口
+ */
+interface CardProps extends ViewProps {
+    /** Tailwind / NativeWind 类名 */
+    className?: string;
+    /** 是否禁用阴影 */
+    noShadow?: boolean;
+    /** 是否禁用边框 */
+    noBorder?: boolean;
+    /** 是否禁用圆角 */
+    noRadius?: boolean;
+}
+/**
+ * Card - 卡片容器组件，支持浅色/深色主题
+ */
+declare function Card({ children, className, style, noShadow, noBorder, noRadius, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+
+/** 图标尺寸类型 */
+type IconSize = number | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Icon 组件属性接口
+ */
+interface IconProps {
+    /** 图标名称，参考 MaterialIcons 图标库 */
+    name: string;
+    /** 图标尺寸：预设值 xs(16px)、sm(20px)、md(24px)、lg(32px)、xl(48px) 或直接指定数字 */
+    size?: IconSize;
+    /** 图标颜色，支持 Tailwind 颜色格式（如 'primary-500'、'gray-600'）或十六进制值 */
+    color?: string;
+    /** 自定义样式 */
+    style?: StyleProp<TextStyle>;
+    /** 点击回调，设置了此属性后图标将变为可点击 */
+    onPress?: () => void;
+    /** 测试 ID */
+    testID?: string;
+}
+/**
+ * 解析图标颜色
+ * @param color - 颜色值
+ * @param theme - 主题对象
+ * @returns 解析后的颜色值
+ */
+/**
+ * Icon - 图标组件
+ *
+ * 基于 MaterialIcons 的图标组件，支持主题颜色、多种尺寸和点击交互
+ * 提供了常用的图标常量集合，方便开发使用
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <Icon name="home" />
+ *
+ * // 指定尺寸
+ * <Icon name="search" size="lg" />
+ * <Icon name="settings" size={32} />
+ *
+ * // 指定颜色
+ * <Icon name="check-circle" color="success-500" />
+ * <Icon name="error" color="red-500" />
+ *
+ * // 可点击图标
+ * <Icon name="close" onPress={() => setVisible(false)} />
+ *
+ * // 使用预设常量
+ * <Icon name={NavigationIcons.home} />
+ * <Icon name={ActionIcons.delete} color="danger-500" />
+ * ```
+ */
+declare function Icon({ name, size, color, style, onPress, testID }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * 导航图标常量
+ */
+declare const NavigationIcons: {
+    readonly home: "home";
+    readonly explore: "explore";
+    readonly profile: "person";
+    readonly settings: "settings";
+    readonly back: "arrow-back";
+    readonly forward: "arrow-forward";
+    readonly close: "close";
+    readonly menu: "menu";
+    readonly more: "more-vert";
+};
+/**
+ * 操作图标常量
+ */
+declare const ActionIcons: {
+    readonly add: "add";
+    readonly edit: "edit";
+    readonly delete: "delete";
+    readonly search: "search";
+    readonly share: "share";
+    readonly favorite: "favorite";
+    readonly favoriteBorder: "favorite-border";
+    readonly check: "check";
+    readonly checkCircle: "check-circle";
+    readonly close: "close";
+    readonly closeCircle: "cancel";
+    readonly copy: "content-copy";
+    readonly download: "download";
+    readonly upload: "upload";
+};
+/**
+ * 状态图标常量
+ */
+declare const StatusIcons: {
+    readonly info: "info";
+    readonly success: "check-circle";
+    readonly warning: "warning";
+    readonly error: "error";
+    readonly help: "help";
+    readonly loading: "refresh";
+};
+/**
+ * 文件图标常量
+ */
+declare const FileIcons: {
+    readonly file: "insert-drive-file";
+    readonly image: "image";
+    readonly video: "videocam";
+    readonly audio: "audiotrack";
+    readonly folder: "folder";
+    readonly folderOpen: "folder-open";
+};
+
+/** 图片缩放模式 */
+type ImageResizeMode = 'cover' | 'contain' | 'stretch' | 'center';
+/**
+ * AppImage 组件属性接口
+ */
+interface AppImageProps {
+    /** 图片资源，可以是本地资源或远程 URL */
+    source: ImageSourcePropType | {
+        uri: string;
+    };
+    /** 宽度，数字表示像素，字符串表示百分比 */
+    width?: number | string;
+    /** 高度，数字表示像素，'auto' 表示自适应，或使用 'aspect-16/9' 等比例格式 */
+    height?: number | string;
+    /** 圆角大小，支持预设值或数字 */
+    borderRadius?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full' | number;
+    /** 加载时的占位图 */
+    placeholder?: ImageSourcePropType;
+    /** 加载失败时的占位图 */
+    errorPlaceholder?: ImageSourcePropType;
+    /** 是否显示加载指示器，设为 true 显示默认指示器，或传入自定义节点 */
+    loadingIndicator?: boolean | React__default.ReactNode;
+    /** 是否在加载失败时显示错误图标 */
+    showError?: boolean;
+    /** 图片缩放模式 */
+    resizeMode?: ImageResizeMode;
+    /** 图片加载成功回调 */
+    onLoad?: () => void;
+    /** 图片加载失败回调 */
+    onError?: (error: any) => void;
+    /** 点击回调 */
+    onPress?: () => void;
+    /** 长按回调 */
+    onLongPress?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: StyleProp<ImageStyle>;
+}
+/**
+ * AppImage - 图片组件
+ *
+ * 功能丰富的图片组件，支持加载状态、错误处理、圆角、点击交互等
+ * 自动处理图片加载过程中的各种状态，提供良好的用户体验
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <AppImage source={{ uri: 'https://example.com/image.jpg' }} />
+ *
+ * // 指定尺寸和圆角
+ * <AppImage
+ *   source={require('./photo.png')}
+ *   width={200}
+ *   height={150}
+ *   borderRadius="lg"
+ * />
+ *
+ * // 显示加载指示器
+ * <AppImage
+ *   source={{ uri: 'https://example.com/large-image.jpg' }}
+ *   loadingIndicator={true}
+ *   showError={true}
+ * />
+ *
+ * // 可点击图片
+ * <AppImage
+ *   source={{ uri: 'https://example.com/photo.jpg' }}
+ *   onPress={() => navigation.navigate('Detail')}
+ *   onLongPress={() => showContextMenu()}
+ * />
+ *
+ * // 使用占位图
+ * <AppImage
+ *   source={{ uri: user.avatar }}
+ *   placeholder={require('./default-avatar.png')}
+ *   errorPlaceholder={require('./error-avatar.png')}
+ *   borderRadius="full"
+ * />
+ * ```
+ */
+declare function AppImage({ source, width, height, borderRadius, placeholder, errorPlaceholder, loadingIndicator, showError, resizeMode, onLoad, onError, onPress, onLongPress, className, style, }: AppImageProps): react_jsx_runtime.JSX.Element;
+
+interface AppListProps<T = any> {
+    data: T[];
+    renderItem: ListRenderItem<T>;
+    keyExtractor?: (item: T, index: number) => string;
+    loading?: boolean;
+    refreshing?: boolean;
+    onRefresh?: () => void | Promise<void>;
+    hasMore?: boolean;
+    onEndReached?: () => void | Promise<void>;
+    onEndReachedThreshold?: number;
+    error?: Error | null;
+    onRetry?: () => void;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    emptyIcon?: string;
+    EmptyComponent?: React__default.ComponentType;
+    divider?: boolean;
+    dividerStyle?: StyleProp<ViewStyle>;
+    skeletonCount?: number;
+    skeletonRender?: () => React__default.ReactElement;
+    ListHeaderComponent?: React__default.ComponentType | React__default.ReactElement | null;
+    ListFooterComponent?: React__default.ComponentType | React__default.ReactElement | null;
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    style?: StyleProp<ViewStyle>;
+    numColumns?: number;
+    columnWrapperStyle?: StyleProp<ViewStyle>;
+    horizontal?: boolean;
+    showsVerticalScrollIndicator?: boolean;
+    showsHorizontalScrollIndicator?: boolean;
+}
+declare function AppList<T = any>({ data, renderItem, keyExtractor, loading, refreshing, onRefresh, hasMore, onEndReached, onEndReachedThreshold, error, onRetry, emptyTitle, emptyDescription, emptyIcon, EmptyComponent, divider, dividerStyle, skeletonCount, skeletonRender, ListHeaderComponent, ListFooterComponent, contentContainerStyle, style, numColumns, columnWrapperStyle, horizontal, showsVerticalScrollIndicator, showsHorizontalScrollIndicator, }: AppListProps<T>): react_jsx_runtime.JSX.Element;
+
+/**
+ * AppInput 组件属性接口
+ */
+interface AppInputProps extends Omit<TextInputProps, 'editable'> {
+    /** 标签文本 */
+    label?: string;
+    /** 错误信息 */
+    error?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 左侧图标 */
+    leftIcon?: React.ReactNode;
+    /** 右侧图标 */
+    rightIcon?: React.ReactNode;
+    /** 自定义样式 */
+    className?: string;
+}
+/**
+ * AppInput - 输入框组件，支持浅色/深色主题
+ */
+declare const AppInput: React$1.ForwardRefExoticComponent<AppInputProps & React$1.RefAttributes<TextInput>>;
+
+/**
+ * Checkbox 组件属性接口
+ */
+interface CheckboxProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    disabled?: boolean;
+    children?: React.ReactNode;
+    className?: string;
+    testID?: string;
+}
+/**
+ * Checkbox - 复选框组件，支持浅色/深色主题
+ */
+declare function Checkbox({ checked, defaultChecked, onChange, disabled, children, className, testID, }: CheckboxProps): react_jsx_runtime.JSX.Element;
+
+interface Option$1 {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+interface CheckboxGroupProps {
+    value?: string[];
+    onChange?: (value: string[]) => void;
+    options?: Option$1[];
+    direction?: 'row' | 'column';
+    disabled?: boolean;
+}
+declare function CheckboxGroup({ value, onChange, options, direction, disabled, }: CheckboxGroupProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Radio 组件属性接口
+ */
+interface RadioProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    disabled?: boolean;
+    children?: React.ReactNode;
+    className?: string;
+    testID?: string;
+}
+/**
+ * Radio - 单选框组件，支持浅色/深色主题
+ */
+declare function Radio({ checked, defaultChecked, onChange, disabled, children, className, testID, }: RadioProps): react_jsx_runtime.JSX.Element;
+
+interface Option {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+interface RadioGroupProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    options?: Option[];
+    direction?: 'row' | 'column';
+    disabled?: boolean;
+}
+declare function RadioGroup({ value, onChange, options, direction, disabled, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Switch 组件属性接口
+ */
+interface SwitchProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    testID?: string;
+    style?: ViewStyle;
+}
+/**
+ * Switch - 开关组件，支持浅色/深色主题
+ */
+declare function Switch({ checked, defaultChecked, onChange, disabled, size, className, testID, style, }: SwitchProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Slider 组件属性接口
+ */
+interface SliderProps {
+    value?: number;
+    defaultValue?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    disabled?: boolean;
+    showTooltip?: boolean;
+    onChange?: (value: number) => void;
+    onChangeEnd?: (value: number) => void;
+    className?: string;
+}
+/**
+ * Slider - 滑块组件，支持浅色/深色主题
+ */
+declare function Slider({ value, defaultValue, min, max, step, disabled, showTooltip, onChange, onChangeEnd, className, }: SliderProps): react_jsx_runtime.JSX.Element;
+
+interface SelectOption {
+    label: string;
+    value: string;
+}
+interface SelectProps {
+    /** 选中值 */
+    value?: string | string[];
+    /** 变化回调 */
+    onChange?: (value: string | string[]) => void;
+    /** 选项列表 */
+    options: SelectOption[];
+    /** 占位文字 */
+    placeholder?: string;
+    /** 是否多选 */
+    multiple?: boolean;
+    /** 是否可搜索 */
+    searchable?: boolean;
+    /** 搜索回调（异步搜索时使用） */
+    onSearch?: (keyword: string) => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否可清空 */
+    clearable?: boolean;
+    /** 自定义样式 */
+    className?: string;
+}
+/**
+ * 底部弹出选择器组件，支持浅色/深色主题
+ */
+declare function Select({ value, onChange, options, placeholder, multiple, searchable, onSearch, disabled, clearable, className, }: SelectProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * DatePicker 组件属性接口
+ */
+interface DatePickerProps {
+    /** 选中日期 */
+    value?: Date;
+    /** 变化回调 */
+    onChange?: (date: Date) => void;
+    /** 占位文字 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 日期格式 */
+    format?: string;
+    /** 最小日期 */
+    minDate?: Date;
+    /** 最大日期 */
+    maxDate?: Date;
+    /** 自定义样式 */
+    className?: string;
+}
+/**
+ * DatePicker - 日期选择器组件，支持浅色/深色主题
+ */
+declare function DatePicker({ value, onChange, placeholder, disabled, format, minDate, maxDate, className, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+
+interface FormItemProps {
+    name: string;
+    label?: string;
+    error?: string;
+    help?: string;
+    required?: boolean;
+    children: React.ReactNode;
+    /** 自定义样式 */
+    className?: string;
+    /** 标签样式 */
+    labelClassName?: string;
+}
+declare function FormItem({ name: _name, label, error, help, required, children, className, labelClassName, }: FormItemProps): react_jsx_runtime.JSX.Element;
+
+interface UseFormOptions<T extends Record<string, any>> {
+    schema: ZodSchema<T>;
+    defaultValues: T;
+}
+interface FormErrors {
+    [key: string]: string;
+}
+declare function useForm<T extends Record<string, any>>({ schema, defaultValues, }: UseFormOptions<T>): {
+    values: T;
+    errors: FormErrors;
+    isValid: boolean;
+    isDirty: boolean;
+    isSubmitting: boolean;
+    setValue: (name: keyof T, value: any) => void;
+    getValue: (name: keyof T) => T[keyof T];
+    validate: () => Promise<boolean>;
+    validateField: (name: keyof T) => Promise<boolean>;
+    reset: () => void;
+    handleSubmit: (onSubmit?: (values: T) => void | Promise<void>) => Promise<void>;
+};
+
+interface UseToggleActions {
+    /** 切换布尔值 */
+    toggle: () => void;
+    /** 设置为指定值 */
+    set: (value: boolean) => void;
+    /** 设置为 true */
+    setTrue: () => void;
+    /** 设置为 false */
+    setFalse: () => void;
+}
+/**
+ * 布尔值切换 Hook
+ * @param defaultValue - 默认值
+ * @returns [当前值, 操作集合]
+ *
+ * @example
+ * ```tsx
+ * const [visible, { toggle, setTrue, setFalse }] = useToggle(false);
+ *
+ * <Button onPress={toggle}>{visible ? '隐藏' : '显示'}</Button>
+ * {visible && <Modal onClose={setFalse} />}
+ * ```
+ */
+declare function useToggle(defaultValue?: boolean): [boolean, UseToggleActions];
+
+/**
+ * 防抖 Hook
+ * @param value - 需要防抖的值
+ * @param delay - 延迟时间（毫秒），默认 500ms
+ * @returns 防抖后的值
+ *
+ * @example
+ * ```tsx
+ * const [keyword, setKeyword] = useState('');
+ * const debouncedKeyword = useDebounce(keyword, 500);
+ *
+ * // 使用 debouncedKeyword 进行搜索
+ * useEffect(() => {
+ *   search(debouncedKeyword);
+ * }, [debouncedKeyword]);
+ * ```
+ */
+declare function useDebounce<T>(value: T, delay?: number): T;
+
+/**
+ * 节流 Hook
+ * @param value - 需要节流的值
+ * @param delay - 节流间隔（毫秒），默认 200ms
+ * @returns 节流后的值
+ *
+ * @example
+ * ```tsx
+ * const [scrollY, setScrollY] = useState(0);
+ * const throttledScrollY = useThrottle(scrollY, 200);
+ *
+ * // 使用 throttledScrollY 更新 UI（如头部透明度）
+ * const headerOpacity = Math.min(throttledScrollY / 200, 1);
+ * ```
+ */
+declare function useThrottle<T>(value: T, delay?: number): T;
+
+interface UseKeyboardReturn {
+    /** 键盘是否显示 */
+    visible: boolean;
+    /** 键盘高度 */
+    height: number;
+    /** 关闭键盘 */
+    dismiss: () => void;
+}
+/**
+ * 键盘状态监听 Hook
+ * @returns 键盘状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * const { visible, height, dismiss } = useKeyboard();
+ *
+ * <ScrollView contentContainerStyle={{ paddingBottom: visible ? height : 0 }}>
+ *   {\/* 内容 *\/}
+ * </ScrollView>
+ * ```
+ */
+declare function useKeyboard(): UseKeyboardReturn;
+
+interface UseDimensionsReturn {
+    /** 屏幕宽度 */
+    width: number;
+    /** 屏幕高度 */
+    height: number;
+    /** 屏幕像素密度 */
+    scale: number;
+    /** 字体缩放比例 */
+    fontScale: number;
+}
+/**
+ * 屏幕尺寸变化监听 Hook
+ * @returns 屏幕尺寸信息
+ *
+ * @example
+ * ```tsx
+ * const { width, height } = useDimensions();
+ *
+ * // 根据宽度决定列数
+ * const numColumns = width > 600 ? 3 : 2;
+ * ```
+ */
+declare function useDimensions(): UseDimensionsReturn;
+
+type Orientation = 'portrait' | 'landscape';
+interface UseOrientationReturn {
+    /** 当前方向 */
+    orientation: Orientation;
+    /** 是否为竖屏 */
+    isPortrait: boolean;
+    /** 是否为横屏 */
+    isLandscape: boolean;
+}
+/**
+ * 横竖屏切换监听 Hook
+ * @returns 方向状态
+ *
+ * @example
+ * ```tsx
+ * const { orientation, isPortrait } = useOrientation();
+ *
+ * <View style={{ flexDirection: isPortrait ? 'column' : 'row' }}>
+ *   {\/* 内容 *\/}
+ * </View>
+ * ```
+ */
+declare function useOrientation(): UseOrientationReturn;
+
+/**
+ * 导航提供者组件 Props
+ */
+interface NavigationProviderProps {
+    /** 子元素（导航器组件） */
+    children: React__default.ReactNode;
+    /** 深度链接配置（可选） */
+    linking?: LinkingOptions<any>;
+    /** 加载时的回退组件 */
+    fallback?: React__default.ReactNode;
+    /** 导航准备就绪时的回调 */
+    onReady?: () => void;
+    /** 状态变化时的回调 */
+    onStateChange?: (state: any) => void;
+    /** 未处理动作时的回调 */
+    onUnhandledAction?: (action: any) => void;
+    /** 自定义导航主题（覆盖默认主题） */
+    theme?: Theme$1;
+}
+/**
+ * 导航提供者组件
+ *
+ * 封装 NavigationContainer，自动集成应用主题。
+ * 所有导航器必须包裹在 NavigationProvider 内。
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * export default function App() {
+ *   return (
+ *     <NavigationProvider>
+ *       <StackNavigator>
+ *         <StackNavigator.Screen name="Home" component={HomeScreen} />
+ *       </StackNavigator>
+ *     </NavigationProvider>
+ *   );
+ * }
+ *
+ * // 带深度链接
+ * export default function App() {
+ *   return (
+ *     <NavigationProvider
+ *       linking={{
+ *         prefixes: ['myapp://', 'https://myapp.com'],
+ *         config: {
+ *           screens: {
+ *             Home: 'home',
+ *             Detail: 'detail/:id',
+ *           },
+ *         },
+ *       }}
+ *       fallback={<LoadingScreen />}
+ *     >
+ *       <RootNavigator />
+ *     </NavigationProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function NavigationProvider({ children, linking, fallback, onReady, onStateChange, onUnhandledAction, theme: customTheme, }: NavigationProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 导航基础类型
+ * @module navigation/types/base
+ */
+/**
+ * 路由参数基础类型
+ * 所有路由参数列表都应继承此类型
+ */
+type ParamListBase = {
+    [key: string]: object | undefined;
+};
+/**
+ * 堆栈导航参数列表
+ * 用户应扩展此类型来定义自己的路由参数
+ *
+ * @example
+ * ```ts
+ * declare module '@gaozh1024/rn-kit' {
+ *   interface StackParamList {
+ *     Home: undefined;
+ *     Detail: { id: string };
+ *   }
+ * }
+ * ```
+ */
+interface StackParamList extends ParamListBase {
+}
+/**
+ * 标签导航参数列表
+ * 用户应扩展此类型来定义自己的路由参数
+ */
+interface TabParamList extends ParamListBase {
+}
+/**
+ * 抽屉导航参数列表
+ * 用户应扩展此类型来定义自己的路由参数
+ */
+interface DrawerParamList extends ParamListBase {
+}
+
+/**
+ * 屏幕选项类型
+ * @module navigation/types/screens
+ */
+/**
+ * 屏幕选项配置 - 堆栈
+ */
+interface StackScreenOptions {
+    /** 标题 */
+    title?: string;
+    /** 是否显示头部 */
+    headerShown?: boolean;
+    /** 自定义头部 */
+    header?: (props: any) => React.ReactElement | null;
+    /** 动画类型 */
+    animation?: 'default' | 'fade' | 'slide_from_right' | 'slide_from_left' | 'slide_from_bottom' | 'none';
+    /** 是否支持全屏手势返回（主要用于 iOS） */
+    fullScreenGestureEnabled?: boolean;
+    /** 自定义后退按钮标题（iOS） */
+    headerBackTitle?: string;
+    /** 是否显示后退按钮 */
+    headerBackVisible?: boolean;
+    /** 内容样式 */
+    contentStyle?: object;
+}
+/**
+ * 屏幕选项配置 - 标签
+ */
+interface TabScreenOptions {
+    /** 标签标题 */
+    title?: string;
+    /** 标签栏标签 */
+    tabBarLabel?: string | ((props: {
+        focused: boolean;
+        color: string;
+    }) => React.ReactNode);
+    /** 标签栏图标 */
+    tabBarIcon?: (props: {
+        focused: boolean;
+        color: string;
+        size: number;
+    }) => React.ReactNode;
+    /** 是否显示标签栏 */
+    tabBarVisible?: boolean;
+    /** 是否支持滑动切换 */
+    swipeEnabled?: boolean;
+}
+/**
+ * 标签栏配置
+ */
+interface TabBarOptions {
+    /** 是否显示标签 */
+    showLabel?: boolean;
+    /** 激活状态颜色 */
+    activeTintColor?: string;
+    /** 非激活状态颜色 */
+    inactiveTintColor?: string;
+    /** 激活背景色 */
+    activeBackgroundColor?: string;
+    /** 非激活背景色 */
+    inactiveBackgroundColor?: string;
+    /** 键盘弹出时是否隐藏 */
+    hideOnKeyboard?: boolean;
+    /** 标签位置 */
+    labelPosition?: 'below-icon' | 'beside-icon';
+    /** 标签样式 */
+    labelStyle?: TextStyle;
+    /** 图标样式 */
+    iconStyle?: ViewStyle;
+    /** 标签栏样式 */
+    style?: ViewStyle;
+    /** 标签栏高度（不含底部安全区，默认 65） */
+    height?: number;
+}
+/**
+ * 屏幕选项配置 - 抽屉
+ */
+interface DrawerScreenOptions {
+    /** 标题 */
+    title?: string;
+    /** 是否显示头部 */
+    headerShown?: boolean;
+    /** 抽屉标签 */
+    drawerLabel?: string | ((props: {
+        focused: boolean;
+        color: string;
+    }) => React.ReactNode);
+    /** 抽屉图标 */
+    drawerIcon?: (props: {
+        focused: boolean;
+        size: number;
+        color: string;
+    }) => React.ReactNode;
+    /** 激活状态颜色 */
+    drawerActiveTintColor?: string;
+    /** 非激活状态颜色 */
+    drawerInactiveTintColor?: string;
+    /** 激活背景色 */
+    drawerActiveBackgroundColor?: string;
+    /** 非激活背景色 */
+    drawerInactiveBackgroundColor?: string;
+}
+/**
+ * 抽屉配置
+ */
+interface DrawerOptions {
+    /** 抽屉类型 */
+    drawerType?: 'front' | 'back' | 'slide' | 'permanent';
+    /** 抽屉宽度 */
+    drawerWidth?: number;
+    /** 遮罩层颜色 */
+    overlayColor?: string;
+    /** 是否支持边缘滑动打开 */
+    edgeWidth?: number;
+    /** 最小滑动距离 */
+    minSwipeDistance?: number;
+    /** 隐藏状态下是否响应手势 */
+    gestureHandlerProps?: object;
+}
+
+/**
+ * 路由配置类型
+ * @module navigation/types/routes
+ */
+
+/**
+ * 路由屏幕配置
+ */
+interface RouteConfig {
+    /** 屏幕名称 */
+    name: string;
+    /** 屏幕组件 */
+    component: React.ComponentType<any>;
+    /** 屏幕选项 */
+    options?: StackScreenOptions | TabScreenOptions | DrawerScreenOptions;
+    /** 初始参数 */
+    initialParams?: Record<string, any>;
+    /** 嵌套路由 */
+    children?: RouteConfig[];
+}
+/**
+ * 堆栈路由配置
+ */
+interface StackRouteConfig extends RouteConfig {
+    options?: StackScreenOptions;
+}
+/**
+ * 标签路由配置
+ */
+interface TabRouteConfig extends RouteConfig {
+    options?: TabScreenOptions;
+}
+/**
+ * 抽屉路由配置
+ */
+interface DrawerRouteConfig extends RouteConfig {
+    options?: DrawerScreenOptions;
+}
+
+/**
+ * 深度链接配置类型
+ * @module navigation/types/linking
+ */
+/**
+ * 路径配置
+ */
+interface PathConfig {
+    /** 路径模板 */
+    path?: string;
+    /** 是否精确匹配 */
+    exact?: boolean;
+    /** 解析参数 */
+    parse?: Record<string, (value: string) => any>;
+    /** 序列化参数 */
+    stringify?: Record<string, (value: any) => string>;
+    /** 嵌套屏幕配置 */
+    screens?: Record<string, PathConfig>;
+}
+/**
+ * 深度链接配置
+ */
+interface LinkingConfig {
+    /** 前缀列表 */
+    prefixes: string[];
+    /** 屏幕路径配置 */
+    config: {
+        /** 初始路由 */
+        initialRouteName?: string;
+        /** 屏幕路径映射 */
+        screens: Record<string, PathConfig>;
+    };
+    /** 获取初始 URL */
+    getInitialURL?: () => Promise<string | null | undefined>;
+    /** 订阅 URL 变化 */
+    subscribe?: (listener: (url: string) => void) => () => void;
+}
+
+/**
+ * 堆栈导航器 Props
+ */
+interface StackNavigatorProps {
+    /** 初始路由名称 */
+    initialRouteName?: string;
+    /** 屏幕选项配置 */
+    screenOptions?: StackScreenOptions;
+    /** 子元素 */
+    children?: React.ReactNode;
+}
+/**
+ * 标签导航器 Props
+ */
+interface TabNavigatorProps {
+    /** 初始路由名称 */
+    initialRouteName?: string;
+    /** 标签栏选项配置 */
+    tabBarOptions?: TabBarOptions;
+    /** 自定义标签栏组件 */
+    tabBar?: (props: _react_navigation_bottom_tabs.BottomTabBarProps) => React.ReactNode;
+    /** 屏幕选项配置 */
+    screenOptions?: TabScreenOptions;
+    /** 子元素 */
+    children?: React.ReactNode;
+}
+/**
+ * 抽屉导航器 Props
+ */
+interface DrawerNavigatorProps {
+    /** 初始路由名称 */
+    initialRouteName?: string;
+    /** 屏幕选项配置 */
+    screenOptions?: DrawerScreenOptions;
+    /** 自定义抽屉内容组件 */
+    drawerContent?: (props: any) => React.ReactNode;
+    /** 抽屉配置 */
+    drawerOptions?: DrawerOptions;
+    /** 子元素 */
+    children?: React.ReactNode;
+}
+
+/**
+ * 导航 Hook 返回类型
+ * @module navigation/types/navigation
+ */
+
+/**
+ * 堆栈屏幕组件 Props
+ * @template T - 路由名称
+ */
+type StackScreenProps<T extends keyof StackParamList> = StackScreenProps$1<StackParamList, T>;
+/**
+ * 标签屏幕组件 Props
+ * @template T - 路由名称
+ */
+type TabScreenProps<T extends keyof TabParamList> = BottomTabScreenProps<TabParamList, T>;
+/**
+ * 抽屉屏幕组件 Props
+ * @template T - 路由名称
+ */
+type DrawerScreenProps<T extends keyof DrawerParamList> = DrawerScreenProps$1<DrawerParamList, T>;
+/**
+ * 堆栈导航 Hook 返回类型
+ */
+type StackNavigation = StackNavigationProp<StackParamList>;
+/**
+ * 标签导航 Hook 返回类型
+ */
+type TabNavigation = BottomTabNavigationProp<TabParamList>;
+/**
+ * 抽屉导航 Hook 返回类型
+ */
+type DrawerNavigation = DrawerNavigationProp<DrawerParamList>;
+/**
+ * 通用导航 Hook 返回类型
+ */
+type AppNavigation = NavigationProp<StackParamList & TabParamList & DrawerParamList>;
+
+/**
+ * 导航模块类型定义
+ *
+ * @module navigation/types
+ * @description 提供完整的导航类型定义，支持类型安全的路由配置
+ */
+
+declare global {
+    namespace ReactNavigation {
+        interface RootParamList extends StackParamList, TabParamList, DrawerParamList {
+        }
+    }
+}
+
+/**
+ * 堆栈导航器组件
+ *
+ * 封装 React Navigation 的 JS Stack Navigator，默认使用 iOS 风格的右滑推进转场。
+ * 如需覆盖默认转场，请在 screenOptions 或单个 Screen options 中显式传入。
+ *
+ * @example
+ * ```tsx
+ * // JSX 方式
+ * <StackNavigator initialRouteName="Home">
+ *   <StackNavigator.Screen
+ *     name="Home"
+ *     component={HomeScreen}
+ *     options={{ title: '首页' }}
+ *   />
+ *   <StackNavigator.Screen
+ *     name="Detail"
+ *     component={DetailScreen}
+ *     options={{ title: '详情', headerShown: true }}
+ *   />
+ * </StackNavigator>
+ * ```
+ */
+declare function StackNavigator({ initialRouteName, screenOptions, children }: StackNavigatorProps): react_jsx_runtime.JSX.Element;
+declare namespace StackNavigator {
+    var Screen: <RouteName extends string | number>(_: _react_navigation_native.RouteConfig<StackParamList, RouteName, _react_navigation_routers.StackNavigationState<StackParamList>, _react_navigation_stack.StackNavigationOptions, _react_navigation_stack.StackNavigationEventMap, {
+        [x: string]: _react_navigation_stack.StackNavigationProp<StackParamList, string, string | undefined>;
+    }[RouteName]>) => null;
+    var Group: React__default.ComponentType<_react_navigation_native.RouteGroupConfig<StackParamList, _react_navigation_stack.StackNavigationOptions, _react_navigation_stack.StackNavigationProp<StackParamList, string, string | undefined>>>;
+}
+/**
+ * 基于配置创建堆栈导航器
+ * 支持更灵活的路由配置方式
+ *
+ * @example
+ * ```tsx
+ * const stackConfig: StackRouteConfig[] = [
+ *   { name: 'Home', component: HomeScreen, options: { title: '首页' } },
+ *   { name: 'Detail', component: DetailScreen },
+ * ];
+ *
+ * <StackNavigator initialRouteName="Home">
+ *   {createStackScreens(stackConfig)}
+ * </StackNavigator>
+ * ```
+ */
+declare function createStackScreens(routes: StackRouteConfig[]): React__default.ReactNode[];
+
+/**
+ * 标签导航器组件
+ *
+ * 封装 React Navigation 的 Bottom Tab Navigator
+ *
+ * @example
+ * ```tsx
+ * // JSX 方式
+ * <TabNavigator
+ *   initialRouteName="Home"
+ *   tabBarOptions={{ activeTintColor: '#f38b32' }}
+ * >
+ *   <TabNavigator.Screen
+ *     name="Home"
+ *     component={HomeScreen}
+ *     options={{
+ *       tabBarLabel: '首页',
+ *       tabBarIcon: ({ color, size }) => <Icon name="home" color={color} size={size} />
+ *     }}
+ *   />
+ *   <TabNavigator.Screen
+ *     name="Profile"
+ *     component={ProfileScreen}
+ *     options={{ tabBarLabel: '我的' }}
+ *   />
+ * </TabNavigator>
+ * ```
+ */
+declare function TabNavigator({ initialRouteName, tabBarOptions, tabBar, screenOptions, children, }: TabNavigatorProps): react_jsx_runtime.JSX.Element;
+declare namespace TabNavigator {
+    var Screen: <RouteName extends string | number>(_: _react_navigation_native.RouteConfig<TabParamList, RouteName, _react_navigation_routers.TabNavigationState<TabParamList>, _react_navigation_bottom_tabs.BottomTabNavigationOptions, _react_navigation_bottom_tabs.BottomTabNavigationEventMap, {
+        [x: string]: _react_navigation_bottom_tabs.BottomTabNavigationProp<TabParamList, string, string | undefined>;
+    }[RouteName]>) => null;
+}
+/**
+ * 基于配置创建标签屏幕
+ *
+ * @example
+ * ```tsx
+ * const tabConfig: TabRouteConfig[] = [
+ *   {
+ *     name: 'Home',
+ *     component: HomeScreen,
+ *     options: { tabBarLabel: '首页', tabBarIcon: HomeIcon }
+ *   },
+ *   {
+ *     name: 'Profile',
+ *     component: ProfileScreen,
+ *     options: { tabBarLabel: '我的' }
+ *   },
+ * ];
+ *
+ * <TabNavigator>
+ *   {createTabScreens(tabConfig)}
+ * </TabNavigator>
+ * ```
+ */
+declare function createTabScreens(routes: TabRouteConfig[]): React__default.ReactNode[];
+
+/**
+ * 抽屉导航器组件
+ *
+ * 封装 React Navigation 的 Drawer Navigator，自动集成主题
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * <DrawerNavigator>
+ *   <DrawerNavigator.Screen name="Home" component={HomeScreen} />
+ *   <DrawerNavigator.Screen name="Settings" component={SettingsScreen} />
+ * </DrawerNavigator>
+ *
+ * // 自定义抽屉内容
+ * <DrawerNavigator drawerContent={props => <CustomDrawerContent {...props} />}>
+ *   <DrawerNavigator.Screen name="Home" component={HomeScreen} />
+ * </DrawerNavigator>
+ * ```
+ */
+declare function DrawerNavigator({ initialRouteName, screenOptions, drawerContent, drawerOptions, children, }: DrawerNavigatorProps): react_jsx_runtime.JSX.Element;
+declare namespace DrawerNavigator {
+    var Screen: <RouteName extends string | number>(_: _react_navigation_native.RouteConfig<DrawerParamList, RouteName, _react_navigation_routers.DrawerNavigationState<DrawerParamList>, _react_navigation_drawer.DrawerNavigationOptions, _react_navigation_drawer.DrawerNavigationEventMap, {
+        [x: string]: _react_navigation_drawer.DrawerNavigationProp<DrawerParamList, string, string | undefined>;
+    }[RouteName]>) => null;
+}
+/**
+ * 基于配置创建抽屉屏幕
+ *
+ * @example
+ * ```tsx
+ * const drawerConfig: DrawerRouteConfig[] = [
+ *   { name: 'Home', component: HomeScreen, options: { drawerLabel: '首页' } },
+ *   { name: 'Settings', component: SettingsScreen },
+ * ];
+ *
+ * <DrawerNavigator>
+ *   {createDrawerScreens(drawerConfig)}
+ * </DrawerNavigator>
+ * ```
+ */
+declare function createDrawerScreens(routes: DrawerRouteConfig[]): React__default.ReactNode[];
+
+/**
+ * 右侧图标配置
+ */
+interface RightIcon {
+    /** 图标名称 */
+    icon: string;
+    /** 点击回调 */
+    onPress: () => void;
+    /** 徽标数量（可选） */
+    badge?: number;
+}
+/**
+ * 应用头部组件 Props
+ */
+interface AppHeaderProps {
+    /** 标题 */
+    title?: string;
+    /** 副标题 */
+    subtitle?: string;
+    /** 左侧图标名称（默认为 'chevron-left' iOS风格） */
+    leftIcon?: string | null;
+    /** 左侧图标点击回调 */
+    onLeftPress?: () => void;
+    /** 右侧图标列表 */
+    rightIcons?: RightIcon[];
+    /** 是否透明背景 */
+    transparent?: boolean;
+    /** 是否启用模糊效果（暂未实现） */
+    blur?: boolean;
+    /** 是否包含安全区域（默认为 true） */
+    safeArea?: boolean;
+    /** 自定义样式 */
+    style?: ViewStyle;
+}
+/**
+ * 应用头部组件
+ *
+ * iOS 风格的顶部导航栏，标题始终居中，不受左右按钮影响
+ *
+ * @example
+ * ```tsx
+ * // 基本用法
+ * <AppHeader title="首页" />
+ *
+ * // 带右侧按钮
+ * <AppHeader
+ *   title="消息"
+ *   rightIcons={[
+ *     { icon: 'search', onPress: () => {} },
+ *     { icon: 'notifications', onPress: () => {}, badge: 5 }
+ *   ]}
+ * />
+ *
+ * // 透明背景
+ * <AppHeader title="详情" transparent onLeftPress={() => navigation.goBack()} />
+ *
+ * // 无左侧按钮
+ * <AppHeader title="首页" leftIcon={null} />
+ * ```
+ */
+declare function AppHeader({ title, subtitle, leftIcon, onLeftPress, rightIcons, transparent, safeArea, style, }: AppHeaderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 自定义底部标签栏组件 Props
+ * 继承自 @react-navigation/bottom-tabs 的 BottomTabBarProps
+ */
+interface CustomBottomTabBarProps extends BottomTabBarProps {
+    /** 是否显示标签 */
+    showLabel?: boolean;
+    /** 激活颜色 */
+    activeTintColor?: string;
+    /** 未激活颜色 */
+    inactiveTintColor?: string;
+    /** TabBar 高度（默认 65） */
+    height?: number;
+    /** 激活背景色 */
+    activeBackgroundColor?: string;
+    /** 非激活背景色 */
+    inactiveBackgroundColor?: string;
+    /** 图标容器样式 */
+    iconStyle?: ViewStyle;
+    /** 标签样式 */
+    labelStyle?: TextStyle;
+    /** 标签栏样式 */
+    style?: ViewStyle;
+}
+/**
+ * 自定义底部标签栏组件
+ *
+ * 自定义样式的底部标签栏，支持徽标、图标、标签等
+ *
+ * @example
+ * ```tsx
+ * <TabNavigator
+ *   tabBar={props => <BottomTabBar {...props} showLabel={true} activeTintColor="#f38b32" />}
+ * >
+ *   <TabNavigator.Screen name="Home" component={HomeScreen} />
+ *   <TabNavigator.Screen name="Profile" component={ProfileScreen} />
+ * </TabNavigator>
+ * ```
+ */
+declare function BottomTabBar({ state, descriptors, navigation, showLabel, activeTintColor, inactiveTintColor, height, activeBackgroundColor, inactiveBackgroundColor, iconStyle, labelStyle, style, }: CustomBottomTabBarProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 抽屉菜单项配置
+ */
+interface DrawerItem {
+    /** 路由名称 */
+    name: string;
+    /** 显示标签 */
+    label: string;
+    /** 图标名称 */
+    icon?: string;
+    /** 徽标 */
+    badge?: number | string;
+}
+/**
+ * 抽屉内容组件 Props
+ */
+interface DrawerContentProps extends DrawerContentComponentProps {
+    /** 头部内容（如用户信息） */
+    header?: React__default.ReactNode;
+    /** 底部内容（如退出按钮） */
+    footer?: React__default.ReactNode;
+    /** 自定义项目列表（如果不提供则使用路由列表） */
+    items?: DrawerItem[];
+    /** 激活背景色 */
+    activeBackgroundColor?: string;
+    /** 激活文字颜色 */
+    activeTintColor?: string;
+    /** 未激活文字颜色 */
+    inactiveTintColor?: string;
+}
+/**
+ * 抽屉内容组件
+ *
+ * 自定义抽屉导航的内容模板，支持头部、底部、自定义菜单项等
+ *
+ * @example
+ * ```tsx
+ * <DrawerNavigator
+ *   drawerContent={props => (
+ *     <DrawerContent
+ *       {...props}
+ *       header={<UserInfo name="张三" email="zhangsan@example.com" />}
+ *       footer={<LogoutButton />}
+ *       items={[
+ *         { name: 'Home', label: '首页', icon: 'home' },
+ *         { name: 'Settings', label: '设置', icon: 'settings' }
+ *       ]}
+ *     />
+ *   )}
+ * >
+ *   <DrawerNavigator.Screen name="Home" component={HomeScreen} />
+ *   <DrawerNavigator.Screen name="Settings" component={SettingsScreen} />
+ * </DrawerNavigator>
+ * ```
+ */
+declare function DrawerContent({ state, descriptors, navigation, header, footer, items, activeBackgroundColor, activeTintColor, inactiveTintColor, }: DrawerContentProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 导航 Hooks
+ *
+ * @module navigation/hooks/useNavigation
+ * @description 提供导航相关的 React Hooks
+ */
+
+/**
+ * 获取 React Navigation 原始导航实例
+ *
+ * 适合业务应用在需要自定义导航参数类型时直接使用。
+ *
+ * @example
+ * ```tsx
+ * type AuthNavigation = NativeStackNavigationProp<AuthStackParamList>;
+ *
+ * function LoginScreen() {
+ *   const navigation = useNavigation<AuthNavigation>();
+ *   return <Button onPress={() => navigation.navigate('Register')} title="注册" />;
+ * }
+ * ```
+ */
+declare function useNavigation<T extends NavigationProp<ParamListBase$1> = NavigationProp<ParamListBase$1>>(): T;
+/**
+ * 获取堆栈导航实例
+ *
+ * @returns 堆栈导航对象，包含 navigate、goBack、push 等方法
+ *
+ * @example
+ * ```tsx
+ * function HomeScreen() {
+ *   const navigation = useStackNavigation();
+ *
+ *   const goToDetail = () => {
+ *     navigation.navigate('Detail', { id: '123' });
+ *   };
+ *
+ *   return <Button onPress={goToDetail} title="查看详情" />;
+ * }
+ * ```
+ */
+declare function useStackNavigation(): StackNavigation;
+/**
+ * 获取标签导航实例
+ *
+ * @returns 标签导航对象
+ *
+ * @example
+ * ```tsx
+ * function ProfileScreen() {
+ *   const navigation = useTabNavigation();
+ *
+ *   const switchToHome = () => {
+ *     navigation.navigate('Home');
+ *   };
+ *
+ *   return <Button onPress={switchToHome} title="返回首页" />;
+ * }
+ * ```
+ */
+declare function useTabNavigation(): TabNavigation;
+/**
+ * 获取抽屉导航实例
+ *
+ * @returns 抽屉导航对象
+ *
+ * @example
+ * ```tsx
+ * function SettingsScreen() {
+ *   const navigation = useDrawerNavigation();
+ *
+ *   const openDrawer = () => {
+ *     navigation.openDrawer();
+ *   };
+ *
+ *   return <Button onPress={openDrawer} title="打开菜单" />;
+ * }
+ * ```
+ */
+declare function useDrawerNavigation(): DrawerNavigation;
+/**
+ * 处理安卓返回键
+ *
+ * 仅在安卓设备上有效，iOS 无效果
+ *
+ * @param handler - 返回 true 阻止默认返回行为，返回 false 允许默认行为
+ *
+ * @example
+ * ```tsx
+ * function ConfirmExitScreen() {
+ *   const navigation = useStackNavigation();
+ *
+ *   useBackHandler(() => {
+ *     // 显示确认对话框
+ *     if (hasUnsavedChanges) {
+ *       showConfirmDialog();
+ *       return true; // 阻止默认返回
+ *     }
+ *     return false; // 允许默认返回
+ *   });
+ *
+ *   return <ScreenContent />;
+ * }
+ * ```
+ */
+declare function useBackHandler(handler: () => boolean): void;
+
+/**
+ * 路由相关 Hooks
+ * @module navigation/hooks/useRoute
+ */
+
+/**
+ * 获取当前路由信息
+ *
+ * @returns 当前路由对象，包含 name、params、key 等
+ *
+ * @example
+ * ```tsx
+ * function DetailScreen() {
+ *   const route = useRoute<'Detail'>();
+ *   const { id } = route.params;
+ *
+ *   return <Text>详情 ID: {id}</Text>;
+ * }
+ * ```
+ */
+declare function useRoute<T extends keyof StackParamList>(): RouteProp<StackParamList, T>;
+
+/**
+ * 导航状态 Hooks
+ * @module navigation/hooks/useNavigationState
+ */
+
+/**
+ * 获取导航状态
+ *
+ * @param selector - 状态选择器函数
+ * @returns 选中的状态值
+ *
+ * @example
+ * ```tsx
+ * // 获取当前路由名称
+ * const routeName = useNavigationState(state => state.routes[state.index].name);
+ *
+ * // 获取路由历史
+ * const routes = useNavigationState(state => state.routes);
+ * ```
+ */
+declare function useNavigationState<T>(selector: (state: NavigationState) => T): T;
+
+declare function createNavigationTheme(pantherTheme: Theme, isDark: boolean): Theme$1;
+
+interface AppStatusBarProps extends Omit<StatusBarProps, 'barStyle' | 'backgroundColor' | 'translucent'> {
+    /** 状态栏文字样式，auto 表示跟随当前主题 */
+    barStyle?: StatusBarStyle | 'auto';
+    /** Android 状态栏背景色，默认跟随主题背景色 */
+    backgroundColor?: string;
+    /** 是否启用沉浸式状态栏，默认 false */
+    translucent?: boolean;
+    /** 测试标识 */
+    testID?: string;
+}
+/**
+ * 全局状态栏组件
+ *
+ * - 默认根据当前主题自动切换明暗文字
+ * - 默认跟随主题背景色
+ * - 页面可通过手动渲染该组件进行局部覆盖
+ */
+declare function AppStatusBar({ barStyle, backgroundColor, translucent, ...props }: AppStatusBarProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * AppProvider Props
+ */
+interface AppProviderProps extends Omit<NavigationProviderProps, 'children'> {
+    /** 子元素 */
+    children: React__default.ReactNode;
+    /**
+     * 是否启用导航（默认 true）
+     * 如果已在其他地方提供 NavigationContainer，请设为 false
+     */
+    enableNavigation?: boolean;
+    /** 是否启用全局 Overlay（Loading/Toast/Alert，默认 true） */
+    enableOverlay?: boolean;
+    /** 是否启用主题（默认 true） */
+    enableTheme?: boolean;
+    /** 是否启用全局状态栏管理（默认 true） */
+    enableStatusBar?: boolean;
+    /** 是否启用安全区域（默认 true） */
+    enableSafeArea?: boolean;
+    /** 自定义亮色主题 */
+    lightTheme?: ThemeConfig;
+    /** 自定义暗色主题 */
+    darkTheme?: ThemeConfig;
+    /** 默认使用暗色模式 */
+    defaultDark?: boolean;
+    /** 受控暗色模式 */
+    isDark?: boolean;
+    /** 全局状态栏配置 */
+    statusBarProps?: AppStatusBarProps;
+}
+/**
+ * 统一应用 Provider
+ *
+ * 整合：SafeAreaProvider + ThemeProvider + NavigationProvider + OverlayProvider
+ * 提供一键式应用初始化方案
+ *
+ * @example
+ * ```tsx
+ * // 基础使用
+ * import { AppProvider } from '@gaozh1024/rn-kit';
+ * import { RootNavigator } from './navigation';
+ *
+ * export default function App() {
+ *   return (
+ *     <AppProvider>
+ *       <RootNavigator />
+ *     </AppProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 带深度链接
+ * import { AppProvider } from '@gaozh1024/rn-kit';
+ *
+ * export default function App() {
+ *   return (
+ *     <AppProvider
+ *       linking={{
+ *         prefixes: ['myapp://', 'https://myapp.com'],
+ *         config: {
+ *           screens: {
+ *             Home: 'home',
+ *             Detail: 'detail/:id',
+ *           },
+ *         },
+ *       }}
+ *       fallback={<LoadingScreen />}
+ *     >
+ *       <RootNavigator />
+ *     </AppProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 禁用部分功能
+ * <AppProvider
+ *   enableNavigation={true}
+ *   enableOverlay={true}
+ *   enableTheme={true}
+ *   enableSafeArea={true}
+ * >
+ *   <YourApp />
+ * </AppProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 自定义主题
+ * <AppProvider
+ *   lightTheme={{
+ *     colors: {
+ *       primary: '#1890ff',
+ *       success: '#52c41a',
+ *       // ... 其他颜色
+ *     },
+ *   }}
+ *   darkTheme={{
+ *     colors: {
+ *       primary: '#40a9ff',
+ *       // ... 其他颜色
+ *     },
+ *   }}
+ * >
+ *   <App />
+ * </AppProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 使用外部 NavigationContainer
+ * import { NavigationContainer } from '@react-navigation/native';
+ *
+ * export default function App() {
+ *   return (
+ *     <NavigationContainer>
+ *       <AppProvider enableNavigation={false}>
+ *         <RootNavigator />
+ *       </AppProvider>
+ *     </NavigationContainer>
+ *   );
+ * }
+ * ```
+ */
+declare function AppProvider({ children, enableNavigation, enableOverlay, enableTheme, enableStatusBar, enableSafeArea, lightTheme, darkTheme, defaultDark, isDark, statusBarProps, ...navigationProps }: AppProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Overlay Provider Props
+ */
+interface OverlayProviderProps {
+    children: React__default.ReactNode;
+}
+/**
+ * 统一 Overlay Provider
+ *
+ * 整合：LoadingProvider + ToastProvider + AlertProvider
+ * 提供全局 Loading、Toast、Alert 功能
+ */
+declare function OverlayProvider({ children }: OverlayProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loading 子系统类型定义
+ * @module overlay/loading/types
+ */
+/**
+ * Loading 状态
+ */
+interface LoadingState {
+    visible: boolean;
+    text?: string;
+}
+/**
+ * Loading 上下文类型
+ */
+interface LoadingContextType {
+    /** 显示 Loading */
+    show: (text?: string) => void;
+    /** 隐藏 Loading */
+    hide: () => void;
+}
+
+/**
+ * Loading 子系统 Hooks
+ * @module overlay/loading/hooks
+ */
+
+/**
+ * 使用 Loading 控制
+ * @returns Loading 控制方法
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { show, hide } = useLoading();
+ *
+ *   const handleSubmit = async () => {
+ *     show('提交中...');
+ *     await submitData();
+ *     hide();
+ *   };
+ * }
+ * ```
+ */
+declare function useLoading(): LoadingContextType;
+
+/**
+ * Toast 子系统类型定义
+ * @module overlay/toast/types
+ */
+/**
+ * Toast 类型
+ */
+type ToastType = 'success' | 'error' | 'info' | 'warning';
+/**
+ * Toast 项
+ */
+interface ToastItem {
+    id: string;
+    message: string;
+    type: ToastType;
+    duration?: number;
+}
+/**
+ * Toast 上下文类型
+ */
+interface ToastContextType {
+    /** 显示 Toast */
+    show: (message: string, type?: ToastType, duration?: number) => void;
+    /** 显示成功 Toast */
+    success: (message: string, duration?: number) => void;
+    /** 显示错误 Toast */
+    error: (message: string, duration?: number) => void;
+    /** 显示信息 Toast */
+    info: (message: string, duration?: number) => void;
+    /** 显示警告 Toast */
+    warning: (message: string, duration?: number) => void;
+}
+
+/**
+ * Toast 子系统 Hooks
+ * @module overlay/toast/hooks
+ */
+
+/**
+ * 使用 Toast 控制
+ * @returns Toast 控制方法
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { success, error } = useToast();
+ *
+ *   const handleSubmit = async () => {
+ *     try {
+ *       await submitData();
+ *       success('提交成功！');
+ *     } catch (e) {
+ *       error('提交失败');
+ *     }
+ *   };
+ * }
+ * ```
+ */
+declare function useToast(): ToastContextType;
+
+/**
+ * Alert 子系统类型定义
+ * @module overlay/alert/types
+ */
+/**
+ * Alert 选项
+ */
+interface AlertOptions {
+    /** 标题 */
+    title?: string;
+    /** 消息内容 */
+    message?: string;
+    /** 确认按钮文本 */
+    confirmText?: string;
+    /** 取消按钮文本 */
+    cancelText?: string;
+    /** 确认回调 */
+    onConfirm?: () => void;
+    /** 取消回调 */
+    onCancel?: () => void;
+    /** 是否显示取消按钮 */
+    showCancel?: boolean;
+}
+/**
+ * Alert 上下文类型
+ */
+interface AlertContextType {
+    /** 显示 Alert */
+    alert: (options: AlertOptions) => void;
+    /** 显示确认对话框 */
+    confirm: (options: Omit<AlertOptions, 'showCancel'>) => void;
+}
+
+/**
+ * Alert 子系统 Hooks
+ * @module overlay/alert/hooks
+ */
+
+/**
+ * 使用 Alert 控制
+ * @returns Alert 控制方法
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { alert, confirm } = useAlert();
+ *
+ *   const handleDelete = () => {
+ *     confirm({
+ *       title: '确认删除',
+ *       message: '此操作不可撤销',
+ *       onConfirm: () => deleteItem(),
+ *     });
+ *   };
+ *
+ *   const handleNotify = () => {
+ *     alert({
+ *       title: '提示',
+ *       message: '操作成功',
+ *     });
+ *   };
+ * }
+ * ```
+ */
+declare function useAlert(): AlertContextType;
+
+export { ActionIcons, Alert, type AlertContextType, type AlertOptions, type AlertProps, type ApiBusinessErrorParser, type ApiConfig, type ApiEndpointConfig, type ApiErrorContext, type ApiErrorHandler, type ApiMethod, AppButton, type AppButtonProps, type AppError, AppHeader, type AppHeaderProps, AppImage, type AppImageProps, AppInput, type AppInputProps, AppList, type AppListProps, type AppNavigation, AppPressable, type AppPressableProps, AppProvider, type AppProviderProps, AppScrollView, type AppScrollViewProps, AppStatusBar, type AppStatusBarProps, AppText, type AppTextProps, AppView, type AppViewProps, BottomTabBar, Card, type CardProps, Center, type CenterProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, Col, type ColProps, type ColorPalette$1 as ColorPalette, type ColorToken, type CustomBottomTabBarProps, DatePicker, type DatePickerProps, DrawerContent, type DrawerContentProps, type DrawerItem, type DrawerNavigation, DrawerNavigator, type DrawerNavigatorProps, type DrawerOptions, type DrawerParamList, type DrawerRouteConfig, type DrawerScreenOptions, type DrawerScreenProps, ErrorCode, FileIcons, FormItem, type FormItemProps, Icon, type IconProps, type IconSize, type InfiniteFetchParams, type InfiniteFetchResult, type LinkingConfig, Loading, type LoadingContextType, type LoadingProps, type LoadingState, MemoryStorage, NavigationIcons, NavigationProvider, type NavigationProviderProps, type Orientation, OverlayProvider, type OverlayProviderProps, Page, type PaginationParams, type PaginationResult, type ParamListBase, type PathConfig, Progress, type ProgressProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, type RgbObject, type RouteConfig, Row, type RowProps, SafeBottom, SafeScreen, type SafeScreenProps, Select, type SelectOption, type SelectProps, Slider, type SliderProps, type StackNavigation, StackNavigator, type StackNavigatorProps, type StackParamList, type StackRouteConfig, type StackScreenOptions, type StackScreenProps, StatusIcons, Switch, type SwitchProps, type TabBarOptions, type TabNavigation, TabNavigator, type TabNavigatorProps, type TabParamList, type TabRouteConfig, type TabScreenOptions, type TabScreenProps, type Theme, type ColorPalette as ThemeColorPalette, type ThemeConfig, ThemeProvider, Toast, type ToastContextType, type ToastItem, type ToastProps, type ToastType, type UseAsyncState, type UseDimensionsReturn, type UseInfiniteOptions, type UseInfiniteReturn, type UseKeyboardReturn, type UseOrientationReturn, type UsePaginationOptions, type UsePaginationReturn, type UseRefreshReturn, type UseToggleActions, adjustBrightness, capitalize, clamp, cn, createAPI, createDrawerScreens, createNavigationTheme, createStackScreens, createTabScreens, createTheme, deepMerge, enhanceError, formatCurrency, formatDate, formatNumber, formatPercent, formatRelativeTime, generateColorPalette, getThemeColors, getValidationErrors, hexToRgb, isDevelopment, isValidEmail, isValidPhone, mapHttpStatus, omit, pick, rgbToHex, slugify, storage, truncate, useAlert, useAsyncState, useBackHandler, useDebounce, useDimensions, useDrawerNavigation, useForm, useInfinite, useKeyboard, useLoading, useMemoizedFn, useNavigation, useNavigationState, useOrientation, usePagination, usePrevious, useRefresh, useRequest, useRoute, useSetState, useStackNavigation, useStorage, useTabNavigation, useTheme, useThemeColors, useThrottle, useToast, useToggle, useUpdateEffect };