@coze-arch/cli 0.0.1-alpha.b0f2c2 → 0.0.1-alpha.b41a94

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 }) => {