@gaozh1024/rn-kit 0.2.0-beta.0 → 0.3.0

package/README.md

@@ -34,6 +34,7 @@ yarn add @gaozh1024/rn-kit
 npm install react react-native
 npm install react-native-screens react-native-safe-area-context
 npm install react-native-gesture-handler react-native-reanimated
+npx expo install expo-linear-gradient
 npm install react-native-svg
 ```
 
@@ -158,7 +159,9 @@ import {
   Card,
   Icon,
   AppImage,
-  AppList, // 数据展示
+  AppList,
+  GradientView,
+  PageDrawer, // 数据展示 / 页面级抽屉
   Checkbox,
   Radio,
   Switch,
@@ -173,6 +176,7 @@ import {
 import {
   // UI Hooks
   useToggle,
+  usePageDrawer,
   useDebounce,
   useThrottle,
   useKeyboard,
@@ -225,6 +229,116 @@ import {
 </TabNavigator>
 ```
 
+### 🧲 抽屉
+
+框架同时提供两类抽屉能力：
+
+- **导航级抽屉**：`DrawerNavigator` / `DrawerContent`
+- **页面级抽屉**：`PageDrawer`
+
+#### 1. 页面级抽屉
+
+适合当前页面内的筛选面板、操作栏、详情侧栏。
+
+```tsx
+import React from 'react';
+import { AppButton, AppText, AppView, PageDrawer } from '@gaozh1024/rn-kit';
+
+function FilterPanel() {
+  const [visible, setVisible] = React.useState(false);
+
+  return (
+    <>
+      <AppButton onPress={() => setVisible(true)}>打开筛选</AppButton>
+
+      <PageDrawer
+        visible={visible}
+        onClose={() => setVisible(false)}
+        title="筛选条件"
+        placement="right"
+        width={320}
+      >
+        <AppView gap={3}>
+          <AppText>这里放筛选项</AppText>
+        </AppView>
+      </PageDrawer>
+    </>
+  );
+}
+```
+
+`PageDrawer` 支持：
+
+- 左 / 右侧抽屉
+- 点击遮罩关闭
+- 自定义 `header` / `footer`
+- 手势滑动关闭
+- Android 返回键优先关闭抽屉
+
+常用参数：
+
+- `placement`: `'left' | 'right'`
+- `width`: 抽屉宽度，默认 `320`
+- `swipeEnabled`: 是否启用手势关闭，默认 `true`
+- `swipeThreshold`: 触发关闭阈值，默认 `80`
+- `closeOnBackdropPress`: 点击遮罩关闭，默认 `true`
+
+### 🌈 渐变背景
+
+框架提供 `GradientView` 作为渐变背景容器，底层封装 `expo-linear-gradient`。
+
+```tsx
+import { GradientView, AppText } from '@gaozh1024/rn-kit';
+
+<GradientView
+  colors={['#f38b32', '#fb923c']}
+  style={{ padding: 24, borderRadius: 16 }}
+>
+  <AppText color="white" weight="bold">
+    渐变卡片
+  </AppText>
+</GradientView>;
+```
+
+如果你的应用是手动集成 `@gaozh1024/rn-kit`，请同时安装：
+
+```bash
+npx expo install expo-linear-gradient
+```
+
+如果你不想在页面里重复写 `useState(false)`，也可以直接使用：
+
+```tsx
+import { AppButton, PageDrawer, usePageDrawer } from '@gaozh1024/rn-kit';
+
+const drawer = usePageDrawer();
+
+<AppButton onPress={drawer.open}>打开</AppButton>;
+<PageDrawer visible={drawer.visible} onClose={drawer.close} />;
+```
+
+#### 2. 导航级抽屉
+
+适合整个导航结构都交给抽屉接管的场景：
+
+```tsx
+import { DrawerContent, DrawerNavigator } from '@gaozh1024/rn-kit';
+
+<DrawerNavigator
+  drawerContent={props => (
+    <DrawerContent
+      {...props}
+      items={[
+        { name: 'Home', label: '首页', icon: 'home' },
+        { name: 'Settings', label: '设置', icon: 'settings' },
+      ]}
+    />
+  )}
+>
+  {/* screens */}
+</DrawerNavigator>;
+```
+
 ### 🔌 API 工厂
 
 ```tsx

package/dist/index.d.mts

@@ -7,6 +7,7 @@ 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 { LinearGradientProps } from 'expo-linear-gradient';
 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';
@@ -1649,7 +1650,7 @@ interface LoadingProps {
  * );
  * ```
  */
