@beppla/tapas-ui 1.5.2 → 1.5.6

package/module/ListItem/README.md

@@ -0,0 +1,122 @@
+# ListItem
+
+列表项组件，基于 @rneui/themed ListItem 封装，支持选中状态、搜索高亮、描述文本、数量角标等功能，适合构建可交互的选择列表。
+
+## 功能特性
+
+- ✅ 选中状态指示（背景色变化 + 勾选图标）
+- ✅ 搜索关键字高亮显示（name 和 desc 同时高亮）
+- ✅ 支持主标题和描述文本
+- ✅ 数量角标（number 属性，圆形背景主题色）
+- ✅ 鼠标悬停效果（Web 端 Hoverable）
+- ✅ 禁用状态，颜色置灰且不可点击
+- ✅ 首末项圆角支持（isFirst / isLast，12px 圆角）
+- ✅ 高度自定义样式：容器、标题、描述、搜索高亮
+- ✅ 文本自适应宽度，自动单行截断
+
+## 安装使用
+
+```tsx
+import ListItem from '@beppla/tapas-ui/components/ListItem/ListItem';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| item | `ItemProps` | (必填) | 列表项数据 |
+| selected | `ItemProps` | (必填) | 当前选中项（通过 value 比较） |
+| key | `number \| string` | (必填) | 唯一标识 |
+| onItemPress | `(item: ItemProps) => void` | (必填) | 点击回调 |
+| disabled | `boolean` | - | 是否禁用 |
+| isFirst | `boolean` | - | 是否为第一项（添加顶部圆角） |
+| isLast | `boolean` | - | 是否为最后一项（添加底部圆角） |
+| search | `string` | - | 搜索关键字，匹配部分高亮 |
+| containerStyle | `StyleProp<ViewStyle>` | - | 外层容器样式 |
+| itemContainerStyle | `StyleProp<ViewStyle>` | - | 项容器样式 |
+| titleContainerStyle | `StyleProp<ViewStyle>` | - | 标题容器样式 |
+| searchHighlightStyle | `StyleProp<TextStyle>` | - | 搜索高亮文本样式 |
+| titleStyle | `StyleProp<TextStyle>` | - | 标题文本样式 |
+| descStyle | `StyleProp<TextStyle>` | - | 描述文本样式 |
+| testID | `string` | - | 测试标识 |
+
+### ItemProps 接口
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| name | `string` | 显示名称（必填） |
+| value | `string \| number` | 值（必填），用于比较选中状态 |
+| id | `string \| number` | 唯一标识 |
+| hide | `boolean` | 是否隐藏 |
+| desc | `string` | 描述文本 |
+| number | `number` | 数量角标 |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+const data = [
+  { name: 'Apple', value: 'apple' },
+  { name: 'Banana', value: 'banana' },
+  { name: 'Cherry', value: 'cherry' },
+];
+
+const [selected, setSelected] = useState(data[0]);
+
+{data.map((item, index) => (
+  <ListItem
+    key={index}
+    item={item}
+    selected={selected}
+    onItemPress={(value) => setSelected(value)}
+    isFirst={index === 0}
+    isLast={index === data.length - 1}
+  />
+))}
+```
+
+### 带描述和搜索高亮
+
+```tsx
+<ListItem
+  key={0}
+  item={{ name: 'John', value: 'john', desc: 'Manager' }}
+  selected={selected}
+  onItemPress={setSelected}
+  search="jo"
+  searchHighlightStyle={{ color: 'red' }}
+/>
+```
+
+### 带数量角标
+
+```tsx
+<ListItem
+  key={0}
+  item={{ name: 'Orders', value: 'orders', number: 5 }}
+  selected={selected}
+  onItemPress={setSelected}
+/>
+```
+
+### 禁用状态
+
+```tsx
+<ListItem
+  key={0}
+  item={{ name: 'Unavailable', value: 'unavailable' }}
+  selected={selected}
+  onItemPress={setSelected}
+  disabled
+/>
+```
+
+## 注意事项
+
+- 选中状态通过比较 `selected.value === item.value` 判断
+- 当 `item.number` 存在时显示数量角标（白字主题色背景），否则选中时显示勾选图标
+- 禁用状态下点击不会触发 `onItemPress`
+- `isFirst` / `isLast` 用于列表首末项圆角（12px），需手动传入
+- 搜索高亮使用正则分割文本，大小写不敏感，同时作用于 name 和 desc 字段
+- 列表项固定高度 48px

