@coze-arch/cli 0.0.1-alpha.e58008 → 0.0.1-alpha.e70f72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/README.md +1 -0
  2. package/lib/__templates__/expo/.cozeproj/scripts/server_dev_run.sh +1 -1
  3. package/lib/__templates__/expo/client/components/Screen.tsx +2 -2
  4. package/lib/__templates__/expo/client/eslint.config.mjs +4 -0
  5. package/lib/__templates__/expo/client/metro.config.js +3 -0
  6. package/lib/__templates__/expo/client/package.json +35 -35
  7. package/lib/__templates__/expo/client/scripts/install-missing-deps.js +10 -10
  8. package/lib/__templates__/expo/eslint-plugins/forbid-emoji/index.js +9 -0
  9. package/lib/__templates__/expo/eslint-plugins/forbid-emoji/rule.js +112 -0
  10. package/lib/__templates__/expo/eslint-plugins/forbid-emoji/tech.md +94 -0
  11. package/lib/__templates__/expo/package.json +1 -1
  12. package/lib/__templates__/expo/pnpm-lock.yaml +394 -221
  13. package/lib/__templates__/expo/server/package.json +9 -7
  14. package/lib/__templates__/expo/server/src/index.ts +1 -0
  15. package/lib/__templates__/expo/template.config.js +56 -0
  16. package/lib/__templates__/native-static/.coze +11 -0
  17. package/lib/__templates__/native-static/index.html +33 -0
  18. package/lib/__templates__/native-static/styles/main.css +136 -0
  19. package/lib/__templates__/native-static/template.config.js +22 -0
  20. package/lib/__templates__/nextjs/README.md +5 -0
  21. package/lib/__templates__/nextjs/eslint.config.mjs +5 -0
  22. package/lib/__templates__/nextjs/next.config.ts +1 -2
  23. package/lib/__templates__/nextjs/package.json +5 -6
  24. package/lib/__templates__/nextjs/pnpm-lock.yaml +1145 -109
  25. package/lib/__templates__/nextjs/scripts/build.sh +4 -1
  26. package/lib/__templates__/nextjs/scripts/dev.sh +4 -4
  27. package/lib/__templates__/nextjs/scripts/start.sh +1 -1
  28. package/lib/__templates__/nextjs/src/app/layout.tsx +1 -1
  29. package/lib/__templates__/nextjs/src/app/page.tsx +4 -3
  30. package/lib/__templates__/nextjs/src/server.ts +35 -0
  31. package/lib/__templates__/nextjs/template.config.js +49 -14
  32. package/lib/__templates__/nextjs/tsconfig.json +1 -1
  33. package/lib/__templates__/nuxt-vue/.coze +12 -0
  34. package/lib/__templates__/nuxt-vue/README.md +73 -0
  35. package/lib/__templates__/nuxt-vue/_gitignore +24 -0
  36. package/lib/__templates__/nuxt-vue/_npmrc +23 -0
  37. package/lib/__templates__/nuxt-vue/app/app.vue +6 -0
  38. package/lib/__templates__/nuxt-vue/app/pages/index.vue +23 -0
  39. package/lib/__templates__/nuxt-vue/assets/css/main.css +24 -0
  40. package/lib/__templates__/nuxt-vue/nuxt.config.ts +116 -0
  41. package/lib/__templates__/nuxt-vue/package.json +35 -0
  42. package/lib/__templates__/nuxt-vue/pnpm-lock.yaml +8759 -0
  43. package/lib/__templates__/nuxt-vue/postcss.config.mjs +8 -0
  44. package/lib/__templates__/nuxt-vue/public/favicon.ico +0 -0
  45. package/lib/__templates__/nuxt-vue/public/robots.txt +2 -0
  46. package/lib/__templates__/nuxt-vue/scripts/build.sh +14 -0
  47. package/lib/__templates__/nuxt-vue/scripts/dev.sh +32 -0
  48. package/lib/__templates__/nuxt-vue/scripts/prepare.sh +14 -0
  49. package/lib/__templates__/nuxt-vue/scripts/start.sh +15 -0
  50. package/lib/__templates__/nuxt-vue/server/api/hello.ts +10 -0
  51. package/lib/__templates__/nuxt-vue/server/middleware/logger.ts +10 -0
  52. package/lib/__templates__/nuxt-vue/server/routes/health.ts +10 -0
  53. package/lib/__templates__/nuxt-vue/tailwind.config.js +13 -0
  54. package/lib/__templates__/nuxt-vue/template.config.js +87 -0
  55. package/lib/__templates__/nuxt-vue/tsconfig.json +18 -0
  56. package/lib/__templates__/taro/.cozeproj/scripts/dev_run.sh +109 -36
  57. package/lib/__templates__/taro/.cozeproj/scripts/pack.sh +24 -1
  58. package/lib/__templates__/taro/README.md +81 -17
  59. package/lib/__templates__/taro/config/index.ts +87 -37
  60. package/lib/__templates__/taro/config/prod.ts +4 -5
  61. package/lib/__templates__/taro/eslint.config.mjs +27 -4
  62. package/lib/__templates__/taro/package.json +16 -4
  63. package/lib/__templates__/taro/patches/@tarojs__plugin-mini-ci@4.1.9.patch +30 -0
  64. package/lib/__templates__/taro/pnpm-lock.yaml +785 -115
  65. package/lib/__templates__/taro/server/package.json +3 -1
  66. package/lib/__templates__/taro/src/app.css +18 -18
  67. package/lib/__templates__/taro/src/app.tsx +9 -0
  68. package/lib/__templates__/taro/src/index.html +36 -47
  69. package/lib/__templates__/taro/src/presets/dev-debug.ts +23 -0
  70. package/lib/__templates__/taro/src/presets/h5-container.tsx +15 -0
  71. package/lib/__templates__/taro/src/presets/h5-navbar.tsx +201 -0
  72. package/lib/__templates__/taro/src/presets/h5-styles.ts +142 -0
  73. package/lib/__templates__/taro/src/presets/index.tsx +18 -0
  74. package/lib/__templates__/templates.json +43 -0
  75. package/lib/__templates__/vite/README.md +190 -11
  76. package/lib/__templates__/vite/_gitignore +1 -0
  77. package/lib/__templates__/vite/eslint.config.mjs +6 -1
  78. package/lib/__templates__/vite/package.json +14 -3
  79. package/lib/__templates__/vite/pnpm-lock.yaml +820 -1593
  80. package/lib/__templates__/vite/scripts/build.sh +4 -1
  81. package/lib/__templates__/vite/scripts/dev.sh +5 -4
  82. package/lib/__templates__/vite/scripts/start.sh +3 -3
  83. package/lib/__templates__/vite/server/routes/index.ts +31 -0
  84. package/lib/__templates__/vite/server/server.ts +55 -0
  85. package/lib/__templates__/vite/server/vite.ts +71 -0
  86. package/lib/__templates__/vite/src/main.ts +2 -2
  87. package/lib/__templates__/vite/template.config.js +49 -14
  88. package/lib/__templates__/vite/tsconfig.json +4 -3
  89. package/lib/__templates__/vite/vite.config.ts +1 -0
  90. package/lib/cli.js +160 -159
  91. package/package.json +7 -3
  92. package/lib/__templates__/taro/src/app.ts +0 -14
  93. package/lib/__templates__/taro/src/utils/h5-styles.ts +0 -22
  94. package/lib/__templates__/taro/src/utils/wx-debug.ts +0 -23
  95. /package/lib/__templates__/expo/patches/{expo@54.0.32.patch → expo@54.0.33.patch} +0 -0
