@gaozh1024/rn-kit 0.3.1 → 0.3.3

package/README.md

@@ -171,6 +171,25 @@ import {
 } from '@gaozh1024/rn-kit';
 ```
 
+#### 可本地化文案参数（i18n 推荐）
+
+- `AppList`
+  - `errorTitle`：错误标题（默认 `加载失败`）
+  - `errorDescription`：错误描述兜底（默认 `请检查网络后重试`）
+  - `retryText`：重试按钮文案（默认 `重新加载`）
+- `Select`
+  - `singleSelectTitle` / `multipleSelectTitle`：弹窗标题
+  - `searchPlaceholder`：搜索占位文案
+  - `emptyText`：空状态文案
+  - `selectedCountText`：多选计数模板，支持 `{{count}}`
+  - `confirmText`：多选确认按钮文案
+- `DatePicker`
+  - `cancelText` / `confirmText`：弹窗操作按钮文案
+  - `pickerTitle`：弹窗标题文案
+  - `pickerDateFormat`：弹窗顶部日期格式
+  - `yearLabel` / `monthLabel` / `dayLabel`：列标题文案
+  - `todayText` / `minDateText` / `maxDateText`：快捷按钮文案
+
 ### 🪝 Hooks
 
 ```tsx
@@ -291,10 +310,7 @@ function FilterPanel() {
 ```tsx
 import { GradientView, AppText } from '@gaozh1024/rn-kit';
 
-<GradientView
-  colors={['#f38b32', '#fb923c']}
-  style={{ padding: 24, borderRadius: 16 }}
->
+<GradientView colors={['#f38b32', '#fb923c']} style={{ padding: 24, borderRadius: 16 }}>
   <AppText color="white" weight="bold">
     渐变卡片
   </AppText>
@@ -452,19 +468,19 @@ export function HeroScreen() {
 
 1. 当前页面没有单独覆盖 `AppStatusBar`
 2. 页面容器本身是白底
-3. 使用了 `Page` / `SafeScreen`，但没有设置 `bg`
+3. 使用了 `AppScreen` / `SafeScreen`，但没有设置 `bg`
 4. 顶部安全区没有和页面背景统一
 
 如果你用的是：
 
 ```tsx
-<Page>
+<AppScreen>
 ```
 
 那它默认不适合登录页这类全屏品牌色场景。请改成：
 
 ```tsx
-<Page bg="primary-500">
+<AppScreen bg="primary-500">
 ```
 
 或者直接用：

package/dist/index.d.mts

@@ -1436,15 +1436,15 @@ declare function SafeScreen({ top, bottom, left, right, bg, flex, className, chi
  *
  * @example
  * ```tsx
- * <Page>
+ * <AppScreen>
  *   <AppHeader title="首页" />
  *   <AppView flex p={4}>
  *     <AppText>页面内容</AppText>
  *   </AppView>
- * </Page>
+ * </AppScreen>
  * ```
  */
-declare function Page({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
+declare function AppScreen({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
 /**
  * 底部安全区域组件 - 只在底部添加安全距离
  * 注意：此组件不会铺满全屏，只占据内容高度
@@ -1914,6 +1914,9 @@ interface AppListProps<T = any> {
     onEndReachedThreshold?: number;
     error?: Error | null;
     onRetry?: () => void;
+    errorTitle?: string;
+    errorDescription?: string;
+    retryText?: string;
     emptyTitle?: string;
     emptyDescription?: string;
     emptyIcon?: string;
@@ -1932,7 +1935,7 @@ interface AppListProps<T = any> {
     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;
+declare function AppList<T = any>({ data, renderItem, keyExtractor, loading, refreshing, onRefresh, hasMore, onEndReached, onEndReachedThreshold, error, onRetry, errorTitle, errorDescription, retryText, 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 {
     /** 是否显示 */
@@ -2134,13 +2137,25 @@ interface SelectProps {
     disabled?: boolean;
     /** 是否可清空 */
     clearable?: boolean;
+    /** 单选弹窗标题 */
+    singleSelectTitle?: string;
+    /** 多选弹窗标题 */
+    multipleSelectTitle?: string;
+    /** 搜索占位文字 */
+    searchPlaceholder?: string;
+    /** 空状态文案 */
+    emptyText?: string;
+    /** 多选已选数量文案模板，使用 {{count}} 作为占位符 */
+    selectedCountText?: string;
+    /** 多选确认按钮文案 */
+    confirmText?: string;
     /** 自定义样式 */
     className?: string;
 }
 /**
  * 底部弹出选择器组件，支持浅色/深色主题
  */
-declare function Select({ value, onChange, options, placeholder, multiple, searchable, onSearch, disabled, clearable, className, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select({ value, onChange, options, placeholder, multiple, searchable, onSearch, disabled, clearable, singleSelectTitle, multipleSelectTitle, searchPlaceholder, emptyText, selectedCountText, confirmText, className, }: SelectProps): react_jsx_runtime.JSX.Element;
 
 /**
  * DatePicker 组件属性接口
@@ -2162,11 +2177,31 @@ interface DatePickerProps {
     maxDate?: Date;
     /** 自定义样式 */
     className?: string;
+    /** 弹窗取消按钮文案 */
+    cancelText?: string;
+    /** 弹窗确认按钮文案 */
+    confirmText?: string;
+    /** 弹窗标题文案 */
+    pickerTitle?: string;
+    /** 弹窗日期展示格式 */
+    pickerDateFormat?: string;
+    /** 年列标题 */
+    yearLabel?: string;
+    /** 月列标题 */
+    monthLabel?: string;
+    /** 日列标题 */
+    dayLabel?: string;
+    /** 快捷按钮“今天”文案 */
+    todayText?: string;
+    /** 快捷按钮“最早”文案 */
+    minDateText?: string;
+    /** 快捷按钮“最晚”文案 */
+    maxDateText?: string;
 }
 /**
  * DatePicker - 日期选择器组件，支持浅色/深色主题
  */
-declare function DatePicker({ value, onChange, placeholder, disabled, format, minDate, maxDate, className, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ value, onChange, placeholder, disabled, format, minDate, maxDate, className, cancelText, confirmText, pickerTitle, pickerDateFormat, yearLabel, monthLabel, dayLabel, todayText, minDateText, maxDateText, }: DatePickerProps): react_jsx_runtime.JSX.Element;
 
 interface FormItemProps {
     name: string;
@@ -3236,6 +3271,7 @@ interface AppStatusBarProps extends Omit<StatusBarProps, 'barStyle' | 'backgroun
  * - 页面可通过手动渲染该组件进行局部覆盖
  */
 declare function AppStatusBar({ barStyle, backgroundColor, translucent, ...props }: AppStatusBarProps): react_jsx_runtime.JSX.Element;
+declare function AppFocusedStatusBar(props: AppStatusBarProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * AppProvider Props
@@ -3548,4 +3584,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, 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 };
+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, AppFocusedStatusBar, AppHeader, type AppHeaderProps, AppImage, type AppImageProps, AppInput, type AppInputProps, AppList, type AppListProps, type AppNavigation, AppPressable, type AppPressableProps, AppProvider, type AppProviderProps, AppScreen, 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, 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

@@ -1436,15 +1436,15 @@ declare function SafeScreen({ top, bottom, left, right, bg, flex, className, chi
  *
  * @example
  * ```tsx
- * <Page>
+ * <AppScreen>
  *   <AppHeader title="首页" />
  *   <AppView flex p={4}>
  *     <AppText>页面内容</AppText>
  *   </AppView>
- * </Page>
+ * </AppScreen>
  * ```
  */
-declare function Page({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
+declare function AppScreen({ children, className, ...props }: Omit<SafeScreenProps, 'top' | 'bottom' | 'left' | 'right'>): react_jsx_runtime.JSX.Element;
 /**
  * 底部安全区域组件 - 只在底部添加安全距离
  * 注意：此组件不会铺满全屏，只占据内容高度
@@ -1914,6 +1914,9 @@ interface AppListProps<T = any> {
     onEndReachedThreshold?: number;
     error?: Error | null;
     onRetry?: () => void;
+    errorTitle?: string;
+    errorDescription?: string;
+    retryText?: string;
     emptyTitle?: string;
     emptyDescription?: string;
     emptyIcon?: string;
@@ -1932,7 +1935,7 @@ interface AppListProps<T = any> {
     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;
+declare function AppList<T = any>({ data, renderItem, keyExtractor, loading, refreshing, onRefresh, hasMore, onEndReached, onEndReachedThreshold, error, onRetry, errorTitle, errorDescription, retryText, 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 {
     /** 是否显示 */
@@ -2134,13 +2137,25 @@ interface SelectProps {
     disabled?: boolean;
     /** 是否可清空 */
     clearable?: boolean;
+    /** 单选弹窗标题 */
+    singleSelectTitle?: string;
+    /** 多选弹窗标题 */
+    multipleSelectTitle?: string;
+    /** 搜索占位文字 */
+    searchPlaceholder?: string;
+    /** 空状态文案 */
+    emptyText?: string;
+    /** 多选已选数量文案模板，使用 {{count}} 作为占位符 */
+    selectedCountText?: string;
+    /** 多选确认按钮文案 */
+    confirmText?: string;
     /** 自定义样式 */
     className?: string;
 }
 /**
  * 底部弹出选择器组件，支持浅色/深色主题
  */
-declare function Select({ value, onChange, options, placeholder, multiple, searchable, onSearch, disabled, clearable, className, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select({ value, onChange, options, placeholder, multiple, searchable, onSearch, disabled, clearable, singleSelectTitle, multipleSelectTitle, searchPlaceholder, emptyText, selectedCountText, confirmText, className, }: SelectProps): react_jsx_runtime.JSX.Element;
 
 /**
  * DatePicker 组件属性接口
@@ -2162,11 +2177,31 @@ interface DatePickerProps {
     maxDate?: Date;
     /** 自定义样式 */
     className?: string;
+    /** 弹窗取消按钮文案 */
+    cancelText?: string;
+    /** 弹窗确认按钮文案 */
+    confirmText?: string;
+    /** 弹窗标题文案 */
+    pickerTitle?: string;
+    /** 弹窗日期展示格式 */
+    pickerDateFormat?: string;
+    /** 年列标题 */
+    yearLabel?: string;
+    /** 月列标题 */
+    monthLabel?: string;
+    /** 日列标题 */
+    dayLabel?: string;
+    /** 快捷按钮“今天”文案 */
+    todayText?: string;
+    /** 快捷按钮“最早”文案 */
+    minDateText?: string;
+    /** 快捷按钮“最晚”文案 */
+    maxDateText?: string;
 }
 /**
  * DatePicker - 日期选择器组件，支持浅色/深色主题
  */
-declare function DatePicker({ value, onChange, placeholder, disabled, format, minDate, maxDate, className, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ value, onChange, placeholder, disabled, format, minDate, maxDate, className, cancelText, confirmText, pickerTitle, pickerDateFormat, yearLabel, monthLabel, dayLabel, todayText, minDateText, maxDateText, }: DatePickerProps): react_jsx_runtime.JSX.Element;
 
 interface FormItemProps {
     name: string;
@@ -3236,6 +3271,7 @@ interface AppStatusBarProps extends Omit<StatusBarProps, 'barStyle' | 'backgroun
  * - 页面可通过手动渲染该组件进行局部覆盖
  */
 declare function AppStatusBar({ barStyle, backgroundColor, translucent, ...props }: AppStatusBarProps): react_jsx_runtime.JSX.Element;
+declare function AppFocusedStatusBar(props: AppStatusBarProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * AppProvider Props
@@ -3548,4 +3584,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, 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 };
+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, AppFocusedStatusBar, AppHeader, type AppHeaderProps, AppImage, type AppImageProps, AppInput, type AppInputProps, AppList, type AppListProps, type AppNavigation, AppPressable, type AppPressableProps, AppProvider, type AppProviderProps, AppScreen, 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, 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.js

@@ -33,12 +33,14 @@ __export(index_exports, {
   ActionIcons: () => ActionIcons,
   Alert: () => Alert,
   AppButton: () => AppButton,
+  AppFocusedStatusBar: () => AppFocusedStatusBar,
   AppHeader: () => AppHeader,
   AppImage: () => AppImage,
   AppInput: () => AppInput,
   AppList: () => AppList,
   AppPressable: () => AppPressable,
   AppProvider: () => AppProvider,
+  AppScreen: () => AppScreen,
   AppScrollView: () => AppScrollView,
   AppStatusBar: () => AppStatusBar,
   AppText: () => AppText,
@@ -63,7 +65,6 @@ __export(index_exports, {
   NavigationIcons: () => NavigationIcons,
   NavigationProvider: () => NavigationProvider,
   OverlayProvider: () => OverlayProvider,
-  Page: () => Page,
   PageDrawer: () => PageDrawer,
   Progress: () => Progress,
   Radio: () => Radio,
@@ -1397,7 +1398,7 @@ var styles = import_react_native5.StyleSheet.create({
     flex: 1
   }
 });
-function Page({
+function AppScreen({
   children,
   className,
   ...props
@@ -1766,7 +1767,15 @@ function Icon({ name, size = "md", color = "gray-600", style, onPress, testID })
     return onPress ? /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(AppPressable, { onPress, children: fallback }) : fallback;
   }
   if (onPress) {
-    return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(AppPressable, { onPress, testID, children: /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(MaterialIconComponent, { name, size: resolvedSize, color: resolvedColor, style }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(AppPressable, { onPress, testID, children: /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
+      MaterialIconComponent,
+      {
+        name,
+        size: resolvedSize,
+        color: resolvedColor,
+        style
+      }
+    ) });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
     MaterialIconComponent,
@@ -2010,12 +2019,18 @@ function EmptyState({
     description && /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { size: "sm", className: "mt-2", style: { color: colors.textMuted }, children: description })
   ] });
 }
-function ErrorState({ error, onRetry }) {
+function ErrorState({
+  error,
+  onRetry,
+  errorTitle,
+  errorDescription,
+  retryText
+}) {
   const colors = useThemeColors();
   return /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(Center, { py: 20, children: [
     /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(Icon, { name: "error-outline", size: 64, color: "error-300" }),
-    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { size: "lg", weight: "medium", color: "error-500", className: "mt-4", children: "\u52A0\u8F7D\u5931\u8D25" }),
-    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { size: "sm", style: { color: colors.textMuted }, className: "mt-2 text-center px-8", children: error.message || "\u8BF7\u68C0\u67E5\u7F51\u7EDC\u540E\u91CD\u8BD5" }),
+    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { size: "lg", weight: "medium", color: "error-500", className: "mt-4", children: errorTitle || "\u52A0\u8F7D\u5931\u8D25" }),
+    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { size: "sm", style: { color: colors.textMuted }, className: "mt-2 text-center px-8", children: error.message || errorDescription || "\u8BF7\u68C0\u67E5\u7F51\u7EDC\u540E\u91CD\u8BD5" }),
     onRetry && /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
       AppPressable,
       {
@@ -2025,7 +2040,7 @@ function ErrorState({ error, onRetry }) {
           styles3.retryButton,
           { backgroundColor: colors.cardElevated, borderColor: colors.border }
         ],
-        children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { style: { color: colors.textSecondary }, className: "text-center", children: "\u91CD\u65B0\u52A0\u8F7D" })
+        children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(AppText, { style: { color: colors.textSecondary }, className: "text-center", children: retryText || "\u91CD\u65B0\u52A0\u8F7D" })
       }
     )
   ] });
@@ -2056,6 +2071,9 @@ function AppList({
   onEndReachedThreshold = 0.5,
   error,
   onRetry,
+  errorTitle,
+  errorDescription,
+  retryText,
   emptyTitle,
   emptyDescription,
   emptyIcon,
@@ -2124,7 +2142,16 @@ function AppList({
     );
   }
   if (error && data.length === 0) {
-    return /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(Center, { style, children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(ErrorState, { error, onRetry }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(Center, { style, children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+      ErrorState,
+      {
+        error,
+        onRetry,
+        errorTitle,
+        errorDescription,
+        retryText
+      }
+    ) });
   }
   const ListEmptyComponent = (0, import_react15.useMemo)(() => {
     if (EmptyComponent) return /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(EmptyComponent, {});
@@ -2286,14 +2313,7 @@ function PageDrawer({
           }
         ),
         /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(AppScrollView, { flex: true, className: "px-4 py-4", children }),
-        footer && /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
-          AppView,
-          {
-            className: "px-4 py-4",
-            style: [styles4.footer, { borderTopColor: colors.divider }],
-            children: footer
-          }
-        )
+        footer && /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(AppView, { className: "px-4 py-4", style: [styles4.footer, { borderTopColor: colors.divider }], children: footer })
       ]
     }
   );
@@ -2944,6 +2964,9 @@ var styles9 = import_react_native18.StyleSheet.create({
 var import_react23 = require("react");
 var import_react_native19 = require("react-native");
 var import_jsx_runtime28 = require("nativewind/jsx-runtime");
+function formatSelectedCountText(template, count) {
+  return template.replace("{{count}}", String(count));
+}
 function Select({
   value,
   onChange,
@@ -2954,6 +2977,12 @@ function Select({
   onSearch,
   disabled = false,
   clearable = true,
+  singleSelectTitle = "\u8BF7\u9009\u62E9",
+  multipleSelectTitle = "\u9009\u62E9\u9009\u9879",
+  searchPlaceholder = "\u641C\u7D22...",
+  emptyText = "\u6682\u65E0\u9009\u9879",
+  selectedCountText = "\u5DF2\u9009\u62E9 {{count}} \u9879",
+  confirmText = "\u786E\u5B9A",
   className
 }) {
   const colors = useFormThemeColors();
@@ -3077,7 +3106,7 @@ function Select({
                   className: "px-4 py-3",
                   style: [styles10.header, { borderBottomColor: colors.divider }],
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { className: "text-lg font-semibold", style: { color: colors.text }, children: multiple ? "\u9009\u62E9\u9009\u9879" : "\u8BF7\u9009\u62E9" }),
+                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { className: "text-lg font-semibold", style: { color: colors.text }, children: multiple ? multipleSelectTitle : singleSelectTitle }),
                     /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(import_react_native19.TouchableOpacity, { onPress: () => setVisible(false), children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(Icon, { name: "close", size: "md", color: colors.icon }) })
                   ]
                 }
@@ -3101,7 +3130,7 @@ function Select({
                           {
                             className: "flex-1 text-base",
                             style: { color: colors.text },
-                            placeholder: "\u641C\u7D22...",
+                            placeholder: searchPlaceholder,
                             placeholderTextColor: colors.textMuted,
                             value: searchKeyword,
                             onChangeText: handleSearch,
@@ -3120,7 +3149,7 @@ function Select({
                   data: filteredOptions,
                   keyExtractor: (item) => item.value,
                   renderItem: renderOption,
-                  ListEmptyComponent: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppView, { center: true, className: "py-8", children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { style: { color: colors.textMuted }, children: "\u6682\u65E0\u9009\u9879" }) })
+                  ListEmptyComponent: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppView, { center: true, className: "py-8", children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { style: { color: colors.textMuted }, children: emptyText }) })
                 }
               ),
               multiple && /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(
@@ -3132,18 +3161,14 @@ function Select({
                   className: "px-4 py-3",
                   style: [styles10.footer, { borderTopColor: colors.divider }],
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(AppText, { style: { color: colors.textMuted }, children: [
-                      "\u5DF2\u9009\u62E9 ",
-                      selectedValues.length,
-                      " \u9879"
-                    ] }),
+                    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { style: { color: colors.textMuted }, children: formatSelectedCountText(selectedCountText, selectedValues.length) }),
                     /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
                       import_react_native19.TouchableOpacity,
                       {
                         className: "px-4 py-2 rounded-lg",
                         style: { backgroundColor: colors.primary },
                         onPress: () => setVisible(false),
-                        children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { className: "font-medium", style: { color: colors.textInverse }, children: "\u786E\u5B9A" })
+                        children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(AppText, { className: "font-medium", style: { color: colors.textInverse }, children: confirmText })
                       }
                     )
                   ]
@@ -3234,7 +3259,17 @@ function DatePicker({
   format = "yyyy-MM-dd",
   minDate,
   maxDate,
-  className
+  className,
+  cancelText = "\u53D6\u6D88",
+  confirmText = "\u786E\u5B9A",
+  pickerTitle = "\u9009\u62E9\u65E5\u671F",
+  pickerDateFormat = "yyyy\u5E74MM\u6708dd\u65E5",
+  yearLabel = "\u5E74",
+  monthLabel = "\u6708",
+  dayLabel = "\u65E5",
+  todayText = "\u4ECA\u5929",
+  minDateText = "\u6700\u65E9",
+  maxDateText = "\u6700\u665A"
 }) {
   const colors = useFormThemeColors();
   const [visible, setVisible] = (0, import_react24.useState)(false);
@@ -3328,18 +3363,18 @@ function DatePicker({
               className: "px-4 py-3",
               style: [styles11.header, { borderBottomColor: colors.divider }],
               children: [
-                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_native20.TouchableOpacity, { onPress: () => setVisible(false), children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.textMuted }, children: "\u53D6\u6D88" }) }),
-                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { className: "text-lg font-semibold", style: { color: colors.text }, children: "\u9009\u62E9\u65E5\u671F" }),
-                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_native20.TouchableOpacity, { onPress: handleConfirm, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.primary }, className: "font-medium", children: "\u786E\u5B9A" }) })
+                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_native20.TouchableOpacity, { onPress: () => setVisible(false), children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.textMuted }, children: cancelText }) }),
+                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { className: "text-lg font-semibold", style: { color: colors.text }, children: pickerTitle }),
+                /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_native20.TouchableOpacity, { onPress: handleConfirm, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.primary }, className: "font-medium", children: confirmText }) })
               ]
             }
           ),
-          /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppView, { center: true, className: "py-4", style: { backgroundColor: colors.headerSurface }, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { className: "text-2xl font-semibold", style: { color: colors.text }, children: formatDate(tempDate, "yyyy\u5E74MM\u6708dd\u65E5") }) }),
+          /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppView, { center: true, className: "py-4", style: { backgroundColor: colors.headerSurface }, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { className: "text-2xl font-semibold", style: { color: colors.text }, children: formatDate(tempDate, pickerDateFormat) }) }),
           /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(AppView, { row: true, className: "h-48", children: [
             /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
               PickerColumn,
               {
-                title: "\u5E74",
+                title: yearLabel,
                 values: years,
                 selectedValue: tempDate.getFullYear(),
                 onSelect: (year) => updateTempDate(year),
@@ -3351,7 +3386,7 @@ function DatePicker({
             /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
               PickerColumn,
               {
-                title: "\u6708",
+                title: monthLabel,
                 values: months,
                 selectedValue: tempDate.getMonth() + 1,
                 onSelect: (month) => updateTempDate(void 0, month),
@@ -3364,7 +3399,7 @@ function DatePicker({
             /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
               PickerColumn,
               {
-                title: "\u65E5",
+                title: dayLabel,
                 values: days,
                 selectedValue: tempDate.getDate(),
                 onSelect: (day) => updateTempDate(void 0, void 0, day),
@@ -3386,7 +3421,7 @@ function DatePicker({
                     className: "flex-1 py-2 items-center rounded-lg",
                     style: { backgroundColor: colors.surfaceMuted },
                     onPress: () => setTempDate(/* @__PURE__ */ new Date()),
-                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: "\u4ECA\u5929" })
+                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: todayText })
                   }
                 ),
                 minDate && /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
@@ -3395,7 +3430,7 @@ function DatePicker({
                     className: "flex-1 py-2 items-center rounded-lg",
                     style: { backgroundColor: colors.surfaceMuted },
                     onPress: () => setTempDate(minDate),
-                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: "\u6700\u65E9" })
+                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: minDateText })
                   }
                 ),
                 maxDate && /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
@@ -3404,7 +3439,7 @@ function DatePicker({
                     className: "flex-1 py-2 items-center rounded-lg",
                     style: { backgroundColor: colors.surfaceMuted },
                     onPress: () => setTempDate(maxDate),
-                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: "\u6700\u665A" })
+                    children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(AppText, { style: { color: colors.text }, children: maxDateText })
                   }
                 )
               ]
@@ -4418,6 +4453,7 @@ var import_react_native_safe_area_context4 = require("react-native-safe-area-con
 
 // src/overlay/AppStatusBar.tsx
 var import_react_native27 = require("react-native");
+var import_native6 = require("@react-navigation/native");
 var import_jsx_runtime38 = require("nativewind/jsx-runtime");
 function AppStatusBar({
   barStyle = "auto",
@@ -4438,6 +4474,11 @@ function AppStatusBar({
     }
   );
 }
+function AppFocusedStatusBar(props) {
+  const isFocused = (0, import_native6.useIsFocused)();
+  if (!isFocused) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(AppStatusBar, { ...props });
+}
 
 // src/overlay/loading/provider.tsx
 var import_react38 = require("react");
@@ -4777,12 +4818,14 @@ var import_react_native_safe_area_context5 = require("react-native-safe-area-con
   ActionIcons,
   Alert,
   AppButton,
+  AppFocusedStatusBar,
   AppHeader,
   AppImage,
   AppInput,
   AppList,
   AppPressable,
   AppProvider,
+  AppScreen,
   AppScrollView,
   AppStatusBar,
   AppText,
@@ -4807,7 +4850,6 @@ var import_react_native_safe_area_context5 = require("react-native-safe-area-con
   NavigationIcons,
   NavigationProvider,
   OverlayProvider,
-  Page,
   PageDrawer,
   Progress,
   Radio,