package/module/MessageBox/MessageBox.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import React, { useEffect, useState, useCallback, useMemo } from "react";
-import { View, Text, Modal, Pressable } from "react-native";
+import { View, Text, Modal, Pressable, useWindowDimensions } from "react-native";
 import { withTheme, makeStyles, useTheme } from "@rneui/themed";
 import TapasIcon from "../Icons/TapasIcon";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -22,6 +22,10 @@ const MessageBox = ({
   onConfirm
 }) => {
   const theme = useTheme();
+  const {
+    width: windowWidth
+  } = useWindowDimensions();
+  const isPhone = windowWidth <= 430;
   const styles = useStyles();
   const [modalVisible, setModalVisible] = useState(false);
   useEffect(() => {
@@ -63,7 +67,9 @@ const MessageBox = ({
     children: /*#__PURE__*/_jsx(View, {
       style: styles.modalContainer,
       children: /*#__PURE__*/_jsxs(View, {
-        style: styles.modalContent,
+        style: [styles.modalContent, isPhone && {
+          width: windowWidth - 32
+        }],
         children: [/*#__PURE__*/_jsxs(View, {
           style: styles.messagebox_header,
           children: [stateIcon ? /*#__PURE__*/_jsx(View, {

package/module/MessageBox/MessageBox.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useEffect","useState","useCallback","useMemo","View","Text","Modal","Pressable","withTheme","makeStyles","useTheme","TapasIcon","jsx","_jsx","jsxs","_jsxs","MessageBox","state","title","text","icon","visible","confirmBtnText","closeBtnText","hideFooter","hideCloseBtn","hideConfirmBtn","descNumberOfLines","onVisibilityChange","onClose","onConfirm","theme","styles","useStyles","modalVisible","setModalVisible","Boolean","stateIcon","handleClose","handleConfirm","handleRequestClose","animationType","transparent","onRequestClose","children","style","modalContainer","modalContent","messagebox_header","messagebox_header_icon","name","size","color","colors","primary","messagebox_header_txt_con","messagebox_header_txt","numberOfLines","ellipsizeMode","messagebox_main","messagebox_main_txt","messagebox_footer","messagebox_btn","onPress","messagebox_btn_txt","backgroundColor","white","flex","justifyContent","alignItems","zIndex","width","borderRadius","display","flexDirection","padding","gap","height","alignContent","overflow","fontSize","fontWeight","secondary","paddingLeft","paddingRight"],"sourceRoot":"../../../components","sources":["MessageBox/MessageBox.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useEffect","useState","useCallback","useMemo","View","Text","Modal","Pressable","useWindowDimensions","withTheme","makeStyles","useTheme","TapasIcon","jsx","_jsx","jsxs","_jsxs","MessageBox","state","title","text","icon","visible","confirmBtnText","closeBtnText","hideFooter","hideCloseBtn","hideConfirmBtn","descNumberOfLines","onVisibilityChange","onClose","onConfirm","theme","width","windowWidth","isPhone","styles","useStyles","modalVisible","setModalVisible","Boolean","stateIcon","handleClose","handleConfirm","handleRequestClose","animationType","transparent","onRequestClose","children","style","modalContainer","modalContent","messagebox_header","messagebox_header_icon","name","size","color","colors","primary","messagebox_header_txt_con","messagebox_header_txt","numberOfLines","ellipsizeMode","messagebox_main","messagebox_main_txt","messagebox_footer","messagebox_btn","onPress","messagebox_btn_txt","backgroundColor","white","flex","justifyContent","alignItems","zIndex","borderRadius","display","flexDirection","padding","gap","height","alignContent","overflow","fontSize","fontWeight","secondary","paddingLeft","paddingRight"],"sourceRoot":"../../../components","sources":["MessageBox/MessageBox.tsx"],"mappings":"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","ignoreList":[]}

package/module/MessageBox/README.md

@@ -0,0 +1,120 @@
+# MessageBox
+
+模态对话框组件，用于显示重要信息和获取用户确认。支持 success、warning、error 三种状态，提供灵活的按钮配置（隐藏确认/取消按钮、隐藏整个底部栏），适合操作确认、错误提示、成功反馈等场景。
+
+## 功能特性
+
+- ✅ 支持 success、warning、error 三种状态
+- ✅ 状态自动匹配图标（check_circle / warning / error）
+- ✅ 可自定义图标名称覆盖默认状态图标
+- ✅ 灵活的按钮配置：隐藏确认按钮、隐藏取消按钮、隐藏整个底部栏
+- ✅ 自定义确认和取消按钮文本
+- ✅ 描述文本行数限制（descNumberOfLines）
+- ✅ 淡入淡出动画（animationType="fade"）
+- ✅ 透明遮罩背景
+- ✅ 支持 onVisibilityChange 双向绑定控制
+
+## 安装使用
+
+```tsx
+import { MessageBox } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| visible | `boolean` | - | 是否显示对话框 |
+| state | `'success' \| 'warning' \| 'error'` | - | 状态类型 |
+| icon | `string` | 根据 state 自动选择 | 自定义图标名称 |
+| title | `string` | - | 标题文本 |
+| text | `string` | - | 描述内容 |
+| hideFooter | `boolean` | `false` | 是否隐藏整个底部按钮栏 |
+| hideCloseBtn | `boolean` | `false` | 是否隐藏取消按钮 |
+| hideConfirmBtn | `boolean` | `false` | 是否隐藏确认按钮 |
+| confirmBtnText | `string` | `'Confirm'` | 确认按钮文本 |
+| closeBtnText | `string` | `'Close'` | 取消按钮文本 |
+| descNumberOfLines | `number` | `3` | 描述文本最大行数 |
+| onVisibilityChange | `(val: boolean) => void` | - | 可见状态变化回调 |
+| onConfirm | `() => void` | - | 确认按钮点击回调 |
+| onClose | `() => void` | - | 取消按钮点击回调 |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+const [visible, setVisible] = useState(false);
+
+<MessageBox
+  visible={visible}
+  title="Confirm"
+  text="Are you sure you want to proceed?"
+  confirmBtnText="OK"
+  closeBtnText="Cancel"
+  onVisibilityChange={setVisible}
+  onConfirm={() => {
+    handleConfirm();
+    setVisible(false);
+  }}
+  onClose={() => setVisible(false)}
+/>
+```
+
+### 不同状态
+
+```tsx
+<MessageBox
+  visible={visible}
+  state="success"
+  title="Success"
+  text="Operation completed!"
+  hideCloseBtn
+  confirmBtnText="OK"
+  onConfirm={() => setVisible(false)}
+/>
+
+<MessageBox
+  visible={visible}
+  state="error"
+  title="Error"
+  text="Operation failed, please retry."
+  confirmBtnText="Retry"
+  closeBtnText="Close"
+  onConfirm={() => handleRetry()}
+  onClose={() => setVisible(false)}
+/>
+```
+
+### 仅确认按钮
+
+```tsx
+<MessageBox
+  visible={visible}
+  title="Notice"
+  text="This is a notification."
+  hideCloseBtn={true}
+  confirmBtnText="Got it"
+  onConfirm={() => setVisible(false)}
+/>
+```
+
+### 无按钮（点击遮罩关闭）
+
+```tsx
+<MessageBox
+  visible={visible}
+  title="Info"
+  text="Click backdrop to close."
+  hideFooter={true}
+  onVisibilityChange={setVisible}
+/>
+```
+
+## 注意事项
+
+- 组件内部维护 `modalVisible` 状态，与外部 `visible` 同步
+- 关闭优先级：`onClose` > `onVisibilityChange` > 内部 `setModalVisible(false)`
+- 对话框固定宽度 392px，居中显示
+- 需在 `ThemeProvider` 内使用
+- 确认按钮使用主题 `primary` 色，取消按钮无背景色

package/module/Navigation/README.md

@@ -0,0 +1,197 @@
+# Navigation
+
+侧边导航栏组件，提供可展开/折叠的垂直导航菜单。支持导航项（navItems）和系统项（systemItems）两层分组，收起时仅显示图标，展开时显示图标和文本。
+
+## 功能特性
+
+- 可展开/折叠的侧边导航（收起 56px，展开 336px）
+- 导航项和系统项两层分组（系统项固定在底部）
+- 点击 Logo 切换展开/折叠状态
+- 选中项高亮显示（展开时背景高亮，收起时图标高亮）
+- 移动端支持背景遮罩层（点击遮罩关闭导航）
+- 可配置权限信息（`permissions` 字段）
+- 支持 `selectedIndex` 受控选中
+- 可选集成 React Navigation 自动路由导航
+- 自定义 Logo 图片
+
+## 安装使用
+
+```tsx
+import { Navigation, NavItem, NavItemType, SelectedItem } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| navItems | `NavItem[]` | - | 导航项数组 |
+| systemItems | `NavItem[]` | - | 系统项数组（显示在底部） |
+| logoImg | `ImageSourcePropType` | - | Logo 图片资源 |
+| expanded | `boolean` | `false` | 是否展开导航菜单 |
+| onItemPress | `(item: NavItem) => void` | - | 导航项点击回调 |
+| onLogoPress | `() => void` | - | Logo 点击回调 |
+| defaultSelectedItem | `SelectedItem` | - | 默认选中项 |
+| selectedIndex | `number` | - | 选中项索引（受控模式，仅匹配 navItems） |
+| visible | `boolean` | `true` | 导航栏是否可见 |
+| onMaskPress | `() => void` | - | 背景遮罩点击回调（移动端） |
+| navigation | `{ navigate: (routeName: string, params?: any) => void }` | - | React Navigation 对象（可选） |
+
+## 类型定义
+
+### NavItem
+
+```tsx
+interface NavItem {
+  name: string;              // 项目名称（展开时显示）
+  iconName: string;          // TapasIcon 图标名称
+  url?: string;              // 链接 URL（可选）
+  permissions?: Permissions[]; // 权限要求（可选）
+}
+```
+
+### Permissions
+
+```tsx
+interface Permissions {
+  resource: string;  // 资源名
+  action: string;    // 操作名
+}
+```
+
+### NavItemType / SelectedItem
+
+```tsx
+enum NavItemType {
+  Nav = 'nav',       // 导航项
+  System = 'system', // 系统项
+}
+
+interface SelectedItem {
+  type: NavItemType;         // 项目类型
+  selectedItemIndex: number; // 项目索引
+}
+```
+
+## 使用示例
+
+### 基础导航
+
+```tsx
+import { Navigation, NavItem, NavItemType } from '@beppla/tapas-ui';
+
+const navItems: NavItem[] = [
+  { name: 'Dashboard', iconName: 'home' },
+  { name: 'Analytics', iconName: 'vector' },
+  { name: 'Products', iconName: 'product_items' },
+  { name: 'Messages', iconName: 'chat' },
+];
+
+const systemItems: NavItem[] = [
+  { name: 'Settings', iconName: 'settings' },
+  { name: 'Refresh', iconName: 'refresh' },
+];
+
+export default function App() {
+  return (
+    <Navigation
+      navItems={navItems}
+      systemItems={systemItems}
+      logoImg={require('./logo.png')}
+      defaultSelectedItem={{
+        type: NavItemType.Nav,
+        selectedItemIndex: 0,
+      }}
+    />
+  );
+}
+```
+
+### 带点击回调
+
+```tsx
+<Navigation
+  navItems={navItems}
+  systemItems={systemItems}
+  logoImg={require('./logo.png')}
+  onItemPress={(item) => {
+    console.log('Selected:', item.name);
+    setCurrentPage(item.name);
+  }}
+/>
+```
+
+### 受控选中索引
+
+```tsx
+const [selectedIdx, setSelectedIdx] = useState(0);
+
+<Navigation
+  navItems={navItems}
+  systemItems={systemItems}
+  logoImg={require('./logo.png')}
+  selectedIndex={selectedIdx}
+  onItemPress={(item) => {
+    const idx = navItems.findIndex(n => n.name === item.name);
+    if (idx >= 0) setSelectedIdx(idx);
+  }}
+/>
+```
+
+### 与 React Navigation 集成
+
+```tsx
+import { useNavigation } from '@react-navigation/native';
+
+const navigation = useNavigation();
+
+<Navigation
+  navItems={[
+    { name: 'Home', iconName: 'home' },
+    { name: 'Details', iconName: 'info' },
+  ]}
+  logoImg={require('./logo.png')}
+  navigation={navigation}
+/>
+```
+
+### 完整布局示例
+
+```tsx
+import { View, Text } from 'react-native';
+import { Navigation, NavItem } from '@beppla/tapas-ui';
+import { useState } from 'react';
+
+const navItems: NavItem[] = [
+  { name: 'Dashboard', iconName: 'home' },
+  { name: 'Products', iconName: 'product_items' },
+  { name: 'Orders', iconName: 'manufacturing' },
+];
+
+export default function App() {
+  const [page, setPage] = useState('Dashboard');
+
+  return (
+    <View style={{ flexDirection: 'row', height: '100%' }}>
+      <Navigation
+        navItems={navItems}
+        logoImg={require('./logo.png')}
+        onItemPress={(item) => setPage(item.name)}
+      />
+      <View style={{ flex: 1, padding: 16 }}>
+        <Text>{page} Content</Text>
+      </View>
+    </View>
+  );
+}
+```
+
+## 注意事项
+
+- 导航栏默认收起状态（宽度 56px），点击 Logo 切换展开（336px）/折叠
+- 桌面端点击 Logo 触发 `onLogoPress` 并切换展开状态；移动端点击 Logo 触发 `onMaskPress`
+- 展开时会在导航栏外显示半透明遮罩层（`rgba(0,0,0,0.5)`），点击遮罩可关闭
+- `selectedIndex` 仅匹配 `navItems` 数组，不支持直接选中 `systemItems`
+- 设置 `navigation` 属性后，点击导航项会自动调用 `navigation.navigate(item.name)`
+- 导航项图标大小固定 20px，颜色为主题 `white`
+- 选中状态：展开时背景高亮（`secondary` 色），收起时图标容器高亮
+- `visible=false` 时整个导航栏不渲染

package/module/NumericInput/README.md

@@ -0,0 +1,95 @@
+# NumericInput
+
+数字输入组件，包含加减按钮和文本输入框，适用于数量选择场景。
+
+## 功能特性
+
+- ✅ 加减按钮控制数值增减
+- ✅ 支持手动键盘输入数字
+- ✅ 可设置最大值和最小值限制
+- ✅ 到达边界时自动禁用对应按钮
+- ✅ 支持整体禁用状态
+- ✅ 加号按钮使用主题色填充背景
+- ✅ 支持 onReduce 和 onAdd 额外回调
+- ✅ 兼容 RN 0.77 Bridgeless 模式（Android 焦点管理修复）
+- ✅ 支持自定义输入框样式
+- ✅ 支持 testID 属性用于测试
+
+## 安装使用
+
+```tsx
+import NumericInput from '@beppla/tapas-ui/components/NumericInput/NumericInput';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| value | `number` | - | 当前数值 |
+| max | `number` | - | 最大值 |
+| min | `number` | - | 最小值 |
+| onChange | `(value: number) => void` | - | 数值变化回调 |
+| onReduce | `() => void` | - | 减少按钮点击回调（在数值变化前触发） |
+| onAdd | `() => void` | - | 增加按钮点击回调（在数值变化前触发） |
+| disabled | `boolean` | - | 是否禁用整个组件 |
+| inputStyle | `StyleProp<ViewStyle>` | - | 输入框自定义样式 |
+| testID | `string` | - | 测试标识 |
+| enableBridgelessFix | `boolean` | `true` | 是否启用 RN 0.77 Bridgeless 模式兼容修复 |
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+<NumericInput
+  value={0}
+  min={0}
+  max={99}
+  onChange={(value) => console.log('数量:', value)}
+/>
+```
+
+### 设置范围
+
+```tsx
+<NumericInput
+  value={5}
+  min={1}
+  max={10}
+  onChange={(value) => setQuantity(value)}
+/>
+```
+
+### 禁用状态
+
+```tsx
+<NumericInput
+  value={3}
+  min={0}
+  max={99}
+  disabled
+  onChange={() => {}}
+/>
+```
+
+### 带额外回调
+
+```tsx
+<NumericInput
+  value={count}
+  min={0}
+  max={99}
+  onChange={(value) => setCount(value)}
+  onAdd={() => console.log('点击了增加')}
+  onReduce={() => console.log('点击了减少')}
+/>
+```
+
+## 注意事项
+
+- `onReduce` 和 `onAdd` 在按钮点击时立即触发，即使数值已到边界也会触发
+- `onChange` 只在数值实际变化时触发（边界处不触发）
+- 手动输入时，超过 `max` 的值会被忽略
+- 失焦时会触发 `onChange` 回调，Android 上有延迟处理以兼容 Bridgeless 模式
+- 组件最小宽度 136px，高度 40px
+- 如果 Android 上遇到焦点问题，可设置 `enableBridgelessFix={false}` 尝试

package/module/Overlay/README.md

@@ -0,0 +1,84 @@
+# Overlay
+
+覆盖层组件，基于 `@rneui/themed` 的 Overlay 封装，用于显示底部弹出的模态内容面板。预设从底部弹出、占屏幕 80% 高度的样式，适合底部 Sheet 和弹出菜单场景。
+
+## 功能特性
+
+- ✅ 继承 @rneui/themed OverlayProps 的全部能力
+- ✅ 预设底部弹出样式（absolute + bottom: 0）
+- ✅ 半透明遮罩背景（backdropStyle）
+- ✅ 支持点击遮罩关闭（onBackdropPress）
+- ✅ 自定义 overlayStyle 和 backdropStyle 覆盖默认样式
+- ✅ 主题色适配
+
+## 安装使用
+
+```tsx
+import { Overlay } from '@beppla/tapas-ui';
+```
+
+## Props
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| isVisible | `boolean` | - | 是否显示覆盖层（必填） |
+| onBackdropPress | `() => void` | - | 点击遮罩回调 |
+| overlayStyle | `StyleProp<ViewStyle>` | 底部弹出，宽100%，高80% | 覆盖层样式 |
+| backdropStyle | `StyleProp<ViewStyle>` | 半透明灰色 | 遮罩样式 |
+| children | `React.ReactNode` | - | 覆盖层内容 |
+
+> 继承 `@rneui/themed` OverlayProps 的所有属性
+
+## 使用示例
+
+### 基础用法
+
+```tsx
+const [isVisible, setIsVisible] = useState(false);
+
+<Button onPress={() => setIsVisible(true)}>Open Overlay</Button>
+<Overlay
+  isVisible={isVisible}
+  onBackdropPress={() => setIsVisible(false)}
+>
+  <View>
+    <Text>Overlay Content</Text>
+  </View>
+</Overlay>
+```
+
+### 自定义高度
+
+```tsx
+<Overlay
+  isVisible={isVisible}
+  onBackdropPress={() => setIsVisible(false)}
+  overlayStyle={{ height: '50%' }}
+>
+  <Text>Half screen overlay</Text>
+</Overlay>
+```
+
+### 居中弹出
+
+```tsx
+<Overlay
+  isVisible={isVisible}
+  onBackdropPress={() => setIsVisible(false)}
+  overlayStyle={{
+    width: '80%',
+    height: 'auto',
+    position: 'relative',
+    borderRadius: 12,
+  }}
+>
+  <Text>Centered modal content</Text>
+</Overlay>
+```
+
+## 注意事项
+
+- 默认样式为底部弹出面板（`position: absolute, bottom: 0, width: 100%, height: 80%`）
+- 传入 `overlayStyle` 会与默认样式合并（数组形式），后者优先级更高
+- 组件需在 `ThemeProvider` 内使用
+- 遮罩背景色使用主题的 `grey4` 颜色