package/README.md CHANGED
@@ -14,6 +14,7 @@ Coze Coding 的项目模板引擎,提供基于前端技术栈的项目初始
14
14
 
15
15
  ```bash
16
16
  rush update
17
+
17
18
  ```
18
19
 
19
20
  ## 使用
@@ -43,4 +43,4 @@ kill_old_server
43
43
 
44
44
  echo "启动 server 服务..."
45
45
  cd "$SERVER_DIR"
46
- NODE_ENV=development PORT="$SERVER_PORT" npx tsx ./src/index.ts 2>&1 | pipe_to_log "SERVER" "$LOG_SERVER_FILE"
46
+ NODE_ENV=development PORT="$SERVER_PORT" npx tsx watch ./src/index.ts 2>&1 | pipe_to_log "SERVER" "$LOG_SERVER_FILE"
@@ -32,7 +32,7 @@ import {
32
32
  *
33
33
  * ## 2. 沉浸式 Header (推荐)
34
34
  * - 场景:Header 背景色/图片需要延伸到状态栏 (如首页、个人中心)。
35
- * - 用法:`<Screen safeAreaEdges={['left', 'right', 'bottom']}>` (去掉 'top')
35
+ * - 用法:`<Screen safeAreaEdges={['left', 'right', 'bottom']}>` (去掉 'top')
36
36
  * - 配合:页面内部 Header 组件必须手动添加 paddingTop:
37
37
  * ```tsx
38
38
  * const insets = useSafeAreaInsets();
@@ -41,7 +41,7 @@ import {
41
41
  *
42
42
  * ## 3. 底部有 TabBar 或 悬浮按钮
43
43
  * - 场景:页面底部有固定导航栏,或者需要精细控制底部留白。
44
- * - 用法:`<Screen safeAreaEdges={['top', 'left', 'right']}>` (去掉 'bottom')
44
+ * - 用法:`<Screen safeAreaEdges={['top', 'left', 'right']}>` (去掉 'bottom')
45
45
  * - 配合:
46
46
  * - 若是滚动页:`<ScrollView contentContainerStyle={{ paddingBottom: insets.bottom + 80 }}>`
47
47
  * - 若是固定页:`<View style={{ paddingBottom: insets.bottom + 60 }}>`
@@ -8,6 +8,7 @@ import pluginImport from 'eslint-plugin-import';
8
8
  import fontawesome6 from '../eslint-plugins/fontawesome6/index.js';
9
9
  import reanimated from '../eslint-plugins/reanimated/index.js';
10
10
  import reactnative from '../eslint-plugins/react-native/index.js';
11
+ import forbidEmoji from '../eslint-plugins/forbid-emoji/index.js';
11
12
 
12
13
  export default [
13
14
  {
@@ -20,6 +21,7 @@ export default [
20
21
  'tailwind.config.js', // 排除 Tailwind 配置文件
21
22
  '**/*.d.ts',
22
23
  'eslint.config.*',
24
+ 'metro.config.*',
23
25
  ],
24
26
  },
25
27
  regexp.configs["flat/recommended"],
@@ -60,6 +62,7 @@ export default [
60
62
  fontawesome6,
61
63
  reanimated,
62
64
  reactnative,
65
+ forbidEmoji,
63
66
  },
64
67
  rules: {
65
68
  // 关闭代码风格规则
@@ -80,6 +83,7 @@ export default [
80
83
  'react/jsx-uses-react': 'off',
81
84
  'fontawesome6/valid-name': 'error',
82
85
  'reanimated/ban-mix-use': 'error',
86
+ 'forbidEmoji/no-emoji': 'error',
83
87
  // 禁止使用 via.placeholder.com 服务
84
88
  'no-restricted-syntax': [
85
89
  'error',
@@ -26,6 +26,9 @@ config.resolver.blockList = [
26
26
  // 4. 通用规则
27
27
  /.*\/__tests__\/.*/, // 排除所有测试目录
28
28
  /.*\.git\/.*/, // 排除 Git 目录
29
+
30
+ // 5. pnpm 临时目录(避免 ENOENT 错误)
31
+ /.*node_modules\/\.pnpm\/.*_tmp_\d+.*/,
29
32
  ];
30
33
 
31
34
  const BACKEND_TARGET = 'http://localhost:9091';
@@ -15,38 +15,38 @@
15
15
  "preset": "jest-expo"
16
16
  },
17
17
  "dependencies": {
18
- "@expo/metro-runtime": "^6.1.2",
19
- "@expo/vector-icons": "^15.0.0",
20
- "@react-native-async-storage/async-storage": "^2.2.0",
21
- "@react-native-community/datetimepicker": "^8.5.0",
22
- "@react-native-community/slider": "^5.0.1",
23
- "@react-native-masked-view/masked-view": "^0.3.2",
24
- "@react-native-picker/picker": "^2.11.0",
18
+ "@expo/metro-runtime": "~6.1.2",
19
+ "@expo/vector-icons": "^15.0.3",
20
+ "@react-native-async-storage/async-storage": "2.2.0",
21
+ "@react-native-community/datetimepicker": "8.4.4",
22
+ "@react-native-community/slider": "5.0.1",
23
+ "@react-native-masked-view/masked-view": "0.3.2",
24
+ "@react-native-picker/picker": "2.11.1",
25
25
  "@react-navigation/bottom-tabs": "^7.2.0",
26
26
  "@react-navigation/native": "^7.0.14",
27
27
  "dayjs": "^1.11.19",
28
- "expo": "54.0.32",
29
- "expo-auth-session": "^7.0.9",
30
- "expo-av": "~16.0.6",
31
- "expo-blur": "~15.0.6",
28
+ "expo": "54.0.33",
29
+ "expo-auth-session": "~7.0.10",
30
+ "expo-av": "~16.0.8",
31
+ "expo-blur": "~15.0.8",
32
32
  "expo-camera": "~17.0.10",
33
- "expo-constants": "~18.0.8",
34
- "expo-crypto": "^15.0.7",
33
+ "expo-constants": "~18.0.13",
34
+ "expo-crypto": "~15.0.8",
35
35
  "expo-file-system": "~19.0.21",
36
- "expo-font": "~14.0.7",
37
- "expo-haptics": "~15.0.6",
38
- "expo-image-picker": "~17.0.7",
39
- "expo-linear-gradient": "~15.0.6",
40
- "expo-linking": "~8.0.7",
41
- "expo-location": "~19.0.7",
42
- "expo-image": "^3.0.11",
43
- "js-base64": "^3.7.7",
44
- "expo-router": "~6.0.0",
45
- "expo-splash-screen": "~31.0.8",
46
- "expo-status-bar": "~3.0.7",
47
- "expo-symbols": "~1.0.6",
36
+ "expo-font": "~14.0.11",
37
+ "expo-haptics": "~15.0.8",
38
+ "expo-image": "~3.0.11",
39
+ "expo-image-picker": "~17.0.10",
40
+ "expo-linear-gradient": "~15.0.8",
41
+ "expo-linking": "~8.0.11",
42
+ "expo-location": "~19.0.8",
43
+ "expo-router": "~6.0.23",
44
+ "expo-splash-screen": "~31.0.13",
45
+ "expo-status-bar": "~3.0.9",
46
+ "expo-symbols": "~1.0.8",
48
47
  "expo-system-ui": "~6.0.9",
49
48
  "expo-web-browser": "~15.0.10",
49
+ "js-base64": "^3.7.7",
50
50
  "react": "19.1.0",
51
51
  "react-dom": "19.1.0",
52
52
  "react-native": "0.81.5",
@@ -54,25 +54,26 @@
54
54
  "react-native-gesture-handler": "~2.28.0",
55
55
  "react-native-keyboard-aware-scroll-view": "^0.9.5",
56
56
  "react-native-modal-datetime-picker": "18.0.0",
57
- "react-native-reanimated": "~4.1.0",
57
+ "react-native-reanimated": "~4.1.1",
58
58
  "react-native-safe-area-context": "~5.6.0",
59
59
  "react-native-screens": "~4.16.0",
60
- "react-native-svg": "15.15.0",
60
+ "react-native-svg": "15.12.1",
61
61
  "react-native-toast-message": "^2.3.3",
62
- "react-native-web": "^0.21.2",
63
- "react-native-webview": "~13.15.0",
62
+ "react-native-web": "~0.21.0",
63
+ "react-native-webview": "13.15.0",
64
64
  "react-native-worklets": "0.5.1",
65
65
  "zod": "^4.2.1"
66
66
  },
67
67
  "devDependencies": {
68
68
  "@babel/core": "^7.25.2",
69
- "babel-plugin-module-resolver": "^5.0.2",
70
- "babel-preset-expo": "^54.0.9",
71
69
  "@eslint/js": "^9.27.0",
72
70
  "@types/jest": "^29.5.12",
73
71
  "@types/react": "~19.1.0",
74
72
  "@types/react-test-renderer": "19.1.0",
73
+ "babel-plugin-module-resolver": "^5.0.2",
74
+ "babel-preset-expo": "^54.0.9",
75
75
  "chalk": "^4.1.2",
76
+ "connect": "^3.7.0",
76
77
  "depcheck": "^1.4.7",
77
78
  "esbuild": "0.27.2",
78
79
  "eslint": "^9.39.2",
@@ -83,13 +84,12 @@
83
84
  "eslint-plugin-react-hooks": "^7.0.1",
84
85
  "eslint-plugin-regexp": "^2.10.0",
85
86
  "globals": "^16.1.0",
87
+ "http-proxy-middleware": "^3.0.5",
86
88
  "jest": "^29.2.1",
87
- "jest-expo": "~54.0.10",
89
+ "jest-expo": "~54.0.17",
88
90
  "react-test-renderer": "19.1.0",
89
91
  "tsx": "^4.21.0",
90
92
  "typescript": "^5.8.3",
91
- "typescript-eslint": "^8.32.1",
92
- "connect": "^3.7.0",
93
- "http-proxy-middleware": "^3.0.5"
93
+ "typescript-eslint": "^8.32.1"
94
94
  }
95
95
  }
@@ -9,7 +9,7 @@ const { execSync } = require('child_process');
9
9
  const fs = require('fs');
10
10
  const path = require('path');
11
11
 
12
- console.log('🔍 检测缺失的依赖...\n');
12
+ console.log('检测缺失的依赖...\n');
13
13
 
14
14
  try {
15
15
  // 运行 depcheck 并获取 JSON 输出
@@ -61,11 +61,11 @@ try {
61
61
  });
62
62
 
63
63
  if (missingPackages.length === 0) {
64
- console.log('✅ 没有发现缺失的依赖!');
64
+ console.log('没有发现缺失的依赖');
65
65
  process.exit(0);
66
66
  }
67
67
 
68
- console.log('📦 发现以下缺失的依赖:');
68
+ console.log('发现以下缺失的依赖:');
69
69
  missingPackages.forEach((pkg, index) => {
70
70
  const files = missing[pkg];
71
71
  console.log(` ${index + 1}. ${pkg}`);
@@ -74,7 +74,7 @@ try {
74
74
  );
75
75
  });
76
76
 
77
- console.log('\n🚀 开始安装...\n');
77
+ console.log('\n开始安装...\n');
78
78
 
79
79
  // 使用 expo install 安装所有缺失的包
80
80
  const packagesToInstall = missingPackages.join(' ');
@@ -84,22 +84,22 @@ try {
84
84
  stdio: 'inherit',
85
85
  });
86
86
 
87
- console.log('\n✅ 所有缺失的依赖已安装完成!');
87
+ console.log('\n所有缺失的依赖已安装完成');
88
88
  } catch (installError) {
89
- console.log('\n⚠️ expo install 失败,尝试使用 npm install...\n');
89
+ console.log('\nexpo install 失败,尝试使用 npm install...\n');
90
90
 
91
91
  execSync(`npm install ${packagesToInstall}`, {
92
92
  stdio: 'inherit',
93
93
  });
94
94
 
95
- console.log('\n所有缺失的依赖已通过 npm 安装完成!');
95
+ console.log('\n所有缺失的依赖已通过 npm 安装完成');
96
96
  }
97
97
  } catch (error) {
98
98
  if (error.message.includes('depcheck')) {
99
- console.error('depcheck 未安装或运行失败');
100
- console.log('💡 尝试运行: npm install -g depcheck');
99
+ console.error('depcheck 未安装或运行失败');
100
+ console.log('尝试运行: npm install -g depcheck');
101
101
  } else {
102
- console.error('发生错误:', error.message);
102
+ console.error('发生错误:', error.message);
103
103
  }
104
104
  process.exit(1);
105
105
  }
@@ -0,0 +1,9 @@
1
+ const noEmoji = require('./rule')
2
+
3
+ const plugin = {
4
+ rules: {
5
+ 'no-emoji': noEmoji,
6
+ },
7
+ }
8
+
9
+ module.exports = plugin
@@ -0,0 +1,112 @@
1
+ const DEFAULTS = {
2
+ ignorePatterns: [],
3
+ }
4
+
5
+ const RE_EMOJI =
6
+ // 匹配完整 emoji 序列:基础图形 + 可选变体选择符/肤色 + 可选 ZWJ 连接序列;以及国旗与 keycap
7
+ /(?:\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?)*)|(?:[\u{1F1E6}-\u{1F1FF}]{2})|(?:[#*0-9]\uFE0F?\u20E3)/gu
8
+
9
+ function buildIgnoreRegexes(patterns) {
10
+ if (!Array.isArray(patterns)) return []
11
+ const result = []
12
+ for (const pattern of patterns) {
13
+ if (typeof pattern !== 'string') continue
14
+ try {
15
+ result.push(new RegExp(pattern))
16
+ } catch (_) {
17
+ continue
18
+ }
19
+ }
20
+ return result
21
+ }
22
+
23
+ function shouldIgnore(text, ignoreRegexes) {
24
+ if (!ignoreRegexes.length) return false
25
+ for (const re of ignoreRegexes) {
26
+ if (re.test(text)) return true
27
+ }
28
+ return false
29
+ }
30
+
31
+ function hasEmoji(text) {
32
+ if (!text) return false
33
+ RE_EMOJI.lastIndex = 0
34
+ return RE_EMOJI.test(text)
35
+ }
36
+
37
+ function collectEmojis(text) {
38
+ if (!text) return []
39
+ RE_EMOJI.lastIndex = 0
40
+ const result = []
41
+ const seen = new Set()
42
+ for (const match of text.matchAll(RE_EMOJI)) {
43
+ if (match[0] && !seen.has(match[0])) {
44
+ seen.add(match[0])
45
+ result.push(match[0])
46
+ }
47
+ }
48
+ return result
49
+ }
50
+
51
+ module.exports = {
52
+ meta: {
53
+ type: 'problem',
54
+ docs: {
55
+ description: 'Disallow emoji in code',
56
+ recommended: 'error',
57
+ },
58
+ schema: [
59
+ {
60
+ type: 'object',
61
+ additionalProperties: false,
62
+ properties: {
63
+ ignorePatterns: {
64
+ type: 'array',
65
+ items: { type: 'string' },
66
+ default: DEFAULTS.ignorePatterns,
67
+ },
68
+ },
69
+ },
70
+ ],
71
+ messages: {
72
+ noEmoji: '禁止在代码中使用 emoji:{{emojis}},请移除或者使用 @expo/vector-icons 图标',
73
+ },
74
+ },
75
+
76
+ create(context) {
77
+ const options = context.options && context.options[0] ? context.options[0] : {}
78
+ const ignoreRegexes = buildIgnoreRegexes(
79
+ Array.isArray(options.ignorePatterns) ? options.ignorePatterns : DEFAULTS.ignorePatterns
80
+ )
81
+
82
+ function checkText(node, text) {
83
+ if (!text) return
84
+ if (shouldIgnore(text, ignoreRegexes)) return
85
+ if (hasEmoji(text)) {
86
+ const emojis = collectEmojis(text)
87
+ const emojiText = emojis.length ? emojis.join(' ') : ''
88
+ context.report({ node, messageId: 'noEmoji', data: { emojis: emojiText } })
89
+ }
90
+ }
91
+
92
+ return {
93
+ Literal(node) {
94
+ if (typeof node.value !== 'string') return
95
+ checkText(node, node.value)
96
+ },
97
+ TemplateLiteral(node) {
98
+ for (const quasi of node.quasis) {
99
+ const cooked = quasi.value && typeof quasi.value.cooked === 'string'
100
+ ? quasi.value.cooked
101
+ : quasi.value && typeof quasi.value.raw === 'string'
102
+ ? quasi.value.raw
103
+ : ''
104
+ checkText(quasi, cooked)
105
+ }
106
+ },
107
+ JSXText(node) {
108
+ checkText(node, node.value)
109
+ },
110
+ }
111
+ },
112
+ }
@@ -0,0 +1,94 @@
1
+ # forbid-emoji 技术设计
2
+
3
+ ## 目标
4
+ - 在代码中检测并禁止使用 emoji
5
+ - 覆盖常见的字符串与 JSX 场景,避免明显漏报
6
+ - 保持实现简单、可维护,避免引入新依赖
7
+
8
+ ## 规则命名与对外形态
9
+ - 插件目录:demo/eslint-plugins/forbid-emoji
10
+ - 规则名:forbid-emoji/no-emoji
11
+ - 规则类型:problem
12
+ - 默认等级:error
13
+
14
+ ## 规则行为定义
15
+ ### 报错
16
+ 当以下任一位置包含 emoji 时,报错:
17
+ - 字符串字面量
18
+ - 模板字符串的静态片段
19
+ - JSXText 文本
20
+ - JSXAttribute 中可静态解析为字符串的值
21
+
22
+ ### 不报错
23
+ 以下场景不触发:
24
+ - 标识符、对象键名、属性名中的字符
25
+ - 数值、正则字面量、BigInt
26
+ - 模板字符串的表达式部分(仅检测静态片段)
27
+ - 被用户显式忽略的路径或内容
28
+
29
+ ## 配置项
30
+ ```json
31
+ {
32
+ "ignorePatterns": []
33
+ }
34
+ ```
35
+ - ignorePatterns:字符串数组,命中任一正则则跳过该文本片段
36
+
37
+ ## 检测策略
38
+ ### AST 访问节点
39
+ - Literal:仅处理 typeof value === 'string'
40
+ - TemplateLiteral:遍历 quasis,使用 cooked 值
41
+ - JSXText:使用 node.value
42
+ - JSXAttribute:可静态解析为字符串时处理
43
+
44
+ ### 忽略策略
45
+ 当文本命中 ignorePatterns 的任一正则时,不再做 emoji 检测,减少误报与白名单配置成本。
46
+
47
+ ## Emoji 识别方案
48
+ ### 组合序列处理
49
+ 考虑到真实文本中的 emoji 组合形式,需要识别以下组合序列并保证命中:
50
+ - 变体选择符:U+FE0F
51
+ - 皮肤色修饰符:U+1F3FB–U+1F3FF
52
+ - ZWJ 组合:U+200D
53
+ - 区域指示符组成的国旗:U+1F1E6–U+1F1FF 的成对序列
54
+ - Keycap 组合:[#*0-9] + U+FE0F? + U+20E3
55
+
56
+ 实现上直接使用完整序列正则匹配,覆盖 ZWJ 连接序列、国旗与 keycap。
57
+
58
+ ### 正则示意
59
+ ```
60
+ const RE_EMOJI =
61
+ /(?:\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?)*)|(?:[\u{1F1E6}-\u{1F1FF}]{2})|(?:[#*0-9]\uFE0F?\u20E3)/gu
62
+ ```
63
+ 命中即判定为 emoji。
64
+
65
+ ## 报错信息
66
+ - messageId: noEmoji
67
+ - 文案:禁止在代码中使用 emoji
68
+
69
+ ## 典型示例
70
+ ### 触发
71
+ - "hello🙂"
72
+ - `title: "Nice 👍"`
73
+ - <Text>欢迎🎉</Text>
74
+
75
+ ### 不触发
76
+ - const icon = "face-smile"
77
+ - <Text>{user.name}</Text>
78
+ - "hello" + emojiName
79
+
80
+ ## 边界与决策
81
+ - 模板字符串表达式部分:不深入解析,避免执行风险与复杂度
82
+ - 正则字面量:不扫描,避免干扰正则语义
83
+ - 注释:默认不扫描
84
+ - 误报控制:提供 ignorePatterns,由使用者按文件或内容片段进行排除
85
+
86
+ ## 性能考虑
87
+ - 仅在字符串节点上进行扫描
88
+ - 正则预编译并复用
89
+ - 对空字符串与短文本快速返回
90
+
91
+ ## 测试计划
92
+ - 覆盖 Literal、TemplateLiteral、JSXText、JSXAttribute 四类节点
93
+ - 覆盖 ZWJ 组合、变体选择符、国旗、keycap、皮肤色修饰符
94
+ - 覆盖 ignorePatterns 行为
@@ -19,7 +19,7 @@
19
19
  "esbuild": "0.27.2"
20
20
  },
21
21
  "patchedDependencies": {
22
- "expo@54.0.32": "patches/expo@54.0.32.patch"
22
+ "expo@54.0.33": "patches/expo@54.0.33.patch"
23
23
  }
24
24
  }
25
25
  }