@coze-arch/cli 0.0.1-alpha.89faa2 → 0.0.1-alpha.8b5326

package/lib/__templates__/expo/eslint-plugins/forbid-emoji/tech.md

@@ -0,0 +1,94 @@
+# forbid-emoji 技术设计
+
+## 目标
+- 在代码中检测并禁止使用 emoji
+- 覆盖常见的字符串与 JSX 场景，避免明显漏报
+- 保持实现简单、可维护，避免引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：demo/eslint-plugins/forbid-emoji
+- 规则名：forbid-emoji/no-emoji
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+当以下任一位置包含 emoji 时，报错：
+- 字符串字面量
+- 模板字符串的静态片段
+- JSXText 文本
+- JSXAttribute 中可静态解析为字符串的值
+
+### 不报错
+以下场景不触发：
+- 标识符、对象键名、属性名中的字符
+- 数值、正则字面量、BigInt
+- 模板字符串的表达式部分（仅检测静态片段）
+- 被用户显式忽略的路径或内容
+
+## 配置项
+```json
+{
+  "ignorePatterns": []
+}
+```
+- ignorePatterns：字符串数组，命中任一正则则跳过该文本片段
+
+## 检测策略
+### AST 访问节点
+- Literal：仅处理 typeof value === 'string'
+- TemplateLiteral：遍历 quasis，使用 cooked 值
+- JSXText：使用 node.value
+- JSXAttribute：可静态解析为字符串时处理
+
+### 忽略策略
+当文本命中 ignorePatterns 的任一正则时，不再做 emoji 检测，减少误报与白名单配置成本。
+
+## Emoji 识别方案
+### 组合序列处理
+考虑到真实文本中的 emoji 组合形式，需要识别以下组合序列并保证命中：
+- 变体选择符：U+FE0F
+- 皮肤色修饰符：U+1F3FB–U+1F3FF
+- ZWJ 组合：U+200D
+- 区域指示符组成的国旗：U+1F1E6–U+1F1FF 的成对序列
+- Keycap 组合：[#*0-9] + U+FE0F? + U+20E3
+
+实现上直接使用完整序列正则匹配，覆盖 ZWJ 连接序列、国旗与 keycap。
+
+### 正则示意
+```
+const RE_EMOJI =
+  /(?:\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
+```
+命中即判定为 emoji。
+
+## 报错信息
+- messageId: noEmoji
+- 文案：禁止在代码中使用 emoji
+
+## 典型示例
+### 触发
+- "hello🙂"
+- `title: "Nice 👍"`
+- <Text>欢迎🎉</Text>
+
+### 不触发
+- const icon = "face-smile"
+- <Text>{user.name}</Text>
+- "hello" + emojiName
+
+## 边界与决策
+- 模板字符串表达式部分：不深入解析，避免执行风险与复杂度
+- 正则字面量：不扫描，避免干扰正则语义
+- 注释：默认不扫描
+- 误报控制：提供 ignorePatterns，由使用者按文件或内容片段进行排除
+
+## 性能考虑
+- 仅在字符串节点上进行扫描
+- 正则预编译并复用
+- 对空字符串与短文本快速返回
+
+## 测试计划
+- 覆盖 Literal、TemplateLiteral、JSXText、JSXAttribute 四类节点
+- 覆盖 ZWJ 组合、变体选择符、国旗、keycap、皮肤色修饰符
+- 覆盖 ignorePatterns 行为

package/lib/__templates__/expo/eslint-plugins/react-native/index.js

@@ -0,0 +1,9 @@
+const wrapScrollViewInView = require('./rule')
+
+const plugin = {
+  rules: {
+    'wrap-horizontal-scrollview-inside-view': wrapScrollViewInView,
+  },
+};
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/react-native/rule.js

@@ -0,0 +1,64 @@
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '禁止带有 horizontal: true 属性的 ScrollView 单独使用',
+      recommended: false,
+    },
+    schema: [],
+    messages: {
+      noSiblings: '禁止带有 props.horizontal: true 的 ScrollView 单独使用，需要在 ScrollView 外层使用一个单独的 View 组件进行包裹',
+    },
+  },
+  create(context) {
+    return {
+      JSXElement(node) {
+        const isScrollView = node.openingElement.name.name === 'ScrollView';
+
+        if (!isScrollView) {
+          return;
+        }
+
+        const hasHorizontalProp = node.openingElement.attributes.some(attr => {
+          if (attr.type === 'JSXAttribute' && attr.name.name === 'horizontal') {
+            if (!attr.value) {
+              return true;
+            }
+            if (
+              attr.value.type === 'JSXExpressionContainer' &&
+              attr.value.expression.value === true
+            ) {
+              return true; // horizontal={true}
+            }
+            if (attr.value.type === 'Literal' && attr.value.value === true) {
+              return true; // horizontal={true} 的另一种形式
+            }
+          }
+          return false;
+        });
+
+        if (!hasHorizontalProp) {
+          return;
+        }
+
+        const parent = node.parent;
+
+        if (
+          parent.type === 'JSXFragment' ||
+          parent.type === 'JSXElement'
+        ) {
+          const siblings = parent.children.filter(
+            child => child.type === 'JSXElement' && child !== node
+          );
+
+          if (siblings.length > 0) {
+            context.report({
+              node,
+              messageId: 'noSiblings',
+            });
+          }
+        }
+      },
+    };
+  },
+}

