@gaozh1024/rn-kit 0.3.2 → 0.3.4

package/README.md

@@ -61,6 +61,7 @@ module.exports = {
   ],
   safelist: [
     { pattern: /^(flex)-(1|2|3|4|5|6|7|8|9|10|11|12)$/ },
+    'flex-wrap',
     { pattern: /^(items)-(start|center|end|stretch)$/ },
     { pattern: /^(justify)-(start|center|end|between|around)$/ },
     { pattern: /^(p|px|py|gap)-(0|1|2|3|4|5|6|8|10|12)$/ },
@@ -171,6 +172,35 @@ import {
 } from '@gaozh1024/rn-kit';
 ```
 
+#### 布局与容器约定
+
+- `AppView` / `Row` 支持 `wrap`，等价于 `flex-wrap`
+- `Card` 支持常用间距快捷属性：`p` / `px` / `py` / `gap`
+- `SafeScreen` / `AppScreen` 同时支持：
+  - `bg="primary-500"` 这类显式颜色
+  - `surface="background" | "card" | "muted"` 这类语义背景
+
+#### Button 颜色语义
+
+`AppButton` 目前支持以下 `color`：
+
+- `primary`
+- `secondary`
+- `success`
+- `warning`
+- `info`
+- `error`
+- `danger`（`error` 的兼容别名）
+- `muted`
+
+```tsx
+<AppButton color="success">保存成功</AppButton>
+<AppButton color="warning" variant="outline">
+  继续操作
+</AppButton>
+<AppButton color="danger">删除</AppButton>
+```
+
 #### 可本地化文案参数（i18n 推荐）
 
 - `AppList`
@@ -190,6 +220,46 @@ import {
   - `yearLabel` / `monthLabel` / `dayLabel`：列标题文案
   - `todayText` / `minDateText` / `maxDateText`：快捷按钮文案
 
+#### 表单与反馈 Hook 当前 API
+
+```tsx
+import { useForm, useToast, useLoading, useAlert } from '@gaozh1024/rn-kit';
+
+const form = useForm({
+  schema,
+  defaultValues: { name: '' },
+});
+
+form.values;
+form.errors;
+form.setValue('name', 'Panther');
+await form.validate();
+await form.validateField('name');
+await form.handleSubmit(async values => {
+  console.log(values);
+});
+
+const toast = useToast();
+toast.show('已保存', 'success', 2000);
+toast.success('成功');
+
+const loading = useLoading();
+loading.show('加载中...');
+loading.hide();
+
+const alert = useAlert();
+alert.alert({ title: '提示', message: '操作完成' });
+alert.confirm({ title: '确认删除', message: '删除后不可恢复' });
+```
+
+说明：
+
+- `useForm` 使用 `defaultValues`，不是 `initialValues`
+- `useForm` 提供 `setValue` / `handleSubmit`，不是 `setFieldValue` / `submit`
+- `useToast` 当前签名为 `show(message, type?, duration?)`
+- `useLoading` 当前签名为 `show(text?)` / `hide()`
+- `useAlert` 当前提供 `alert()` / `confirm()`，不包含 `prompt()` / `custom()`
+
 ### 🪝 Hooks
 
 ```tsx
@@ -317,6 +387,14 @@ import { GradientView, AppText } from '@gaozh1024/rn-kit';
 </GradientView>;
 ```
 
+TypeScript 下如果你把颜色数组先提到变量里，建议写成 tuple：
+
+```tsx
+const heroColors = ['#f38b32', '#fb923c'] as const;
+
+<GradientView colors={heroColors} />;
+```
+
 如果你的应用是手动集成 `@gaozh1024/rn-kit`，请同时安装：
 
 ```bash
@@ -398,16 +476,31 @@ export default function App() {
 
 - 亮色主题：`dark-content`
 - 暗色主题：`light-content`
+- 默认 `translucent={false}`
 - Android 状态栏背景默认跟随当前主题背景色
 
-### 2. 页面级覆盖
+### 2. 使用 `AppHeader` 时的默认行为
+
+如果页面使用了 `AppHeader`，通常不需要再单独处理状态栏：
+
+- `AppHeader` 内部会自动注入 `AppFocusedStatusBar`
+- 配置为 `translucent + backgroundColor="transparent"`
+- 顶部状态栏区域会直接显示 Header 自身背景色
+
+适合：
+
+- 普通详情页
+- 设置页
+- 使用有色 Header 的二级页面
+
+### 3. 页面级覆盖
 
 如果某个页面需要单独控制状态栏，可以在页面内显式渲染：
 
 ```tsx
-import { AppStatusBar } from '@gaozh1024/rn-kit';
+import { AppFocusedStatusBar } from '@gaozh1024/rn-kit';
 
-<AppStatusBar barStyle="light-content" backgroundColor="#f38b32" />;
+<AppFocusedStatusBar barStyle="light-content" backgroundColor="transparent" translucent />;
 ```
 
 适合：
@@ -416,19 +509,21 @@ import { AppStatusBar } from '@gaozh1024/rn-kit';
 - 沉浸式详情页
 - 顶部大图/渐变背景页
 
-### 3. 登录页全屏背景示例
+对于导航页面，优先使用 `AppFocusedStatusBar`，这样只有当前聚焦页面会覆盖状态栏配置。
+
+### 4. 登录页全屏背景示例
 
 如果登录页希望顶部状态栏区域也和页面背景保持一致，不要直接使用默认白底容器。
 
 推荐：
 
 ```tsx
-import { AppStatusBar, SafeScreen, AppView } from '@gaozh1024/rn-kit';
+import { AppFocusedStatusBar, SafeScreen, AppView } from '@gaozh1024/rn-kit';
 
 export function LoginScreen() {
   return (
     <>
-      <AppStatusBar barStyle="light-content" backgroundColor="#f38b32" translucent={false} />
+      <AppFocusedStatusBar barStyle="light-content" backgroundColor="transparent" translucent />
 
       <SafeScreen bg="primary-500">
         <AppView flex className="bg-primary-500">
@@ -440,15 +535,15 @@ export function LoginScreen() {
 }
 ```
 
-### 4. 沉浸式状态栏示例
+### 5. 沉浸式状态栏示例
 
 ```tsx
-import { AppStatusBar, SafeScreen, AppView } from '@gaozh1024/rn-kit';
+import { AppFocusedStatusBar, SafeScreen, AppView } from '@gaozh1024/rn-kit';
 
 export function HeroScreen() {
   return (
     <>
-      <AppStatusBar barStyle="light-content" backgroundColor="transparent" translucent />
+      <AppFocusedStatusBar barStyle="light-content" backgroundColor="transparent" translucent />
 
       <SafeScreen top={false} bottom={false}>
         <AppView flex className="bg-black">
@@ -460,13 +555,13 @@ export function HeroScreen() {
 }
 ```
 
-### 5. 常见问题
+### 6. 常见问题
 
 #### 为什么顶部还是白色？
 
 通常是以下原因之一：
 
-1. 当前页面没有单独覆盖 `AppStatusBar`
+1. 当前页面没有使用 `AppHeader`，也没有单独覆盖 `AppFocusedStatusBar` / `AppStatusBar`
 2. 页面容器本身是白底
 3. 使用了 `AppScreen` / `SafeScreen`，但没有设置 `bg`
 4. 顶部安全区没有和页面背景统一

package/TAILWIND_SETUP.md

@@ -40,6 +40,7 @@ module.exports = {
   ],
   safelist: [
     { pattern: /^(flex)-(1|2|3|4|5|6|7|8|9|10|11|12)$/ },
+    'flex-wrap',
     { pattern: /^(items)-(start|center|end|stretch)$/ },
     { pattern: /^(justify)-(start|center|end|between|around)$/ },
     { pattern: /^(p|px|py|gap)-(0|1|2|3|4|5|6|8|10|12)$/ },

package/dist/index.d.mts

@@ -1073,6 +1073,8 @@ interface AppViewProps extends ViewProps {
     flex?: boolean | number;
     /** 是否使用水平排列（flex-direction: row） */
     row?: boolean;
+    /** 是否允许换行 */
+    wrap?: boolean;
     /** 是否居中显示（items-center justify-center） */
     center?: boolean;
     /** 是否两端对齐（justify-between） */
@@ -1128,7 +1130,7 @@ interface AppViewProps extends ViewProps {
  * </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;
+declare function AppView({ flex, row, wrap, 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 布局 */
@@ -1413,6 +1415,8 @@ interface SafeScreenProps extends ViewProps {
     right?: boolean;
     /** 背景颜色 */
     bg?: string;
+    /** 语义化背景 */
+    surface?: 'background' | 'card' | 'muted';
     /** 是否使用 flex: 1 */
     flex?: boolean;
     /** 自定义样式类 */
@@ -1430,7 +1434,7 @@ interface SafeScreenProps extends ViewProps {
  * </SafeScreen>
  * ```
  */
-declare function SafeScreen({ top, bottom, left, right, bg, flex, className, children, style, ...props }: SafeScreenProps): react_jsx_runtime.JSX.Element;
+declare function SafeScreen({ top, bottom, left, right, bg, surface, flex, className, children, style, ...props }: SafeScreenProps): react_jsx_runtime.JSX.Element;
 /**
  * 页面容器组件 - 包含安全区域和基础布局
  *
@@ -1461,13 +1465,14 @@ declare function SafeBottom({ children, className, ...props }: Omit<SafeScreenPr
 /**
  * AppButton 组件属性接口
  */
+type AppButtonColor = 'primary' | 'secondary' | 'success' | 'warning' | 'info' | 'error' | 'danger' | 'muted';
 interface AppButtonProps {
     /** 按钮样式变体：solid(实心)、outline(描边)、ghost(透明) */
     variant?: 'solid' | 'outline' | 'ghost';
     /** 按钮尺寸：sm(小)、md(中)、lg(大) */
     size?: 'sm' | 'md' | 'lg';
     /** 按钮颜色主题 */
-    color?: 'primary' | 'secondary' | 'danger';
+    color?: AppButtonColor;
     /** 是否显示加载状态 */
     loading?: boolean;
     /** 是否禁用 */
@@ -1503,6 +1508,9 @@ interface AppButtonProps {
  * // 不同颜色
  * <AppButton color="primary">主题色</AppButton>
  * <AppButton color="secondary">次要色</AppButton>
+ * <AppButton color="success">成功操作</AppButton>
+ * <AppButton color="warning">警告操作</AppButton>
+ * <AppButton color="info">提示操作</AppButton>
  * <AppButton color="danger">危险操作</AppButton>
  *
  * // 加载状态
@@ -1696,6 +1704,14 @@ declare function Progress({ value, max, size, color, testID, className, barClass
  * Card 组件属性接口
  */
 interface CardProps extends ViewProps {
+    /** 内边距 */
+    p?: number;
+    /** 水平内边距 */
+    px?: number;
+    /** 垂直内边距 */
+    py?: number;
+    /** 子元素间距 */
+    gap?: number;
     /** Tailwind / NativeWind 类名 */
     className?: string;
     /** 是否禁用阴影 */
@@ -1708,7 +1724,7 @@ interface CardProps extends ViewProps {
 /**
  * Card - 卡片容器组件，支持浅色/深色主题
  */
-declare function Card({ children, className, style, noShadow, noBorder, noRadius, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ children, p, px, py, gap, className, style, noShadow, noBorder, noRadius, ...props }: CardProps): react_jsx_runtime.JSX.Element;
 
 /** 图标尺寸类型 */
 type IconSize = number | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -2017,6 +2033,7 @@ interface AppInputProps extends Omit<TextInputProps, 'editable'> {
  * AppInput - 输入框组件，支持浅色/深色主题
  */
 declare const AppInput: React$1.ForwardRefExoticComponent<AppInputProps & React$1.RefAttributes<TextInput>>;
+declare const AppTextInput: React$1.ForwardRefExoticComponent<AppInputProps & React$1.RefAttributes<TextInput>>;
 
 /**
  * Checkbox 组件属性接口
@@ -2978,6 +2995,7 @@ interface AppHeaderProps {
  * 应用头部组件
  *
  * iOS 风格的顶部导航栏，标题始终居中，不受左右按钮影响
+ * 内部会自动注入聚焦态透明状态栏，让顶部状态栏区域跟随 Header 背景显示
  *
  * @example
  * ```tsx
@@ -3584,4 +3602,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, 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 };
+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, AppTextInput, 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

@@ -1073,6 +1073,8 @@ interface AppViewProps extends ViewProps {
     flex?: boolean | number;
     /** 是否使用水平排列（flex-direction: row） */
     row?: boolean;
+    /** 是否允许换行 */
+    wrap?: boolean;
     /** 是否居中显示（items-center justify-center） */
     center?: boolean;
     /** 是否两端对齐（justify-between） */
@@ -1128,7 +1130,7 @@ interface AppViewProps extends ViewProps {
  * </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;
+declare function AppView({ flex, row, wrap, 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 布局 */
@@ -1413,6 +1415,8 @@ interface SafeScreenProps extends ViewProps {
     right?: boolean;
     /** 背景颜色 */
     bg?: string;
+    /** 语义化背景 */
+    surface?: 'background' | 'card' | 'muted';
     /** 是否使用 flex: 1 */
     flex?: boolean;
     /** 自定义样式类 */
@@ -1430,7 +1434,7 @@ interface SafeScreenProps extends ViewProps {
  * </SafeScreen>
  * ```
  */
-declare function SafeScreen({ top, bottom, left, right, bg, flex, className, children, style, ...props }: SafeScreenProps): react_jsx_runtime.JSX.Element;
+declare function SafeScreen({ top, bottom, left, right, bg, surface, flex, className, children, style, ...props }: SafeScreenProps): react_jsx_runtime.JSX.Element;
 /**
  * 页面容器组件 - 包含安全区域和基础布局
  *
@@ -1461,13 +1465,14 @@ declare function SafeBottom({ children, className, ...props }: Omit<SafeScreenPr
 /**
  * AppButton 组件属性接口
  */
+type AppButtonColor = 'primary' | 'secondary' | 'success' | 'warning' | 'info' | 'error' | 'danger' | 'muted';
 interface AppButtonProps {
     /** 按钮样式变体：solid(实心)、outline(描边)、ghost(透明) */
     variant?: 'solid' | 'outline' | 'ghost';
     /** 按钮尺寸：sm(小)、md(中)、lg(大) */
     size?: 'sm' | 'md' | 'lg';
     /** 按钮颜色主题 */
-    color?: 'primary' | 'secondary' | 'danger';
+    color?: AppButtonColor;
     /** 是否显示加载状态 */
     loading?: boolean;
     /** 是否禁用 */
@@ -1503,6 +1508,9 @@ interface AppButtonProps {
  * // 不同颜色
  * <AppButton color="primary">主题色</AppButton>
  * <AppButton color="secondary">次要色</AppButton>
+ * <AppButton color="success">成功操作</AppButton>
+ * <AppButton color="warning">警告操作</AppButton>
+ * <AppButton color="info">提示操作</AppButton>
  * <AppButton color="danger">危险操作</AppButton>
  *
  * // 加载状态
@@ -1696,6 +1704,14 @@ declare function Progress({ value, max, size, color, testID, className, barClass
  * Card 组件属性接口
  */
 interface CardProps extends ViewProps {
+    /** 内边距 */
+    p?: number;
+    /** 水平内边距 */
+    px?: number;
+    /** 垂直内边距 */
+    py?: number;
+    /** 子元素间距 */
+    gap?: number;
     /** Tailwind / NativeWind 类名 */
     className?: string;
     /** 是否禁用阴影 */
@@ -1708,7 +1724,7 @@ interface CardProps extends ViewProps {
 /**
  * Card - 卡片容器组件，支持浅色/深色主题
  */
-declare function Card({ children, className, style, noShadow, noBorder, noRadius, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ children, p, px, py, gap, className, style, noShadow, noBorder, noRadius, ...props }: CardProps): react_jsx_runtime.JSX.Element;
 
 /** 图标尺寸类型 */
 type IconSize = number | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -2017,6 +2033,7 @@ interface AppInputProps extends Omit<TextInputProps, 'editable'> {
  * AppInput - 输入框组件，支持浅色/深色主题
  */
 declare const AppInput: React$1.ForwardRefExoticComponent<AppInputProps & React$1.RefAttributes<TextInput>>;
+declare const AppTextInput: React$1.ForwardRefExoticComponent<AppInputProps & React$1.RefAttributes<TextInput>>;
 
 /**
  * Checkbox 组件属性接口
@@ -2978,6 +2995,7 @@ interface AppHeaderProps {
  * 应用头部组件
  *
  * iOS 风格的顶部导航栏，标题始终居中，不受左右按钮影响
+ * 内部会自动注入聚焦态透明状态栏，让顶部状态栏区域跟随 Header 背景显示
  *
  * @example
  * ```tsx
@@ -3584,4 +3602,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, 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 };
+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, AppTextInput, 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 };