@coze-arch/cli 0.0.1-alpha.fd3d56 → 0.0.1-alpha.ff3d06

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/restrict-linear-gradient/index.js

@@ -0,0 +1,9 @@
+const noLinearGradientBackgroundColor = require('./rule')
+
+const plugin = {
+  rules: {
+    'no-linear-gradient-backgroundcolor': noLinearGradientBackgroundColor,
+  },
+}
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/restrict-linear-gradient/rule.js

@@ -0,0 +1,120 @@
+const LINEAR_GRADIENT_RE = /linear-gradient/i
+
+function getPropertyKeyName(property) {
+  if (!property || property.type !== 'Property') return null
+  if (property.key.type === 'Identifier') return property.key.name
+  if (property.key.type === 'Literal' && typeof property.key.value === 'string') {
+    return property.key.value
+  }
+  return null
+}
+
+function getStaticStringValue(node) {
+  if (!node) return null
+  if (node.type === 'Literal' && typeof node.value === 'string') return node.value
+  if (node.type === 'TemplateLiteral') {
+    return node.quasis.map(quasi => quasi.value?.cooked || '').join('')
+  }
+  return null
+}
+
+function isLinearGradientString(text) {
+  if (!text) return false
+  return LINEAR_GRADIENT_RE.test(text)
+}
+
+function checkStyleObjectExpression(objectExpression, report) {
+  if (!objectExpression || objectExpression.type !== 'ObjectExpression') return
+  for (const property of objectExpression.properties) {
+    if (!property || property.type !== 'Property') continue
+    const keyName = getPropertyKeyName(property)
+    if (keyName !== 'backgroundColor') continue
+    const valueText = getStaticStringValue(property.value)
+    if (isLinearGradientString(valueText)) {
+      report(property.key || property)
+    }
+  }
+}
+
+function isStyleSheetMethodCall(node, methodName) {
+  if (!node || node.type !== 'CallExpression') return false
+  const callee = node.callee
+  if (!callee || callee.type !== 'MemberExpression') return false
+  if (callee.object.type !== 'Identifier' || callee.object.name !== 'StyleSheet') return false
+  if (callee.property.type === 'Identifier') return callee.property.name === methodName
+  return false
+}
+
+function checkStyleExpression(expression, report) {
+  if (!expression) return
+  if (expression.type === 'ObjectExpression') {
+    checkStyleObjectExpression(expression, report)
+    return
+  }
+  if (expression.type === 'ArrayExpression') {
+    for (const element of expression.elements) {
+      if (!element) continue
+      if (element.type === 'SpreadElement') {
+        checkStyleExpression(element.argument, report)
+      } else {
+        checkStyleExpression(element, report)
+      }
+    }
+    return
+  }
+  // 例：StyleSheet.flatten([styles.a, { backgroundColor: 'linear-gradient(...)' }])
+  if (isStyleSheetMethodCall(expression, 'flatten')) {
+    const arg = expression.arguments[0]
+    checkStyleExpression(arg, report)
+    return
+  }
+  // 例：StyleSheet.compose(styles.a, { backgroundColor: `linear-gradient(${angle},#fff,#000)` })
+  if (isStyleSheetMethodCall(expression, 'compose')) {
+    const [first, second] = expression.arguments
+    checkStyleExpression(first, report)
+    checkStyleExpression(second, report)
+  }
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow linear-gradient string in backgroundColor',
+      recommended: 'error',
+    },
+    schema: [],
+    messages: {
+      noLinearGradientBackgroundColor:
+        'backgroundColor 和 linear-gradient 无法一起使用，请将 backgroundColor 改为 experimental_backgroundImage',
+    },
+  },
+
+  create(context) {
+    function report(node) {
+      context.report({ node, messageId: 'noLinearGradientBackgroundColor' })
+    }
+
+    return {
+      CallExpression(node) {
+        if (!isStyleSheetMethodCall(node, 'create')) return
+        const firstArg = node.arguments[0]
+        if (!firstArg || firstArg.type !== 'ObjectExpression') return
+
+        checkStyleObjectExpression(firstArg, report)
+
+        for (const property of firstArg.properties) {
+          if (!property || property.type !== 'Property') continue
+          if (!property.value || property.value.type !== 'ObjectExpression') continue
+          checkStyleObjectExpression(property.value, report)
+        }
+      },
+
+      JSXAttribute(node) {
+        if (!node.name || node.name.name !== 'style') return
+        if (!node.value || node.value.type !== 'JSXExpressionContainer') return
+        checkStyleExpression(node.value.expression, report)
+      },
+    }
+  },
+}

