wechat-emojis 1.0.2 → 2.0.0

package/docs/NPM_USAGE.md

@@ -0,0 +1,223 @@
+# 微信表情包 NPM 包使用指南
+
+### 1. 安装包
+
+```bash
+npm install wechat-emojis
+```
+
+### 2. 在 React 项目中使用
+
+#### 基础导入
+
+```typescript
+import {
+  getEmojiPath,
+  getEmojisByCategory,
+  EmojiCategory,
+  searchEmojis,
+  getRandomEmoji,
+  type EmojiName
+} from 'wechat-emojis';
+```
+
+#### 创建表情组件
+
+```tsx
+// components/WeChatEmoji.tsx
+import React from 'react';
+import { getEmojiPath, type EmojiName } from 'wechat-emojis';
+
+interface WeChatEmojiProps {
+  name: EmojiName;
+  size?: number;
+  className?: string;
+}
+
+const WeChatEmoji: React.FC<WeChatEmojiProps> = ({
+  name,
+  size = 24,
+  className = ''
+}) => {
+  const emojiPath = getEmojiPath(name);
+
+  if (!emojiPath) {
+    return null;
+  }
+
+  return (
+    <img
+      src={emojiPath}
+      alt={name}
+      width={size}
+      height={size}
+      className={`wechat-emoji ${className}`}
+    />
+  );
+};
+
+export default WeChatEmoji;
+```
+
+#### 使用示例
+
+```tsx
+// App.tsx
+import React from 'react';
+import WeChatEmoji from './components/WeChatEmoji';
+import { getEmojisByCategory, EmojiCategory } from 'wechat-emojis';
+
+function App() {
+  const faceEmojis = getEmojisByCategory(EmojiCategory.FACE);
+
+  return (
+    <div>
+      <h1>微信表情包示例</h1>
+
+      {/* 单个表情 */}
+      <WeChatEmoji name="微笑" size={32} />
+      <WeChatEmoji name="大哭" size={32} />
+
+      {/* 表情列表 */}
+      <div>
+        {faceEmojis.slice(0, 10).map(emoji => (
+          <WeChatEmoji key={emoji} name={emoji} size={24} />
+        ))}
+      </div>
+    </div>
+  );
+}
+
+export default App;
+```
+
+### 3. 处理静态资源
+
+由于表情图片是静态资源，你需要将它们复制到项目的 public 目录：
+
+#### 方法一：手动复制
+
+```bash
+# 创建资源目录
+mkdir -p public/assets
+
+# 复制资源文件
+cp -r node_modules/wechat-emojis/assets/* public/assets/
+```
+
+#### 方法二：使用构建脚本
+
+在你的 `package.json` 中添加：
+
+```json
+{
+  "scripts": {
+    "postinstall": "mkdir -p public/assets && cp -r node_modules/wechat-emojis/assets/* public/assets/",
+    "build": "npm run copy-assets && react-scripts build",
+    "copy-assets": "mkdir -p public/assets && cp -r node_modules/wechat-emojis/assets/* public/assets/"
+  }
+}
+```
+
+#### 方法三：使用 webpack 配置
+
+如果你使用自定义 webpack 配置，可以添加：
+
+```javascript
+// webpack.config.js
+const CopyPlugin = require('copy-webpack-plugin');
+
+module.exports = {
+  plugins: [
+    new CopyPlugin({
+      patterns: [
+        {
+          from: 'node_modules/wechat-emojis/assets',
+          to: 'assets'
+        }
+      ]
+    })
+  ]
+};
+```
+
+## 🔧 TypeScript 支持
+
+包已包含完整的 TypeScript 类型定义，你可以享受完整的类型检查和智能提示：
+
+```typescript
+import { EmojiName, EmojiCategory } from 'wechat-emojis';
+
+// 类型安全的表情名称
+const emojiName: EmojiName = '微笑'; // ✅ 正确
+const invalidName: EmojiName = '不存在的表情'; // ❌ TypeScript 错误
+
+// 枚举类型
+const category: EmojiCategory = EmojiCategory.FACE;
+```
+
+## 📱 在其他框架中使用
+
+### Vue.js
+
+```vue
+<template>
+  <div>
+    <img :src="getEmojiPath('微笑')" alt="微笑" width="24" height="24" />
+  </div>
+</template>
+
+<script>
+import { getEmojiPath } from 'wechat-emojis';
+
+export default {
+  methods: {
+    getEmojiPath
+  }
+};
+</script>
+```
+
+### Angular
+
+```typescript
+// emoji.service.ts
+import { Injectable } from '@angular/core';
+import { getEmojiPath, getEmojisByCategory, EmojiCategory } from 'wechat-emojis';
+
+@Injectable({
+  providedIn: 'root'
+})
+export class EmojiService {
+  getEmojiPath = getEmojiPath;
+  getEmojisByCategory = getEmojisByCategory;
+  EmojiCategory = EmojiCategory;
+}
+```
+
+```html
+<!-- emoji.component.html -->
+<img [src]="emojiService.getEmojiPath('微笑')" alt="微笑" width="24" height="24">
+```
+
+## 🎯 最佳实践
+
+1. **预加载常用表情**：在应用启动时预加载常用表情图片
+2. **懒加载**：对于大量表情，考虑使用懒加载
+3. **缓存**：利用浏览器缓存机制，避免重复加载
+4. **错误处理**：始终检查 `getEmojiPath` 的返回值
+5. **性能优化**：使用 `React.memo` 或类似优化手段避免不必要的重渲染
+
+## 🐛 常见问题
+
+### Q: 表情图片显示不出来？
+
+A: 确保已将 assets 目录复制到项目的 public 目录中。
+
+### Q: TypeScript 类型错误？
+
+A: 确保安装了最新版本的包，并重启 TypeScript 服务。
+
+### Q: 如何自定义表情路径？
+
+A: 你可以修改返回的路径，或者将图片复制到自定义目录。

