@beppla/tapas-ui 1.4.14 → 1.4.15

package/package/module/Icons/README.md

@@ -0,0 +1,182 @@
+# 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

@@ -0,0 +1,341 @@
+{
+  "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"
+  ]
+}