package/lib/__templates__/expo/eslint-plugins/reanimated/index.js

@@ -0,0 +1,9 @@
+const banMixUse = require('./rule')
+
+const plugin = {
+  rules: {
+    'ban-mix-use': banMixUse,
+  },
+};
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/reanimated/rule.js

@@ -0,0 +1,88 @@
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description:
+        'Disallow passing useAnimatedScrollHandler return value to ScrollView',
+      recommended: 'error',
+    },
+    schema: [],
+    messages: {
+      noUseAnimatedScrollHandlerOnScroll:
+        'Do not pass useAnimatedScrollHandler return value to ScrollView, pass to Animated.ScrollView instead.',
+    },
+  },
+
+  create(context) {
+    // 记录 useAnimatedScrollHandler 的本地名字
+    let useAnimatedScrollHandlerImportName = null;
+    // 记录 ScrollView 的本地名字
+    let scrollViewImportName = null;
+    // 记录调用 useAnimatedScrollHandler 返回值的变量名
+    const animatedScrollHandlerVars = new Set();
+
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value === 'react-native-reanimated') {
+          for (const specifier of node.specifiers) {
+            if (
+              specifier.type === 'ImportSpecifier' &&
+              specifier.imported.name === 'useAnimatedScrollHandler'
+            ) {
+              useAnimatedScrollHandlerImportName = specifier.local.name;
+            }
+          }
+        }
+
+        if (node.source.value === 'react-native') {
+          for (const specifier of node.specifiers) {
+            if (
+              specifier.type === 'ImportSpecifier' &&
+              specifier.imported.name === 'ScrollView'
+            ) {
+              scrollViewImportName = specifier.local.name;
+            }
+          }
+        }
+      },
+
+      VariableDeclarator(node) {
+        if (
+          node.init &&
+          node.init.type === 'CallExpression' &&
+          node.init.callee.type === 'Identifier' &&
+          node.init.callee.name === useAnimatedScrollHandlerImportName
+        ) {
+          if (node.id.type === 'Identifier') {
+            animatedScrollHandlerVars.add(node.id.name);
+          }
+        }
+      },
+
+      JSXOpeningElement(node) {
+        if (
+          node.name.type === 'JSXIdentifier' &&
+          node.name.name === scrollViewImportName
+        ) {
+          for (const attr of node.attributes) {
+            if (
+              attr.type === 'JSXAttribute' &&
+              attr.name.name === 'onScroll' &&
+              attr.value &&
+              attr.value.type === 'JSXExpressionContainer' &&
+              attr.value.expression.type === 'Identifier'
+            ) {
+              const varName = attr.value.expression.name;
+              if (animatedScrollHandlerVars.has(varName)) {
+                context.report({
+                  node: attr,
+                  messageId: 'noUseAnimatedScrollHandlerOnScroll',
+                });
+              }
+            }
+          }
+        }
+      },
+    };
+  },
+};

package/lib/__templates__/expo/package.json

@@ -17,6 +17,9 @@
   "pnpm": {
     "overrides": {
       "esbuild": "0.27.2"
+    },
+    "patchedDependencies": {
+      "expo@54.0.33": "patches/expo@54.0.33.patch"
     }
   }
 }

package/lib/__templates__/expo/patches/expo@54.0.33.patch

@@ -0,0 +1,45 @@
+diff --git a/src/async-require/hmr.ts b/src/async-require/hmr.ts
+index 33ce50ee2950c40d2b0553b148710f1e24e44f3d..3d78cb02dd7e96ac9727a2935d8178f2c7e95982 100644
+--- a/src/async-require/hmr.ts
++++ b/src/async-require/hmr.ts
+@@ -216,6 +216,40 @@ const HMRClient: HMRClientNativeInterface = {
+
+     client.on('update-done', () => {
+       hideLoading();
++      if (process.env.EXPO_PUBLIC_COZE_PROJECT_ID && typeof window !== 'undefined' && window.location) {
++        if((window as any).__updateTimeoutId) {
++          clearTimeout((window as any).__updateTimeoutId);
++        }
++        const updateDoneTime = Date.now();
++        (window as any).__updateDoneTime = updateDoneTime;
++        (window as any).__updateTimeoutId = setTimeout(() => {
++          const lastUpdateTime = (window as any).__updateDoneTime;
++          if (lastUpdateTime !== updateDoneTime) return;
++          const checkServerAndReload = (retriesLeft: number) => {
++            if ((window as any).__updateDoneTime !== updateDoneTime) return;
++            fetch(`/favicon.ico?_t=${Date.now()}`)
++              .then((response) => {
++                if (response.status === 200) {
++                  console.warn('[HMR] Server is ready (200), reloading now.');
++                  window.location.reload();
++                } else {
++                  throw new Error(`Server status: ${response.status}`);
++                }
++              }).catch((error) => {
++                console.warn(`[HMR] Check failed (${error.message}). Retries left: ${retriesLeft}`);
++                if (retriesLeft > 0) {
++                  setTimeout(() => {
++                    checkServerAndReload(retriesLeft - 1);
++                  }, 5000);
++                } else {
++                  console.error('[HMR] Server unreachable after 6 attempts. Abort reload.');
++                }
++              });
++          };
++          checkServerAndReload(6);
++        }, 35_000);
++      }
++      console.log('[HMR] Update done.');
+     });
+
+     client.on('error', (data: { type: string; message: string }) => {