package/{REACT_USAGE.md → docs/REACT_USAGE.md}

@@ -58,16 +58,15 @@ const WeChatEmoji: React.FC<{name: EmojiName}> = ({ name }) => {
 mkdir -p src/utils/wechat-emojis
 mkdir -p public/assets
 
-# 复制TypeScript模块
-cp path/to/wechatEmoji.ts src/utils/wechat-emojis/
-cp path/to/wechatEmoji.js src/utils/wechat-emojis/
+# 复制构建产物（npm 包内不含 src/，克隆仓库时可用 path/to/dist/index.js）
+cp path/to/dist/index.js src/utils/wechat-emojis/
 
 # 复制表情资源到public目录
 cp -r path/to/assets/* public/assets/
 ```
 
 2. **调整图片路径**（重要）：
-由于React项目中public目录的资源访问方式，需要修改 `wechatEmoji.ts` 中的图片路径，将所有 `'assets/'` 替换为 `'/assets/'`。
+由于React项目中public目录的资源访问方式，需要修改复制过去的 `dist/index.js` 中的图片路径，将所有 `'assets/'` 替换为 `'/assets/'`。使用 npm 包时无需修改，包内的路径是 `assets/...`，直接拼到 `/` 后面即可（如上面的 `/${emojiPath}`）。
 
 
 ## 🚀 基础使用

package/package.json

@@ -1,23 +1,29 @@
 {
   "name": "wechat-emojis",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "完整的微信内置表情资源库，包含 109 个高清 PNG 图片和类型安全的 TypeScript API",
-  "main": "wechatEmoji.js",
-  "types": "wechatEmoji.d.ts",
-  "module": "wechatEmoji.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
-    "wechatEmoji.js",
-    "wechatEmoji.ts",
-    "wechatEmoji.d.ts",
-    "assets/**/*",
-    "README.md",
-    "API.md",
-    "REACT_USAGE.md"
+    "dist/index.js",
+    "dist/index.d.ts",
+    "assets/**/*.png",
+    "docs/API.md",
+    "docs/NPM_USAGE.md",
+    "docs/REACT_USAGE.md",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "typecheck": "tsc --noEmit",
+    "typecheck:scripts": "tsc -p tsconfig.scripts.json",
+    "verify:assets": "node scripts/verify-assets.ts",
+    "typecheck:examples": "tsc --noEmit --target es2017 --module commonjs --moduleResolution node --strict examples/typescript/example.ts",
+    "test": "npm run build && npm run typecheck:scripts && npm run typecheck:examples && npm run verify:assets && npm run check:package",
+    "build:site": "node scripts/build-site.ts",
+    "check:site": "node scripts/check-site.ts",
+    "check:package": "node scripts/check-package.ts",
+    "prepare": "node scripts/prepare.ts"
   },
   "keywords": [
     "wechat",
@@ -39,8 +45,10 @@
   "bugs": {
     "url": "https://github.com/xxk8/wechat-emojis/issues"
   },
-  "homepage": "https://github.com/xxk8/wechat-emojis#readme",
+  "homepage": "https://xxk8.github.io/wechat-emojis/",
   "devDependencies": {
+    "@types/node": "^22.20.5",
+    "esbuild": "^0.28.2",
     "typescript": "^5.9.2"
   },
   "engines": {

package/wechatEmoji.ts

@@ -1,364 +0,0 @@
-/**
- * 微信表情包 TypeScript 模块
- * 提供类型安全的表情访问和图片路径获取功能
- */
-
-/**
- * 表情类别枚举
- */
-export enum EmojiCategory {
-  /** 人脸表情 */
-  FACE = 'face',
-  /** 手势表情 */
-  GESTURE = 'gesture',
-  /** 动物表情 */
-  ANIMAL = 'animal',
-  /** 祝福表情 */
-  BLESSING = 'blessing',
-  /** 其他表情 */
-  OTHER = 'other'
-}
-
-/**
- * 表情信息接口
- */
-export interface EmojiInfo {
-  /** 表情名称 */
-  name: string;
-  /** 表情类别 */
-  category: EmojiCategory;
-  /** 图片文件路径 */
-  path: string;
-  /** 英文名称（可选） */
-  englishName?: string;
-}
-
-/**
- * 表情名称类型
- */
-export type EmojiName =
-  // 人脸表情
-  | '微笑' | '撇嘴' | '色' | '发呆' | '得意' | '流泪' | '害羞' | '闭嘴' | '睡' | '大哭'
-  | '尴尬' | '发怒' | '调皮' | '呲牙' | '惊讶' | '难过' | '囧' | '抓狂' | '吐' | '偷笑'
-  | '愉快' | '白眼' | '傲慢' | '困' | '惊恐' | '憨笑' | '悠闲' | '咒骂' | '疑问' | '嘘'
-  | '晕' | '衰' | '骷髅' | '敲打' | '再见' | '擦汗' | '抠鼻' | '鼓掌' | '坏笑' | '右哼哼'
-  | '鄙视' | '委屈' | '快哭了' | '阴险' | '亲亲' | '可怜' | '笑脸' | '生病' | '脸红' | '破涕为笑'
-  | '恐惧' | '失望' | '无语' | '嘿哈' | '捂脸' | '机智' | '皱眉' | '耶' | '吃瓜'
-  | '加油' | '汗' | '天啊' | 'Emm' | '社会社会' | '旺柴' | '好的' | '打脸' | '哇' | '翻白眼'
-  | '666' | '让我看看' | '叹气' | '苦涩' | '裂开' | '奸笑'
-  // 手势表情
-  | '握手' | '胜利' | '抱拳' | '勾引' | '拳头' | 'OK' | '合十' | '强' | '拥抱' | '弱'
-  // 动物表情
-  | '猪头' | '跳跳' | '发抖' | '转圈'
-  // 祝福表情
-  | '庆祝' | '礼物' | '红包' | '發' | '福' | '烟花' | '爆竹'
-  // 其他表情
-  | '嘴唇' | '爱心' | '心碎' | '啤酒' | '咖啡' | '蛋糕' | '凋谢' | '菜刀' | '炸弹' | '便便' | '太阳'
-  | '月亮' | '玫瑰';
-
-/**
- * 表情数据映射
- * 将表情名称映射到完整的表情信息
- */
-const EMOJI_DATA: Record<EmojiName, EmojiInfo> = {
-  // 人脸表情
-  '微笑': { name: '微笑', category: EmojiCategory.FACE, path: 'assets/face/微笑.png' },
-  '撇嘴': { name: '撇嘴', category: EmojiCategory.FACE, path: 'assets/face/撇嘴.png' },
-  '色': { name: '色', category: EmojiCategory.FACE, path: 'assets/face/色.png' },
-  '发呆': { name: '发呆', category: EmojiCategory.FACE, path: 'assets/face/发呆.png' },
-  '得意': { name: '得意', category: EmojiCategory.FACE, path: 'assets/face/得意.png' },
-  '流泪': { name: '流泪', category: EmojiCategory.FACE, path: 'assets/face/流泪.png' },
-  '害羞': { name: '害羞', category: EmojiCategory.FACE, path: 'assets/face/害羞.png' },
-  '闭嘴': { name: '闭嘴', category: EmojiCategory.FACE, path: 'assets/face/闭嘴.png' },
-  '睡': { name: '睡', category: EmojiCategory.FACE, path: 'assets/face/睡.png' },
-  '大哭': { name: '大哭', category: EmojiCategory.FACE, path: 'assets/face/大哭.png' },
-  '尴尬': { name: '尴尬', category: EmojiCategory.FACE, path: 'assets/face/尴尬.png' },
-  '发怒': { name: '发怒', category: EmojiCategory.FACE, path: 'assets/face/发怒.png' },
-  '调皮': { name: '调皮', category: EmojiCategory.FACE, path: 'assets/face/调皮.png' },
-  '呲牙': { name: '呲牙', category: EmojiCategory.FACE, path: 'assets/face/呲牙.png' },
-  '惊讶': { name: '惊讶', category: EmojiCategory.FACE, path: 'assets/face/惊讶.png' },
-  '难过': { name: '难过', category: EmojiCategory.FACE, path: 'assets/face/难过.png' },
-  '囧': { name: '囧', category: EmojiCategory.FACE, path: 'assets/face/囧.png' },
-  '抓狂': { name: '抓狂', category: EmojiCategory.FACE, path: 'assets/face/抓狂.png' },
-  '吐': { name: '吐', category: EmojiCategory.FACE, path: 'assets/face/吐.png' },
-  '偷笑': { name: '偷笑', category: EmojiCategory.FACE, path: 'assets/face/偷笑.png' },
-  '愉快': { name: '愉快', category: EmojiCategory.FACE, path: 'assets/face/愉快.png' },
-  '白眼': { name: '白眼', category: EmojiCategory.FACE, path: 'assets/face/白眼.png' },
-  '傲慢': { name: '傲慢', category: EmojiCategory.FACE, path: 'assets/face/傲慢.png' },
-  '困': { name: '困', category: EmojiCategory.FACE, path: 'assets/face/困.png' },
-  '惊恐': { name: '惊恐', category: EmojiCategory.FACE, path: 'assets/face/惊恐.png' },
-  '憨笑': { name: '憨笑', category: EmojiCategory.FACE, path: 'assets/face/憨笑.png' },
-  '悠闲': { name: '悠闲', category: EmojiCategory.FACE, path: 'assets/face/悠闲.png' },
-  '咒骂': { name: '咒骂', category: EmojiCategory.FACE, path: 'assets/face/咒骂.png' },
-  '疑问': { name: '疑问', category: EmojiCategory.FACE, path: 'assets/face/疑问.png' },
-  '嘘': { name: '嘘', category: EmojiCategory.FACE, path: 'assets/face/嘘.png' },
-  '晕': { name: '晕', category: EmojiCategory.FACE, path: 'assets/face/晕.png' },
-  '衰': { name: '衰', category: EmojiCategory.FACE, path: 'assets/face/衰.png' },
-  '骷髅': { name: '骷髅', category: EmojiCategory.FACE, path: 'assets/face/骷髅.png' },
-  '敲打': { name: '敲打', category: EmojiCategory.FACE, path: 'assets/face/敲打.png' },
-  '再见': { name: '再见', category: EmojiCategory.FACE, path: 'assets/face/再见.png' },
-  '擦汗': { name: '擦汗', category: EmojiCategory.FACE, path: 'assets/face/擦汗.png' },
-  '抠鼻': { name: '抠鼻', category: EmojiCategory.FACE, path: 'assets/face/抠鼻.png' },
-  '鼓掌': { name: '鼓掌', category: EmojiCategory.FACE, path: 'assets/face/鼓掌.png' },
-  '坏笑': { name: '坏笑', category: EmojiCategory.FACE, path: 'assets/face/坏笑.png' },
-  '右哼哼': { name: '右哼哼', category: EmojiCategory.FACE, path: 'assets/face/右哼哼.png' },
-  '鄙视': { name: '鄙视', category: EmojiCategory.FACE, path: 'assets/face/鄙视.png' },
-  '委屈': { name: '委屈', category: EmojiCategory.FACE, path: 'assets/face/委屈.png' },
-  '快哭了': { name: '快哭了', category: EmojiCategory.FACE, path: 'assets/face/快哭了.png' },
-  '阴险': { name: '阴险', category: EmojiCategory.FACE, path: 'assets/face/阴险.png' },
-  '亲亲': { name: '亲亲', category: EmojiCategory.FACE, path: 'assets/face/亲亲.png' },
-  '可怜': { name: '可怜', category: EmojiCategory.FACE, path: 'assets/face/可怜.png' },
-  '笑脸': { name: '笑脸', category: EmojiCategory.FACE, path: 'assets/face/笑脸.png' },
-  '生病': { name: '生病', category: EmojiCategory.FACE, path: 'assets/face/生病.png' },
-  '脸红': { name: '脸红', category: EmojiCategory.FACE, path: 'assets/face/脸红.png' },
-  '破涕为笑': { name: '破涕为笑', category: EmojiCategory.FACE, path: 'assets/face/破涕为笑.png' },
-  '恐惧': { name: '恐惧', category: EmojiCategory.FACE, path: 'assets/face/恐惧.png' },
-  '失望': { name: '失望', category: EmojiCategory.FACE, path: 'assets/face/失望.png' },
-  '无语': { name: '无语', category: EmojiCategory.FACE, path: 'assets/face/无语.png' },
-  '嘿哈': { name: '嘿哈', category: EmojiCategory.FACE, path: 'assets/face/嘿哈.png' },
-  '捂脸': { name: '捂脸', category: EmojiCategory.FACE, path: 'assets/face/捂脸.png' },
-  '机智': { name: '机智', category: EmojiCategory.FACE, path: 'assets/face/机智.png' },
-  '皱眉': { name: '皱眉', category: EmojiCategory.FACE, path: 'assets/face/皱眉.png' },
-  '耶': { name: '耶', category: EmojiCategory.FACE, path: 'assets/face/耶.png' },
-  '吃瓜': { name: '吃瓜', category: EmojiCategory.FACE, path: 'assets/face/吃瓜.png' },
-  '加油': { name: '加油', category: EmojiCategory.FACE, path: 'assets/face/加油.png' },
-
-  '汗': { name: '汗', category: EmojiCategory.FACE, path: 'assets/face/汗.png' },
-  '天啊': { name: '天啊', category: EmojiCategory.FACE, path: 'assets/face/天啊.png' },
-  'Emm': { name: 'Emm', category: EmojiCategory.FACE, path: 'assets/face/Emm.png' },
-  '社会社会': { name: '社会社会', category: EmojiCategory.FACE, path: 'assets/face/社会社会.png' },
-  '旺柴': { name: '旺柴', category: EmojiCategory.FACE, path: 'assets/face/旺柴.png' },
-  '好的': { name: '好的', category: EmojiCategory.FACE, path: 'assets/face/好的.png' },
-  '打脸': { name: '打脸', category: EmojiCategory.FACE, path: 'assets/face/打脸.png' },
-  '哇': { name: '哇', category: EmojiCategory.FACE, path: 'assets/face/哇.png' },
-  '翻白眼': { name: '翻白眼', category: EmojiCategory.FACE, path: 'assets/face/翻白眼.png' },
-  '666': { name: '666', category: EmojiCategory.FACE, path: 'assets/face/666.png' },
-  '让我看看': { name: '让我看看', category: EmojiCategory.FACE, path: 'assets/face/让我看看.png' },
-  '叹气': { name: '叹气', category: EmojiCategory.FACE, path: 'assets/face/叹气.png' },
-  '苦涩': { name: '苦涩', category: EmojiCategory.FACE, path: 'assets/face/苦涩.png' },
-  '裂开': { name: '裂开', category: EmojiCategory.FACE, path: 'assets/face/裂开.png' },
-  '奸笑': { name: '奸笑', category: EmojiCategory.FACE, path: 'assets/face/奸笑.png' },
-
-  // 手势表情
-  '握手': { name: '握手', category: EmojiCategory.GESTURE, path: 'assets/gesture/握手.png' },
-  '胜利': { name: '胜利', category: EmojiCategory.GESTURE, path: 'assets/gesture/胜利.png' },
-  '抱拳': { name: '抱拳', category: EmojiCategory.GESTURE, path: 'assets/gesture/抱拳.png' },
-  '勾引': { name: '勾引', category: EmojiCategory.GESTURE, path: 'assets/gesture/勾引.png' },
-  '拳头': { name: '拳头', category: EmojiCategory.GESTURE, path: 'assets/gesture/拳头.png' },
-  'OK': { name: 'OK', category: EmojiCategory.GESTURE, path: 'assets/gesture/OK.png' },
-  '合十': { name: '合十', category: EmojiCategory.GESTURE, path: 'assets/gesture/合十.png' },
-  '强': { name: '强', category: EmojiCategory.GESTURE, path: 'assets/gesture/强.png' },
-  '拥抱': { name: '拥抱', category: EmojiCategory.GESTURE, path: 'assets/gesture/拥抱.png' },
-  '弱': { name: '弱', category: EmojiCategory.GESTURE, path: 'assets/gesture/弱.png' },
-
-
-  // 动物表情
-  '猪头': { name: '猪头', category: EmojiCategory.ANIMAL, path: 'assets/animal/猪头.png' },
-  '跳跳': { name: '跳跳', category: EmojiCategory.ANIMAL, path: 'assets/animal/跳跳.png' },
-  '发抖': { name: '发抖', category: EmojiCategory.ANIMAL, path: 'assets/animal/发抖.png' },
-  '转圈': { name: '转圈', category: EmojiCategory.ANIMAL, path: 'assets/animal/转圈.png' },
-
-  // 祝福表情
-  '庆祝': { name: '庆祝', category: EmojiCategory.BLESSING, path: 'assets/blessing/庆祝.png' },
-  '礼物': { name: '礼物', category: EmojiCategory.BLESSING, path: 'assets/blessing/礼物.png' },
-  '红包': { name: '红包', category: EmojiCategory.BLESSING, path: 'assets/blessing/红包.png' },
-  '發': { name: '發', category: EmojiCategory.BLESSING, path: 'assets/blessing/發.png' },
-  '福': { name: '福', category: EmojiCategory.BLESSING, path: 'assets/blessing/福.png' },
-  '烟花': { name: '烟花', category: EmojiCategory.BLESSING, path: 'assets/blessing/烟花.png' },
-  '爆竹': { name: '爆竹', category: EmojiCategory.BLESSING, path: 'assets/blessing/爆竹.png' },
-
-  // 其他表情
-  '嘴唇': { name: '嘴唇', category: EmojiCategory.OTHER, path: 'assets/other/嘴唇.png' },
-  '爱心': { name: '爱心', category: EmojiCategory.OTHER, path: 'assets/other/爱心.png' },
-  '心碎': { name: '心碎', category: EmojiCategory.OTHER, path: 'assets/other/心碎.png' },
-  '啤酒': { name: '啤酒', category: EmojiCategory.OTHER, path: 'assets/other/啤酒.png' },
-  '咖啡': { name: '咖啡', category: EmojiCategory.OTHER, path: 'assets/other/咖啡.png' },
-  '蛋糕': { name: '蛋糕', category: EmojiCategory.OTHER, path: 'assets/other/蛋糕.png' },
-  '凋谢': { name: '凋谢', category: EmojiCategory.OTHER, path: 'assets/other/凋谢.png' },
-  '菜刀': { name: '菜刀', category: EmojiCategory.OTHER, path: 'assets/other/菜刀.png' },
-  '炸弹': { name: '炸弹', category: EmojiCategory.OTHER, path: 'assets/other/炸弹.png' },
-  '便便': { name: '便便', category: EmojiCategory.OTHER, path: 'assets/other/便便.png' },
-  '太阳': { name: '太阳', category: EmojiCategory.OTHER, path: 'assets/other/太阳.png' },
-  '月亮': { name: '月亮', category: EmojiCategory.OTHER, path: 'assets/other/月亮.png' },
-  '玫瑰': { name: '玫瑰', category: EmojiCategory.OTHER, path: 'assets/other/玫瑰.png' }
-};
-
-/**
- * 获取所有表情数据的辅助函数
- */
-function getAllEmojiData(): EmojiInfo[] {
-  const result: EmojiInfo[] = [];
-  for (const key in EMOJI_DATA) {
-    if (EMOJI_DATA.hasOwnProperty(key)) {
-      result.push(EMOJI_DATA[key as EmojiName]);
-    }
-  }
-  return result;
-}
-
-/**
- * 按类别分组的表情数据
- */
-export const EMOJI_CATEGORIES = {
-  [EmojiCategory.FACE]: getAllEmojiData().filter(emoji => emoji.category === EmojiCategory.FACE),
-  [EmojiCategory.GESTURE]: getAllEmojiData().filter(emoji => emoji.category === EmojiCategory.GESTURE),
-  [EmojiCategory.ANIMAL]: getAllEmojiData().filter(emoji => emoji.category === EmojiCategory.ANIMAL),
-  [EmojiCategory.BLESSING]: getAllEmojiData().filter(emoji => emoji.category === EmojiCategory.BLESSING),
-  [EmojiCategory.OTHER]: getAllEmojiData().filter(emoji => emoji.category === EmojiCategory.OTHER)
-} as const;
-
-/**
- * 获取表情图片路径
- * @param name 表情名称
- * @returns 图片路径，如果表情不存在则返回 null
- *
- * @example
- * ```typescript
- * const path = getEmojiPath('微笑'); // 'assets/face/微笑.png'
- * const invalidPath = getEmojiPath('不存在'); // null
- * ```
- */
-export function getEmojiPath(name: EmojiName): string | null {
-  const emoji = EMOJI_DATA[name];
-  return emoji ? emoji.path : null;
-}
-
-/**
- * 获取表情信息
- * @param name 表情名称
- * @returns 表情信息对象，如果表情不存在则返回 null
- *
- * @example
- * ```typescript
- * const emoji = getEmojiInfo('微笑');
- * // { name: '微笑', category: EmojiCategory.FACE, path: 'assets/face/微笑.png' }
- * ```
- */
-export function getEmojiInfo(name: EmojiName): EmojiInfo | null {
-  return EMOJI_DATA[name] || null;
-}
-
-/**
- * 根据类别获取表情列表
- * @param category 表情类别
- * @returns 该类别下的所有表情信息
- *
- * @example
- * ```typescript
- * const faceEmojis = getEmojisByCategory(EmojiCategory.FACE);
- * ```
- */
-export function getEmojisByCategory(category: EmojiCategory): EmojiInfo[] {
-  return EMOJI_CATEGORIES[category];
-}
-
-/**
- * 获取所有表情信息
- * @returns 所有表情的信息数组
- *
- * @example
- * ```typescript
- * const allEmojis = getAllEmojis();
- * console.log(`总共有 ${allEmojis.length} 个表情`);
- * ```
- */
-export function getAllEmojis(): EmojiInfo[] {
-  return getAllEmojiData();
-}
-
-/**
- * 搜索表情
- * @param keyword 搜索关键词
- * @returns 匹配的表情信息数组
- *
- * @example
- * ```typescript
- * const results = searchEmojis('笑');
- * // 返回包含 '微笑', '偷笑', '坏笑' 等的表情
- * ```
- */
-export function searchEmojis(keyword: string): EmojiInfo[] {
-  const lowerKeyword = keyword.toLowerCase();
-  return getAllEmojiData().filter(emoji => 
-    emoji.name.toLowerCase().includes(lowerKeyword)
-  );
-}
-
-/**
- * 检查表情是否存在
- * @param name 表情名称
- * @returns 是否存在该表情
- *
- * @example
- * ```typescript
- * const exists = hasEmoji('微笑'); // true
- * const notExists = hasEmoji('不存在的表情'); // false
- * ```
- */
-export function hasEmoji(name: string): name is EmojiName {
-  return name in EMOJI_DATA;
-}
-
-/**
- * 获取表情名称列表
- * @param category 可选的类别筛选
- * @returns 表情名称数组
- *
- * @example
- * ```typescript
- * const allNames = getEmojiNames();
- * const faceNames = getEmojiNames(EmojiCategory.FACE);
- * ```
- */
-export function getEmojiNames(category?: EmojiCategory): string[] {
-  if (category) {
-    return getEmojisByCategory(category).map(emoji => emoji.name);
-  }
-  const names: string[] = [];
-  for (const key in EMOJI_DATA) {
-    if (EMOJI_DATA.hasOwnProperty(key)) {
-      names.push(key);
-    }
-  }
-  return names;
-}
-
-/**
- * 随机获取表情
- * @param category 可选的类别筛选
- * @returns 随机表情信息
- *
- * @example
- * ```typescript
- * const randomEmoji = getRandomEmoji();
- * const randomFaceEmoji = getRandomEmoji(EmojiCategory.FACE);
- * ```
- */
-export function getRandomEmoji(category?: EmojiCategory): EmojiInfo {
-  const emojis = category ? getEmojisByCategory(category) : getAllEmojis();
-  const randomIndex = Math.floor(Math.random() * emojis.length);
-  return emojis[randomIndex];
-}
-
-/**
- * 默认导出对象，包含所有主要功能
- */
-const WeChatEmojis = {
-  // 枚举和类型
-  EmojiCategory,
-
-  // 数据
-  EMOJI_CATEGORIES,
-
-  // 工具函数
-  getEmojiPath,
-  getEmojiInfo,
-  getEmojisByCategory,
-  getAllEmojis,
-  searchEmojis,
-  hasEmoji,
-  getEmojiNames,
-  getRandomEmoji
-} as const;
-
-export default WeChatEmojis;