@beppla/tapas-ui 1.4.34 → 1.5.0

package/package/module/Drawer/SCROLLVIEW_FIX.md

@@ -1,127 +0,0 @@
-# Drawer ScrollView 布局修复
-
-## 问题描述
-
-之前 Drawer 组件的 ScrollView 在某些情况下，内容高度不足时无法填充整个可用空间，导致布局不理想。
-
-## 解决方案
-
-### 修改内容
-
-为 ScrollView 添加 `contentContainerStyle`，使用 `flexGrow: 1` 确保内容容器能够填充整个 ScrollView。
-
-```typescript
-<ScrollView 
-  style={[styles.middleSection, middleSectionStyle]}
-  contentContainerStyle={styles.containerStyle}  // ✨ 新增
->
-  {component}
-  {children}
-</ScrollView>
-```
-
-### 样式定义
-
-```typescript
-containerStyle: {
-  flexGrow: 1,  // 让内容容器至少填充整个 ScrollView
-}
-```
-
-## 技术说明
-
-### `flex: 1` vs `flexGrow: 1`
-
-在 ScrollView 的 `contentContainerStyle` 中：
-
-- ❌ **不要使用 `flex: 1`**
-  - `flex: 1` 是 `flex-grow: 1`, `flex-shrink: 1`, `flex-basis: 0` 的简写
-  - 会让内容容器强制占据固定高度，可能破坏滚动行为
-  - 在内容超出时会导致布局问题
-
-- ✅ **使用 `flexGrow: 1`**
-  - 允许内容容器增长以填充可用空间
-  - 当内容少时，容器会扩展填充 ScrollView
-  - 当内容多时，容器自然增长，保持滚动功能正常
-  - 不会影响 `flex-shrink` 和 `flex-basis` 的默认行为
-
-### ScrollView 的两个样式属性
-
-```typescript
-// 外层容器样式（ScrollView 本身）
-style={{
-  flex: 1,           // ✅ 正确：让 ScrollView 占满可用空间
-  paddingHorizontal: 16,
-}}
-
-// 内层内容容器样式（包裹 children）
-contentContainerStyle={{
-  flexGrow: 1,       // ✅ 正确：让内容至少填充 ScrollView
-  paddingBottom: 20, // 内容的 padding
-}}
-```
-
-## 使用场景
-
-这个修复特别适用于：
-
-1. **内容较少时**: 确保内容垂直居中或填充整个抽屉
-2. **动态内容**: 内容高度可能变化的场景
-3. **表单布局**: 需要底部按钮始终在底部的情况
-4. **空状态**: 显示空状态提示时保持良好布局
-
-## 示例
-
-### 修复前
-
-```typescript
-// 内容少时，ScrollView 内容不填充，底部有空白
-<Drawer visible={true}>
-  <Text>少量内容</Text>
-</Drawer>
-```
-
-### 修复后
-
-```typescript
-// 内容少时，ScrollView 内容填充整个可用空间
-<Drawer visible={true}>
-  <Text>少量内容</Text>
-  {/* 内容会填充整个抽屉高度 */}
-</Drawer>
-```
-
-## React Native ScrollView 官方文档
-
-根据 React Native 官方文档：
-
-> `contentContainerStyle`: These styles will be applied to the scroll view content container which wraps all of the child views.
-
-推荐使用：
-- `flexGrow: 1` - 让内容至少填充容器
-- `paddingBottom` - 内容底部间距
-- `alignItems` - 内容对齐方式
-
-## 注意事项
-
-1. **不要在 contentContainerStyle 中使用 `flex: 1`**
-   - 会导致滚动行为异常
-   - 在 Web 上可能引起布局问题
-
-2. **保持 style 中的 `flex: 1`**
-   - ScrollView 本身需要 `flex: 1` 来占据可用空间
-   - 这是在 `middleSection` 样式中定义的
-
-3. **Web 平台兼容性**
-   - 使用 `flexGrow: 1` 在 Web 和原生平台都能正常工作
-   - 确保跨平台一致性
-
-## 相关资源
-
-- [React Native ScrollView 文档](https://reactnative.dev/docs/scrollview)
-- [Flexbox 布局指南](https://css-tricks.com/snippets/css/a-guide-to-flexbox/)
-- [React Native 布局最佳实践](https://reactnative.dev/docs/flexbox)
-
-## 版本历史
-
-- **v1.4.18**: 修复 ScrollView 内容容器布局，使用 `flexGrow: 1`

package/package/module/Icons/README.md

@@ -1,182 +0,0 @@
-# TapasIcon
-
-优雅的图标组件，支持自定义字体图标。
-
-## 特性
-
-- 🎨 **自动字体加载检测** - 智能检测字体是否可用
-- 🔄 **优雅的降级处理** - 字体不可用时显示备用图标
-- 📱 **跨平台兼容** - 支持React Native和Web环境
-- 🎯 **完整的TypeScript支持** - 完整的类型定义
-- 🎨 **主题集成** - 与@rneui/themed完美集成
-- 🚀 **高性能** - 使用useMemo优化渲染性能
-
-## 安装
-
-```bash
-yarn add @beppla/tapas-ui
-```
-
-## 使用方法
-
-### 基本使用
-
-```tsx
-import { TapasIcon } from '@beppla/tapas-ui';
-
-// 基本图标
-<TapasIcon name="home" />
-
-// 自定义大小和颜色
-<TapasIcon name="settings" size={32} color="#007AFF" />
-
-// 带点击事件
-<TapasIcon name="heart" onPress={() => console.log('喜欢')} />
-
-// 禁用状态
-<TapasIcon name="delete" disabled />
-```
-
-### 图标名称
-
-组件支持以下图标名称：
-
-#### 导航类
-- `home` - 首页
-- `back` - 返回
-- `forward` - 前进
-- `menu` - 菜单
-
-#### 功能类
-- `search` - 搜索
-- `settings` - 设置
-- `add` - 添加
-- `edit` - 编辑
-- `delete` - 删除
-- `close` - 关闭
-- `check` - 确认
-
-#### 状态类
-- `loading` - 加载中
-- `error` - 错误
-- `warning` - 警告
-- `info` - 信息
-
-#### 业务类
-- `user` - 用户
-- `store` - 商店
-- `warehouse` - 仓库
-- `shipping` - 物流
-- `order` - 订单
-
-## API
-
-### Props
-
-| 属性 | 类型 | 默认值 | 描述 |
-|------|------|--------|------|
-| `name` | `string` | - | 图标名称（必需） |
-| `size` | `number` | `24` | 图标大小 |
-| `color` | `string` | `#000` | 图标颜色 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `style` | `StyleProp<TextStyle>` | - | 自定义样式 |
-| `onPress` | `() => void` | - | 点击事件 |
-
-### 继承的属性
-
-组件继承了 `@rneui/themed` 的 `IconProps` 类型，支持所有标准的图标属性。
-
-## 字体加载
-
-组件会自动检测字体是否可用：
-
-1. **Web环境**：使用 `document.fonts.check()` 检测字体加载状态
-2. **原生环境**：假设字体已可用
-3. **降级处理**：字体不可用时显示备用图标
-
-### 字体文件
-
-确保以下文件存在于正确位置：
-
-```
-assets/
-  fonts/
-    customfont.ttf    # 字体文件
-components/
-  Icons/
-    real-icon-mapping.json  # 图标映射
-```
-
-## 备用图标
-
-当字体不可用或图标不存在时，组件会显示备用图标：
-
-- 使用Unicode字符作为备用
-- 支持表情符号作为备用
-- 提供默认的"❓"图标
-
-## 主题集成
-
-组件与 `@rneui/themed` 完美集成：
-
-```tsx
-import { useTheme } from '@rneui/themed';
-
-const MyComponent = () => {
-  const { theme } = useTheme();
-  
-  return (
-    <TapasIcon 
-      name="home" 
-      color={theme.colors.primary}
-      size={theme.spacing.lg}
-    />
-  );
-};
-```
-
-## 性能优化
-
-- 使用 `useMemo` 缓存图标信息
-- 字体检测结果缓存
-- 避免不必要的重新渲染
-
-## 浏览器兼容性
-
-- ✅ Chrome 60+
-- ✅ Firefox 55+
-- ✅ Safari 11+
-- ✅ Edge 79+
-
-## 故障排除
-
-### 图标不显示
-
-1. 检查字体文件是否存在
-2. 确认字体路径配置正确
-3. 查看浏览器控制台错误信息
-
-### 字体加载失败
-
-1. 检查网络请求是否成功
-2. 确认字体文件格式正确
-3. 验证CORS配置
-
-### 备用图标显示
-
-这是正常行为，表示：
-- 字体正在加载中
-- 字体加载失败
-- 图标名称不存在
-
-## 示例
-
-查看 [Storybook 故事](../../stories/Icons/TapasIcon.stories.tsx) 获取更多使用示例。
-
-## 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 许可证
-
-MIT License

package/package/module/Icons/icon-categories.json

@@ -1,341 +0,0 @@
-{
-  "navigation": [
-    "back",
-    "restaurant_menu",
-    "home",
-    "back1",
-    "drawer_close",
-    "backspace",
-    "close",
-    "chevron_left",
-    "chevron_right",
-    "history-menu",
-    "history_menu"
-  ],
-  "business": [
-    "seafood",
-    "ingredients",
-    "warehouse-2",
-    "warehouse-1",
-    "shippings-outlined",
-    "order_approve_outlined",
-    "order_under_review",
-    "shippings",
-    "store-1",
-    "store",
-    "order_approve",
-    "ordering",
-    "order_list"
-  ],
-  "action": [
-    "add-ons",
-    "refresh1",
-    "add_photo",
-    "post_add",
-    "edit",
-    "upload",
-    "download",
-    "delete",
-    "add",
-    "credit_card",
-    "library_add",
-    "refresh"
-  ],
-  "status": [
-    "pause_circle",
-    "play_circle",
-    "warning_filled",
-    "error_filled",
-    "check_circle_filled",
-    "warning",
-    "error",
-    "check_circle",
-    "check",
-    "radio_button_unchecked",
-    "radio_button_checked",
-    "indeterminate_check_box",
-    "check_box_outline_blank",
-    "check_box",
-    "active_pause",
-    "pause"
-  ],
-  "function": [
-    "settings-app",
-    "filter",
-    "data_info_alert",
-    "sort",
-    "help_outlined",
-    "help_filled",
-    "search",
-    "settings"
-  ],
-  "food": [
-    "seafood",
-    "restaurant_menu",
-    "beer",
-    "pizza",
-    "wine",
-    "cake",
-    "fastfood"
-  ],
-  "other": [
-    "victuals",
-    "toast",
-    "milk",
-    "pie",
-    "stocktaking",
-    "link",
-    "list-view",
-    "grid-view",
-    "stop_record",
-    "calculator",
-    "campaign",
-    "ad",
-    "factories",
-    "shelf-life",
-    "source",
-    "cloud_sync",
-    "broken_image",
-    "package",
-    "bills",
-    "e-ship-platform",
-    "e-shop",
-    "award_filled",
-    "qr_code_scan",
-    "card_gear",
-    "archive",
-    "loyalty",
-    "award_outlined",
-    "event",
-    "schedule",
-    "percent",
-    "product_items",
-    "general-circle",
-    "drag_handle",
-    "groups",
-    "table_chart",
-    "apps",
-    "product-chart",
-    "language",
-    "emoticon_down",
-    "emoticon_up",
-    "analytics",
-    "receipt_long",
-    "disabled",
-    "person",
-    "card_membership",
-    "person_off",
-    "card_off",
-    "priority_high",
-    "hourglass_bottom",
-    "notifications",
-    "notification_importan",
-    "more_vert",
-    "settlement",
-    "pos_terminal",
-    "apple",
-    "payments",
-    "ontime",
-    "drawer_open",
-    "remove",
-    "shopping_cart-1",
-    "celebration",
-    "expand_circle_left",
-    "expand_circle_right",
-    "diversity",
-    "visibility_off",
-    "visibility",
-    "expand_less",
-    "expand_more",
-    "star_outline",
-    "star_filled",
-    "new_releases",
-    "handyman",
-    "clear-all",
-    "description",
-    "instant",
-    "cash",
-    "category",
-    "event_seat",
-    "sensor_window",
-    "arrow_drop_up",
-    "arrow_drop_down",
-    "location-pin",
-    "shopping_cart",
-    "more_horiz",
-    "admin_panel",
-    "currency",
-    "facebook",
-    "x",
-    "threads",
-    "linkedin",
-    "instagram",
-    "youtube",
-    "mustard1",
-    "peanuts1",
-    "lupin1",
-    "ice-cream",
-    "juice",
-    "cocktails",
-    "mian-course",
-    "snacks",
-    "loaf-of-bread",
-    "bakery_dining",
-    "set_meal",
-    "coffee_tea",
-    "unknown",
-    "cold",
-    "hot",
-    "heavy-fog",
-    "extreme-heavy-fog",
-    "severe-haze",
-    "heavy-haze",
-    "moderate-haze",
-    "strong-fog",
-    "dense-fog",
-    "sandstorm",
-    "dust-storm",
-    "dust",
-    "sand",
-    "haze",
-    "foggy",
-    "mist",
-    "snow",
-    "snow-flurry-night",
-    "shower-snow-night",
-    "heavy-snowstorm",
-    "moderate-heavy-snow",
-    "light-moderate-snow",
-    "shower-flurry",
-    "shower-snow",
-    "rain-snow",
-    "sleet",
-    "snowstorm",
-    "moderate-snow",
-    "light-snow",
-    "rain",
-    "outline-heavy-shower-rain-night",
-    "heavy-snow",
-    "shower-rain-night",
-    "heavy-severe-storm",
-    "storm-heavy-storm",
-    "heavy-rain-storm",
-    "moderate-heavy-rain",
-    "light-moderate-rain-1",
-    "freezing-rain",
-    "severe-storm",
-    "heavy-storm",
-    "storm",
-    "drizzle-rain",
-    "extreme-rain",
-    "heavy-rain",
-    "moderate-rain",
-    "light-rain-1",
-    "heavy-thundershower-with-hail",
-    "heavy-thunderstorm",
-    "thundershower",
-    "heavy-shower-rain",
-    "shower-rain",
-    "partly-cloudy-night",
-    "few-clouds-night",
-    "cloudy-night",
-    "clear-night",
-    "overcast",
-    "partly-cloudy",
-    "few-clouds",
-    "cloudy",
-    "sunny",
-    "outline-unknown",
-    "outline-cold",
-    "outline-hot",
-    "outline-extreme-heavy-fog",
-    "outline-heavy-fog",
-    "outline-heavy-haze",
-    "outline-severe-haze",
-    "outline-moderate-haze",
-    "outline-strong-fog",
-    "outline-sandstorm",
-    "outline-dense-fog",
-    "outline-dust",
-    "outline-dust-storm",
-    "outline-sand",
-    "outline-haze",
-    "outline-mist",
-    "outline-foggy",
-    "snow1",
-    "left_arrow",
-    "uniE901",
-    "uniE902",
-    "ai",
-    "send",
-    "eggs",
-    "celery",
-    "fish",
-    "lactose",
-    "lupin",
-    "mollusc",
-    "mustard",
-    "nuts",
-    "peanuts",
-    "sesame",
-    "so2",
-    "soy",
-    "gluten",
-    "crustacean",
-    "outline-snow-flurry-night",
-    "outline-shower-snow-night",
-    "outline-heavy-snowstorm",
-    "outline-moderate-heavy-snow",
-    "outline-light-moderate-snow",
-    "outline-shower-flurry",
-    "outline-shower-snow",
-    "outline-rain-snow",
-    "outline-sleet",
-    "outline-snowstorm",
-    "outline-heavy-snow",
-    "outline-moderate-snow",
-    "outline-rain",
-    "heavy-shower-rain-night",
-    "outline-light-snow",
-    "outline-heavy-severe-storm",
-    "outline-shower-rain-night",
-    "outline-storm-heavy-storm",
-    "outline-heavy-rain-storm",
-    "outline-moderate-heavy-rain",
-    "light-moderate-rain",
-    "outline-freezing-rain",
-    "outline-severe-storm",
-    "outline-heavey-storm",
-    "outline-storm",
-    "outline-drizzle-rain",
-    "extreme-rain-1",
-    "outline-heavy-rain",
-    "outline-moderate-rain",
-    "light-rain",
-    "outline-heavy-thundershower-with-hail",
-    "outline-heavy-thunderstorm",
-    "outline-extreme-rain",
-    "outline-heavy-shower-rain-1",
-    "outline-partly-cloudy-night",
-    "outline-cloudy-night",
-    "outline-clear-night",
-    "outline-overcast",
-    "outline-partly-cloudy",
-    "outline-few-clouds",
-    "outline-heavy-shower-rain",
-    "outline-cloudy",
-    "outline-sunny",
-    "outline-few-clouds-night",
-    "contract",
-    "request",
-    "supplier",
-    "task_approval",
-    "task",
-    "group",
-    "procurement",
-    "voucher",
-    "chat",
-    "duplicate",
-    "vector"
-  ]
-}