-declare function Loading({ text, color, overlay, visible, testID, }: LoadingProps): react_jsx_runtime.JSX.Element | null;
+declare function Loading({ text, color, overlay, visible, testID }: LoadingProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Progress 组件属性接口
@@ -1933,6 +1934,65 @@ interface AppListProps<T = any> {
 }
 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;
 
+interface PageDrawerProps {
+    /** 是否显示 */
+    visible: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 标题 */
+    title?: string;
+    /** 自定义头部 */
+    header?: React__default.ReactNode;
+    /** 自定义底部 */
+    footer?: React__default.ReactNode;
+    /** 抽屉位置 */
+    placement?: 'left' | 'right';
+    /** 抽屉宽度 */
+    width?: number;
+    /** 是否启用手势关闭 */
+    swipeEnabled?: boolean;
+    /** 关闭阈值 */
+    swipeThreshold?: number;
+    /** 点击遮罩是否关闭 */
+    closeOnBackdropPress?: boolean;
+    /** 是否显示关闭按钮 */
+    showCloseButton?: boolean;
+    /** 内容 */
+    children?: React__default.ReactNode;
+    /** 测试 ID */
+    testID?: string;
+    /** 内容测试 ID */
+    contentTestID?: string;
+    /** 遮罩测试 ID */
+    backdropTestID?: string;
+}
+declare function PageDrawer({ visible, onClose, title, header, footer, placement, width, swipeEnabled, swipeThreshold, closeOnBackdropPress, showCloseButton, children, testID, contentTestID, backdropTestID, }: PageDrawerProps): react_jsx_runtime.JSX.Element | null;
+
+interface GradientViewProps extends Omit<LinearGradientProps, 'colors' | 'style' | 'children'> {
+    /** 渐变色列表，至少两个颜色 */
+    colors: readonly [string, string, ...string[]];
+    /** 子元素 */
+    children?: React__default.ReactNode;
+    /** 自定义容器样式 */
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * GradientView - 渐变背景容器
+ *
+ * 对 expo-linear-gradient 的轻量封装，用于页面级/卡片级渐变背景。
+ *
+ * @example
+ * ```tsx
+ * <GradientView
+ *   colors={['#f38b32', '#fb923c']}
+ *   style={{ padding: 24, borderRadius: 16 }}
+ * >
+ *   <AppText color="white">渐变标题</AppText>
+ * </GradientView>
+ * ```
+ */
+declare function GradientView({ colors, start, end, children, style, ...props }: GradientViewProps): react_jsx_runtime.JSX.Element;
+
 /**
  * AppInput 组件属性接口
  */
@@ -1972,15 +2032,16 @@ interface CheckboxProps {
  */
 declare function Checkbox({ checked, defaultChecked, onChange, disabled, children, className, testID, }: CheckboxProps): react_jsx_runtime.JSX.Element;
 
-interface Option$1 {
+interface FormGroupOption {
     label: string;
     value: string;
     disabled?: boolean;
 }
+
 interface CheckboxGroupProps {
     value?: string[];
     onChange?: (value: string[]) => void;
-    options?: Option$1[];
+    options?: FormGroupOption[];
     direction?: 'row' | 'column';
     disabled?: boolean;
 }
@@ -2003,15 +2064,10 @@ interface RadioProps {
  */
 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[];
+    options?: FormGroupOption[];
     direction?: 'row' | 'column';
     disabled?: boolean;
 }
@@ -2126,23 +2182,25 @@ interface FormItemProps {
 }
 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>> {
+type FormValues = Record<string, unknown>;
+type FieldName<T extends FormValues> = Extract<keyof T, string>;
+interface UseFormOptions<T extends FormValues> {
     schema: ZodSchema<T>;
     defaultValues: T;
 }
 interface FormErrors {
     [key: string]: string;
 }
-declare function useForm<T extends Record<string, any>>({ schema, defaultValues, }: UseFormOptions<T>): {
+declare function useForm<T extends FormValues>({ 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];
+    setValue: <K extends FieldName<T>>(name: K, value: T[K]) => void;
+    getValue: <K extends FieldName<T>>(name: K) => T[K];
     validate: () => Promise<boolean>;
-    validateField: (name: keyof T) => Promise<boolean>;
+    validateField: (name: FieldName<T>) => Promise<boolean>;
     reset: () => void;
     handleSubmit: (onSubmit?: (values: T) => void | Promise<void>) => Promise<void>;
 };
@@ -2172,6 +2230,34 @@ interface UseToggleActions {
  */
 declare function useToggle(defaultValue?: boolean): [boolean, UseToggleActions];
 
+interface UsePageDrawerReturn {
+    /** 当前是否打开 */
+    visible: boolean;
+    /** 打开抽屉 */
+    open: () => void;
+    /** 关闭抽屉 */
+    close: () => void;
+    /** 切换抽屉开关状态 */
+    toggle: () => void;
+    /** 直接设置抽屉可见状态 */
+    setVisible: (visible: boolean) => void;
+}
+/**
+ * 页面级抽屉状态管理 Hook
+ *
+ * @param defaultVisible - 默认是否打开
+ * @returns 抽屉可见状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * const drawer = usePageDrawer();
+ *
+ * <AppButton onPress={drawer.open}>打开筛选</AppButton>
+ * <PageDrawer visible={drawer.visible} onClose={drawer.close} />
+ * ```
+ */
+declare function usePageDrawer(defaultVisible?: boolean): UsePageDrawerReturn;
+
 /**
  * 防抖 Hook
  * @param value - 需要防抖的值
@@ -3462,4 +3548,4 @@ interface AlertContextType {
  */
 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 };
+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, type FormErrors, type FormGroupOption, FormItem, type FormItemProps, GradientView, type GradientViewProps, 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, PageDrawer, type PageDrawerProps, 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 UseFormOptions, type UseInfiniteOptions, type UseInfiniteReturn, type UseKeyboardReturn, type UseOrientationReturn, type UsePageDrawerReturn, 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, usePageDrawer, usePagination, usePrevious, useRefresh, useRequest, useRoute, useSetState, useStackNavigation, useStorage, useTabNavigation, useTheme, useThemeColors, useThrottle, useToast, useToggle, useUpdateEffect };

package/dist/index.d.ts

@@ -7,6 +7,7 @@ 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 { LinearGradientProps } from 'expo-linear-gradient';
 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';
@@ -1649,7 +1650,7 @@ interface LoadingProps {
  * );
  * ```
  */
-declare function Loading({ text, color, overlay, visible, testID, }: LoadingProps): react_jsx_runtime.JSX.Element | null;
+declare function Loading({ text, color, overlay, visible, testID }: LoadingProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Progress 组件属性接口
@@ -1933,6 +1934,65 @@ interface AppListProps<T = any> {
 }
 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;
 
+interface PageDrawerProps {
+    /** 是否显示 */
+    visible: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 标题 */
+    title?: string;
+    /** 自定义头部 */
+    header?: React__default.ReactNode;
+    /** 自定义底部 */
+    footer?: React__default.ReactNode;
+    /** 抽屉位置 */
+    placement?: 'left' | 'right';
+    /** 抽屉宽度 */
+    width?: number;
+    /** 是否启用手势关闭 */
+    swipeEnabled?: boolean;
+    /** 关闭阈值 */
+    swipeThreshold?: number;
+    /** 点击遮罩是否关闭 */
+    closeOnBackdropPress?: boolean;
+    /** 是否显示关闭按钮 */
+    showCloseButton?: boolean;
+    /** 内容 */
+    children?: React__default.ReactNode;
+    /** 测试 ID */
+    testID?: string;
+    /** 内容测试 ID */
+    contentTestID?: string;
+    /** 遮罩测试 ID */
+    backdropTestID?: string;
+}
+declare function PageDrawer({ visible, onClose, title, header, footer, placement, width, swipeEnabled, swipeThreshold, closeOnBackdropPress, showCloseButton, children, testID, contentTestID, backdropTestID, }: PageDrawerProps): react_jsx_runtime.JSX.Element | null;
+
+interface GradientViewProps extends Omit<LinearGradientProps, 'colors' | 'style' | 'children'> {
+    /** 渐变色列表，至少两个颜色 */
+    colors: readonly [string, string, ...string[]];
+    /** 子元素 */
+    children?: React__default.ReactNode;
+    /** 自定义容器样式 */
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * GradientView - 渐变背景容器
+ *
+ * 对 expo-linear-gradient 的轻量封装，用于页面级/卡片级渐变背景。
+ *
+ * @example
+ * ```tsx
+ * <GradientView
+ *   colors={['#f38b32', '#fb923c']}
+ *   style={{ padding: 24, borderRadius: 16 }}
+ * >
+ *   <AppText color="white">渐变标题</AppText>
+ * </GradientView>
+ * ```
+ */
+declare function GradientView({ colors, start, end, children, style, ...props }: GradientViewProps): react_jsx_runtime.JSX.Element;
+
 /**
  * AppInput 组件属性接口
  */
@@ -1972,15 +2032,16 @@ interface CheckboxProps {
  */
 declare function Checkbox({ checked, defaultChecked, onChange, disabled, children, className, testID, }: CheckboxProps): react_jsx_runtime.JSX.Element;
 
-interface Option$1 {
+interface FormGroupOption {
     label: string;
     value: string;
     disabled?: boolean;
 }
+
 interface CheckboxGroupProps {
     value?: string[];
     onChange?: (value: string[]) => void;
-    options?: Option$1[];
+    options?: FormGroupOption[];
     direction?: 'row' | 'column';
     disabled?: boolean;
 }
@@ -2003,15 +2064,10 @@ interface RadioProps {
  */
 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[];
+    options?: FormGroupOption[];
     direction?: 'row' | 'column';
     disabled?: boolean;
 }
@@ -2126,23 +2182,25 @@ interface FormItemProps {
 }
 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>> {
+type FormValues = Record<string, unknown>;
+type FieldName<T extends FormValues> = Extract<keyof T, string>;
+interface UseFormOptions<T extends FormValues> {
     schema: ZodSchema<T>;
     defaultValues: T;
 }
 interface FormErrors {
     [key: string]: string;
 }
-declare function useForm<T extends Record<string, any>>({ schema, defaultValues, }: UseFormOptions<T>): {
+declare function useForm<T extends FormValues>({ 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];
+    setValue: <K extends FieldName<T>>(name: K, value: T[K]) => void;
+    getValue: <K extends FieldName<T>>(name: K) => T[K];
     validate: () => Promise<boolean>;
-    validateField: (name: keyof T) => Promise<boolean>;
+    validateField: (name: FieldName<T>) => Promise<boolean>;
     reset: () => void;
     handleSubmit: (onSubmit?: (values: T) => void | Promise<void>) => Promise<void>;
 };
@@ -2172,6 +2230,34 @@ interface UseToggleActions {
  */
 declare function useToggle(defaultValue?: boolean): [boolean, UseToggleActions];
 
+interface UsePageDrawerReturn {
+    /** 当前是否打开 */
+    visible: boolean;
+    /** 打开抽屉 */
+    open: () => void;
+    /** 关闭抽屉 */
+    close: () => void;
+    /** 切换抽屉开关状态 */
+    toggle: () => void;
+    /** 直接设置抽屉可见状态 */
+    setVisible: (visible: boolean) => void;
+}
+/**
+ * 页面级抽屉状态管理 Hook
+ *
+ * @param defaultVisible - 默认是否打开
+ * @returns 抽屉可见状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * const drawer = usePageDrawer();
+ *
+ * <AppButton onPress={drawer.open}>打开筛选</AppButton>
+ * <PageDrawer visible={drawer.visible} onClose={drawer.close} />
+ * ```
+ */
+declare function usePageDrawer(defaultVisible?: boolean): UsePageDrawerReturn;
+
 /**
  * 防抖 Hook
  * @param value - 需要防抖的值
@@ -3462,4 +3548,4 @@ interface AlertContextType {
  */
 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 };
+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, type FormErrors, type FormGroupOption, FormItem, type FormItemProps, GradientView, type GradientViewProps, 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, PageDrawer, type PageDrawerProps, 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 UseFormOptions, type UseInfiniteOptions, type UseInfiniteReturn, type UseKeyboardReturn, type UseOrientationReturn, type UsePageDrawerReturn, 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, usePageDrawer, usePagination, usePrevious, useRefresh, useRequest, useRoute, useSetState, useStackNavigation, useStorage, useTabNavigation, useTheme, useThemeColors, useThrottle, useToast, useToggle, useUpdateEffect };