package/lib/__templates__/expo/eslint-plugins/restrict-linear-gradient/tech.md

@@ -0,0 +1,58 @@
+# restrict-linear-gradient 技术设计
+
+## 目标
+- 禁止在 backgroundColor 中使用 linear-gradient 字符串
+- 覆盖 StyleSheet.create 与 JSX style 的常见写法
+- 实现轻量、易维护，不引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：expo/eslint-plugins/restrict-linear-gradient
+- 规则名：restrict-linear-gradient/no-linear-gradient-backgroundcolor
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+当以下任一位置出现 backgroundColor 且值包含 linear-gradient( 时，报错：
+- StyleSheet.create 的样式对象中
+- JSX 元素 style 属性内的对象或数组成员
+
+### 不报错
+以下场景不触发：
+- 非 backgroundColor 的属性
+- backgroundColor 的非字符串值
+- 模板字符串包含表达式的动态值
+- 与 style 无关的对象字面量
+
+## 检测策略
+### StyleSheet.create
+遍历 StyleSheet.create 的首个参数对象，检查：
+- 顶层 backgroundColor
+- 每个样式项对应的对象内的 backgroundColor
+
+### JSX style
+定位 JSXAttribute(name=style) 后，检查表达式：
+- ObjectExpression
+- ArrayExpression 的各元素
+- StyleSheet.flatten / StyleSheet.compose 的参数
+
+## 线性渐变识别
+使用正则 /linear-gradient/i 检测字符串字面量与模板字符串静态片段。
+
+## 报错信息
+- messageId: noLinearGradientBackgroundColor
+- 文案：backgroundColor 和 linear-gradient 无法一起使用，请将 backgroundColor 改为 experimental_backgroundImage
+
+## 典型示例
+### 触发
+- StyleSheet.create({ a: { backgroundColor: 'linear-gradient(135deg,#F97316 0%,#FB923C 100%)' } })
+- <View style={{ backgroundColor: "linear-gradient(135deg,#F97316 0%,#FB923C 100%)" }} />
+- <View style={[{ backgroundColor: `linear-gradient(135deg,#F97316 0%,#FB923C 100%)` }]} />
+
+### 不触发
+- { background: 'linear-gradient(...)' }
+- { backgroundColor: someVar }
+
+## 性能考虑
+- 仅扫描目标节点与静态字符串
+- 早返回空节点与非字符串值

package/lib/__templates__/expo/package.json

@@ -19,7 +19,7 @@
       "esbuild": "0.27.2"
     },
     "patchedDependencies": {
-      "expo@54.0.32": "patches/expo@54.0.32.patch"
+      "expo@54.0.33": "patches/expo@54.0.33.patch"
     }
   }
 }

package/lib/__templates__/expo/patches/{expo@54.0.32.patch → expo@54.0.33.patch}

@@ -1,8 +1,8 @@
 diff --git a/src/async-require/hmr.ts b/src/async-require/hmr.ts
-index 33ce50ee2950c40d2b0553b148710f1e24e44f3d..a13d6f2da10dea858019cc991c21753f64f01fd0 100644
+index 33ce50ee2950c40d2b0553b148710f1e24e44f3d..3d78cb02dd7e96ac9727a2935d8178f2c7e95982 100644
 --- a/src/async-require/hmr.ts
 +++ b/src/async-require/hmr.ts
-@@ -216,6 +216,39 @@ const HMRClient: HMRClientNativeInterface = {
+@@ -216,6 +216,40 @@ const HMRClient: HMRClientNativeInterface = {
 
      client.on('update-done', () => {
        hideLoading();
@@ -39,6 +39,7 @@ index 33ce50ee2950c40d2b0553b148710f1e24e44f3d..a13d6f2da10dea858019cc991c21753f
 +          checkServerAndReload(6);
 +        }, 35_000);
 +      }
++      console.log('[HMR] Update done.');
      });
 
      client.on('error', (data: { type: string; message: string }) => {